Market API

The public API exposes the same provenance-first market records used by the terminal. API keys and higher-volume access remain waitlist-only until usage is proven.

Public endpoints

GET /api/v1/markets lists markets. GET /api/v1/markets/:slug returns one record. GET /api/v1/markets/:slug/history returns native-currency price observations. Public responses are cached for 15 seconds with a five-minute stale-if-error window.

Response contract

Money uses integer minor units and ISO currency. Nullable fields are intentionally unknown, not zero. Every observed metric includes sourceLabel, sourceUrl, observedAt and confidence.

Pagination and caching

Collection endpoints use opaque cursor pagination. Send If-None-Match with the prior ETag to receive 304 when a representation has not changed.

Authenticated operations

Watchlists, claims, source verification, entitlements and operator ingest require a signed-in user or scoped API key. Every write requires an idempotency key and records an audit actor.

API waitlist

Send your expected use case and request volume to api@bidterminal.lol. Paid product access does not purchase ranking influence or access to personal data.