Skip to content
TAO$188.12
BTC0.002928
MCap$2.21B
Vol$86.07M

API reference / Markets

TAO/USD candles

GET/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, 1d or 1w (UTC, weeks start Monday). 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.

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_fiat members and meta.fiat_currency). Omitted: those are null. USD is always served (*_price_usd).

countbackquery· integer · 1 to 5000

Return the countback bars ending at to_time (default: now, the forming bar included), oldest first, up to 5000 (the TradingView datafeed's countback). Use it instead of limit: it cannot be combined with from_time, cursor or limit (400 INVALID_PARAMETER). Fewer bars come back only when the series starts later (meta.interval_first_bucket_time). To read further back, ask again with to_time = the first bar's open_at; meta.page.next_cursor is null on a countback answer.

precisionquery· string

full: the same members with the USD, fiat and BTC prices and volume_usd unrounded, 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. 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.

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

open in meta.fiat_currency per 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_usd x the rate at the bar's close). Null without the currency parameter, and when the rate is missing.

Format: decimal number, as a string
high_price_fiatstring · unit ccy_per_tao · can be null

high in meta.fiat_currency per TAO (a price): high_price_usd x 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_usd x the rate at the bar's close). Null without the currency parameter, and when the rate is missing.

Format: decimal number, as a string
low_price_fiatstring · unit ccy_per_tao · can be null

low in meta.fiat_currency per TAO (a price): low_price_usd x 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_usd x the rate at the bar's close). Null without the currency parameter, and when the rate is missing.

Format: decimal number, as a string
close_price_fiatstring · unit ccy_per_tao · can be null

close in meta.fiat_currency per TAO (a price): close_price_usd x that currency's reference rate at the bar's close (meta.fiat_method; on an older data version's answer, close_price_usd x the rate at the bar's close). Null without the currency parameter, 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 before meta.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_reason says 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 when is_carried is 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 (its open_at plus 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 while meta.final_through is 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 without currency, on a bar without fiat prices, and while meta.fx_unavailable_reason is 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 in meta.fx_days). Equal to fx_day_last when every point inside the bar has the same rate day. Null without currency, on a bar without fiat prices, and while meta.fx_unavailable_reason is 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 while meta.fx_unavailable_reason is 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), 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.