Skip to content
Sign in
Menu

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.

Worked examples at a 2% rate and a 0.003 USDC floor.
Your pricePlatform feeAgent price
0.009 USDC (minimum)0.003 USDC0.012 USDC
0.010 USDC0.003 USDC0.013 USDC
0.150 USDC0.003 USDC0.153 USDC
1.000 USDC0.020 USDC1.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:

JSON
{ "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:

  1. If the payout ratio doesn't change, the new price applies at once.
  2. 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_progress with Retry-After: 30.
  3. NODRA updates the vault's ratio on-chain. This pays out the vault's balance at the old ratio first.
  4. The new price takes effect.