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.

polyfeed is paid via crypto only. No card, no recurring auth, no off-chain account ledger.

​
Flow

1

Pick a tier

GET /v1/billing/tiers — returns available tiers with monthly price.
2

Quote a payment

POST /v1/billing/x402/quote — choose chain + token, get exact wei amount and payment requirements.
3

Pay on-chain

Your wallet signs an x402 facilitator request on Polygon. Funds settle to the polyfeed receiving address.
4

Settle the subscription

POST /v1/billing/x402/settle — submits the on-chain proof. Server verifies via facilitator, provisions your subscription, invalidates your tier cache. Your next API call uses the new tier.
Idempotent on (provider, providerRef) — retries safe.

​
History

GET /v1/billing/history — list all your payments. Response is a discriminated union on provider (currently only x402, future: stripe).

​
Cancellation

Subscriptions are pay-as-you-go monthly. They expire automatically. No cancellation endpoint — just stop renewing. See x402 details.