Skip to main content
You pay per call, from a prepaid balance. There is no subscription and no monthly minimum. An agent with a crypto wallet can instead pay each call in USDC without an account; see Pay With x402. The two calls that tell you what exists are free. Every new account starts with $5 of balance, with no card needed, which is enough for 500 paid calls.

​
Price per call

Each endpoint has one flat price per call, however many results it returns. The free calls list what exists, so finding what to ask for never costs anything. They need no balance, don’t count toward a key’s spend budget, and don’t appear on Usage or Logs.

​
What you’re charged for

  • Only paid calls that succeed. A call that returns an error (400, 401, 402, 403, 404 or 5xx) costs nothing.
  • One price per call. Asking for 100 metrics in one call to GET /v1/commodities/metric-values costs the same $0.01 as asking for one. So batch where you can.
  • Calls from the API Reference and AI assistants too. The Try it button and the Data MCP connection send real calls, charged like any other.

​
When a call is refused

A paid call is refused with status 402 and error type insufficient_balance before any data is read if either of these would be exceeded:
  • Your balance. The message is Insufficient balance.
  • The key’s monthly spend budget, set per key under API Keys. The message is Monthly spend cap reached.
A refused call costs nothing. Retrying it fails the same way until you top up or raise the key’s budget.

​
Cap what a key can spend

Every API key has a Spend budget (USD): the most it may spend in a calendar month (UTC). Set it when you create the key, and change it any time from API Keys. The budget still applies when auto-recharge is on, so a key can never spend past it. See Authentication.

​
Top up your balance

Open Balance in the console and click Top Up. Pick $20, $50 or $100, then pay by card through Stripe. The money is added as soon as the payment goes through, and the card is saved for auto-recharge.

​
Auto-recharge

Auto-recharge tops up your balance for you, so calls don’t start failing with 402 because it ran low.
  1. Open Balance and, next to auto-recharge, click Manage.
  2. Tick Automatically recharge when my balance runs low.
  3. Pick Recharge amount, the amount to add each time: $20, $50 or $100.
  4. Pick When balance drops below, the level that triggers it: $5, $10 or $20.
  5. Click Save.
Auto-recharge needs a saved card. A top-up saves the card it’s paid with, or click Save Card in the same window. How it behaves:
  • It checks right after each charged call, and once a day, so it also catches a balance that dropped for another reason, such as a refund.
  • It charges once at a time. Many calls finishing together never trigger more than one recharge.
  • If your card is declined, auto-recharge switches itself off so it doesn’t keep retrying. Update your card and turn it back on.

​
See what you’ve spent

The console’s Usage page shows your spend by key and by endpoint, day by day. Logs lists every paid call with the endpoint it called, what it sent, and what it cost. Free calls are not listed.