> ## Documentation Index
> Fetch the complete documentation index at: https://data-docs.orbbit.co/llms.txt
> Use this file to discover all available pages before exploring further.

# Pricing & Billing

> What each call costs, how your balance works, and how to top it up automatically.

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](https://data-docs.orbbit.co/for-agents/x402.md). 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.

| Data | Name | Endpoint | Price per call |
| - | - | - | - |
| [Commodities](https://data-docs.orbbit.co/market-data/commodities.md) | List Commodities | `GET /v1/commodities` | Free |
| [Commodities](https://data-docs.orbbit.co/market-data/commodities.md) | Get Commodity Metric Values | `GET /v1/commodities/metric-values` | \$0.01 |
| [Branded Food](https://data-docs.orbbit.co/industry-data/cpg/branded-food.md) | List Branded Food Categories | `GET /v1/branded-foods/categories` | Free |
| [Branded Food](https://data-docs.orbbit.co/industry-data/cpg/branded-food.md) | Search Branded Foods | `GET /v1/branded-foods` | \$0.01 |
| [Branded Food](https://data-docs.orbbit.co/industry-data/cpg/branded-food.md) | Get a Branded Food | `GET /v1/branded-foods/{id}` | \$0.01 |

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](https://data-docs.orbbit.co/for-agents/data-mcp.md) 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`.

```json theme={null}
{
  "error": {
    "type": "insufficient_balance",
    "message": "Insufficient balance"
  }
}
```

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](https://data-docs.orbbit.co/authentication.md).

## 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.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.