Skip to content
Sign in
Menu

Reference overview

NODRA's public interfaces, base URLs, conventions, errors and rate limits.

On this page

Public interfaces

InterfaceBaseAuthReference
Gateway: paid calls to launched APIs{gateway origin}/v1/{slug}x402 payment per callGateway
Directory API: search and read listings{API origin}/v1/directoryNoneDirectory
Pricing API: minimum price and fee rules{API origin}/v1/pricingNonePricing

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" }. Parse amount as a big integer.
  • Times are ISO 8601 in UTC.
  • Lists use cursors: pass next_cursor back as cursor with the same filters and sort. null means the last page.
  • Request ids: every directory and pricing response has an x-request-id header. Quote it when you report a problem.

Errors

The directory and pricing APIs return errors as:

JSONIllustrative values
{
  "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.

StatuscodeWhen
404not_foundUnknown path, or an API that isn't live and listed. Also returned with 405 for methods other than GET.
422validation_failedA query parameter is invalid. See details.
429rate_limitedToo many requests from your address. Honour Retry-After.
500internalUnexpected error.

Rate limits

Limits are set by the deployment; there are no X-RateLimit headers. Back off using Retry-After.
WhatLimited perOn excess
Directory and pricing requestsClient address, per minute429 rate_limited with Retry-After
Gateway quotes (any response that issues a quote)Client address, per minute429 {"error":"rate_limited"} with Retry-After
Paid gateway requestsNot 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.