OpenAPI 3.1.0 · v1.0.0

API

requeststoken.org public API

Read-only JSON used by requeststoken.org: token market data relayed from DexScreener, Requests download figures, and the download observatory. Figures are informational, may be delayed or unavailable, and are not financial advice or a promise of any return. No authentication; please cache responses and poll gently. JSON endpoints negotiate on the Accept header: JSON by default, YAML when YAML is preferred (application/yaml, application/x-yaml or text/yaml); responses carry Vary: Accept. Errors are application/problem+json. Operational routes: /health (readiness, 200 or 503) and /metrics (Prometheus text).

Machine-readable schema: /openapi.json

01 — Endpoints

Read-only JSON

`GET /api/token`

Token market data · Token

Price, market cap, liquidity, 24h volume and trade counts for the token pair, relayed from DexScreener. Cached for 15 seconds.

Response fields (37)

available boolean — False when market data could not be fetched; display fields then hold a dash.
stale boolean — True when a previously fetched value is being reused.
source string
source_label string
name string
symbol string
contract string
price_native_symbol string
change_direction string
price_display string
price_native_display string
market_cap_display string
change_display string
liquidity_display string
volume_display string
buys_display string
sells_display string
activity_display string
status_display string
chain string | null
chain_display string | null
dex string | null
dex_display string | null
price_usd string | null
price_native string | null
pair_url string | null
pair_address string | null
listed_on string | null
detail string | null
fetched_at string | null
fetched_at_display string | null
market_cap_usd number | null
change_h24_pct number | null
liquidity_usd number | null
volume_h24_usd number | null
buys_h24 integer | null
sells_h24 integer | null

`GET /api/requests`

Requests download figures · Downloads

Headline download figures and a recent daily series for the Requests package. Cached for 5 minutes.

Response fields (12)

available boolean
stale boolean
package string
source string
source_label string
source_url string
total_downloads integer | null
figures array
series array
series_caption string
detail string | null
fetched_at string | null

`GET /api/observatory`

Download observatory snapshot · Downloads

The full daily download history behind /observatory, with its freshness status. Not cached.

Response fields (6)

snapshot object — Retained daily download snapshot for the Requests package (UTC dates).
checkedAt string
status string — current, cached, fallback
serverTime string
refreshing boolean
message string | null

02 — Content negotiation

JSON or YAML

The JSON endpoints above, /openapi.json and /health choose a format from the Accept header and send Vary: Accept.

application/json, */*, no header — JSON
application/yaml, application/x-yaml, text/yaml — YAML (application/yaml)
q-values — the higher-quality format wins; q=0 excludes a format
Anything else (text/html, image/png…) — JSON with 200, not 406
Errors — application/problem+json regardless of Accept (e.g. 404, 405)
/metrics — always Prometheus text

curl https://requeststoken.org/api/token
curl -H 'Accept: application/yaml' https://requeststoken.org/api/token
curl -H 'Accept: application/yaml;q=0.9, application/json;q=0.5' https://requeststoken.org/health
curl -H 'Accept: application/yaml' https://requeststoken.org/openapi.json

03 — Operational

Health and metrics

GET /health — readiness: {"status": "ok", "checks": {...}}; 503 when a check fails.

GET /metrics — Prometheus text: request counts, in-flight requests and latency per route.