Skip to content
TAO$189.43
BTC0.002936
MCap$2.22B
Vol$87.29M

API reference / Markets

TAO market snapshot: price, market cap, volume, supply

GET/api/v2/markets/tao
Status
Stable
Auth
API key or OAuth access token
Scope
data:read
Rate limit
plan

TAO/USD now.

Full description

TAO/USD now (the volume-weighted mean of several exchanges' 1-minute closes) with its changes over 1 h..1 y, 24 h high and low and the all-time high and low of the UTC daily close; market cap and fully diluted market cap; 24 h volume on exchanges and through the subnet pools; supply from chain state (issuance, stake, per-block and daily emission, scheduled inflation and the measured 24 h issuance change, TAO in subnet pools); subnet counts and the last lock cost; and a 30-day sparkline of daily closes. Always the latest data (no at): price.as_of is the price's minute, meta.at the chain block of the supply and network figures. include=params adds data.params: the network's chain parameters at the state head (delegate and childkey take limits, the nominator minimum stake, TaoWeight, the subnet owner cut, the registration rate limit and lock-cost floor, the subnet limit and the staking coldkey count), each raw value with a display ratio where it is a fraction; no extra metering. include=valuation adds data.valuation: TAO/USD's Mayer multiple and power-law fair value, computed by this API from the TAO/USD daily closes (one more data-source call, cached 300 s). include=halving adds data.halving: the halving schedule computed by this API from this answer's supply (halvings so far, the next threshold, what remains and an estimated date at the measured issuance growth; no extra call, +0). include=extremes adds data.extremes: TAO/USD's INTRADAY all-time high and low (candle highs and lows, with their UTC days, over the whole stored history), computed by this API from the TAO candles (cached 300 s). include=circulation adds data.circulation: the TAO recycled by registrations, the effective circulating supply (issuance - recycled - TAO in subnet pools) and its market cap, and the alpha market cap without burned alpha (TAO and USD), computed by this API from one subnet directory read (cached 300 s). Errors are application/problem+json: INVALID_INCLUDE, UNKNOWN_PARAMETER, NOT_READY (503, no TAO/USD price yet), SOURCE_TIMEOUT (503), SOURCE_NOT_READY (503).

Query parameters

includequery· string

A comma list (repeatable) of params (adds the network's chain parameters as data.params, read by the data source) and valuation (adds data.valuation, computed by this API: one more data-source call) and halving (adds data.halving, computed by this API from the answer's own supply: no extra call, +0), extremes (adds data.extremes, the intraday all-time high and low, computed by this API) and circulation (adds data.circulation, recycled TAO, the effective circulating supply and the alpha market cap, computed by this API). Anything else is a 400 INVALID_INCLUDE.

Response

data is an object with these fields. Amounts are integer strings in their base unit, and null means unknown, never zero (see Units and formats). meta.at names the block the answer was read at.

Price, market figures, supply and network.

priceobject

TAO/USD now, its changes, 24 h range and all-time daily-close extremes.

16 fields in price
price_usdstring · unit usd_per_tao · 6 decimals · can be null

TAO/USD at as_of (USD per 1 TAO: a price, not an amount), 6 decimals: the volume-weighted mean of the exchanges' 1-minute USD closes (meta.price_method). Null only if no price exists (the source answers 503 NOT_READY instead today).

Format: decimal number, as a string
as_ofstring (date-time)

The minute of price_usd, RFC 3339 UTC: the latest minute with a TAO/USD price. It can differ from meta.at.time (the chain block of the supply and network figures) by a few minutes.

Format: date and time, ISO 8601 in UTC
sourcesinteger · unit count

Number of exchanges whose 1-minute close made up price_usd.

change_1hstring · unit ratio · 6 decimals · can be null

TAO/USD change over 1 h: price_usd / the canonical price at exactly as_of - 1 h (that minute; the covering hour before 1-minute history) - 1, a signed ratio with 6 decimals (0.05 = +5 %). Null when the stored history does not reach that far back.

Format: decimal number, as a string · can be negative
change_24hstring · unit ratio · 6 decimals · can be null

TAO/USD change over 24 h: price_usd / the canonical price at exactly as_of - 24 h (that minute; the covering hour before 1-minute history) - 1, a signed ratio with 6 decimals (0.05 = +5 %). Null when the stored history does not reach that far back.

Format: decimal number, as a string · can be negative
change_7dstring · unit ratio · 6 decimals · can be null

TAO/USD change over 7 d: price_usd / the canonical price at exactly as_of - 7 d (that minute; the covering hour before 1-minute history) - 1, a signed ratio with 6 decimals (0.05 = +5 %). Null when the stored history does not reach that far back.

Format: decimal number, as a string · can be negative
change_30dstring · unit ratio · 6 decimals · can be null

TAO/USD change over 30 d: price_usd / the canonical price at exactly as_of - 30 d (that minute; the covering hour before 1-minute history) - 1, a signed ratio with 6 decimals (0.05 = +5 %). Null when the stored history does not reach that far back.

Format: decimal number, as a string · can be negative
change_1ystring · unit ratio · 6 decimals · can be null

TAO/USD change over 365 d: price_usd / the canonical price at exactly as_of - 365 d (that minute; the covering hour before 1-minute history) - 1, a signed ratio with 6 decimals (0.05 = +5 %). Null when the stored history does not reach that far back.

Format: decimal number, as a string · can be negative
high_24h_price_usdstring · unit usd_per_tao · 6 decimals · can be null

Highest 1-minute TAO/USD price in the 24 h before as_of (a price, USD per TAO), 6 decimals. Null without prices in the window.

Format: decimal number, as a string
low_24h_price_usdstring · unit usd_per_tao · 6 decimals · can be null

Lowest 1-minute TAO/USD price in the 24 h before as_of (a price, USD per TAO), 6 decimals. Null without prices in the window.

Format: decimal number, as a string
ath_daily_close_price_usdstring · unit usd_per_tao · 6 decimals · can be null

All-time high of the UTC daily close (a price, USD per TAO) over the stored history (from meta.history_from_day), 6 decimals. Daily closes, so a single-exchange print (Binance's listing minute) does not set it: it is not the highest minute ever traded. Null without daily history.

Format: decimal number, as a string
ath_daystring (date) · can be null

The UTC day of ath_daily_close_price_usd; null with it.

Format: date, YYYY-MM-DD
atl_daily_close_price_usdstring · unit usd_per_tao · 6 decimals · can be null

All-time low of the UTC daily close (a price, USD per TAO) over the stored history, 6 decimals. Null without daily history.

Format: decimal number, as a string
atl_daystring (date) · can be null

The UTC day of atl_daily_close_price_usd; null with it.

Format: date, YYYY-MM-DD
price_btcstring · unit btc_per_tao · 10 decimals · can be null

TAO/BTC at the same minute as price_usd (as_of): BTC per 1 TAO, a price, 10 decimals. Derived, not a traded TAO/BTC market: price_usd / BTC/USD, with BTC/USD the volume-weighted close of Coinbase BTC-USD and Kraken XBT/USD at that minute (btc_source). No direct TAO/BTC market is deep enough to price on, so a quoted TAO/BTC pair would be noisier than the two deep USD markets. Null (with btc_source) until that minute's BTC/USD candles are fetched.

Format: decimal number, as a string
btc_sourceobject · can be null

How price_btc was made (always derived, an opaque identifier) and the BTC/USD price it used. Null with price_btc.

3 fields in btc_source
methodstring

Always derived: price_btc = price_usd / btc_usd. No direct TAO/BTC market is deep enough to price on, so the TAO/BTC figure is computed from the two USD prices at the same minute (as_of), not read from a TAO/BTC order book. New values may be added; show an unknown value as is (or generically).

btc_usdstring · unit usd_per_btc

BTC/USD at as_of (USD per 1 BTC, a price): the volume-weighted close of the btc_usd_sources 1-minute candles (Coinbase BTC-USD and Kraken XBT/USD).

Format: decimal number, as a string
btc_usd_sourcesarray of string

The exchanges whose BTC/USD 1-minute candles made btc_usd (coinbase, kraken). Clients must accept sources not documented yet.

marketobject

Market capitalisation and 24 h exchange and on-chain volumes.

9 fields in market
market_cap_usdstring · unit usd · 2 decimals · can be null

TotalIssuance x price.price_usd, in USD (2 decimals). Null when TotalIssuance is not readable.

Format: decimal number, as a string
fully_diluted_market_cap_usdstring · unit usd · 2 decimals · can be null

21,000,000 TAO x price.price_usd, in USD (2 decimals).

Format: decimal number, as a string
volume_24h_cex_tao_raostring · unit rao (÷1e9) · can be null

TAO traded on the exchanges in meta.cex_sources (TAO-USD and TAO-USDT 1-minute candles) over the 24 h before price.as_of, in rao. Null without candles.

Format: whole number, as a string · on chain: u64
volume_24h_cex_usdstring · unit usd · 2 decimals · can be null

volume_24h_cex_tao_rao x price.price_usd, in USD (2 decimals). Null with it.

Format: decimal number, as a string
volume_24h_onchain_tao_raostring · unit rao (÷1e9) · can be null

TAO through every subnet pool (buys + sells, each swap step once) in the hourly buckets of the 24 h before meta.at, in rao. Null without pool candles.

Format: whole number, as a string · on chain: u64
volume_24h_onchain_usdstring · unit usd · 2 decimals · can be null

volume_24h_onchain_tao_rao in USD at price.price_usd (2 decimals). Null with it.

Format: decimal number, as a string
pool_swaps_24hinteger · unit count · can be null

Swap steps through subnet pools in the same 24 h (a move or swap between subnets is 2 steps); not a count of stake events. Null without pool candles.

market_cap_reference_usdobject · can be null

CoinGecko's market capitalisation of TAO, in USD: a third-party definition (CoinGecko), not verified by us; the chain-truth market_cap_usd and the exchange volume (volume_24h_cex_*, from the exchanges in meta.cex_sources) stay the primary figures. Null when CoinGecko's figure is older than 2 hours (or missing). market_cap_usd stays the primary figure.

3 fields in market_cap_reference_usd
valuestring · unit usd

The figure, in USD (decimal string), as the provider states it.

Format: decimal number, as a string
sourcestring

The provider: coingecko (its own definition, not ours). New values may be added; show an unknown value as is (or generically).

as_ofstring (date-time)

The provider's last update of the figure (CoinGecko's last_updated_at), RFC 3339 UTC.

Format: date and time, ISO 8601 in UTC
volume_24h_reference_usdobject · can be null

CoinGecko's 24 h trading volume of TAO, in USD: a third-party definition (CoinGecko), not verified by us; the chain-truth market_cap_usd and the exchange volume (volume_24h_cex_*, from the exchanges in meta.cex_sources) stay the primary figures. Null when CoinGecko's figure is older than 2 hours (or missing). volume_24h_cex_usd (the exchanges in meta.cex_sources) stays the primary figure.

3 fields in volume_24h_reference_usd
valuestring · unit usd

The figure, in USD (decimal string), as the provider states it.

Format: decimal number, as a string
sourcestring

The provider: coingecko (its own definition, not ours). New values may be added; show an unknown value as is (or generically).

as_ofstring (date-time)

The provider's last update of the figure (CoinGecko's last_updated_at), RFC 3339 UTC.

Format: date and time, ISO 8601 in UTC
supplyobject

Issuance, stake, emission and pooled TAO from chain state.

9 fields in supply
issuance_tao_raostring · unit rao (÷1e9) · can be null

SubtensorModule.TotalIssuance at meta.at, in rao. Null when not readable.

Format: whole number, as a string · on chain: u64
max_supply_tao_raostring · unit rao (÷1e9) · can be null

The 21,000,000 TAO cap, in rao (a constant).

Format: whole number, as a string · on chain: u64
staked_tao_raostring · unit rao (÷1e9) · can be null

SubtensorModule.TotalStake at meta.at, in rao. Null when not readable.

Format: whole number, as a string · on chain: u64
staking_ratiostring · unit ratio · 6 decimals · can be null

staked_tao_rao / issuance_tao_rao, a ratio with 6 decimals. Null when either is null.

Format: decimal number, as a string
block_emission_tao_raostring · unit rao (÷1e9) · can be null

TAO emitted per block by the runtime's halving rule, 1 TAO / 2^floor(log2(21M / (21M - issuance))), in rao. Null when issuance_tao_rao is null.

Format: whole number, as a string · on chain: u64
daily_emission_tao_raostring · unit rao (÷1e9) · can be null

block_emission_tao_rao x 7,200 blocks, in rao. Null with it.

Format: whole number, as a string · on chain: u64
annual_inflation_ratestring · unit ratio · 6 decimals · can be null

daily_emission_tao_rao x 365 / issuance_tao_rao: the scheduled rate, a ratio with 6 decimals. Null when either is null. issuance_change_24h_tao_rao is the measured change.

Format: decimal number, as a string
issuance_change_24h_tao_raostring · unit rao (÷1e9) · can be null

Measured: TotalIssuance at meta.at minus TotalIssuance at the last block 24 h earlier, signed, in rao (emission net of recycling and burns). Null when either value is not readable.

Format: whole number, as a string · can be negative
locked_in_subnet_pools_tao_raostring · unit rao (÷1e9) · can be null

TAO reserves of every subnet pool (SubnetTAO, root excluded) at their latest state, in rao.

Format: whole number, as a string · on chain: u64
networkobject

Subnet counts and the last registration lock cost.

3 fields in network
subnetsinteger · unit count

Live subnets (NetworksAdded = true), root excluded.

subnets_including_rootinteger · unit count

Live subnets, root (netuid 0) included.

last_lock_cost_tao_raostring · unit rao (÷1e9) · can be null

SubtensorModule.NetworkLastLockCost: TAO locked by the last subnet registration, in rao. Null when not readable.

Format: whole number, as a string · on chain: u64
sparkline_30d_price_usdarray of string · unit usd_per_tao

TAO/USD UTC daily closes (USD per TAO, prices) of the last 30 days, oldest first; the last is the current day's close so far. [] without daily history.

Format: decimal number, as a string
paramsvalue · optional

Only with include=params (absent otherwise): the network's chain parameters (take limits, the nominator minimum, TaoWeight, the owner cut, the registration rate limit and lock floor, the subnet limit and the staking coldkey count) at the state head.

valuationobject · can be null

Only with include=valuation (absent otherwise): TAO/USD's Mayer multiple and power-law fair value (from TAO's genesis), computed by this API from the TAO/USD UTC daily closes (one more data-source call, cached 300 s).

5 fields in valuation
price_usdstring · unit usd_per_tao · 6 decimals · can be null

The latest daily bucket's close (the current UTC day so far), USD per TAO, 6 decimals. Null without history.

Format: decimal number, as a string
price_daystring (date) · can be null

The UTC day of price_usd's bucket. Null without history.

Format: date, YYYY-MM-DD
history_daysinteger · unit days

Closed UTC daily closes the indicators were computed on (at most 1,000).

mayerobject

The Mayer multiple.

4 fields in mayer
ma_200d_price_usdstring · unit usd_per_tao · 6 decimals · can be null

The simple mean of the last 200 closed UTC daily closes, USD per TAO, 6 decimals. Null with unavailable_reason.

Format: decimal number, as a string
mayer_multiple_ratiostring · unit ratio · 6 decimals · can be null

price_usd / ma_200d_price_usd, 6 decimals (1 = at the 200-day mean). Null with unavailable_reason.

Format: decimal number, as a string
interpretationenum · can be null

The multiple's band: below_trend under 1, at_trend from 1 to under 2.4, overheated from 2.4 (Trace Mayer's bands). Null with unavailable_reason.

One of: below_trend, at_trend, overheated
unavailable_reasonstring · can be null

Null when the figures are given; else insufficient_history (fewer than 200 closed days, in this subnet generation for a subnet) or no_history (no daily close at all). Known values: insufficient_history, no_history, degenerate_fit. New values may be added; treat unknown values as unavailable.

power_lawobject

The power-law fair value.

8 fields in power_law
anchor_daystring (date) · can be null

Day 0 of the fit (UTC): TAO's mainnet genesis (2023-03-20) for TAO; for a subnet, the day before its current generation started (life_start_time's UTC day minus one, so the life's first day is day 1), tied to the life and not to the candle window; a re-registered slot is never fitted across two lives. Null without history.

Format: date, YYYY-MM-DD
days_since_anchorinteger · unit days · can be null

Days from anchor_day to price_day, the fit's x at which fair_value_price_usd is read.

coefficient_a_price_usdstring · unit usd_per_tao · 6 decimals · can be null

The fit's a: the fitted price at day 1, USD per TAO, 6 decimals. Null with unavailable_reason.

Format: decimal number, as a string
exponent_b_coefficientstring · unit coefficient · 6 decimals · can be null

The fit's exponent b (dimensionless, signed), 6 decimals. Null with unavailable_reason.

Format: decimal number, as a string · can be negative
fair_value_price_usdstring · unit usd_per_tao · 6 decimals · can be null

a x days_since_anchor^b: the fitted price at price_day, USD per TAO, 6 decimals. Null with unavailable_reason.

Format: decimal number, as a string
price_vs_fair_value_ratiostring · unit ratio · 6 decimals · can be null

price_usd / fair_value_price_usd - 1, a signed ratio, 6 decimals (-0.2 = 20 % under the fitted value). Null with unavailable_reason.

Format: decimal number, as a string · can be negative
r_squared_ratiostring · unit ratio · 6 decimals · can be null

The fit's R² on the log-log points (0..1, 6 decimals). Fit quality within this series only: not comparable across subnets, whose histories start at different days. Null with unavailable_reason.

Format: decimal number, as a string
unavailable_reasonstring · can be null

Null when the fit is given; else insufficient_history (fewer than 30 closed days after the anchor), no_history or degenerate_fit (no spread in days, or a fit that overflows). New values may be added; treat unknown values as unavailable.

halvingobject · can be null

Only with include=halving (absent otherwise): TAO's halving schedule, computed by this API from this answer's supply (no extra data-source call): halvings so far, the next threshold and what remains, and an estimated date at the measured issuance growth.

10 fields in halving
halvings_completedinteger · unit count · can be null

Halvings so far: floor(log2(21M / (21M - issuance))). Null with unavailable_reason.

block_emission_tao_raostring · unit rao (÷1e9) · can be null

TAO emitted per block now by the rule, in rao; equal to supply.block_emission_tao_rao (a disagreement nulls every figure, emission_rule_mismatch).

Format: whole number, as a string · on chain: u64
next_block_emission_tao_raostring · unit rao (÷1e9) · can be null

TAO emitted per block after the next halving, in rao (half of block_emission_tao_rao).

Format: whole number, as a string · on chain: u64
current_period_start_issuance_tao_raostring · unit rao (÷1e9) · can be null

The issuance at which the current emission period began (the last halving threshold), in rao.

Format: whole number, as a string · on chain: u64
next_halving_issuance_tao_raostring · unit rao (÷1e9) · can be null

The issuance at which emission next halves, 21M x (1 - 2^-(halvings_completed + 1)), in rao.

Format: whole number, as a string · on chain: u64
remaining_to_next_halving_tao_raostring · unit rao (÷1e9) · can be null

next_halving_issuance_tao_rao - supply.issuance_tao_rao, in rao.

Format: whole number, as a string · on chain: u64
blocks_to_next_halving_at_block_emissioninteger · unit blocks · can be null

Blocks until the next halving if every block minted block_emission_tao_rao and nothing were recycled (ceil(remaining / block emission)): an upper-bound-style schedule figure, not a forecast.

days_to_next_halving_at_measured_ratestring · unit days · 2 decimals · can be null

remaining / supply.issuance_change_24h_tao_rao (the measured net issuance growth, recycling included), in days, 2 decimals. Null when the 24 h change is unknown or not above 0 (no_issuance_growth).

Format: decimal number, as a string
estimated_next_halving_daystring (date) · can be null

meta.at.time + days_to_next_halving_at_measured_rate, as a UTC day. An estimate; null with it.

Format: date, YYYY-MM-DD
unavailable_reasonstring · can be null

Why figures are null: no_issuance (issuance unreadable; all null), supply_cap (issuance at the cap; all null), emission_rule_mismatch (the served block emission disagrees with the rule; all null) or no_issuance_growth (only the two date figures null). Null when every figure is served. New values may be added; treat unknown values as unavailable.

extremesobject · can be null · beta

Only with include=extremes (absent otherwise): TAO/USD's INTRADAY all-time high and low (the candles' high / low), beside price's daily-close extremes; computed by this API from the TAO candles (cached 300 s).

6 fields in extremes
ath_price_usdstring · unit usd_per_tao · 6 decimals · can be null

The highest TAO/USD price of any candle (its high_price_usd), USD per TAO, 6 decimals: an intraday high, where price.ath_daily_close_price_usd is a daily close. The open candle counts. Null when no candle is stored.

Format: decimal number, as a string
ath_daystring (date) · can be null

The UTC day of that high (the first on a tie). Null with ath_price_usd.

Format: date, YYYY-MM-DD
atl_price_usdstring · unit usd_per_tao · 6 decimals · can be null

The lowest TAO/USD price of any candle (its low_price_usd), 6 decimals: an intraday low. Null when no candle is stored.

Format: decimal number, as a string
atl_daystring (date) · can be null

The UTC day of that low (the first on a tie). Null with atl_price_usd.

Format: date, YYYY-MM-DD
history_from_daystring (date) · can be null

The first day of the weekly candle the history starts in (the extremes cover every stored day since). Null when no candle is stored.

Format: date, YYYY-MM-DD
basisstring

intraday: candle highs and lows, never closes (the closes are on price). New values may be added; show an unknown value as is (or generically).

circulationobject · can be null · beta

Only with include=circulation (absent otherwise): the registration TAO recycled, the effective circulating supply and the alpha market cap, computed by this API from one subnet directory read (cached 300 s).

9 fields in circulation
as_of_heightinteger · unit block · can be null

The block the subnet directory was read at (the head, possibly a few blocks off meta.at).

subnets_countedinteger · unit count

Live subnets summed (root excluded).

recycled_tao_raostring · unit rao (÷1e9) · can be null

The live subnets' RAORecycledForRegistration summed, in rao: TAO recycled by registrations and still counted by a live slot (a dissolved subnet's counter is gone with it). Null when any live subnet's counter is unknown (never a partial sum).

Format: whole number, as a string · on chain: u64
effective_circulating_tao_raostring · unit rao (÷1e9) · can be null

supply.issuance_tao_rao - recycled_tao_rao - supply.locked_in_subnet_pools_tao_rao, in rao (signed; not clamped): TAO in circulation outside the pools and the recycled counters. Null when any part is.

Format: whole number, as a string · can be negative
market_cap_effective_usdstring · unit usd · 6 decimals · can be null

effective_circulating_tao_rao at price.price_usd, 6 decimals. Null when either is.

Format: decimal number, as a string · can be negative
alpha_market_cap_tao_raostring · unit rao (÷1e9) · can be null

Every subnet's alpha market cap without the burned alpha, summed, root excluded (the directory's meta.totals.market_cap_ex_burned_tao_rao), in rao of TAO: the known part when alpha_market_cap_is_lower_bound.

Format: whole number, as a string · on chain: u64
alpha_market_cap_is_lower_boundboolean · can be null

True when a subnet's cap is unknown, so alpha_market_cap_tao_rao leaves it out (a lower bound).

alpha_market_cap_usdstring · unit usd · 6 decimals · can be null

alpha_market_cap_tao_rao at price.price_usd, 6 decimals. Null when either is.

Format: decimal number, as a string
alpha_market_cap_basisstring

ex_burned: alpha outside the pools without the burned alpha.

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), slow public, max-age=300, stale-while-revalidate=600 (state that moves in minutes or days) or tip public, 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). Never immutable. no-store on 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-revalidate and stale-if-error; no-store with X-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, with X-BTAI-Stale-As-Of, Age (its seconds since then) and Warning: 110 - "Response is Stale", and Cache-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.