Skip to main content

Documentation Index

Fetch the complete documentation index at: https://polyfeed.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

All /v1/* endpoints require a Bearer API key.
Authorization: Bearer pk_live_xxxxxxxxxxxx

Key management

Keys are created and rotated at app.polyfeed.dev/keys. Tied to your Better-Auth account (Google / GitHub / email).
  • Keys are shown once on creation. Save to your secret manager immediately.
  • Rotate at will — old keys revoke instantly.
  • One account can hold many keys (one per environment, per bot, etc.).

Errors

StatusMeaning
401 UnauthorizedMissing or malformed Authorization header
403 ForbiddenKey valid but tier doesn’t grant access to the requested coin or route
429 Too Many RequestsPer-key rate limit hit. Honor Retry-After header
See Errors for full reference.

Scopes

Tier determines which coins and routes a key can hit. See Rate limits for tier matrix. Use GET /v1/billing/tiers to enumerate live.