Public API

Docs

Read-only REST API for Nuanze market analytics. No API key required.

Base URL

All endpoints are served under:

/api/v1

Authentication

None. Public v1 endpoints are open read-only. CORS allows browser clients from any origin for GET requests. Responses are plain JSON (not SuperJSON).

Rate limits

Default limit is 60 requests per minute per client IP. Exceeding the limit returns HTTP 429 with a Retry-After header.

Examples

List markets

curl "/api/v1/markets"

Wallet summary

curl "/api/v1/wallets/0x0000000000000000000000000000000000000001"

JavaScript

const res = await fetch("/api/v1/markets");
const markets = await res.json();
console.log(markets);

Errors

Errors use a consistent shape:

{ "error": { "code": "NOT_FOUND", "message": "..." } }
  • 400 — invalid query or path parameters
  • 404 — unknown route or missing resource
  • 429 — rate limit exceeded
  • 500 — unexpected server error