Skip to content
Sign in
Menu

Pricing API

The minimum provider price and the platform fee rules. Public, no authentication.

  • Public
  • GET only
On this page

Get pricing rules

GET/v1/pricingNone

The rules NODRA uses to turn a provider's price into the price agents pay. Takes no parameters.

ShellIllustrative values
curl 'https://api.example.com/v1/pricing'
JSON200 OK
{
  "currency": "USDC",
  "decimals": 6,
  "min_provider_price": { "amount": "9000", "decimals": 6, "currency": "USDC" },
  "fee": {
    "rate_bps": 200,
    "floor": { "amount": "3000", "decimals": 6, "currency": "USDC" }
  },
  "max_fee_share_bps": 2500,
  "example_at_minimum": {
    "provider_price": { "amount": "9000", "decimals": 6, "currency": "USDC" },
    "platform_fee": { "amount": "3000", "decimals": 6, "currency": "USDC" },
    "agent_price": { "amount": "12000", "decimals": 6, "currency": "USDC" }
  }
}

Fields

FieldDescription
min_provider_priceThe lowest price a provider can set.
fee.rate_bpsThe fee rate in basis points of the provider price (200 = 2%), rounded up to a whole base unit.
fee.floorThe minimum fee. The fee is the greater of the rate and the floor.
max_fee_share_bpsThe most of a payment the fee may be, in basis points (2500 = 25%). It's why there's a minimum price.
example_at_minimumA worked example at the minimum price.

Agent price = provider price + max(ceil(provider price × rate_bps / 10,000), floor).