Configure pricing
How per-call pricing works: your price, the platform fee, the agent price, minimums and price changes.
On this page
The pricing model
Each API has one price per call, in USDC. It applies to every path and method under the API's gateway URL. There are no subscriptions, tiers or per-endpoint prices.
- Your price
- What you receive per billable call. You set it.
- Platform fee
- NODRA's fee per call, added on top of your price.
- Agent price
- Your price plus the fee. This is the amount in the 402 quote and on the directory page.
How the fee is calculated
The fee is the greater of 2% of your price (rounded up to the next base unit) and a floor of 0.003 USDC. The minimum price is 0.009 USDC. These values come from the public pricing endpoint, `GET /v1/pricing`, which the registration form reads, so they're always current there.
| Your price | Platform fee | Agent price |
|---|---|---|
| 0.009 USDC (minimum) | 0.003 USDC | 0.012 USDC |
| 0.010 USDC | 0.003 USDC | 0.013 USDC |
| 0.150 USDC | 0.003 USDC | 0.153 USDC |
| 1.000 USDC | 0.020 USDC | 1.020 USDC |
How amounts are represented
In the form you enter a decimal, such as 0.013, with up to 6 decimal places. Over the wire, every amount is an integer string in USDC base units (6 decimals), never a floating-point number:
{ "amount": "13000", "decimals": 6, "currency": "USDC" }13000 base units is 0.013 USDC.
How the payout is split
The agent pays the full agent price into your API's vault. When the vault pays out, the balance is split at a ratio fixed when the vault was created (or when the price last changed): the platform's share is rounded down, so any rounding favours you. For the 0.010 USDC example, a payout of one call sends 0.010001 USDC to you and 0.002999 USDC to the platform.
How pricing affects consumers
Callers see the agent price in the directory and in every quote, before they pay. Agents usually run with a per-call spending limit, and a quote above it is refused without paying, so an API priced above what agents expect simply won't be called.
Changing the price
On a draft, a new price applies immediately. On a live or paused API, the new price is shown as pending and applied between payments, usually within minutes:
- If the payout ratio doesn't change, the new price applies at once.
- Otherwise NODRA stops issuing new quotes for about a minute while open quotes and payments finish. During that time callers get
503 price_change_in_progresswithRetry-After: 30. - NODRA updates the vault's ratio on-chain. This pays out the vault's balance at the old ratio first.
- The new price takes effect.