Core concepts
The vocabulary used throughout NODRA: providers, consumers, gateways, quotes, x402, USDC, verification and settlement.
On this page
Participants
- API provider
- Someone who owns an HTTP API and sells calls to it through NODRA. Providers sign in with a Solana wallet, which is also where their earnings are paid out.
- API consumer
- Any client that calls a NODRA gateway URL and pays per call: a developer's code, an application, or an autonomous agent. Consumers don't sign in to NODRA.
- Autonomous agent
- Software, often an AI agent, that decides to call a paid API on its own. It pays from its own wallet, inside spending limits its developer sets.
The platform
- API directory
- The public list of APIs that are live and listed, at /apis. It shows each API's description, gateway URL, price per call, billing rule and 30-day usage.
- Gateway
- The NODRA server that agents call. It answers with quotes, checks payments, forwards requests to the provider and returns the provider's answer.
- Gateway URL
- Each live API's address on the gateway:
{gateway origin}/v1/{slug}. Callers append the provider's own path and query, for example/v1/weather-forecasts/forecast?city=Lisbon. - Upstream
- The provider's own API, at the upstream URL they registered. Only the gateway calls it, adding the provider's upstream key if one is stored.
- Vault
- A per-API Solana account created when an API launches. Payments for that API go into its vault, and NODRA pays the provider's share out from it.
Payments
- Paid API request
- A request to a gateway URL that carries a payment for a quote. One payment buys one call.
- HTTP 402
- The
402 Payment Requiredstatus. The gateway answers it to any call that has no payment, with a quote in thePAYMENT-REQUIREDheader. - x402
- An open protocol that uses HTTP 402 and three headers (
PAYMENT-REQUIRED,PAYMENT-SIGNATURE,PAYMENT-RESPONSE) to pay for HTTP requests. NODRA implements version 2 with theexactscheme on Solana. - Quote
- One price offer for one call: amount, asset, network, recipient and a quote id. Quotes expire after 60 seconds and can be paid once.
- Solana
- The blockchain the payments settle on. Transfers confirm in about a second, and NODRA pays the network fee.
- USDC
- A dollar-denominated stablecoin. Amounts are integers in base units with 6 decimals:
13000is 0.013 USDC. - Payment authorization
- The caller's signed USDC transfer for the quote, sent in the
PAYMENT-SIGNATUREheader. It's signed by the payer but not yet submitted; NODRA adds the fee payer's signature only when it settles. - Payment verification
- NODRA's checks that the authorization pays exactly what the quote asked, to the right vault, on the right network, and would succeed on-chain.
- Settlement
- Submitting the verified transfer to Solana and waiting for confirmation. A payment counts as earned only once it's settled.
- Billing rule
- What counts as a billable answer for an API, for example "a successful (2xx) answer with a body". Answers that don't meet it aren't charged.