Data API

Single subscription tier (api_all_access) unlocks every published dataset. Authenticate with Authorization: Bearer sk_live_….

Plan & limits

Price: $99/month
Rate limit: 120/minute · 100,000/day
Scope: all published catalog data + realtime snapshots

Subscribe →

Authentication

Authorization: Bearer sk_live_…

Create keys at /developers after subscribing. 401 = bad key, 402 = no active plan, 429 = rate limited.

GET /api/v1/data/me

Current plan & limits for this key.

curl http://127.0.0.1:3000/api/v1/data/me -H "Authorization: Bearer $KEY"

GET /api/v1/data/catalog

List all published datasets. Query: sector, limit, offset.

curl "http://127.0.0.1:3000/api/v1/data/catalog?sector=finance&limit=20" \
  -H "Authorization: Bearer $KEY"

GET /api/v1/data/search

Faceted product search. Query: q, sector, sort, page.

curl "http://127.0.0.1:3000/api/v1/data/search?q=earthquake" \
  -H "Authorization: Bearer $KEY"

GET /api/v1/data/datasets/:slug

Dataset metadata & version info.

curl http://127.0.0.1:3000/api/v1/data/datasets/fred-macro-series \
  -H "Authorization: Bearer $KEY"

GET /api/v1/data/datasets/:slug/records

Page through raw records (JSONL-backed). Query: limit (max 1000), cursor (line offset). Response includes next URL when more pages exist.

curl "http://127.0.0.1:3000/api/v1/data/datasets/fred-macro-series/records?limit=100" \
  -H "Authorization: Bearer $KEY"

GET /api/v1/data/realtime/:feed

Latest realtime snapshot (e.g. binance-bookTicker, usgs-all-hour).

curl http://127.0.0.1:3000/api/v1/data/realtime/binance-bookTicker \
  -H "Authorization: Bearer $KEY"

Rate limit headers

X-RateLimit-Limit-Minute
X-RateLimit-Remaining-Minute
X-RateLimit-Limit-Day
X-RateLimit-Remaining-Day
Retry-After   # on 429

Subscribe with USDC on Solana

Pay the monthly plan in USDC (SPL) on Solana via web (/pricing) or CLI. On confirmation you get a full-access API key.

# CLI
pnpm cli config
pnpm cli pay create --email you@example.com
# open Solana Pay URL in Phantom, then:
pnpm cli pay verify <referenceCode>
# local/dev without USDC:
pnpm cli pay simulate <referenceCode>

# HTTP
curl -X POST http://127.0.0.1:3000/api/v1/subscribe/solana \
  -H "Content-Type: application/json" -d '{"email":"you@example.com"}'
curl -X POST http://127.0.0.1:3000/api/v1/subscribe/solana/verify \
  -H "Content-Type: application/json" \
  -d '{"referenceCode":"ss_…","issueApiKey":true}'
# optional: "txSignature":"…" or "simulate":true (devnet only)

Env: SOLANA_NETWORK (devnet|mainnet-beta), SOLANA_TREASURY_WALLET, SOLANA_RPC_URL, API_PLAN_PRICE_USDC (default 99). On success you receive a one-time sk_live_… key.