Reference overview
NODRA's public interfaces, base URLs, conventions, errors and rate limits.
On this page
Public interfaces
The dashboard API is not public
Provider features (sign-in, registering and launching APIs, earnings, payments and payouts) use NODRA's dashboard API. It accepts only the NODRA web app as a browser origin, and needs a session cookie and a CSRF token for every change, so it isn't documented here as a public API. Use the dashboard for these tasks.
Conventions
- JSON responses, UTF-8.
- Money is always
{ "amount": "<integer base units>", "decimals": 6, "currency": "USDC" }. Parseamountas a big integer. - Times are ISO 8601 in UTC.
- Lists use cursors: pass
next_cursorback ascursorwith the same filters and sort.nullmeans the last page. - Request ids: every directory and pricing response has an
x-request-idheader. Quote it when you report a problem.
Errors
The directory and pricing APIs return errors as:
{
"code": "validation_failed",
"message": "The request is not valid.",
"retryable": false,
"request_id": "req_Hq3kP0x9LmZt",
"details": [{ "field": "sort", "issue": "Must be newest, price or popular." }]
}Branch on code, never on message. details appears only on validation_failed. The gateway uses a different, smaller shape; see Error handling.
| Status | code | When |
|---|---|---|
| 404 | not_found | Unknown path, or an API that isn't live and listed. Also returned with 405 for methods other than GET. |
| 422 | validation_failed | A query parameter is invalid. See details. |
| 429 | rate_limited | Too many requests from your address. Honour Retry-After. |
| 500 | internal | Unexpected error. |
Rate limits
| What | Limited per | On excess |
|---|---|---|
| Directory and pricing requests | Client address, per minute | 429 rate_limited with Retry-After |
| Gateway quotes (any response that issues a quote) | Client address, per minute | 429 {"error":"rate_limited"} with Retry-After |
| Paid gateway requests | Not rate limited | — |
CORS and caching
Directory and pricing responses allow any origin (Access-Control-Allow-Origin: *), set no cookies, and may be cached for 30 seconds (Cache-Control: public, max-age=30). Gateway responses are Cache-Control: no-store.