Skip to content
Sign in
Menu

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 Required status. The gateway answers it to any call that has no payment, with a quote in the PAYMENT-REQUIRED header.
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 the exact scheme 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: 13000 is 0.013 USDC.
Payment authorization
The caller's signed USDC transfer for the quote, sent in the PAYMENT-SIGNATURE header. 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.