CoinGecko DEX feed: one asset (a subnet's alpha, or TAO)
https://api.bittensor.ai/api/v2/integrations/coingecko/asset- Status
- Beta
- Auth
- API key or OAuth access token
- Scope
data:read- Rate limit
plan
{asset: {id, name, symbol, decimals, totalSupply, circulatingSupply, maxSupply}} for a subnet's alpha (id = its netuid) or TAO (id=0), at the head: total supply SubnetAlphaIn + SubnetAlphaOut - AlphaBurned, circulating SubnetAlphaOut - AlphaBurned, whole tokens (TAO: TotalIssuance for both). Cached 5 minutes. Errors are application/problem+json: INVALID_ID, SUBNET_NOT_FOUND (404: no subnet in that slot), SERVICE_UNAVAILABLE (503: a supply term is not readable; never a guessed supply), UNKNOWN_PARAMETER, SOURCE_TIMEOUT (503), SOURCE_NOT_READY (503). External format: the 200 is CoinGecko's DEX integration's own wire format, not this API's {data, meta} envelope (member names, casing and number encoding are CoinGecko's DEX integration's); authentication, rate limits, metering and problem+json errors are this API's.
Beta: this route may change with one release's notice in the v2 changelog; additive changes need none (x-stability: beta).
Query parameters
- idquery, required· string
The asset: a subnet's netuid (
19), or0for TAO. ASCII digits; anything else: 400INVALID_ID.- Format:
^[0-9]{1,5}$
Response headers
10 headers: ETag, Cache-Control, CDN-Cache-Control, X-BTAI-Stale, X-BTAI-Stale-As-Of, RateLimit-Policy, RateLimit, X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset
- ETag
Strong validator of this answer. Send it back as
If-None-Match: an unchanged answer is a 304 Not Modified without a body. A settled answer's validator leaves the chain head out, so it stays valid as the head moves.- Cache-Control
One of three classes: settled
public, max-age=3600, stale-while-revalidate=86400(pinned to a block that cannot move), slowpublic, max-age=300, stale-while-revalidate=600(state that moves in minutes or days) or tippublic, max-age=6, stale-while-revalidate=12(follows the chain head); the label routes are cached until the next nightly copy (public, max-age=<seconds>, stale-while-revalidate=60). Neverimmutable.no-storeon an earlier answer served because the data source failed (X-BTAI-Stale).- CDN-Cache-Control
The same class for shared caches (RFC 9213; browsers ignore it): settled 24 h, slow 300 s, tip 6 s, each with
stale-while-revalidateandstale-if-error;no-storewithX-BTAI-Stale.- X-BTAI-Stale
Present only when the data source failed to answer (it timed out or was unavailable) and an earlier answer to the same request is served instead of a 503 (stale if error, RFC 5861). Then
if-error, withX-BTAI-Stale-As-Of,Age(its seconds since then) andWarning: 110 - "Response is Stale", andCache-Control: no-store: the answer is never kept as fresh, and a later request reads again. Prices and quotes are never served this way.- X-BTAI-Stale-As-Of
With
X-BTAI-Stale: when the earlier answer served was produced, an RFC 3339 UTC time (2026-10-21T12:00:00Z).- RateLimit-Policy
The tier's request quota of the current window (IETF draft), e.g.
"tier";q=600.- RateLimit
Requests left in the current window and the seconds until it resets (IETF draft), e.g.
"tier";r=597;t=42.- X-RateLimit-Limit
The tier's request quota of the current window.
- X-RateLimit-Remaining
Requests left in the current window.
- X-RateLimit-Reset
When the current window resets, Unix seconds.
Status codes
200 · 304 · 400 · 401 · 402 · 403 · 404 · 429 · 500 · 502 · 503
304 Not Modified: the If-None-Match validator still matches; no body.
Error codes
The codes this endpoint can return. Each links to what it means and what to do.
From the API's published specification, version 1.165.0.