Skip to content
Sign in
Menu

Quick start

See NODRA from both sides in a few minutes: find an API and inspect its quote, or register your own.

On this page

1. Browse the directory

Open the API directory. No account is needed. Search by name or capability, filter by category, and open an API to see its gateway URL, price per call and billing rule.

2. Ask an API for a quote

Calling a gateway URL without a payment is free. The gateway answers 402 Payment Required and puts the quote in the PAYMENT-REQUIRED header as base64-encoded JSON. Copy an API's gateway URL from its directory page and try it:

ShellRequest a quoteIllustrative values
curl -i 'https://gateway.example.com/v1/weather-forecasts/forecast?city=Lisbon'

# Decode the quote (macOS: base64 -D)
curl -s -o /dev/null -D - 'https://gateway.example.com/v1/weather-forecasts/forecast?city=Lisbon' \
  | grep -i '^payment-required:' | cut -d' ' -f2 | tr -d '\r' | base64 -d | jq

The decoded quote tells you exactly what one call costs and where to pay. Understand an HTTP 402 response walks through every field.

3. Pay for a call

To complete the call you sign a USDC transfer for the quote and send the same request again with a PAYMENT-SIGNATURE header. You need a Solana wallet whose USDC token account holds at least the quoted amount. You don't need SOL.

Follow Make your first paid API request for the full walkthrough.

Or: publish your own API

  1. Sign in with a Solana wallet

    Go to Sign in. The wallet you use is also where you're paid. See Create an account.

  2. Register the API

    From the dashboard, choose Register API and fill in the details. See Register an API.

  3. Run a test call, then launch

    A passing test unlocks Launch API. A minute or so later the API is live at https://gateway.example.com/v1/<your-slug>. See Test your API and Launch your API.