TAO/USD candles
https://api.bittensor.ai/api/v2/prices/tao/candles- Status
- Stable
- Auth
- API key or OAuth access token
- Scope
data:read- Rate limit
plan
OHLC of TAO/USD (the canonical price: the volume-weighted mean of several exchanges' 1-minute USD closes) with the TAO traded on those exchanges, oldest first, labelled by open_at.
Full description
OHLC of TAO/USD (the canonical price: the volume-weighted mean of several exchanges' 1-minute USD closes) with the TAO traded on those exchanges, oldest first, labelled by open_at. Intervals 1m, 5m, 15m, 30m, 1h, 4h, 1d and 1w, UTC-aligned from a Monday origin (a 1w bucket opens on a Monday). Each bar also carries its BTC twins (*_price_btc: the USD price / BTC/USD, derived, not a traded TAO/BTC market), with currency its fiat twins (*_price_fiat: the USD price x that currency's reference rate at the bar's close), and the TAO swapped through every subnet pool (onchain_volume_tao_rao, on-chain turnover beside the exchange volume_tao_rao). With from_time, the limit buckets from it; without, the latest limit buckets before to_time (or now, the forming bucket included). Not paged: move the window with from_time / to_time. A bucket without a stored price is a carried bar (is_carried; absent on an older data version's answer). A bucket is closed once meta.data_head has passed its end. Interval 1m serves closed minutes only (the TAO/USD minute is published about 15 seconds after it closes); longer intervals include the forming bucket (closed: false) computed from the minutes closed so far. The prices are exchange data: meta.at is the chain's latest block and meta.coverage the heights the buckets span. Errors are application/problem+json: INVALID_INTERVAL, INVALID_TIME, INVALID_RANGE, INVALID_WINDOW, INVALID_LIMIT, UNKNOWN_PARAMETER, SOURCE_TIMEOUT (503), SOURCE_NOT_READY (503). from_time and to_time must sit on a bucket boundary of interval (UTC from the Monday 2000-01-03 origin: whole hours for 1h, 00/04/../20 UTC for 4h, midnight for 1d, a Monday midnight for 1w); otherwise a 400 INVALID_WINDOW. One URL per window is what lets every viewer of a closed window share one cached answer. countback returns the N most recent bars before to_time in one call (up to 5,000). Finality and caching: a bar is final once it can no longer change (it ends at or before meta.final_through). A page whose every bar is final and whose window is fixed (an explicit to_time at or before meta.final_through) is served Cache-Control: public, max-age=31536000, immutable with an ETag; any other page keeps a short lifetime, as the forming bar changes every block. With currency, each bar's fx_source / fx_day_first / fx_day_last and meta.fx_days (each rate's day, value and publisher) name the reference rates used (null with meta.fx_unavailable_reason while not available). A bar without a price of its own is carried (is_carried, carried_reason): its open, high, low and close are the previous close and its volumes 0.
Query parameters
- intervalquery· enum · one of 1m, 5m, 15m, 30m, 1h, 4h, 1d, 1w · default 1h
Bucket width:
1m,5m,15m,30m,1h,4h,1dor1w(UTC, weeks start Monday).1mserves closed minutes only (the TAO/USD minute is published about 15 seconds after it closes); longer intervals include the forming bucket (closed: false) computed from the minutes closed so far.- from_timequery· string (date-time)
Start of the window, inclusive (RFC 3339).
- Format: date and time, ISO 8601 in UTC
- to_timequery· string (date-time)
End of the window, exclusive (RFC 3339). Default: now.
- Format: date and time, ISO 8601 in UTC
- limitquery· integer · default 100 · 1 to 1000
At most this many buckets, 1..1000.
- currencyquery· enum · one of AED, ARS, AUD, BGN, BRL, CAD, CHF, CNY, COP, CZK, DKK, EUR, GBP, HKD, HUF, IDR, ILS, INR, ISK, JPY, KES, KRW, MXN, MYR, NGN, NOK, NZD, PHP, PKR, PLN, RON, SEK, SGD, THB, TRY, TWD, UAH, VND, ZAR
Also price the OHLC in this currency (ISO 4217, upper case; the
*_price_fiatmembers andmeta.fiat_currency). Omitted: those are null. USD is always served (*_price_usd).- countbackquery· integer · 1 to 5000
Return the
countbackbars ending atto_time(default: now, the forming bar included), oldest first, up to 5000 (the TradingView datafeed'scountback). Use it instead oflimit: it cannot be combined withfrom_time,cursororlimit(400INVALID_PARAMETER). Fewer bars come back only when the series starts later (meta.interval_first_bucket_time). To read further back, ask again withto_time= the first bar'sopen_at;meta.page.next_cursoris null on acountbackanswer.- precisionquery· string
full: the same members with the USD, fiat and BTC prices andvolume_usdunrounded, as decimal strings. Accepted only from service integrations; for any other caller this parameter does not exist.
Response
data is a list of objects 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.
Buckets oldest first: from from_time forward, else the latest limit buckets before to_time (or now, the forming bucket included). Every bucket of the window is served: a bucket without a price of its own is a carried bar (is_carried, carried_reason); on an older data version's answer such a bucket is absent. [] when the window has none.
- open_atstring (date-time)
Start of the bucket, RFC 3339 UTC.
- Format: date and time, ISO 8601 in UTC
- open_price_usdstring · unit usd_per_tao · 6 decimals
TAO/USD open of the bucket (USD per TAO, a price), 6 decimals, from the canonical series (the volume-weighted mean of the exchanges' 1-minute closes): the previous bar's close (the page's first bar: the last stored close before it), at every interval (
meta.ohlc_method; an older data version's answer aggregated the minutes to the bucket on their own).- Format: decimal number, as a string
- high_price_usdstring · unit usd_per_tao · 6 decimals
TAO/USD high of the bucket (USD per TAO, a price), 6 decimals, from the canonical series (the volume-weighted mean of the exchanges' 1-minute closes): the highest composite minute close in the bar, at least max(open, close) (never the sources' spread) (
meta.ohlc_method; an older data version's answer aggregated the minutes to the bucket on their own).- Format: decimal number, as a string
- low_price_usdstring · unit usd_per_tao · 6 decimals
TAO/USD low of the bucket (USD per TAO, a price), 6 decimals, from the canonical series (the volume-weighted mean of the exchanges' 1-minute closes): the lowest composite minute close in the bar, at most min(open, close) (
meta.ohlc_method; an older data version's answer aggregated the minutes to the bucket on their own).- Format: decimal number, as a string
- close_price_usdstring · unit usd_per_tao · 6 decimals
TAO/USD close of the bucket (USD per TAO, a price), 6 decimals, from the canonical series (the volume-weighted mean of the exchanges' 1-minute closes): the bar's last composite minute close (
meta.ohlc_method; an older data version's answer aggregated the minutes to the bucket on their own). For a forming bucket, the latest price so far.- Format: decimal number, as a string
- volume_tao_raostring · unit rao (÷1e9) · can be null
TAO traded on the source exchanges in the bucket, in rao. Null when the sources report no volume for it.
- Format: whole number, as a string · on chain: u64
- closedboolean
True once the bucket has ended (its end is at or before
meta.data_head); false while it is still forming. Interval1mserves closed minutes only (the TAO/USD minute is published about 15 seconds after it closes); longer intervals include the forming bucket (closed: false) computed from the minutes closed so far.- open_price_btcstring · unit btc_per_tao · can be null
TAO/BTC open of the bucket (BTC per TAO, a price): the previous bar's BTC close; null when that bar has none (the BTC series' first bar, or after a gap) (
meta.btc_method; on an older data version's answer,open_price_usd/ BTC/USD at the bar's open). Derived from the two USD markets, not a traded TAO/BTC market. Null where no BTC/USD price covers that time.- Format: decimal number, as a string
- high_price_btcstring · unit btc_per_tao · can be null
TAO/BTC high of the bucket (BTC per TAO, a price):
high_price_usd/ BTC/USD at the bar's close, containing the BTC open and close (meta.btc_method; on an older data version's answer,high_price_usd/ BTC/USD at the bar's close). Derived from the two USD markets, not a traded TAO/BTC market. Null where no BTC/USD price covers that time.- Format: decimal number, as a string
- low_price_btcstring · unit btc_per_tao · can be null
TAO/BTC low of the bucket (BTC per TAO, a price):
low_price_usd/ BTC/USD at the bar's close, containing the BTC open and close (meta.btc_method; on an older data version's answer,low_price_usd/ BTC/USD at the bar's close). Derived from the two USD markets, not a traded TAO/BTC market. Null where no BTC/USD price covers that time.- Format: decimal number, as a string
- close_price_btcstring · unit btc_per_tao · can be null
TAO/BTC close of the bucket (BTC per TAO, a price):
close_price_usd/ BTC/USD at the bar's close (meta.btc_method; on an older data version's answer,close_price_usd/ BTC/USD at the bar's close). Derived from the two USD markets, not a traded TAO/BTC market. Null where no BTC/USD price covers that time.- Format: decimal number, as a string
- open_price_fiatstring · unit ccy_per_tao · can be null
openinmeta.fiat_currencyper TAO (a price): the previous bar's fiat close; null when that bar has none (the fiat series' first bar, or after a gap) (meta.fiat_method; on an older data version's answer,open_price_usdx the rate at the bar's close). Null without thecurrencyparameter, and when the rate is missing.- Format: decimal number, as a string
- high_price_fiatstring · unit ccy_per_tao · can be null
highinmeta.fiat_currencyper TAO (a price):high_price_usdx that currency's reference rate at the bar's close, containing the fiat open and close (meta.fiat_method; on an older data version's answer,high_price_usdx the rate at the bar's close). Null without thecurrencyparameter, and when the rate is missing.- Format: decimal number, as a string
- low_price_fiatstring · unit ccy_per_tao · can be null
lowinmeta.fiat_currencyper TAO (a price):low_price_usdx that currency's reference rate at the bar's close, containing the fiat open and close (meta.fiat_method; on an older data version's answer,low_price_usdx the rate at the bar's close). Null without thecurrencyparameter, and when the rate is missing.- Format: decimal number, as a string
- close_price_fiatstring · unit ccy_per_tao · can be null
closeinmeta.fiat_currencyper TAO (a price):close_price_usdx that currency's reference rate at the bar's close (meta.fiat_method; on an older data version's answer,close_price_usdx the rate at the bar's close). Null without thecurrencyparameter, and when the rate is missing.- Format: decimal number, as a string
- onchain_volume_tao_raostring · unit rao (÷1e9) · can be null
TAO swapped through every subnet pool in the bar (buys + sells), in rao: on-chain turnover, not exchange volume (
volume_tao_rao). Null beforemeta.onchain_volume_from.- Format: whole number, as a string · on chain: u64
- source_resolution_senum · unit seconds · can be null · beta
The resolution, in seconds, of the price points the bar was computed from:
60, the 1-minute series, from 2024-04-11 12:00 UTC;3600, one point an hour, before it. Before 2024-04-11 12:00 UTC the underlying series is hourly, so a 1m-30m bar there is a single hourly point: those intervals are SPARSE (one bar per hour, nothing filled between them), and an hour, day or week bar is computed from hourly points. Null on an older data version's answer.- One of:
60,3600 - is_carriedboolean · optional · beta
True when the bar has no price of its own: open, high, low and close are the close before it (the previous bar's; for a page's first bar, the last price before it) and the volumes are 0 (
carried_reasonsays why). The series is continuous, so a quiet bucket is a carried bar, never a gap. False on an older data version's answer, which leaves such a bucket out.- carried_reasonstring · can be null · beta
Why the bar is carried:
no_trades(no swap and no pool change in the bucket),no_source_data(no price was recorded for the bucket),coarser_source(a minute bar inside an hour whose prices are known only hourly: before 2024-04-11 12:00 UTC the TAO/USD series is hourly). Null exactly whenis_carriedis false. New values may be added; treat unknown values as unavailable.- finalboolean · optional · beta
True when the bar can no longer change: it ends at or before
meta.final_through(itsopen_atplus the interval). A final bar is safe to cache for good. False while the bar is forming or may still be corrected, and on every bar whilemeta.final_throughis null.- fx_sourcestring · can be null · beta
Who published the reference rate of the bar's last price point, the one that priced the fiat close (for example
ecb). Null withoutcurrency, on a bar without fiat prices, and whilemeta.fx_unavailable_reasonis set. New values may be added; show an unknown value as is (or generically).- fx_day_firststring (date) · can be null · beta
The earliest UTC rate day among the price points inside this bar (each point is priced at the latest reference rate published on or before its day). The fiat open is not one of them: it is the previous point's close at that point's rate, so its rate day is the previous bar's
fx_day_last(for the page's first bar, the rate in force before the page, listed inmeta.fx_days). Equal tofx_day_lastwhen every point inside the bar has the same rate day. Null withoutcurrency, on a bar without fiat prices, and whilemeta.fx_unavailable_reasonis set.- Format: date, YYYY-MM-DD
- fx_day_laststring (date) · can be null · beta
The latest UTC rate day among the price points inside this bar (each point is priced at the latest reference rate published on or before its day); the fiat close's rate day. Null without
currency, on a bar without fiat prices, and whilemeta.fx_unavailable_reasonis set.- Format: date, YYYY-MM-DD
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.
- AMBIGUOUS_CREDENTIALS
- BAD_GATEWAY
- BILLING_UNAVAILABLE
- BUDGET_EXCEEDED
- CONCURRENCY_LIMIT
- INSUFFICIENT_PERMISSIONS
- INTERNAL_ERROR
- INVALID_CURRENCY
- INVALID_INTERVAL
- INVALID_LIMIT
- INVALID_RANGE
- INVALID_TIME
- INVALID_WINDOW
- PAYMENT_REQUIRED
- RATE_LIMITED
- REPEATED_PARAMETER
- SERVICE_UNAVAILABLE
- SOURCE_BUSY
- SOURCE_NOT_READY
- SOURCE_TIMEOUT
- UNAUTHORIZED
- UNKNOWN_PARAMETER
- VALIDATION_ERROR
From the API's published specification, version 1.165.0.