Data API
Crypto market data and the site’s own indicators over HTTPS, as JSON: on Dev, the liquidation heatmap (the full grid, the levels standing now and the largest clusters); candles, open interest, funding rates, CME gaps, the visual screener, seven screeners and daily market-cycle indicators. Every coin the site follows, with one request. The API comes with every paid plan: MAX, Pro and Dev.
https://www.tradingdigits.io/api/v1Quick start
https://www.tradingdigits.io exactly, with www. The address without www redirects to it, and HTTP clients drop the key when a redirect changes the host, so the request would arrive without one (401).Send your key in the Authorization header. The examples read it from an environment variable, TD_API_KEY: a request for the RSI screener, a Python helper that waits on Retry-After and pages through hourly candles, and a visual-screener filter in JavaScript.
Call /api/v1/me first to check a new key: it answers with your plan, its limits and this month’s use.
curl "https://www.tradingdigits.io/api/v1/screeners/rsi?timeframe=4h" \
-H "Authorization: Bearer $TD_API_KEY"{
"data": [
{
"symbol": "BTCUSDT",
"candle_closed_at": "2026-11-09T12:00:00.000Z",
"price": 74372.01,
"rsi": 32.4,
"rsi_change_percent": 29.54818073,
"direction": "up"
},
{
"symbol": "ETHUSDT",
"candle_closed_at": "2026-11-09T12:00:00.000Z",
"price": 2113.3,
"rsi": 28.22,
"rsi_change_percent": 23.9350022,
"direction": "up"
}
],
"meta": {
"as_of": "2026-11-09T12:00:00.000Z",
"stale": false,
"timeframe": "4h",
"period": 14,
"left_out": [],
"count": 529
}
}Authentication
Every request needs an API key, as Authorization: Bearer <key> or in an X-API-Key header.
- Keys are made on your account page while you have a paid plan.
- Never put a key in a URL: such a request is refused (
400 key_in_url), since URLs end up in logs. Revoke a key that has been in one. - A revoked key, or a plan that has ended, stops working within a minute.
Plans and limits
| MAX | Pro | Dev | |
|---|---|---|---|
| Requests a minute | 1 | 60 | 120 |
| Requests a month | 150 | 100,000 | 300,000 |
| Screener timeframes | 4h and 1d | Every timeframe | Every timeframe |
| Candles | Daily | Daily and hourly | Daily and hourly |
| History | The last 365 days | All of it | All of it |
| Liquidation heatmap | — | — | Included |
| Commercial use | — | — | Yes |
| MCP server for AI apps | — | — | Yes |
| Every other endpoint | Included | Included | Included |
- Limits count per account, not per key: more keys add no capacity.
- Every paid plan has all of the site’s MAX features as well. Only Dev allows the data to be used in something you sell; see the Data API Terms.
- A minute is a clock minute; a month is a calendar month, starting over on the 1st at 00:00 UTC.
- Every request that passes the key check counts, including those answered with 400, 404 or 503 (a liquidation heatmap request answered with 503 excepted). Requests refused with 401, 403 or 429 do not.
Rate-limit headers
- X-RateLimit-Limit
- Requests allowed this minute.
- X-RateLimit-Remaining
- Requests left this minute.
- X-RateLimit-Reset
- When the minute ends (Unix seconds).
- X-Quota-Limit, X-Quota-Remaining
- Requests allowed and left this month.
- X-Quota-Reset
- When the month ends (Unix seconds).
- Retry-After
- On a 429 or 503: seconds to wait before trying again.
Compare the plans and their prices on the Data API page.
Requests and answers
- Every endpoint is
GETand answers JSON:{ "data": ..., "meta": { ... } }(/api/v1/meexcepted). metadescribes the answer; each endpoint below lists its own. Most haveas_of, when the data is from (a candle’s close, an open-interest hour, a funding update), andstale,truewhen newer data should have arrived by now and has not (the answer is still the newest there is). Lists havecount, the number of items.- Times go out as ISO 8601 in UTC (
2026-11-09T12:00:00.000Z). They come in as ISO 8601 (2026-11-01, or2026-11-01T12:00:00Z; without a zone, UTC) or as Unix time in milliseconds. A number that looks like seconds is refused. - Time ranges include
startand stop beforeend. A request returns 100 items, or up to 1,000 withlimit; a full page hasmeta.next_start, thestartof the next page (nullon the last one). - Symbols are trading pairs as the exchange names them, such as
BTCUSDTor1000PEPEUSDT, in any case./api/v1/symbolslists them. - Prices are in the pair’s quote currency (USDT). Changes are in percent (
1.5= 1.5%); funding rates are fractions (0.0001= 0.01%).nullmeans no value: not enough history, or no data. - New fields may be added to answers: read fields by name and ignore the ones you do not use.
Errors
An error answers with an HTTP status and a body of error (a code to check) and message (what went wrong, in English).
| Status | error | Meaning |
|---|---|---|
| 400 | invalid_parameter | A parameter is missing, given twice, or not one of its values. The message names it. |
| 400 | key_in_url | The key was sent in the URL. Send it in a header, and revoke that key: URLs end up in logs. |
| 401 | missing_api_key | No key in the Authorization or X-API-Key header. |
| 401 | invalid_api_key | The key is not valid, or it has been revoked. |
| 403 | no_active_plan | The key’s account has no active plan (MAX, Pro or Dev). |
| 403 | not_in_plan | The plan does not include it: the liquidation heatmap (Dev), or on MAX a timeframe other than 4h and 1d, hourly candles, or history older than 365 days. The message says what the plan includes. |
| 404 | not_found | No data for that symbol. The message says why. |
| 405 | method_not_allowed | The API answers GET only. |
| 429 | rate_limited | Over the plan’s requests a minute. Wait Retry-After seconds. |
| 429 | monthly_quota_exceeded | This month’s requests are used up. The quota starts over on the 1st, 00:00 UTC. |
| 500 | internal_error | Something went wrong on our side. Try again later. |
| 503 | unavailable | Briefly unavailable. Try again after Retry-After seconds. |
{
"error": "invalid_parameter",
"message": "timeframe must be one of: 1m, 5m, 15m, 1h, 4h, 12h, 1d, 3d, 1w, 1M."
}HTTP/1.1 400 Bad Request
content-type: application/jsonWhen data updates
All times UTC. meta.stale turns true as shown.
| Data | Updated | Stale when |
|---|---|---|
| Candles, daily | 00:05 UTC | The newest close is more than 25 hours old |
| Candles, hourly | Every hour at about :10 | The newest close is more than 2 hours old |
| Open interest and its history | Every hour at about :07 | The newest hour is more than 2 hours old |
| Funding rates | Every 2 minutes | The newest update is more than 10 minutes old |
| Funding rate history | Every hour at about :01 | The newest hour is more than 2 hours old |
| Long/short ratios and their history | Every 10 minutes; each pair’s new hour within the hour | The newest hour is more than 2 hours old (OKX: 3 hours, since its hours are stored once they have ended) |
| Coinbase premium | Every 10 minutes | The newest close is more than 2 hours old |
| CME gaps | Open gaps checked every 15 minutes | No stale flag: see meta.last_change |
| Visual screener | Every hour, about 10–15 minutes past | The hour described is more than 2 hours old |
| Market performance | Live (prices read at most a minute apart) | The prices are more than 5 minutes old |
| Screeners | About a minute after each candle close | The next close is more than 10 minutes overdue |
| Daily indicators, latest | From 00:15 UTC, usually complete by 00:45 | The next day’s values are more than an hour late |
| Daily indicators, history | 00:05 UTC | The newest day is more than 25 hours old |
| Puell Multiple | About 01:15 UTC, for the day before | The newest day ended more than 26 hours ago |
| Bitcoin network | About 01:15 UTC, for the day before | The newest day ended more than 27 hours ago |
| Liquidation heatmap | Every minute | The heatmap is more than 2 minutes old |
Account and coverage
Your plan and usage
Your plan, its limits, what it includes and this month’s use. Call it to check a new key. It counts as a request.
Response
- plan, plan_name
max,proordev, and its name (MAX,Pro,Dev).- limits
requests_per_minuteandrequests_per_month.- includes
screener_timeframesandcandle_intervals(the values the plan accepts),history_days(null: the full history),liquidation_heatmap,commercial_useandmcp_server(trueorfalse).- month.requests_used
- Requests counted this month, this one included.
nullif the counters are briefly unavailable. - month.resets_at
- When the monthly quota starts over: the 1st of next month, 00:00 UTC.
- This is the one answer without the
{data, meta}wrapper.
Updated: Live.
curl "https://www.tradingdigits.io/api/v1/me" \
-H "Authorization: Bearer $TD_API_KEY"{
"plan": "pro",
"plan_name": "Pro",
"limits": {
"requests_per_minute": 60,
"requests_per_month": 100000
},
"includes": {
"screener_timeframes": [
"1m",
"5m",
"15m",
"1h",
"4h",
"12h",
"1d",
"3d",
"1w",
"1M"
],
"candle_intervals": [
"1d",
"1h"
],
"history_days": null,
"liquidation_heatmap": false,
"commercial_use": false,
"mcp_server": false
},
"month": {
"requests_used": 1234,
"resets_at": "2026-12-01T00:00:00.000Z"
}
}Symbols
What the API covers: the spot coins it follows and the Binance USDT-M perpetuals.
Response: data
- spot[]
- The coins with prices: candles, screeners, daily indicators and market performance.
symbol,base,exchange(binanceormexc, where the prices come from;binance_futuresfor a coin none of these exchanges lists for spot, priced from its Binance USDT-M perpetual) andstablecoin. - perpetuals[]
- The Binance USDT-M perpetuals: open interest, the visual screener and the liquidation heatmap.
symbolandbaseas Binance names it (such as1000PEPE), andstablecoin. - stablecoin
truefor a stablecoin. The lists leave stablecoins out unlessinclude_stablecoins=true; every endpoint answers for one asked for bysymbol.
Response: meta
- spot_count
- How many spot coins (about 460 in November 2026).
- perpetual_count
- How many perpetuals (about 520).
- Funding rates have a list of their own: every crypto pair any of the five exchanges reports (see
/api/v1/funding). - Crypto only: no tokenized stocks, and no stock, ETF, index, commodity or FX perpetuals.
- Coins that were delisted may still have candle history.
Updated: As exchanges list and delist coins.
curl "https://www.tradingdigits.io/api/v1/symbols" \
-H "Authorization: Bearer $TD_API_KEY"{
"data": {
"spot": [
{
"symbol": "BTCUSDT",
"base": "BTC",
"exchange": "binance"
},
{
"symbol": "ETHUSDT",
"base": "ETH",
"exchange": "binance"
}
],
"perpetuals": [
{
"symbol": "BTCUSDT",
"base": "BTC"
},
{
"symbol": "ETHUSDT",
"base": "ETH"
}
]
},
"meta": {
"spot_count": 529,
"perpetual_count": 522
}
}Market data
Candles
One coin’s closed spot candles, oldest first: daily or hourly.
Query parameters
symbolrequiredThe trading pair, such as BTCUSDT.
intervaloptionaldefault 1dDaily or hourly candles. MAX: 1d only.
startoptionaldefault 365 days (1d) or 7 days (1h) before endThe first candle open to include: ISO 8601 or Unix milliseconds.
endoptionaldefault nowThe candle open to stop before (not included).
limitoptionaldefault 100Candles in this page. A full page comes with meta.next_start.
Response: data
- time
- The candle’s open (UTC).
- open, high, low, close
- Prices in the pair’s quote currency (USDT).
- volume
1honly: volume in USDT.nullbefore late October 2026.- volume_base
1honly: volume in the coin.nullbefore late October 2026.
Response: meta
- as_of
- The newest stored candle’s close.
- Daily candles have no volume. Bitcoin’s daily history goes back to 2010.
- Only closed candles: the candle that is still forming is never included.
- On MAX: daily candles of the last 365 days, from 00:00 UTC that day (
meta.history_from). An earlierstart, or anendbefore then, is refused with403 not_in_plan. Pro and Dev include the full history.
Updated: 1d daily at about 00:05 UTC; 1h every hour at about :10.
curl "https://www.tradingdigits.io/api/v1/candles?symbol=BTCUSDT&interval=1h&limit=2" \
-H "Authorization: Bearer $TD_API_KEY"{
"data": [
{
"time": "2026-11-02T15:00:00.000Z",
"open": 77869.12,
"high": 78112.01,
"low": 77298.28,
"close": 77519.24,
"volume": 75701081.90627,
"volume_base": 973.37066
},
{
"time": "2026-11-02T16:00:00.000Z",
"open": 77519.25,
"high": 77685.74,
"low": 77283.08,
"close": 77501.73,
"volume": 43516158.8998311,
"volume_base": 561.65933
}
],
"meta": {
"symbol": "BTCUSDT",
"interval": "1h",
"as_of": "2026-11-09T14:00:00.000Z",
"stale": false,
"count": 2,
"next_start": "2026-11-02T16:00:00.001Z"
}
}Open interest
Every Binance USDT-M perpetual’s open interest at the newest recorded hour, and how it and the price changed over 1h, 4h, 24h, 7d and 30d.
Query parameters
symboloptionalOne coin only, such as BTCUSDT. Leave it out for every coin.
include_stablecoinsoptionaldefault falseStablecoins are left out of the list, as the site’s tools hide them by default; true keeps them. A coin asked for by symbol is answered either way.
Response: data
- symbol, base
- The perpetual, and its base asset as Binance names it (such as
1000PEPE). - price
- The contract price at that hour (
oi_usd/oi_base). - oi_usd
- Open interest in USD.
- oi_base
- Open interest in contracts (units of the base asset).
- change_percent
oi_usd,oi_baseandprice, each over1h,4h,24h,7dand30d, in percent.nullwithout a record that far back.
Response: meta
- as_of
- The recorded hour.
Updated: Every hour, recorded at about :07.
curl "https://www.tradingdigits.io/api/v1/open-interest" \
-H "Authorization: Bearer $TD_API_KEY"{
"data": [
{
"symbol": "BTCUSDT",
"base": "BTC",
"price": 74694.3,
"oi_usd": 7222988183,
"oi_base": 96700.661,
"change_percent": {
"oi_usd": {
"1h": -0.03,
"4h": 0.51,
"24h": -0.93,
"7d": -3.64,
"30d": -5.77
},
"oi_base": {
"1h": 0.25,
"4h": -0.08,
"24h": 0.67,
"7d": 0.51,
"30d": 4.44
},
"price": {
"1h": -0.27,
"4h": 0.59,
"24h": -1.59,
"7d": -4.13,
"30d": -9.78
}
}
}
],
"meta": {
"as_of": "2026-11-09T14:00:00.000Z",
"stale": false,
"count": 522
}
}Open interest history
One perpetual’s open interest every hour, oldest first.
Query parameters
symbolrequiredThe trading pair, such as BTCUSDT.
startoptionaldefault end − 7 daysThe first time to include: ISO 8601 or Unix milliseconds.
endoptionaldefault nowThe time to stop before (not included).
limitoptionaldefault 100Items in this page. A full page comes with meta.next_start.
Response: data
- time
- The hour.
- oi_usd, oi_base
- Open interest in USD and in contracts.
- price
- The contract price (
oi_usd/oi_base).
Response: meta
- as_of
- The newest recorded hour (of any perpetual).
- On MAX: the hours of the last 365 days, from 00:00 UTC that day (
meta.history_from). An earlierstart, or anendbefore then, is refused with403 not_in_plan. Pro and Dev include the full history.
Updated: Every hour, recorded at about :07.
curl "https://www.tradingdigits.io/api/v1/open-interest/history?symbol=BTCUSDT&limit=2" \
-H "Authorization: Bearer $TD_API_KEY"{
"data": [
{
"time": "2026-11-02T15:00:00.000Z",
"oi_usd": 7542886505.4006,
"oi_base": 96921.498,
"price": 77824.7
},
{
"time": "2026-11-02T16:00:00.000Z",
"oi_usd": 7541497455.14645,
"oi_base": 97325.962,
"price": 77487.007
}
],
"meta": {
"symbol": "BTCUSDT",
"as_of": "2026-11-09T14:00:00.000Z",
"stale": false,
"count": 2,
"next_start": "2026-11-02T16:00:00.001Z"
}
}Funding rates
Each crypto perpetual’s current funding rate on Binance, OKX, Bybit, Bitget and Gate.io.
Query parameters
symboloptionalOne coin only, such as BTCUSDT. Leave it out for every coin.
include_stablecoinsoptionaldefault falseStablecoins are left out of the list, as the site’s tools hide them by default; true keeps them. A coin asked for by symbol is answered either way.
Response: data
- symbol
- The pair.
- rates
binance,okx,bybit,bitget,gateio: the rate as a fraction per funding interval (0.0001= 0.01%).nullwhere the exchange does not list the pair.- updated_at
- When the pair’s rates were last updated.
Response: meta
- as_of
- The newest update.
- Rates are per each exchange’s own funding interval, not annualised.
- Crypto only: each exchange’s stock, ETF, index, commodity, metal, FX and pre-IPO contracts are left out, by its own classification. Where a ticker is a coin on one exchange and a stock on another, only the coin’s rates are given.
- Pairs not updated for a day are left out.
Updated: Every 2 minutes.
curl "https://www.tradingdigits.io/api/v1/funding" \
-H "Authorization: Bearer $TD_API_KEY"{
"data": [
{
"symbol": "BTCUSDT",
"rates": {
"binance": 0.0001,
"okx": 0.000057259778991,
"bybit": 0.00008104,
"bitget": 0.000079,
"gateio": 0.000072
},
"updated_at": "2026-11-09T14:56:09.514Z"
},
{
"symbol": "ETHUSDT",
"rates": {
"binance": 0.00000675,
"okx": 0.0000417714981742,
"bybit": 0.00002332,
"bitget": 0.000022,
"gateio": 0.00001
},
"updated_at": "2026-11-09T14:56:09.514Z"
}
],
"meta": {
"as_of": "2026-11-09T14:56:09.514Z",
"stale": false,
"count": 1566
}
}Funding rate history
One pair’s funding rate on the five exchanges every hour, oldest first: what /api/v1/funding showed at the hour.
Query parameters
symbolrequiredThe trading pair, such as BTCUSDT.
startoptionaldefault end − 7 daysThe first time to include: ISO 8601 or Unix milliseconds.
endoptionaldefault nowThe time to stop before (not included).
limitoptionaldefault 100Items in this page. A full page comes with meta.next_start.
Response: data
- time
- The hour.
- rates
binance,okx,bybit,bitget,gateio: each exchange’s current rate at that hour, as a fraction per its funding interval.nullwhere the exchange did not list the pair.
Response: meta
- as_of
- The newest recorded hour (of any pair).
- The exchanges keep the rates they settled, not the current rate they showed in between: this is that rate, hour by hour.
- An hour when the rates were not being updated is left out rather than repeated.
- On MAX: the hours of the last 365 days, from 00:00 UTC that day (
meta.history_from). An earlierstart, or anendbefore then, is refused with403 not_in_plan. Pro and Dev include the full history.
Updated: Every hour, recorded at about :01.
curl "https://www.tradingdigits.io/api/v1/funding/history?symbol=BTCUSDT&limit=2" \
-H "Authorization: Bearer $TD_API_KEY"{
"data": [
{
"time": "2026-11-15T22:00:00.000Z",
"rates": {
"binance": 0.00000174,
"okx": 0.000005924883,
"bybit": 0.00006574,
"bitget": -0.000005,
"gateio": 0.000031
}
},
{
"time": "2026-11-15T23:00:00.000Z",
"rates": {
"binance": -0.00001113,
"okx": -0.000006294185,
"bybit": 0.00005423,
"bitget": 0.000005,
"gateio": 0.000022
}
}
],
"meta": {
"symbol": "BTCUSDT",
"as_of": "2026-11-16T03:00:00.000Z",
"stale": false,
"count": 2,
"next_start": "2026-11-15T23:00:00.001Z"
}
}Long/short ratios
Every crypto USDT perpetual’s newest long/short readings on Binance, Bybit or OKX: accounts long and short, Binance’s top traders, and taker buy and sell volume.
Query parameters
exchangeoptionaldefault binanceThe exchange whose readings to give.
symboloptionalOne coin only, such as BTCUSDT. Leave it out for every coin.
include_stablecoinsoptionaldefault falseStablecoins are left out of the list, as the site’s tools hide them by default; true keeps them. A coin asked for by symbol is answered either way.
Response: data
- symbol
- The perpetual, as Binance names it (OKX’s
BTC-USDT-SWAPisBTCUSDT). - time
- The hour of the pair’s newest reading.
- account_long, account_ratio
- All accounts with a position: the share long (0–1) and longs / shorts.
- top_account_long, top_account_ratio
- Binance only: its top traders (the top 20% by margin balance), counted by accounts.
- top_position_long, top_position_ratio
- Binance only: its top traders, weighted by position size.
- taker_hour
- The hour (its start) the taker volume is of.
nullon Bybit. - taker_buy, taker_sell
- Binance and OKX: the volume takers bought and sold in the hour, in the coin.
- taker_ratio
taker_buy/taker_sell.
Response: meta
- as_of
- The newest hour with readings (of any pair).
- taker_hour
- The newest closed hour of taker volume.
nullon Bybit.
- Each exchange’s own readings, one an hour, at the times the exchange gives them: a field is
nullwhere the exchange does not publish it, or that reading was not recorded. - Binance’s and Bybit’s ratio at an hour is their reading at that hour. OKX stamps its reading with the start of the hour and takes it at the end: OKX’s 22:00 is its reading at 23:00, so its newest hour is the one before.
- The pairs are read in turn through the hour, so for a while some pairs’
timeis the hour beforeas_of. A pair with no reading in the 3 hours beforeas_ofis left out.
Updated: Every 10 minutes; each pair’s new hour arrives within the hour.
curl "https://www.tradingdigits.io/api/v1/long-short" \
-H "Authorization: Bearer $TD_API_KEY"{
"data": [
{
"symbol": "BTCUSDT",
"time": "2026-11-16T03:00:00.000Z",
"account_long": 0.7446,
"account_ratio": 2.9154,
"top_account_long": 0.7729,
"top_account_ratio": 3.4033,
"top_position_long": 0.6348,
"top_position_ratio": 1.7386,
"taker_hour": "2026-11-16T02:00:00.000Z",
"taker_buy": 4276.031,
"taker_sell": 3856.576,
"taker_ratio": 1.10876
},
{
"symbol": "ETHUSDT",
"time": "2026-11-16T03:00:00.000Z",
"account_long": 0.7222,
"account_ratio": 2.5997,
"top_account_long": 0.7842,
"top_account_ratio": 3.6339,
"top_position_long": 0.6024,
"top_position_ratio": 1.5152,
"taker_hour": "2026-11-16T02:00:00.000Z",
"taker_buy": 97247.75,
"taker_sell": 97720.83,
"taker_ratio": 0.995159
}
],
"meta": {
"exchange": "binance",
"as_of": "2026-11-16T03:00:00.000Z",
"stale": false,
"taker_hour": "2026-11-16T02:00:00.000Z",
"count": 522
}
}Long/short history
One perpetual’s long/short readings on Binance, Bybit or OKX every hour, oldest first.
Query parameters
symbolrequiredThe trading pair, such as BTCUSDT.
exchangeoptionaldefault binanceThe exchange whose readings to give.
startoptionaldefault end − 7 daysThe first time to include: ISO 8601 or Unix milliseconds.
endoptionaldefault nowThe time to stop before (not included).
limitoptionaldefault 100Items in this page. A full page comes with meta.next_start.
Response: data
- time
- The hour of the reading.
- account_long, account_ratio
- All accounts with a position: the share long (0–1) and longs / shorts.
- top_account_long, top_account_ratio
- Binance only: its top traders (the top 20% by margin balance), counted by accounts.
- top_position_long, top_position_ratio
- Binance only: its top traders, weighted by position size.
- taker_buy, taker_sell
- Binance and OKX: the volume takers bought and sold in the hour starting at
time, in the coin. - taker_ratio
taker_buy/taker_sell.
Response: meta
- as_of
- The exchange’s newest hour with readings (of any pair).
- Each exchange’s own readings, one an hour, at the times the exchange gives them: a field is
nullwhere the exchange does not publish it, or that reading was not recorded. - Binance’s and Bybit’s ratio at an hour is their reading at that hour. OKX stamps its reading with the start of the hour and takes it at the end: OKX’s 22:00 is its reading at 23:00, so its newest hour is the one before.
- A row’s taker volume is of the hour starting at its
time, so the newest row has none until that hour has closed. - On MAX: the hours of the last 365 days, from 00:00 UTC that day (
meta.history_from). An earlierstart, or anendbefore then, is refused with403 not_in_plan. Pro and Dev include the full history.
Updated: Every 10 minutes; each pair’s new hour arrives within the hour.
curl "https://www.tradingdigits.io/api/v1/long-short/history?symbol=BTCUSDT&limit=2" \
-H "Authorization: Bearer $TD_API_KEY"{
"data": [
{
"time": "2026-11-09T04:00:00.000Z",
"account_long": 0.7385,
"account_ratio": 2.8241,
"top_account_long": 0.7551,
"top_account_ratio": 3.0833,
"top_position_long": 0.6641,
"top_position_ratio": 1.9774,
"taker_buy": 1727.533,
"taker_sell": 1421.454,
"taker_ratio": 1.21533
},
{
"time": "2026-11-09T05:00:00.000Z",
"account_long": 0.7365,
"account_ratio": 2.7951,
"top_account_long": 0.7539,
"top_account_ratio": 3.0634,
"top_position_long": 0.6643,
"top_position_ratio": 1.979,
"taker_buy": 3591.283,
"taker_sell": 3948.582,
"taker_ratio": 0.909512
}
],
"meta": {
"symbol": "BTCUSDT",
"exchange": "binance",
"as_of": "2026-11-16T03:00:00.000Z",
"stale": false,
"count": 2,
"next_start": "2026-11-09T05:00:00.001Z"
}
}CME gaps
Bitcoin’s weekend gaps around the CME futures closure, newest first.
Query parameters
statusoptionaldefault allGaps not yet filled, filled ones, or both.
cme_closedoptionaldefault truetrue: weekends when CME was closed. false: weekends since CME trades 24/7, measured at the same hours.
Response: data
- friday_close_time, sunday_open_time
- CME’s weekly close (Friday 16:00 Chicago time) and reopening (Sunday 17:00).
- friday_close, sunday_open
- Bitcoin’s price at those times.
- gap_bottom, gap_top, gap_size
- The gap’s range and size in USD.
- gap_percent
- The gap’s size in percent.
- direction
upordown: where the price opened against Friday’s close.- filled, filled_at
- Whether the price has come back to Friday’s close, and the start of the hour it did.
- cme_closed
- Whether CME was actually closed that weekend.
Response: meta
- last_change
- When a gap was last added or filled. This endpoint has no
as_oforstale.
- Measured on Binance’s BTCUSDT spot price. A gap is listed when the two prices differ by more than 0.1%.
- CME’s crypto futures trade 24/7 since 29 May 2026, so the last real gap is the weekend of 22 May 2026. The weekends since are measured at the same hours (
cme_closed=false): the gaps that would have formed. - On MAX: every gap still open, and the filled ones whose Friday close is in the last 365 days (
meta.history_fromsays where that starts).
Updated: Open gaps are checked every 15 minutes.
curl "https://www.tradingdigits.io/api/v1/cme-gaps" \
-H "Authorization: Bearer $TD_API_KEY"{
"data": [
{
"friday_close_time": "2026-05-22T21:00:00.000Z",
"sunday_open_time": "2026-05-24T22:00:00.000Z",
"friday_close": 75984.47,
"sunday_open": 76151.14,
"gap_bottom": 75984.47,
"gap_top": 76151.14,
"gap_size": 166.67,
"gap_percent": 0.22,
"direction": "up",
"filled": true,
"filled_at": "2026-05-26T17:00:00.000Z",
"cme_closed": true
},
{
"friday_close_time": "2026-05-15T21:00:00.000Z",
"sunday_open_time": "2026-05-17T22:00:00.000Z",
"friday_close": 79123.12,
"sunday_open": 78405.72,
"gap_bottom": 78405.72,
"gap_top": 79123.12,
"gap_size": 717.4,
"gap_percent": 0.91,
"direction": "down",
"filled": true,
"filled_at": "2026-08-21T08:00:00.000Z",
"cme_closed": true
}
],
"meta": {
"last_change": "2026-11-09T00:15:00.098Z",
"count": 413
}
}Liquidation heatmap (Dev)
The data behind the site’s Liquidation Heatmap, as numbers: the estimated liquidation value in USD at each price band over time, for one Binance USDT-M perpetual. Longs are liquidated below the price, shorts above.
These are estimates from our model, not a record of liquidations. The three endpoints are part of the Dev plan. When the heatmap is busy, a request is answered 503 with Retry-After and does not count.
Heatmap grid
Dev onlyThe whole heatmap of one perpetual: 340 price bands, each with a value per column of time, and the perpetual’s price candle of each column, so you can draw it from this one answer.
Query parameters
symbolrequiredA Binance USDT-M perpetual, such as BTCUSDT.
periodoptionaldefault 24hThe span the heatmap covers.
resolutionoptionaldefault fullcoarse: 34 bands (each 10 of the full grid’s, summed) and one column per hour (24h), 2 hours (3d), 4 hours (7d) or day (30d), each starting on the clock and holding what stood at its end; the newest is still running. The size the MCP tool uses.
Response: data
- times[]
- Each column’s time, oldest first. The last column is what stands now.
- levels[]
- The price bands, lowest first:
price_low,price_highandvalues, one value per column in whole USD (0 = none). - candles[]
- The perpetual’s price candle of each column, in the order of
times:open,high,lowandclose. The last is still forming. Coarse: the candle across the column’s time.
Response: meta
- as_of
- When the heatmap was last updated.
- resolution
fullorcoarse.- rows, columns
- The grid’s size: 340 bands (34 coarse), and the number of columns for the period.
- price_min, price_max
- The price range the bands cover.
- A 24h grid has 340 × 288 values (coarse: 34 × 24). Use
/levelswhen you only need what stands now, and/clustersfor the largest clusters and how they changed.
Updated: Every minute.
curl "https://www.tradingdigits.io/api/v1/liquidation-heatmap?symbol=BTCUSDT&period=24h" \
-H "Authorization: Bearer $TD_API_KEY"{
"data": {
"times": [
"2026-11-17T05:40:00.000Z",
"2026-11-17T05:45:00.000Z",
"2026-11-17T05:50:00.000Z"
],
"levels": [
{
"price_low": 64447.4758,
"price_high": 64483.76078,
"values": [
95959,
199268,
251182
]
},
{
"price_low": 64483.76078,
"price_high": 64520.04577,
"values": [
31153,
64693,
64702
]
}
],
"candles": [
{
"open": 64918,
"high": 64918,
"low": 64854,
"close": 64872.3
},
{
"open": 64872.4,
"high": 64916.6,
"low": 64848.3,
"close": 64848.3
},
{
"open": 64848,
"high": 64855.8,
"low": 64792.1,
"close": 64804.9
}
]
},
"meta": {
"symbol": "BTCUSDT",
"period": "24h",
"resolution": "full",
"as_of": "2026-11-18T05:37:28.422Z",
"stale": false,
"rows": 340,
"columns": 288,
"price_min": 58279.0286,
"price_max": 70615.923
}
}Liquidation levels
Dev onlyThe levels standing now (the heatmap’s newest column), largest first.
Query parameters
symbolrequiredA Binance USDT-M perpetual, such as BTCUSDT.
periodoptionaldefault 24hThe heatmap the levels come from.
limitoptionaldefault 20How many levels.
Response: data
- price_low, price_high
- The price band.
- side
long(below the price, where longs are liquidated) orshort(above).- value_usd
- The estimated liquidation value in whole USD.
Response: meta
- price
- The perpetual’s latest price.
- Bands with no value are left out.
Updated: Every minute.
curl "https://www.tradingdigits.io/api/v1/liquidation-heatmap/levels?symbol=BTCUSDT&period=24h&limit=3" \
-H "Authorization: Bearer $TD_API_KEY"{
"data": [
{
"price_low": 63032.36144,
"price_high": 63068.64643,
"side": "long",
"value_usd": 20421840
},
{
"price_low": 62996.07646,
"price_high": 63032.36144,
"side": "long",
"value_usd": 17746336
},
{
"price_low": 65572.31029,
"price_high": 65608.59527,
"side": "short",
"value_usd": 16150289
}
],
"meta": {
"symbol": "BTCUSDT",
"period": "24h",
"as_of": "2026-11-18T05:13:00.224Z",
"stale": false,
"price": 64474.8,
"count": 3
}
}Liquidation clusters
Dev onlyThe largest clusters over the period: the ones standing now, then the ones the price swept or that faded, with when each formed, peaked and ended.
Query parameters
symbolrequiredA Binance USDT-M perpetual, such as BTCUSDT.
periodoptionaldefault 24hThe heatmap the clusters are read from.
limitoptionaldefault 10How many standing clusters, and how many gone ones.
Response: data
- price_low, price_high
- The cluster’s price range: adjacent bands around its largest band, each holding at least half of that band’s value.
- side
long(below the price, where longs are liquidated) orshort(above). A gone cluster: against the price at its peak.- status
standing;swept: the price traded into it after its peak;faded: it fell below half its peak without the price reaching it. Standing clusters come first, largest first; then the gone ones, largest peak first.- value_usd
- Its estimated liquidation value now, in whole USD.
- peak_usd, peak_at
- Its largest value over the period, and when.
- formed_at
- When it reached at least half of its value now (standing) or of its peak (gone) and held it since.
null: it already stood when the period began. - ended_at
- Swept: when the price first traded into it. Faded: when it fell below half its peak. Standing:
null. - distance_pct
- From the price now to its nearer edge, in percent: negative below the price, 0 when the price is inside it.
- history_usd
- Its value at each of
meta.history_times.
Response: meta
- price
- The perpetual’s latest price.
- history_times
- Eight times spread evenly across the period, the last one now.
- standing, gone
- How many clusters of each kind the answer has.
Updated: Every minute.
curl "https://www.tradingdigits.io/api/v1/liquidation-heatmap/clusters?symbol=BTCUSDT&period=24h&limit=2" \
-H "Authorization: Bearer $TD_API_KEY"{
"data": [
{
"price_low": 65282.03042,
"price_high": 65790.02019,
"side": "short",
"status": "standing",
"value_usd": 178353792,
"peak_usd": 178353792,
"peak_at": "2026-11-18T05:35:00.000Z",
"formed_at": "2026-11-17T16:00:00.000Z",
"ended_at": null,
"distance_pct": 0.89,
"history_usd": [
168215,
18941635,
47857163,
82511094,
110270963,
130714165,
161403058,
178353792
]
},
{
"price_low": 62234.0918,
"price_high": 62887.22151,
"side": "long",
"status": "standing",
"value_usd": 163121395,
"peak_usd": 163121395,
"peak_at": "2026-11-18T05:35:00.000Z",
"formed_at": "2026-11-17T16:05:00.000Z",
"ended_at": null,
"distance_pct": -2.81,
"history_usd": [
79133,
13546635,
31986641,
77205520,
119040379,
138535583,
152350868,
163121395
]
},
{
"price_low": 64302.33587,
"price_high": 64483.76078,
"side": "short",
"status": "swept",
"value_usd": 1175161,
"peak_usd": 33410117,
"peak_at": "2026-11-17T21:15:00.000Z",
"formed_at": "2026-11-17T17:25:00.000Z",
"ended_at": "2026-11-17T21:20:00.000Z",
"distance_pct": -0.34,
"history_usd": [
154091,
0,
7907256,
7738231,
25560014,
2049483,
0,
1175161
]
},
{
"price_low": 65064.32052,
"price_high": 65209.46045,
"side": "short",
"status": "swept",
"value_usd": 10449887,
"peak_usd": 30304060,
"peak_at": "2026-11-17T23:05:00.000Z",
"formed_at": "2026-11-17T17:05:00.000Z",
"ended_at": "2026-11-17T23:10:00.000Z",
"distance_pct": 0.56,
"history_usd": [
0,
5580271,
11591764,
11507547,
22785538,
29730561,
5344832,
10449887
]
}
],
"meta": {
"symbol": "BTCUSDT",
"period": "24h",
"as_of": "2026-11-18T05:37:28.422Z",
"stale": false,
"price": 64704.3,
"history_times": [
"2026-11-17T05:40:00.000Z",
"2026-11-17T09:05:00.000Z",
"2026-11-17T12:30:00.000Z",
"2026-11-17T15:55:00.000Z",
"2026-11-17T19:20:00.000Z",
"2026-11-17T22:45:00.000Z",
"2026-11-18T02:10:00.000Z",
"2026-11-18T05:35:00.000Z"
],
"standing": 2,
"gone": 2,
"count": 4
}
}MCP server
AI assistants can read the data as tools through our MCP server (Model Context Protocol): ask ChatGPT, Claude, Cursor and other MCP apps about the market in plain language. Part of Dev.
https://www.tradingdigits.io/api/mcp/v1Connect it
- ChatGPT: add a custom connector (an MCP server) with the server URL and OAuth sign-in. ChatGPT sends you to a Trading Digits page: sign in and allow it.
- Claude (claude.ai, Desktop, mobile): Customize, then Connectors, then Add custom connector, with the server URL. Then Connect, sign in and allow it.
- Claude Code, Cursor, VS Code: add the server URL as in the examples; the app asks you to sign in. Or give it a Dev API key in the
Authorizationheader. - Any other MCP client: Streamable HTTP at the server URL, signing in with OAuth (the client finds where from the server’s
401), or withAuthorization: Bearer <key>.
Signing in
- Sign-in gives the app a token that only opens the MCP server. Your account page lists each connected app; disconnect one there and it loses access within a minute.
- With a key, use a separate key for each app, so you can revoke one without stopping the others. Never paste a key into a chat.
Tools
| Tool | What it answers |
|---|---|
get_ | Your Trading Digits plan, its limits and this month's usage. |
list_ | The coins the data covers: spot pairs (candles, screeners, daily indicators, market performance; priced from Binance or MEXC) and Binance USDT-M perpetuals (open interest, the visual screener, liquidation levels). |
get_ | One coin's closed spot candles, oldest first: daily (1d: open, high, low, close; Bitcoin goes back to 2010) or hourly (1h: with volume in USDT and in the coin). |
get_ | Open interest of the Binance USDT-M perpetuals at the newest recorded hour (USD and contracts), with the percent change of open interest and price over 1h, 4h, 24h, 7d and 30d. |
get_ | One Binance USDT-M perpetual's open interest every hour, oldest first: USD, contracts and the contract price. |
get_ | Each crypto perpetual's current funding rate (no stock, commodity or FX contracts) on Binance, OKX, Bybit, Bitget and Gate.io, as a fraction per that exchange's funding interval (0.0001 = 0.01%), not annualised; null where the exchange does not list the pair. |
get_ | One pair's funding rate on Binance, OKX, Bybit, Bitget and Gate.io every hour, oldest first: each exchange's current rate at that hour, as a fraction per its funding interval (0.0001 = 0.01%), null where it did not list the pair. |
get_ | Every crypto USDT perpetual's newest long/short readings on one exchange: account_long (the share of accounts long, 0-1) and account_ratio (longs / shorts); on Binance also its top traders by accounts (top_account_*) and by position size (top_position_*); on Binance and OKX the taker buy and sell volume of the newest closed hour (taker_buy, taker_sell in the coin, taker_ratio). |
get_ | One perpetual's long/short readings every hour on Binance, Bybit or OKX, oldest first: the same fields as get_long_short; a row's taker volume is of the hour starting at its time. |
get_ | The Coinbase premium every hour, oldest first: Coinbase's BTC-USD (or ETH-USD) hourly close against Binance's BTCUSDT (ETHUSDT) spot close, in USD (premium_usd) and in percent of Binance's (premium_percent). |
get_ | Our 21 crypto narratives now (such as layer-1, defi, ai, meme, rwa, depin), largest market cap first: market cap (circulating supply x price, USD), 24h spot volume on Binance, MEXC, Bybit and OKX (total and per exchange), volume_to_market_cap, the coins counted, and change_24h_percent of market cap and volume against the hour 24 hours before. |
get_ | One narrative's market cap, 24h spot volume (total and per exchange), volume_to_market_cap and coins counted over time, oldest first. |
get_ | Bitcoin's weekend gaps around the CME futures closure (Friday 16:00 to Sunday 17:00 Chicago time), newest first, measured on Binance BTCUSDT: the gap's range, size, direction and whether it has been filled. |
get_ | Every Binance USDT-M perpetual's change in price, open interest and futures volume over one window, and its regime on three views: regime.price_oi (longs_entering, shorts_closing, longs_closing, shorts_entering), regime.price_volume (strong_rally, thin_rally, thin_selloff, strong_selloff) and regime.volume_oi (leverage_building, positions_unwinding, interest_fading, quiet_buildup). |
get_ | Coins by market cap with live price (USDT), market cap, 24h volume and the price change in percent over 1h, 24h, 7d, 30d and 1y (change_percent.1h to change_percent.1y). |
run_ | Every coin's indicator values on one timeframe, computed on closed candles (the numbers the site's screener pages show). |
get_ | The latest values of a cycle indicator, on closed daily candles. |
get_ | One coin's daily close and the indicator's lines every day, oldest first, with the same fields as get_daily_indicators (pi_cycle_top also meta.signals, pi_cycle_bottom meta.zones). |
get_ | Bitcoin's network every day, oldest first: hashrate (hashes a second: the work of the day's blocks over 86,400 s), difficulty (of the day's last block) and supply (BTC issued through the day's last block), computed from block heights. |
get_ | The liquidation levels standing now on Trading Digits' liquidation heatmap for one Binance USDT-M perpetual, largest first: each price band (price_low, price_high), its side (long: below the price, where longs are liquidated; short: above) and its estimated liquidation value in USD. |
get_ | The largest clusters on Trading Digits' liquidation heatmap for one Binance USDT-M perpetual over a period: first the clusters standing now (largest first), then the largest that are gone. |
get_ | Trading Digits' liquidation heatmap for one Binance USDT-M perpetual, at a size an assistant can read: 34 price bands (data.levels, lowest first: price_low, price_high and values), each with its estimated liquidation value in USD at every time column (data.times, oldest first: one per hour for 24h, 2 hours for 3d, 4 hours for 7d, a day for 30d, each starting on the clock; each column holds what stood at its end, the last is still running and holds now), and the perpetual's price candle of each column (data.candles: open, high, low, close). |
Limits and answers
- Every tool call counts as one request against your plan's limits, on the same counters as the REST API (Dev: 120 a minute, 300,000 a month); listing the tools does not. A liquidation tool call turned away because the heatmap is busy does not count.
- A tool answers with the REST endpoint’s JSON (
dataandmeta). List tools takesymbols,where,sort_bywithmin/max,orderandlimit(default 50);meta.countis the rows in the answer andmeta.total, when some were left out, how many matched. - An answer is at most about 60,000 characters, to fit an assistant's context: a longer list is cut (
meta.truncated), and a cut time series continues frommeta.next_start. The liquidation heatmap comes in three sizes: get_liquidation_heatmap gives a coarse grid (34 bands, a column per hour to a day), get_liquidation_clusters the largest clusters over the period, get_liquidation_levels the levels standing now; the whole grid is REST only (/api/v1/liquidation-heatmap). - Protocol: Streamable HTTP, versions 2026-07-28, 2025-11-25, 2025-06-18, 2025-03-26; tools only, no sessions.
# sign in with your Trading Digits account (run /mcp in Claude Code)
claude mcp add --transport http trading-digits "https://www.tradingdigits.io/api/mcp/v1"
# or with a Dev API key
claude mcp add --transport http trading-digits "https://www.tradingdigits.io/api/mcp/v1" \
--header "Authorization: Bearer $TD_API_KEY"{
"data": [
{
"symbol": "SUIUSDT",
"candle_closed_at": "2026-11-13T12:00:00.000Z",
"price": 3.41,
"rsi": 24.8,
"rsi_change_percent": -6.2,
"direction": "down"
}
],
"meta": {
"as_of": "2026-11-13T12:00:00.000Z",
"stale": false,
"timeframe": "4h",
"period": 14,
"left_out": [],
"count": 1,
"total": 9
}
}Market overview
Visual screener
Every Binance USDT-M perpetual’s change in price, open interest and futures volume over one window, and its regime on three views: price vs open interest, price vs volume, volume vs open interest.
Query parameters
windowoptionaldefault 24hThe window the changes are measured over.
symboloptionalOne coin only, such as BTCUSDT. Leave it out for every coin.
include_stablecoinsoptionaldefault falseStablecoins are left out of the list, as the site’s tools hide them by default; true keeps them. A coin asked for by symbol is answered either way.
Response: data
- symbol, base
- The perpetual.
- price
- The contract price at the hour (
as_of). - market_cap_rank
- 1 = the largest market cap among the perpetuals.
nullwhen unranked. - oi_usd, oi_base
- Open interest in USD and in contracts.
- volume_usd
- Futures volume (USDT) in the volume window.
nullwhen unavailable. - change_percent
price,oi_base,oi_usdandvolume, in percent.- regime
price_oi,price_volumeandvolume_oi: see the table below.nullwhen a change is missing or exactly 0.
Regimes
| View | Both up | First up, second down | Both down | First down, second up |
|---|---|---|---|---|
| price_oi price vs open interest | longs_entering | shorts_closing | longs_closing | shorts_entering |
| price_volume price vs volume | strong_rally | thin_rally | thin_selloff | strong_selloff |
| volume_oi volume vs open interest | leverage_building | positions_unwinding | interest_fading | quiet_buildup |
Response: meta
- as_of
- The open-interest hour the result describes.
- window_start
- Where the price and open-interest changes start.
- volume_window_start, volume_window_end
- The closed futures candles whose volume is compared with the same span before them. The 7d window ends on a 4-hour boundary, the 30d window on a day.
- left_out
- Perpetuals with no open interest recorded at the hour, so not in this result.
- volume_unavailable
- Perpetuals whose futures volume was unavailable (
volume_usdand its regimes arenull).
- Regimes use open interest in contracts (
oi_base), so a price move alone does not change it.
Updated: Every hour, about 10–15 minutes past the hour.
curl "https://www.tradingdigits.io/api/v1/visual-screener?window=24h" \
-H "Authorization: Bearer $TD_API_KEY"{
"data": [
{
"symbol": "BTCUSDT",
"base": "BTC",
"price": 74694.3,
"market_cap_rank": 1,
"oi_usd": 7222988183,
"oi_base": 96700.661,
"volume_usd": 13290308170,
"change_percent": {
"price": -1.59,
"oi_base": 0.67,
"oi_usd": -0.93,
"volume": 513.11
},
"regime": {
"price_oi": "shorts_entering",
"price_volume": "strong_selloff",
"volume_oi": "leverage_building"
}
},
{
"symbol": "ETHUSDT",
"base": "ETH",
"price": 2124.48,
"market_cap_rank": 2,
"oi_usd": 4828481248,
"oi_base": 2272782.6,
"volume_usd": 11153293137,
"change_percent": {
"price": -4.97,
"oi_base": -4.32,
"oi_usd": -9.07,
"volume": 556.2
},
"regime": {
"price_oi": "longs_closing",
"price_volume": "strong_selloff",
"volume_oi": "positions_unwinding"
}
}
],
"meta": {
"as_of": "2026-11-09T14:00:00.000Z",
"stale": false,
"window": "24h",
"window_start": "2026-11-08T14:00:00.000Z",
"volume_window_start": "2026-11-08T14:00:00.000Z",
"volume_window_end": "2026-11-09T14:00:00.000Z",
"left_out": [],
"volume_unavailable": [],
"count": 522
}
}Market performance
Coins by market cap with live price, market cap, 24h volume and the price change over 1h, 24h, 7d, 30d and 1y.
Query parameters
symboloptionalOne coin only, such as BTCUSDT. Leave it out for every coin.
include_stablecoinsoptionaldefault falseStablecoins are left out of the list, as the site’s tools hide them by default; true keeps them. A coin asked for by symbol is answered either way.
Response: data
- symbol, base, name
- The pair, its coin and the coin’s name.
- rank
- By market cap among the coins listed, 1 = the largest: stablecoins count only with
include_stablecoins=true. A stablecoin asked for bysymbolwithout it hasranknull. - price
- The live price of one token, in USDT.
- pair_price
- The pair’s own price:
1000SATSUSDTtrades 1,000 SATS. - market_cap_usd
- Circulating supply (refreshed daily) × the live price.
- volume_24h_usd
- Binance spot volume over the last 24 hours.
- change_percent
1h,24h,7d,30d,1yin percent.nullwithout a price that far back.- perpetual
- The Binance USDT-M perpetual of the same coin, or
null.
- Covers the coins
/api/v1/symbolslists that Binance trades against USDT and that have a market cap on record. Wrapped and fiat tokens are left out, and stablecoins unlessinclude_stablecoins=true.
Updated: Live prices, read at most a minute apart.
curl "https://www.tradingdigits.io/api/v1/market-performance" \
-H "Authorization: Bearer $TD_API_KEY"{
"data": [
{
"symbol": "BTCUSDT",
"base": "BTC",
"name": "Bitcoin",
"rank": 1,
"price": 74862.78,
"pair_price": 74862.78,
"market_cap_usd": 1505476431597,
"volume_24h_usd": 1292521308,
"change_percent": {
"1h": 0.13,
"24h": -1.55,
"7d": -3.95,
"30d": -9.62,
"1y": -27.26
},
"perpetual": "BTCUSDT"
},
{
"symbol": "ETHUSDT",
"base": "ETH",
"name": "Ethereum",
"rank": 2,
"price": 2129.54,
"pair_price": 2129.54,
"market_cap_usd": 260237979695,
"volume_24h_usd": 831659420,
"change_percent": {
"1h": 0.19,
"24h": -4.98,
"7d": -6.9,
"30d": -14.79,
"1y": -38.43
},
"perpetual": "ETHUSDT"
}
],
"meta": {
"as_of": "2026-11-09T14:57:21.562Z",
"stale": false,
"count": 459
}
}Narratives
Our 21 crypto narratives now, largest market cap first: market cap, 24h spot volume on four exchanges, and the change over 24 hours.
Query parameters
narrativeoptionalOne narrative only. Leave it out for all of them.
Response: data
- narrative, name
- The narrative’s id (
layer-1,defi,ai,meme,rwa…) and name. - market_cap_usd
- The sum over its coins of circulating supply × price.
- volume_24h_usd
- The coins’ spot volume over the last 24 hours on Binance, MEXC, Bybit and OKX, in USD.
- volume_24h_by_exchange
binance,mexc,bybit,okx: the same volume per exchange.- volume_to_market_cap
volume_24h_usd÷market_cap_usd.- coins
- The coins counted this hour.
- change_24h_percent
market_capandvolumeagainst the hour 24 hours before, in percent.nullwhen that hour is not recorded.
Response: meta
- as_of
- The hour the figures were taken in (they are read at about 5 minutes past).
- compared_with
- The hour
change_24h_percentcompares with, ornull.
- A coin can belong to several narratives, so the narratives’ market caps do not add up to the market’s.
- Volume counts each coin’s spot pairs quoted in USDT, USDC, FDUSD and USD1 on the four exchanges, a pair only when its price is within 3% of the coin’s own price (another coin under the same ticker, or a halted pair, is left out).
- Stablecoins belong to no narrative.
Updated: Every hour, at about 5 minutes past.
curl "https://www.tradingdigits.io/api/v1/narratives" \
-H "Authorization: Bearer $TD_API_KEY"{
"data": [
{
"narrative": "layer-1",
"name": "Layer 1",
"market_cap_usd": 1807420128804,
"volume_24h_usd": 7542969186,
"volume_24h_by_exchange": {
"binance": 4207575693,
"mexc": 823773234,
"bybit": 1380072784,
"okx": 1131547475
},
"volume_to_market_cap": 0.0042,
"coins": 106,
"change_24h_percent": {
"market_cap": -1,
"volume": 9.52
}
},
{
"narrative": "exchange-tokens",
"name": "Exchange tokens",
"market_cap_usd": 83766583765,
"volume_24h_usd": 119608444,
"volume_24h_by_exchange": {
"binance": 86922106,
"mexc": 14243984,
"bybit": 7292781,
"okx": 11149573
},
"volume_to_market_cap": 0.0014,
"coins": 8,
"change_24h_percent": {
"market_cap": -0.23,
"volume": -6.21
}
},
{
"narrative": "defi",
"name": "DeFi",
"market_cap_usd": 45961897744,
"volume_24h_usd": 625843648,
"volume_24h_by_exchange": {
"binance": 287641267,
"mexc": 51300176,
"bybit": 159676748,
"okx": 127225457
},
"volume_to_market_cap": 0.0136,
"coins": 117,
"change_24h_percent": {
"market_cap": 0.89,
"volume": -7.99
}
}
],
"meta": {
"as_of": "2026-11-17T21:00:00.000Z",
"stale": false,
"compared_with": "2026-11-16T21:00:00.000Z",
"count": 21
}
}Narrative history
One narrative’s market cap, 24h spot volume and coins counted over time, oldest first: hourly, or one row a day.
Query parameters
narrativerequiredThe narrative, such as defi.
intervaloptionaldefault 1h1h: every hour recorded. 1d: the 00:00 UTC rows.
startoptionaldefault end − 7 days (1h), 365 days (1d)The first time to include: ISO 8601 or Unix milliseconds.
endoptionaldefault nowThe time to stop before (not included).
limitoptionaldefault 100Items in this page. A full page comes with meta.next_start.
Response: data
- time
- When the figures were taken: the hour, or 00:00 UTC.
- market_cap_usd, volume_24h_usd, volume_24h_by_exchange, volume_to_market_cap, coins
- As in
/api/v1/narratives.
Response: meta
- as_of
- The newest hour recorded for every narrative.
- hourly_from
- Where the hourly rows start: before it, one row a day at 00:00 UTC.
- On MAX: the rows of the last 365 days, from 00:00 UTC that day (
meta.history_from). An earlierstart, or anendbefore then, is refused with403 not_in_plan. Pro and Dev include the full history.
Updated: Every hour, at about 5 minutes past.
curl "https://www.tradingdigits.io/api/v1/narratives/history?narrative=defi&interval=1d&limit=2" \
-H "Authorization: Bearer $TD_API_KEY"{
"data": [
{
"time": "2025-11-18T00:00:00.000Z",
"market_cap_usd": 55863324171,
"volume_24h_usd": 1959061602,
"volume_24h_by_exchange": {
"binance": 1154289943,
"mexc": 276694797,
"bybit": 352676226,
"okx": 175400637
},
"volume_to_market_cap": 0.0351,
"coins": 110
},
{
"time": "2025-11-19T00:00:00.000Z",
"market_cap_usd": 57757784412,
"volume_24h_usd": 2074093274,
"volume_24h_by_exchange": {
"binance": 1241657822,
"mexc": 279720807,
"bybit": 364362292,
"okx": 188352353
},
"volume_to_market_cap": 0.0359,
"coins": 110
}
],
"meta": {
"narrative": "defi",
"name": "DeFi",
"interval": "1d",
"as_of": "2026-11-17T21:00:00.000Z",
"stale": false,
"hourly_from": "2026-08-19T19:00:00.000Z",
"count": 2,
"next_start": "2025-11-20T00:00:00.000Z"
}
}Screeners
The seven screeners give every coin’s indicator values on one timeframe, computed on closed candles only: a value never changes after its candle has closed. They are the numbers the site’s screener pages show, and every setting those pages offer is available.
Every screener takes timeframe (default 4h) and symbol. On 1m and 5m they answer one coin at a time, so symbol is required there. Each row starts with symbol, candle_closed_at and price (that candle’s close). Stablecoins are left out unless include_stablecoins=true (/api/v1/symbols marks them).
MAX includes the 4h and 1d timeframes; another timeframe is refused with 403 not_in_plan. Pro and Dev include every timeframe.
meta.left_out lists coins whose candle at that close was not stored in time. Asking for one of them by symbol gives a 404 that says so.
Each screener takes filters, listed with it, so you receive only the coins you are looking for: rsi_below=30, status=oversold, level=explosive,extreme. A _below or _above filter is strict and never matches a null value; a list filter matches any of its comma-separated values; filters given together must all match. With a filter, meta.filters repeats them, meta.total counts the coins before filtering and meta.count after. A filtered request counts as one request.
RSI
Every coin’s RSI (14 periods) and how it moved since the candle before.
Query parameters
timeframeoptionaldefault 4h1m and 5m answer one coin at a time: give symbol with them.
symboloptionalOne coin only. Required on 1m and 5m.
include_stablecoinsoptionaldefault falseStablecoins are left out of the list, as the site’s tools hide them by default; true keeps them. A coin asked for by symbol is answered either way.
rsi_belowoptionalOnly coins whose rsi is below this.
rsi_aboveoptionalOnly coins whose rsi is above this.
directionoptionalOnly coins with this direction (one or several, comma-separated).
Response: data
- symbol
- The trading pair.
- candle_closed_at
- When the candle the values are computed on closed.
- price
- That candle’s close.
- rsi
- RSI(14), 0–100.
- rsi_change_percent
- The change since the candle before, in percent of that RSI.
- direction
up,down, orflatwhen it moved less than 1%.
Response: meta
- as_of
- The candle close the result is computed to.
- left_out
- Coins whose candle at that close was not stored in time, so they are not in this result.
Updated: Within about a minute of each candle close (1m/5m: when asked).
curl "https://www.tradingdigits.io/api/v1/screeners/rsi?timeframe=4h" \
-H "Authorization: Bearer $TD_API_KEY"{
"data": [
{
"symbol": "BTCUSDT",
"candle_closed_at": "2026-11-09T12:00:00.000Z",
"price": 74372.01,
"rsi": 32.4,
"rsi_change_percent": 29.54818073,
"direction": "up"
},
{
"symbol": "ETHUSDT",
"candle_closed_at": "2026-11-09T12:00:00.000Z",
"price": 2113.3,
"rsi": 28.22,
"rsi_change_percent": 23.9350022,
"direction": "up"
}
],
"meta": {
"as_of": "2026-11-09T12:00:00.000Z",
"stale": false,
"timeframe": "4h",
"period": 14,
"left_out": [],
"count": 529
}
}Moving averages
Every coin’s fast and slow moving average, three trends between them and the price, and when the two averages last crossed.
Query parameters
timeframeoptionaldefault 4h1m and 5m answer one coin at a time: give symbol with them.
typeoptionaldefault emaExponential or simple moving averages.
fast, slowoptionaldefault 50, 200A pair of periods.
symboloptionalOne coin only. Required on 1m and 5m.
include_stablecoinsoptionaldefault falseStablecoins are left out of the list, as the site’s tools hide them by default; true keeps them. A coin asked for by symbol is answered either way.
price_vs_fastoptionalOnly coins with this price_vs_fast.
price_vs_slowoptionalOnly coins with this price_vs_slow.
fast_vs_slowoptionalOnly coins with this fast_vs_slow.
crossoptionalOnly coins whose averages crossed this way on the newest closed candle.
last_crossoptionalOnly coins whose newest cross was this way.
crossed_withinoptionalOnly coins whose newest cross was on one of the newest this-many closed candles: crossed_within=5 with last_cross=golden finds golden crosses in the last 5 candles.
Response: data
- symbol
- The trading pair.
- candle_closed_at
- When the candle the values are computed on closed.
- price
- That candle’s close.
- fast, slow
- The two averages.
- price_vs_fast, price_vs_slow, fast_vs_slow
bullishwhen the first is above the second by more than 0.3% of the first,bearishwhen below by more, elseneutral.- cross
goldenwhen the fast average crossed above the slow one on the newest closed candle,deathwhen it crossed below, elsenull.- last_cross
- The direction of the newest cross,
goldenordeath.nullwhen the averages have not crossed within the candles available. - last_cross_at
- The close of the candle the newest cross happened on.
- last_cross_candles_ago
- How many candles before the newest closed one it happened: 0 = on the newest.
Response: meta
- as_of
- The candle close the result is computed to.
- left_out
- Coins whose candle at that close was not stored in time, so they are not in this result.
Updated: Within about a minute of each candle close (1m/5m: when asked).
curl "https://www.tradingdigits.io/api/v1/screeners/moving-averages?timeframe=4h&type=ema&fast=50&slow=200" \
-H "Authorization: Bearer $TD_API_KEY"{
"data": [
{
"symbol": "BTCUSDT",
"candle_closed_at": "2026-11-09T12:00:00.000Z",
"price": 74372.01,
"fast": 76850.38338,
"slow": 80228.24397,
"price_vs_fast": "bearish",
"price_vs_slow": "bearish",
"fast_vs_slow": "bearish",
"cross": null,
"last_cross": null,
"last_cross_at": null,
"last_cross_candles_ago": null
},
{
"symbol": "ETHUSDT",
"candle_closed_at": "2026-11-09T12:00:00.000Z",
"price": 2113.3,
"fast": 2252.902816,
"slow": 2396.768475,
"price_vs_fast": "bearish",
"price_vs_slow": "bearish",
"fast_vs_slow": "bearish",
"cross": null,
"last_cross": null,
"last_cross_at": null,
"last_cross_candles_ago": null
},
{
"symbol": "ZECUSDT",
"candle_closed_at": "2026-11-09T12:00:00.000Z",
"price": 1206.97,
"fast": 1259.704262,
"slow": 1257.308236,
"price_vs_fast": "bearish",
"price_vs_slow": "bearish",
"fast_vs_slow": "neutral",
"cross": null,
"last_cross": "golden",
"last_cross_at": "2026-11-06T16:00:00.000Z",
"last_cross_candles_ago": 17
}
],
"meta": {
"as_of": "2026-11-09T12:00:00.000Z",
"stale": false,
"timeframe": "4h",
"type": "ema",
"fast": 50,
"slow": 200,
"left_out": [],
"count": 529
}
}Bollinger Bands
Every coin’s Bollinger Bands, their width and where the price sits.
Query parameters
timeframeoptionaldefault 4h1m and 5m answer one coin at a time: give symbol with them.
periodoptionaldefault 20Candles in the average.
std_devoptionaldefault 2Standard deviations from the middle band.
symboloptionalOne coin only. Required on 1m and 5m.
include_stablecoinsoptionaldefault falseStablecoins are left out of the list, as the site’s tools hide them by default; true keeps them. A coin asked for by symbol is answered either way.
statusoptionalOnly coins with this status.
width_belowoptionalOnly coins whose width_percent is below this.
width_aboveoptionalOnly coins whose width_percent is above this.
Response: data
- symbol
- The trading pair.
- candle_closed_at
- When the candle the values are computed on closed.
- price
- That candle’s close.
- upper, middle, lower
- The bands.
- width_percent
- Upper minus lower, in percent of the middle band.
- status
overbought(above the upper band),oversold(below the lower),near_top(top fifth),near_bottom(bottom fifth) orneutral.- distance_to_upper_percent, distance_to_lower_percent
- From the price to each outer band, in percent of the price.
Response: meta
- as_of
- The candle close the result is computed to.
- left_out
- Coins whose candle at that close was not stored in time, so they are not in this result.
Updated: Within about a minute of each candle close (1m/5m: when asked).
curl "https://www.tradingdigits.io/api/v1/screeners/bollinger?timeframe=4h&period=20&std_dev=2" \
-H "Authorization: Bearer $TD_API_KEY"{
"data": [
{
"symbol": "BTCUSDT",
"candle_closed_at": "2026-11-09T12:00:00.000Z",
"price": 74372.01,
"upper": 76850.39921,
"middle": 75629.4425,
"lower": 74408.48579,
"width_percent": 3.228786744,
"status": "oversold",
"distance_to_upper_percent": 3.332421982,
"distance_to_lower_percent": 0.04904505069
},
{
"symbol": "ETHUSDT",
"candle_closed_at": "2026-11-09T12:00:00.000Z",
"price": 2113.3,
"upper": 2312.523988,
"middle": 2214.8725,
"lower": 2117.221012,
"width_percent": 8.81779765,
"status": "oversold",
"distance_to_upper_percent": 9.42715128,
"distance_to_lower_percent": 0.1855397719
}
],
"meta": {
"as_of": "2026-11-09T12:00:00.000Z",
"stale": false,
"timeframe": "4h",
"period": 20,
"std_dev": 2,
"left_out": [],
"count": 529
}
}Supertrend
Every coin’s Supertrend line, its direction and whether the price is testing it.
Query parameters
timeframeoptionaldefault 4h1m and 5m answer one coin at a time: give symbol with them.
periodoptionaldefault 10The ATR period.
multiplieroptionaldefault 3The ATR multiplier.
symboloptionalOne coin only. Required on 1m and 5m.
include_stablecoinsoptionaldefault falseStablecoins are left out of the list, as the site’s tools hide them by default; true keeps them. A coin asked for by symbol is answered either way.
directionoptionalOnly coins with this direction.
statusoptionalOnly coins with this status.
Response: data
- symbol
- The trading pair.
- candle_closed_at
- When the candle the values are computed on closed.
- price
- That candle’s close.
- supertrend, supertrend_previous
- The line on the newest closed candle and on the one before.
- direction
upwhen the close is above the line, elsedown.- status
testing_supportortesting_resistancewhen the line lies inside the newest candle’s range (support when the previous close was above its line), elsebullishorbearish.
Response: meta
- as_of
- The candle close the result is computed to.
- left_out
- Coins whose candle at that close was not stored in time, so they are not in this result.
Updated: Within about a minute of each candle close (1m/5m: when asked).
curl "https://www.tradingdigits.io/api/v1/screeners/supertrend?timeframe=4h&period=10&multiplier=3" \
-H "Authorization: Bearer $TD_API_KEY"{
"data": [
{
"symbol": "BTCUSDT",
"candle_closed_at": "2026-11-09T12:00:00.000Z",
"price": 74372.01,
"supertrend": 76836.69339,
"supertrend_previous": 76912.01988,
"direction": "down",
"status": "bearish"
},
{
"symbol": "ETHUSDT",
"candle_closed_at": "2026-11-09T12:00:00.000Z",
"price": 2113.3,
"supertrend": 2232.201553,
"supertrend_previous": 2234.086726,
"direction": "down",
"status": "bearish"
}
],
"meta": {
"as_of": "2026-11-09T12:00:00.000Z",
"stale": false,
"timeframe": "4h",
"period": 10,
"multiplier": 3,
"left_out": [],
"count": 529
}
}Volatility (ATR, ADX)
Every coin’s Average True Range or Average Directional Index.
Query parameters
timeframeoptionaldefault 4h1m and 5m answer one coin at a time: give symbol with them.
indicatoroptionaldefault atrWhich indicator.
periodoptionaldefault 14Candles in the indicator. ADX needs about twice as many.
symboloptionalOne coin only. Required on 1m and 5m.
include_stablecoinsoptionaldefault falseStablecoins are left out of the list, as the site’s tools hide them by default; true keeps them. A coin asked for by symbol is answered either way.
statusoptionalOnly coins with this status: high_vol, moderate, low_vol with atr; extreme_trend, strong_trend, weak_trend with adx.
atr_percent_below, atr_percent_aboveoptionalatr only: only coins whose atr_percent is below / above this.
adx_below, adx_aboveoptionaladx only: only coins whose adx is below / above this.
Response: data
- symbol
- The trading pair.
- candle_closed_at
- When the candle the values are computed on closed.
- price
- That candle’s close.
- atr, atr_percent
atronly: the ATR in price units, and in percent of the close.- adx, plus_di, minus_di
adxonly: the ADX and the two directional indicators.- status
- ATR:
high_vol(above 5%),moderate(above 2%),low_vol. ADX:extreme_trend(above 50),strong_trend(above 25),weak_trend.
Response: meta
- as_of
- The candle close the result is computed to.
- left_out
- Coins whose candle at that close was not stored in time, so they are not in this result.
Updated: Within about a minute of each candle close (1m/5m: when asked).
curl "https://www.tradingdigits.io/api/v1/screeners/volatility?timeframe=4h&indicator=adx&period=14" \
-H "Authorization: Bearer $TD_API_KEY"{
"data": [
{
"symbol": "BTCUSDT",
"candle_closed_at": "2026-11-09T12:00:00.000Z",
"price": 74372.01,
"adx": 40.69861952,
"plus_di": 8.053993621,
"minus_di": 36.80181822,
"status": "strong_trend"
},
{
"symbol": "ETHUSDT",
"candle_closed_at": "2026-11-09T12:00:00.000Z",
"price": 2113.3,
"adx": 38.96521753,
"plus_di": 7.212584782,
"minus_di": 44.43889568,
"status": "strong_trend"
}
],
"meta": {
"as_of": "2026-11-09T12:00:00.000Z",
"stale": false,
"timeframe": "4h",
"indicator": "adx",
"period": 14,
"left_out": [],
"count": 529
}
}Relative volume
Every coin’s volume on its newest closed candle against the average of the candles before it.
Query parameters
timeframeoptionaldefault 4h1m and 5m answer one coin at a time: give symbol with them.
rvol_periodoptionaldefault 20Candles in the average.
symboloptionalOne coin only. Required on 1m and 5m.
include_stablecoinsoptionaldefault falseStablecoins are left out of the list, as the site’s tools hide them by default; true keeps them. A coin asked for by symbol is answered either way.
leveloptionalOnly coins at this level.
rvol_aboveoptionalOnly coins whose rvol is above this (such as 2: twice the average).
rvol_belowoptionalOnly coins whose rvol is below this.
Response: data
- symbol
- The trading pair.
- candle_closed_at
- When the candle the values are computed on closed.
- price
- That candle’s close.
- volume_usd
- The newest closed candle’s volume in USDT.
- average_volume_usd
- The average volume of the
rvol_periodcandles before it. - rvol
volume_usd/average_volume_usd.- level
explosive(5× or more),extreme(3×),high(2×),normal(0.5×) orquiet.
Response: meta
- as_of
- The candle close the result is computed to.
- left_out
- Coins whose candle at that close was not stored in time, so they are not in this result.
Updated: Within about a minute of each candle close (1m/5m: when asked).
curl "https://www.tradingdigits.io/api/v1/screeners/volume?timeframe=4h&rvol_period=20" \
-H "Authorization: Bearer $TD_API_KEY"{
"data": [
{
"symbol": "BTCUSDT",
"candle_closed_at": "2026-11-09T12:00:00.000Z",
"price": 74372.01,
"volume_usd": 233483962,
"average_volume_usd": 143533118.2,
"rvol": 1.626690516,
"level": "normal"
},
{
"symbol": "ETHUSDT",
"candle_closed_at": "2026-11-09T12:00:00.000Z",
"price": 2113.3,
"volume_usd": 146697281,
"average_volume_usd": 66357827,
"rvol": 2.210700495,
"level": "high"
}
],
"meta": {
"as_of": "2026-11-09T12:00:00.000Z",
"stale": false,
"timeframe": "4h",
"rvol_period": 20,
"left_out": [],
"count": 529
}
}Candlestick patterns
The candlestick patterns each coin’s newest closed candle completes, and the overall signal.
Query parameters
timeframeoptionaldefault 4h1m and 5m answer one coin at a time: give symbol with them.
symboloptionalOne coin only. Required on 1m and 5m.
include_stablecoinsoptionaldefault falseStablecoins are left out of the list, as the site’s tools hide them by default; true keeps them. A coin asked for by symbol is answered either way.
signaloptionalOnly coins with this signal.
patternoptionalOnly coins whose patterns include this one (or any of several, comma-separated). The names are listed below.
Response: data
- symbol
- The trading pair.
- candle_closed_at
- When the candle the values are computed on closed.
- price
- That candle’s close.
- patterns
- Bullish:
bullish_engulfing,hammer,morning_star,morning_doji_star,piercing_line,three_white_soldiers,bullish_harami,tweezer_bottom,bullish_marubozu. Bearish:bearish_engulfing,hanging_man,shooting_star,evening_star,evening_doji_star,dark_cloud_cover,three_black_crows,bearish_harami,tweezer_top,bearish_marubozu. Neutral:doji. - signal
bullishorbearishwhen more of the patterns point that way,neutralon a tie (a doji alone included),nullwith no pattern.
Response: meta
- as_of
- The candle close the result is computed to.
- left_out
- Coins whose candle at that close was not stored in time, so they are not in this result.
Updated: Within about a minute of each candle close (1m/5m: when asked).
curl "https://www.tradingdigits.io/api/v1/screeners/candlestick-patterns?timeframe=4h" \
-H "Authorization: Bearer $TD_API_KEY"{
"data": [
{
"symbol": "BTCUSDT",
"candle_closed_at": "2026-11-09T12:00:00.000Z",
"price": 74372.01,
"patterns": [],
"signal": null
},
{
"symbol": "ETHUSDT",
"candle_closed_at": "2026-11-09T12:00:00.000Z",
"price": 2113.3,
"patterns": [
"bullish_harami"
],
"signal": "bullish"
}
],
"meta": {
"as_of": "2026-11-09T12:00:00.000Z",
"stale": false,
"timeframe": "4h",
"left_out": [],
"count": 529
}
}Daily indicators
Cycle indicators on closed daily candles, as the site’s indicator pages show them. Pi Cycle Top and Bottom, the 2-Year MA Multiplier, the Mayer Multiple and the 200-week moving average are computed for every coin; the Golden Ratio Multiplier, the Rainbow Chart, the Power Law, the AHR999 Index and the Puell Multiple for Bitcoin only. Each has two endpoints: the latest values (every coin, symbol optional; stablecoins left out unless include_stablecoins=true), and one coin’s daily history (paged like /api/v1/candles, default the last 365 days).
Latest rows start with symbol, candle_closed_at, price and days; most end with enough_history: whether the coin has the days the site’s page asks for. History rows have time (the day’s open), close and the indicator’s lines (null until there are enough days).
Pi Cycle Top
The 111-day moving average against twice the 350-day moving average, and the last time it crossed above.
Query parameters
symboloptionalOne coin only, such as BTCUSDT. Leave it out for every coin.
include_stablecoinsoptionaldefault falseStablecoins are left out of the list, as the site’s tools hide them by default; true keeps them. A coin asked for by symbol is answered either way.
Response: data
- symbol
- The trading pair.
- candle_closed_at
- The close of the coin’s newest daily candle.
- price
- That day’s close.
- days
- How many daily candles the coin has.
- sma_111
- The 111-day simple moving average.
- sma_350_x2
- Twice the 350-day simple moving average.
- last_signal
- The last day the 111-day average crossed above it (a date), or
nullif never. - enough_history
- At least 350 days.
Response: meta
- as_of
- The day the values were built for (00:00 UTC).
Updated: Daily from 00:15 UTC, after the day’s candles are stored; usually complete by 00:45.
curl "https://www.tradingdigits.io/api/v1/indicators/pi-cycle-top" \
-H "Authorization: Bearer $TD_API_KEY"{
"data": [
{
"symbol": "BTCUSDT",
"candle_closed_at": "2026-11-09T00:00:00.000Z",
"price": 74851.44,
"days": 5952,
"sma_111": 76086.7409,
"sma_350_x2": 151517.1997,
"last_signal": "2021-04-12",
"enough_history": true
},
{
"symbol": "ETHUSDT",
"candle_closed_at": "2026-11-09T00:00:00.000Z",
"price": 2127.46,
"days": 3371,
"sma_111": 2324.414324,
"sma_350_x2": 4636.950343,
"last_signal": "2021-03-06",
"enough_history": true
}
],
"meta": {
"as_of": "2026-11-09T00:00:00.000Z",
"stale": false,
"count": 530
}
}Pi Cycle Top history
One coin’s daily close and both Pi Cycle Top lines, oldest first.
Query parameters
symbolrequiredThe trading pair, such as BTCUSDT.
startoptionaldefault end − 365 daysThe first time to include: ISO 8601 or Unix milliseconds.
endoptionaldefault nowThe time to stop before (not included).
limitoptionaldefault 100Items in this page. A full page comes with meta.next_start.
Response: data
- time
- The day’s open (00:00 UTC).
- close
- The day’s close.
- sma_111, sma_350_x2
- The two lines.
Response: meta
- signals
- Every day the 111-day average crossed above.
- On MAX: the days of the last 365 days, from 00:00 UTC that day (
meta.history_from). An earlierstart, or anendbefore then, is refused with403 not_in_plan. Pro and Dev include the full history. The signals are held to the same days.
Updated: Daily at about 00:05 UTC, when the day’s candle is stored.
curl "https://www.tradingdigits.io/api/v1/indicators/pi-cycle-top/history?symbol=BTCUSDT&limit=2" \
-H "Authorization: Bearer $TD_API_KEY"{
"data": [
{
"time": "2025-11-10T00:00:00.000Z",
"close": 106011.13,
"sma_111": 113516.4292,
"sma_350_x2": 205854.667
},
{
"time": "2025-11-11T00:00:00.000Z",
"close": 103058.99,
"sma_111": 113375.0148,
"sma_350_x2": 205918.0603
}
],
"meta": {
"symbol": "BTCUSDT",
"as_of": "2026-11-09T00:00:00.000Z",
"stale": false,
"signals": [
"2013-04-06",
"2013-12-05",
"2017-12-17"
],
"count": 2,
"next_start": "2025-11-11T00:00:00.001Z"
}
}Pi Cycle Bottom
The 150-day exponential moving average against 0.745 × the 471-day moving average, and the latest bottoming zone (the first below the second).
Query parameters
symboloptionalOne coin only, such as BTCUSDT. Leave it out for every coin.
include_stablecoinsoptionaldefault falseStablecoins are left out of the list, as the site’s tools hide them by default; true keeps them. A coin asked for by symbol is answered either way.
Response: data
- symbol
- The trading pair.
- candle_closed_at
- The close of the coin’s newest daily candle.
- price
- That day’s close.
- days
- How many daily candles the coin has.
- ema_150
- The 150-day exponential moving average.
- sma_471_x0745
- 0.745 × the 471-day simple moving average.
- zone_start, zone_end
- The latest zone’s first and last day.
zone_endisnullwhile it is open. - in_zone
- Whether the coin is in a zone now.
- enough_history
- At least 471 days.
Response: meta
- as_of
- The day the values were built for (00:00 UTC).
Updated: Daily from 00:15 UTC, after the day’s candles are stored; usually complete by 00:45.
curl "https://www.tradingdigits.io/api/v1/indicators/pi-cycle-bottom" \
-H "Authorization: Bearer $TD_API_KEY"{
"data": [
{
"symbol": "BTCUSDT",
"candle_closed_at": "2026-11-09T00:00:00.000Z",
"price": 74851.44,
"days": 5952,
"ema_150": 76566.36549,
"sma_471_x0745": 63222.26067,
"zone_start": "2022-07-13",
"zone_end": "2023-03-16",
"in_zone": false,
"enough_history": true
},
{
"symbol": "ETHUSDT",
"candle_closed_at": "2026-11-09T00:00:00.000Z",
"price": 2127.46,
"days": 3371,
"ema_150": 2308.955748,
"sma_471_x0745": 2054.042094,
"zone_start": "2026-07-23",
"zone_end": "2026-08-31",
"in_zone": false,
"enough_history": true
}
],
"meta": {
"as_of": "2026-11-09T00:00:00.000Z",
"stale": false,
"count": 530
}
}Pi Cycle Bottom history
One coin’s daily close and both Pi Cycle Bottom lines, oldest first.
Query parameters
symbolrequiredThe trading pair, such as BTCUSDT.
startoptionaldefault end − 365 daysThe first time to include: ISO 8601 or Unix milliseconds.
endoptionaldefault nowThe time to stop before (not included).
limitoptionaldefault 100Items in this page. A full page comes with meta.next_start.
Response: data
- time
- The day’s open (00:00 UTC).
- close
- The day’s close.
- ema_150, sma_471_x0745
- The two lines.
Response: meta
- zones
- Every bottoming zone:
start,end(nullwhile open) andactive.
- On MAX: the days of the last 365 days, from 00:00 UTC that day (
meta.history_from). An earlierstart, or anendbefore then, is refused with403 not_in_plan. Pro and Dev include the full history. The zones that had not ended by then are held to the same days.
Updated: Daily at about 00:05 UTC, when the day’s candle is stored.
curl "https://www.tradingdigits.io/api/v1/indicators/pi-cycle-bottom/history?symbol=BTCUSDT&limit=2" \
-H "Authorization: Bearer $TD_API_KEY"{
"data": [
{
"time": "2025-11-10T00:00:00.000Z",
"close": 106011.13,
"ema_150": 109984.2186,
"sma_471_x0745": 69771.73314
},
{
"time": "2025-11-11T00:00:00.000Z",
"close": 103058.99,
"ema_150": 109892.4937,
"sma_471_x0745": 69826.79214
}
],
"meta": {
"symbol": "BTCUSDT",
"as_of": "2026-11-09T00:00:00.000Z",
"stale": false,
"zones": [
{
"start": "2015-01-14",
"end": "2015-09-28",
"active": false
},
{
"start": "2018-12-19",
"end": "2019-05-09",
"active": false
}
],
"count": 2,
"next_start": "2025-11-11T00:00:00.001Z"
}
}2-Year MA Multiplier
The 730-day moving average, five times it, and which zone the price is in.
Query parameters
symboloptionalOne coin only, such as BTCUSDT. Leave it out for every coin.
include_stablecoinsoptionaldefault falseStablecoins are left out of the list, as the site’s tools hide them by default; true keeps them. A coin asked for by symbol is answered either way.
Response: data
- symbol
- The trading pair.
- candle_closed_at
- The close of the coin’s newest daily candle.
- price
- That day’s close.
- days
- How many daily candles the coin has.
- ma_730
- The 730-day moving average. Under 730 days it averages every day so far, as the site does.
- ma_730_x5
- Five times it.
- zone
below_ma,above_ma5orbetween.- enough_history
- At least 547 days.
Response: meta
- as_of
- The day the values were built for (00:00 UTC).
Updated: Daily from 00:15 UTC, after the day’s candles are stored; usually complete by 00:45.
curl "https://www.tradingdigits.io/api/v1/indicators/two-year-ma" \
-H "Authorization: Bearer $TD_API_KEY"{
"data": [
{
"symbol": "BTCUSDT",
"candle_closed_at": "2026-11-09T00:00:00.000Z",
"price": 74851.44,
"days": 5952,
"ma_730": 89444.76341,
"ma_730_x5": 447223.8171,
"zone": "below_ma",
"enough_history": true
},
{
"symbol": "ETHUSDT",
"candle_closed_at": "2026-11-09T00:00:00.000Z",
"price": 2127.46,
"days": 3371,
"ma_730": 2742.06674,
"ma_730_x5": 13710.3337,
"zone": "below_ma",
"enough_history": true
}
],
"meta": {
"as_of": "2026-11-09T00:00:00.000Z",
"stale": false,
"count": 530
}
}2-Year MA Multiplier history
One coin’s daily close, its 730-day moving average and five times it, oldest first.
Query parameters
symbolrequiredThe trading pair, such as BTCUSDT.
startoptionaldefault end − 365 daysThe first time to include: ISO 8601 or Unix milliseconds.
endoptionaldefault nowThe time to stop before (not included).
limitoptionaldefault 100Items in this page. A full page comes with meta.next_start.
Response: data
- time
- The day’s open (00:00 UTC).
- close
- The day’s close.
- ma_730, ma_730_x5
- The two lines.
- On MAX: the days of the last 365 days, from 00:00 UTC that day (
meta.history_from). An earlierstart, or anendbefore then, is refused with403 not_in_plan. Pro and Dev include the full history.
Updated: Daily at about 00:05 UTC, when the day’s candle is stored.
curl "https://www.tradingdigits.io/api/v1/indicators/two-year-ma/history?symbol=BTCUSDT&limit=2" \
-H "Authorization: Bearer $TD_API_KEY"{
"data": [
{
"time": "2025-11-10T00:00:00.000Z",
"close": 106011.13,
"ma_730": 80366.86577,
"ma_730_x5": 401834.3288
},
{
"time": "2025-11-11T00:00:00.000Z",
"close": 103058.99,
"ma_730": 80457.26968,
"ma_730_x5": 402286.3484
}
],
"meta": {
"symbol": "BTCUSDT",
"as_of": "2026-11-09T00:00:00.000Z",
"stale": false,
"count": 2,
"next_start": "2025-11-11T00:00:00.001Z"
}
}Mayer Multiple
The price over its 200-day moving average, for every coin.
Query parameters
symboloptionalOne coin only, such as BTCUSDT. Leave it out for every coin.
include_stablecoinsoptionaldefault falseStablecoins are left out of the list, as the site’s tools hide them by default; true keeps them. A coin asked for by symbol is answered either way.
Response: data
- symbol
- The trading pair.
- candle_closed_at
- The close of the coin’s newest daily candle.
- price
- That day’s close.
- days
- How many daily candles the coin has.
- sma_200
- The average of the 200 daily closes before the newest day (that day itself not included), as the site’s Mayer Multiple page computes it.
- multiple
price/sma_200. Below 1 the price is under its 200-day average.- enough_history
- Whether there are 200 earlier days. Without them
sma_200andmultiplearenull.
Response: meta
- as_of
- The day the values were built for (00:00 UTC).
- Days before 1 January 2011 are not counted (Bitcoin’s first months), as on the site.
Updated: Daily from 00:15 UTC, after the day’s candles are stored; usually complete by 00:45.
curl "https://www.tradingdigits.io/api/v1/indicators/mayer-multiple" \
-H "Authorization: Bearer $TD_API_KEY"{
"data": [
{
"symbol": "BTCUSDT",
"candle_closed_at": "2026-11-16T00:00:00.000Z",
"price": 65351.05,
"days": 5959,
"sma_200": 73030.61725,
"multiple": 0.8948445523,
"enough_history": true
},
{
"symbol": "ETHUSDT",
"candle_closed_at": "2026-11-16T00:00:00.000Z",
"price": 1835.35,
"days": 3378,
"sma_200": 2146.18475,
"multiple": 0.8551686895,
"enough_history": true
}
],
"meta": {
"as_of": "2026-11-16T00:00:00.000Z",
"stale": false,
"count": 530
}
}Mayer Multiple history
One coin’s daily close, the 200-day average before each day and the multiple, oldest first.
Query parameters
symbolrequiredThe trading pair, such as BTCUSDT.
startoptionaldefault end − 365 daysThe first time to include: ISO 8601 or Unix milliseconds.
endoptionaldefault nowThe time to stop before (not included).
limitoptionaldefault 100Items in this page. A full page comes with meta.next_start.
Response: data
- time
- The day’s open (00:00 UTC).
- close
- The day’s close.
- sma_200, multiple
- The average of the 200 closes before the day, and the close over it.
nullfor the coin’s first 200 days.
- On MAX: the days of the last 365 days, from 00:00 UTC that day (
meta.history_from). An earlierstart, or anendbefore then, is refused with403 not_in_plan. Pro and Dev include the full history.
Updated: Daily at about 00:05 UTC, when the day’s candle is stored.
curl "https://www.tradingdigits.io/api/v1/indicators/mayer-multiple/history?symbol=BTCUSDT&limit=2" \
-H "Authorization: Bearer $TD_API_KEY"{
"data": [
{
"time": "2025-11-17T00:00:00.000Z",
"close": 92215.14,
"sma_200": 110444.9168,
"multiple": 0.8349423647
},
{
"time": "2025-11-18T00:00:00.000Z",
"close": 92960.83,
"sma_200": 110423.543,
"multiple": 0.8418569765
}
],
"meta": {
"symbol": "BTCUSDT",
"as_of": "2026-11-16T00:00:00.000Z",
"stale": false,
"count": 2,
"next_start": "2025-11-18T00:00:00.001Z"
}
}200-Week Moving Average
The 200-week (1,400-day) moving average, how fast it is rising, and the price over it, for every coin.
Query parameters
symboloptionalOne coin only, such as BTCUSDT. Leave it out for every coin.
include_stablecoinsoptionaldefault falseStablecoins are left out of the list, as the site’s tools hide them by default; true keeps them. A coin asked for by symbol is answered either way.
Response: data
- symbol
- The trading pair.
- candle_closed_at
- The close of the coin’s newest daily candle.
- price
- That day’s close.
- days
- How many daily candles the coin has.
- ma_1400
- The 1,400-day moving average. Under 1,400 days it averages every day so far, as the site does.
- change_30d_percent
- How much the average changed over the last 30 days, in percent: the colour of the site’s 200 WMA heatmap.
- multiple
price/ma_1400.- enough_history
- At least 548 days (1.5 years).
Response: meta
- as_of
- The day the values were built for (00:00 UTC).
Updated: Daily from 00:15 UTC, after the day’s candles are stored; usually complete by 00:45.
curl "https://www.tradingdigits.io/api/v1/indicators/two-hundred-week-ma" \
-H "Authorization: Bearer $TD_API_KEY"{
"data": [
{
"symbol": "BTCUSDT",
"candle_closed_at": "2026-11-16T00:00:00.000Z",
"price": 65351.05,
"days": 5959,
"ma_1400": 67945.03271,
"change_30d_percent": 1.930053425,
"multiple": 0.9618223348,
"enough_history": true
},
{
"symbol": "ETHUSDT",
"candle_closed_at": "2026-11-16T00:00:00.000Z",
"price": 1835.35,
"days": 3378,
"ma_1400": 2556.787021,
"change_30d_percent": 0.8231085083,
"multiple": 0.7178345263,
"enough_history": true
}
],
"meta": {
"as_of": "2026-11-16T00:00:00.000Z",
"stale": false,
"count": 530
}
}200-Week Moving Average history
One coin’s daily close, its 1,400-day moving average, the average’s 30-day change and the close over it, oldest first.
Query parameters
symbolrequiredThe trading pair, such as BTCUSDT.
startoptionaldefault end − 365 daysThe first time to include: ISO 8601 or Unix milliseconds.
endoptionaldefault nowThe time to stop before (not included).
limitoptionaldefault 100Items in this page. A full page comes with meta.next_start.
Response: data
- time
- The day’s open (00:00 UTC).
- close
- The day’s close.
- ma_1400, change_30d_percent, multiple
- As in the latest values, on each day.
- On MAX: the days of the last 365 days, from 00:00 UTC that day (
meta.history_from). An earlierstart, or anendbefore then, is refused with403 not_in_plan. Pro and Dev include the full history.
Updated: Daily at about 00:05 UTC, when the day’s candle is stored.
curl "https://www.tradingdigits.io/api/v1/indicators/two-hundred-week-ma/history?symbol=BTCUSDT&limit=2" \
-H "Authorization: Bearer $TD_API_KEY"{
"data": [
{
"time": "2025-11-17T00:00:00.000Z",
"close": 92215.14,
"ma_1400": 55286.64605,
"change_30d_percent": 2.374651413,
"multiple": 1.667945998
},
{
"time": "2025-11-18T00:00:00.000Z",
"close": 92960.83,
"ma_1400": 55322.79513,
"change_30d_percent": 2.357703391,
"multiple": 1.680335019
}
],
"meta": {
"symbol": "BTCUSDT",
"as_of": "2026-11-16T00:00:00.000Z",
"stale": false,
"count": 2,
"next_start": "2025-11-18T00:00:00.001Z"
}
}Golden Ratio Multiplier
Bitcoin’s 350-day moving average and its multiples at 1.6, 2, 3, 5, 8, 13 and 21.
Query parameters
symboloptionaldefault BTCUSDTBitcoin only: leave it out, or give BTCUSDT. Any other pair is a 404.
Response: data
- symbol
- The trading pair.
- candle_closed_at
- The close of the coin’s newest daily candle.
- price
- That day’s close.
- days
- How many daily candles the coin has.
- ma_350
- The 350-day moving average.
- ma_350_x1_6, ma_350_x2, ma_350_x3, ma_350_x5, ma_350_x8, ma_350_x13, ma_350_x21
- The average times 1.6, 2, 3, 5, 8, 13 and 21.
- multiple
price/ma_350: compare it with the multipliers.- enough_history
- At least 350 days.
Response: meta
- as_of
- The day the values were built for (00:00 UTC).
- Bitcoin only: the answer is one row,
BTCUSDT.
Updated: Daily from 00:15 UTC, after the day’s candles are stored; usually complete by 00:45.
curl "https://www.tradingdigits.io/api/v1/indicators/golden-ratio-multiplier" \
-H "Authorization: Bearer $TD_API_KEY"{
"data": [
{
"symbol": "BTCUSDT",
"candle_closed_at": "2026-11-16T00:00:00.000Z",
"price": 65351.05,
"days": 5959,
"ma_350": 75366.92449,
"ma_350_x1_6": 120587.0792,
"ma_350_x2": 150733.849,
"ma_350_x3": 226100.7735,
"ma_350_x5": 376834.6224,
"ma_350_x8": 602935.3959,
"ma_350_x13": 979770.0183,
"ma_350_x21": 1582705.414,
"multiple": 0.8671051717,
"enough_history": true
}
],
"meta": {
"as_of": "2026-11-16T00:00:00.000Z",
"stale": false,
"count": 1
}
}Golden Ratio Multiplier history
Bitcoin’s daily close, 350-day moving average and its seven multiples, oldest first.
Query parameters
symboloptionaldefault BTCUSDTBitcoin only: leave it out, or give BTCUSDT. Any other pair is a 404.
startoptionaldefault end − 365 daysThe first time to include: ISO 8601 or Unix milliseconds.
endoptionaldefault nowThe time to stop before (not included).
limitoptionaldefault 100Items in this page. A full page comes with meta.next_start.
Response: data
- time
- The day’s open (00:00 UTC).
- close
- The day’s close.
- ma_350
- The 350-day moving average (every day so far until there are 350).
- ma_350_x1_6, ma_350_x2, ma_350_x3, ma_350_x5, ma_350_x8, ma_350_x13, ma_350_x21
- Its multiples.
- multiple
close/ma_350.
- The lines start on 30 July 2010, as on the site:
nullbefore. - On MAX: the days of the last 365 days, from 00:00 UTC that day (
meta.history_from). An earlierstart, or anendbefore then, is refused with403 not_in_plan. Pro and Dev include the full history.
Updated: Daily at about 00:05 UTC, when the day’s candle is stored.
curl "https://www.tradingdigits.io/api/v1/indicators/golden-ratio-multiplier/history?limit=2" \
-H "Authorization: Bearer $TD_API_KEY"{
"data": [
{
"time": "2025-11-17T00:00:00.000Z",
"close": 92215.14,
"ma_350": 102957.9225,
"ma_350_x1_6": 164732.676,
"ma_350_x2": 205915.845,
"ma_350_x3": 308873.7675,
"ma_350_x5": 514789.6126,
"ma_350_x8": 823663.3801,
"ma_350_x13": 1338452.993,
"ma_350_x21": 2162116.373,
"multiple": 0.8956585153
},
{
"time": "2025-11-18T00:00:00.000Z",
"close": 92960.83,
"ma_350": 102949.6686,
"ma_350_x1_6": 164719.4698,
"ma_350_x2": 205899.3373,
"ma_350_x3": 308849.0059,
"ma_350_x5": 514748.3431,
"ma_350_x8": 823597.349,
"ma_350_x13": 1338345.692,
"ma_350_x21": 2161943.041,
"multiple": 0.9029735721
}
],
"meta": {
"symbol": "BTCUSDT",
"as_of": "2026-11-16T00:00:00.000Z",
"stale": false,
"count": 2,
"next_start": "2025-11-18T00:00:00.001Z"
}
}Bitcoin Rainbow Chart
Which of the Rainbow Chart’s nine bands Bitcoin’s price is in, and where the bands are.
Query parameters
symboloptionaldefault BTCUSDTBitcoin only: leave it out, or give BTCUSDT. Any other pair is a 404.
Response: data
- symbol
- The trading pair.
- candle_closed_at
- The close of the coin’s newest daily candle.
- price
- That day’s close.
- days
- How many daily candles the coin has.
- band
- The band the price is in, coolest to hottest:
fire_sale,buy,accumulate,still_cheap,hodl,bubble,fomo,sell,max_bubble. Outside them:below_fire_saleorabove_max_bubble. - floor
- The lower edge of the lowest band (
fire_sale). - band_tops
- Each band’s upper edge, by name. The bands touch: a band starts at the top of the band below it.
Response: meta
- as_of
- The day the values were built for (00:00 UTC).
- The bands are a logarithmic regression fitted to Bitcoin’s whole daily price history, as on the site’s Rainbow Chart. The fit is made again every day with the new close, so the bands of a past day move a little from one day to the next.
- Bitcoin only: the answer is one row,
BTCUSDT.
Updated: Daily from 00:15 UTC, after the day’s candles are stored; usually complete by 00:45.
curl "https://www.tradingdigits.io/api/v1/indicators/rainbow" \
-H "Authorization: Bearer $TD_API_KEY"{
"data": [
{
"symbol": "BTCUSDT",
"candle_closed_at": "2026-11-16T00:00:00.000Z",
"price": 65351.05,
"days": 5959,
"band": "buy",
"floor": 44515.5099,
"band_tops": {
"fire_sale": 63805.38974,
"buy": 91454.14193,
"accumulate": 131083.9117,
"still_cheap": 187886.4264,
"hodl": 269303.1416,
"bubble": 386000.1143,
"fomo": 553265.3178,
"sell": 793011.4541,
"max_bubble": 1136646.643
}
}
],
"meta": {
"as_of": "2026-11-16T00:00:00.000Z",
"stale": false,
"count": 1
}
}Bitcoin Rainbow Chart history
Bitcoin’s daily close, the band it was in and the bands’ edges, oldest first.
Query parameters
symboloptionaldefault BTCUSDTBitcoin only: leave it out, or give BTCUSDT. Any other pair is a 404.
startoptionaldefault end − 365 daysThe first time to include: ISO 8601 or Unix milliseconds.
endoptionaldefault nowThe time to stop before (not included).
limitoptionaldefault 100Items in this page. A full page comes with meta.next_start.
Response: data
- time
- The day’s open (00:00 UTC).
- close
- The day’s close.
- band, floor, band_tops
- As in the latest values, on each day.
- Every day’s bands come from today’s fit: what the chart shows today for that day, not what it showed then.
- On MAX: the days of the last 365 days, from 00:00 UTC that day (
meta.history_from). An earlierstart, or anendbefore then, is refused with403 not_in_plan. Pro and Dev include the full history.
Updated: Daily at about 00:05 UTC, when the day’s candle is stored.
curl "https://www.tradingdigits.io/api/v1/indicators/rainbow/history?limit=2" \
-H "Authorization: Bearer $TD_API_KEY"{
"data": [
{
"time": "2025-11-17T00:00:00.000Z",
"close": 92215.14,
"band": "accumulate",
"floor": 33136.11778,
"band_tops": {
"fire_sale": 47494.9723,
"buy": 68075.94084,
"accumulate": 97575.24843,
"still_cheap": 139857.4737,
"hodl": 200461.8309,
"bubble": 287327.8387,
"fomo": 411835.4429,
"sell": 590295.8542,
"max_bubble": 846088.4112
}
},
{
"time": "2025-11-18T00:00:00.000Z",
"close": 92960.83,
"band": "accumulate",
"floor": 33163.89266,
"band_tops": {
"fire_sale": 47534.78286,
"buy": 68133.00248,
"accumulate": 97657.03656,
"still_cheap": 139974.703,
"hodl": 200629.8592,
"bubble": 287568.6786,
"fomo": 412180.6457,
"sell": 590790.6436,
"max_bubble": 846797.6073
}
}
],
"meta": {
"symbol": "BTCUSDT",
"as_of": "2026-11-16T00:00:00.000Z",
"stale": false,
"count": 2,
"next_start": "2025-11-18T00:00:00.001Z"
}
}Bitcoin Power Law
The Bitcoin Power Law model’s three lines today, and the price against its mid line.
Query parameters
symboloptionaldefault BTCUSDTBitcoin only: leave it out, or give BTCUSDT. Any other pair is a 404.
Response: data
- symbol
- The trading pair.
- candle_closed_at
- The close of the coin’s newest daily candle.
- price
- That day’s close.
- days
- How many daily candles the coin has.
- mid
- The model’s mid line on the newest closed day.
- upper, lower
- Its upper and lower lines.
- multiple
price/mid.
Response: meta
- as_of
- The day the values were built for (00:00 UTC).
- The model is a fixed function of the days since Bitcoin’s first block (3 January 2009), as the site’s Power Law page draws it: a day’s lines never change.
- Bitcoin only: the answer is one row,
BTCUSDT.
Updated: Daily from 00:15 UTC, after the day’s candles are stored; usually complete by 00:45.
curl "https://www.tradingdigits.io/api/v1/indicators/power-law" \
-H "Authorization: Bearer $TD_API_KEY"{
"data": [
{
"symbol": "BTCUSDT",
"candle_closed_at": "2026-11-16T00:00:00.000Z",
"price": 65351.05,
"days": 5959,
"mid": 190830.4354,
"upper": 682377.667,
"lower": 62019.8915,
"multiple": 0.3424561175
}
],
"meta": {
"as_of": "2026-11-16T00:00:00.000Z",
"stale": false,
"count": 1
}
}Bitcoin Power Law history
Bitcoin’s daily close and the Power Law model’s three lines on each day, oldest first.
Query parameters
symboloptionaldefault BTCUSDTBitcoin only: leave it out, or give BTCUSDT. Any other pair is a 404.
startoptionaldefault end − 365 daysThe first time to include: ISO 8601 or Unix milliseconds.
endoptionaldefault nowThe time to stop before (not included).
limitoptionaldefault 100Items in this page. A full page comes with meta.next_start.
Response: data
- time
- The day’s open (00:00 UTC).
- close
- The day’s close.
- mid, upper, lower, multiple
- The model’s lines on the day, and
close/mid.
- On MAX: the days of the last 365 days, from 00:00 UTC that day (
meta.history_from). An earlierstart, or anendbefore then, is refused with403 not_in_plan. Pro and Dev include the full history.
Updated: Daily at about 00:05 UTC, when the day’s candle is stored.
curl "https://www.tradingdigits.io/api/v1/indicators/power-law/history?limit=2" \
-H "Authorization: Bearer $TD_API_KEY"{
"data": [
{
"time": "2025-11-17T00:00:00.000Z",
"close": 92215.14,
"mid": 136566.914,
"upper": 514156.8178,
"lower": 44384.24703,
"multiple": 0.6752377812
},
{
"time": "2025-11-18T00:00:00.000Z",
"close": 92960.83,
"mid": 136696.5083,
"upper": 514569.5682,
"lower": 44426.36519,
"multiple": 0.6800527033
}
],
"meta": {
"symbol": "BTCUSDT",
"as_of": "2026-11-16T00:00:00.000Z",
"stale": false,
"count": 2,
"next_start": "2025-11-18T00:00:00.001Z"
}
}AHR999 Index
Bitcoin’s AHR999 Index: price against its 200-day average and a long-term growth curve, and its zone.
Query parameters
symboloptionaldefault BTCUSDTBitcoin only: leave it out, or give BTCUSDT. Any other pair is a 404.
Response: data
- symbol
- The trading pair.
- candle_closed_at
- The close of the coin’s newest daily candle.
- price
- That day’s close.
- days
- How many daily candles the coin has.
- ahr999
price² / (sma_200×growth_price), as the site’s AHR999 page computes it.- sma_200
- The average of the last 200 daily closes, the newest included.
- growth_price
- The growth curve 10^(5.84 × log10(days since 3 January 2009) − 17.01).
- zone
accumulation(below 0.45),top(above 4) orbetween: the zones the site’s chart shades.
Response: meta
- as_of
- The day the values were built for (00:00 UTC).
- The published AHR999 divides by the 200-day dollar-cost-averaging cost; the site, and this endpoint, by the plain 200-day average.
- Bitcoin only: the answer is one row,
BTCUSDT.
Updated: Daily from 00:15 UTC, after the day’s candles are stored; usually complete by 00:45.
curl "https://www.tradingdigits.io/api/v1/indicators/ahr999" \
-H "Authorization: Bearer $TD_API_KEY"{
"data": [
{
"symbol": "BTCUSDT",
"candle_closed_at": "2026-11-16T00:00:00.000Z",
"price": 65351.05,
"days": 5959,
"ahr999": 0.3163444046,
"sma_200": 72978.4725,
"growth_price": 184990.8353,
"zone": "accumulation"
}
],
"meta": {
"as_of": "2026-11-16T00:00:00.000Z",
"stale": false,
"count": 1
}
}AHR999 Index history
Bitcoin’s daily close and its AHR999 Index on each day, oldest first.
Query parameters
symboloptionaldefault BTCUSDTBitcoin only: leave it out, or give BTCUSDT. Any other pair is a 404.
startoptionaldefault end − 365 daysThe first time to include: ISO 8601 or Unix milliseconds.
endoptionaldefault nowThe time to stop before (not included).
limitoptionaldefault 100Items in this page. A full page comes with meta.next_start.
Response: data
- time
- The day’s open (00:00 UTC).
- close
- The day’s close.
- ahr999, sma_200, growth_price, zone
- As in the latest values, on each day (
nullfor the first 199 days).
- On MAX: the days of the last 365 days, from 00:00 UTC that day (
meta.history_from). An earlierstart, or anendbefore then, is refused with403 not_in_plan. Pro and Dev include the full history.
Updated: Daily at about 00:05 UTC, when the day’s candle is stored.
curl "https://www.tradingdigits.io/api/v1/indicators/ahr999/history?limit=2" \
-H "Authorization: Bearer $TD_API_KEY"{
"data": [
{
"time": "2025-11-17T00:00:00.000Z",
"close": 92215.14,
"ahr999": 0.5815245978,
"sma_200": 110423.543,
"growth_price": 132426.4366,
"zone": "between"
},
{
"time": "2025-11-18T00:00:00.000Z",
"close": 92960.83,
"ahr999": 0.5905127321,
"sma_200": 110403.9114,
"growth_price": 132551.9923,
"zone": "between"
}
],
"meta": {
"symbol": "BTCUSDT",
"as_of": "2026-11-16T00:00:00.000Z",
"stale": false,
"count": 2,
"next_start": "2025-11-18T00:00:00.001Z"
}
}Puell Multiple
Bitcoin’s Puell Multiple: the value of the day’s new coins against its one-year average, and its zone.
Query parameters
symboloptionaldefault BTCUSDTBitcoin only: leave it out, or give BTCUSDT. Any other pair is a 404.
Response: data
- symbol
- The trading pair.
- candle_closed_at
- The close of the coin’s newest daily candle.
- price
- That day’s close.
- days
- How many daily candles the coin has.
- puell_multiple
issuance_usd/issuance_usd_ma_365, as the site’s Puell Multiple page computes it.- issuance_btc
- The BTC mined that day: the supply after the day’s last block less the day before’s (block subsidies; a halving inside a day is exact).
- issuance_usd
issuance_btc× the day’s close.- issuance_usd_ma_365
- The average of
issuance_usdover the 365 days ending that day, the day included. - zone
accumulation(below 0.6),top(above 3.5) orbetween: the zones the site’s chart shades (its green band starts at 0.3).
Response: meta
- as_of
- The end of the newest day with a value (00:00 UTC).
- A day counts once both its close (00:05 UTC) and its supply (about 01:15 UTC, from block heights) are stored: until then the newest value is the day before’s, and
candle_closed_atsays which day it is. - Bitcoin only: the answer is one row,
BTCUSDT.
Updated: Daily at about 01:15 UTC, for the day before.
curl "https://www.tradingdigits.io/api/v1/indicators/puell-multiple" \
-H "Authorization: Bearer $TD_API_KEY"{
"data": [
{
"symbol": "BTCUSDT",
"candle_closed_at": "2026-11-16T00:00:00.000Z",
"price": 65351.05,
"days": 5959,
"puell_multiple": 1.034657868,
"issuance_btc": 537.5,
"issuance_usd": 35126189.38,
"issuance_usd_ma_365": 33949569.66,
"zone": "between"
}
],
"meta": {
"as_of": "2026-11-16T00:00:00.000Z",
"stale": false,
"count": 1
}
}Puell Multiple history
Bitcoin’s daily close, its issuance and its Puell Multiple on each day, oldest first.
Query parameters
symboloptionaldefault BTCUSDTBitcoin only: leave it out, or give BTCUSDT. Any other pair is a 404.
startoptionaldefault end − 365 daysThe first time to include: ISO 8601 or Unix milliseconds.
endoptionaldefault nowThe time to stop before (not included).
limitoptionaldefault 100Items in this page. A full page comes with meta.next_start.
Response: data
- time
- The day’s open (00:00 UTC).
- close
- The day’s close.
- puell_multiple, issuance_btc, issuance_usd, issuance_usd_ma_365, zone
- As in the latest values, on each day. Days from 15 October 2010; the multiple from 14 October 2011 (
nullbefore, as is the average). The days of 3–9 August 2016 have no close and no row.
- On MAX: the days of the last 365 days, from 00:00 UTC that day (
meta.history_from). An earlierstart, or anendbefore then, is refused with403 not_in_plan. Pro and Dev include the full history.
Updated: Daily at about 01:15 UTC, for the day before.
curl "https://www.tradingdigits.io/api/v1/indicators/puell-multiple/history?limit=2" \
-H "Authorization: Bearer $TD_API_KEY"{
"data": [
{
"time": "2025-11-17T00:00:00.000Z",
"close": 92215.14,
"puell_multiple": 0.7628493896,
"issuance_btc": 387.5,
"issuance_usd": 35733366.75,
"issuance_usd_ma_365": 46841968.07,
"zone": "between"
},
{
"time": "2025-11-18T00:00:00.000Z",
"close": 92960.83,
"puell_multiple": 0.8250976432,
"issuance_btc": 415.625,
"issuance_usd": 38636844.97,
"issuance_usd_ma_365": 46826997.13,
"zone": "between"
}
],
"meta": {
"symbol": "BTCUSDT",
"as_of": "2026-11-16T00:00:00.000Z",
"stale": false,
"count": 2,
"next_start": "2025-11-18T00:00:00.001Z"
}
}Bitcoin network
Hashrate, difficulty and supply
Bitcoin’s hashrate, difficulty and supply every day, oldest first, computed from the blockchain.
Query parameters
startoptionaldefault end − 365 daysThe first time to include: ISO 8601 or Unix milliseconds.
endoptionaldefault nowThe time to stop before (not included).
limitoptionaldefault 100Items in this page. A full page comes with meta.next_start.
Response: data
- time
- The day’s open (00:00 UTC). A day holds the blocks after the last block before its open, up to the last block before its end (by block time).
- hashrate
- Hashes a second: the work of the day’s blocks (each block’s difficulty × 2³²) over the day’s 86,400 seconds.
- difficulty
- The difficulty of the day’s last block (at 4 decimal places).
- supply
- Bitcoin issued through the day’s last block, the genesis block’s 50 BTC included (the issuance schedule).
Response: meta
- as_of
- The end of the newest day.
- From January 2009. A day’s hashrate is an estimate from the blocks found that day, so it moves a lot from one day to the next: average it over a week or a month for the trend.
- On MAX: the days of the last 365 days, from 00:00 UTC that day (
meta.history_from). An earlierstart, or anendbefore then, is refused with403 not_in_plan. Pro and Dev include the full history.
Updated: Daily at about 01:15 UTC, for the day before.
curl "https://www.tradingdigits.io/api/v1/bitcoin/network?limit=2" \
-H "Authorization: Bearer $TD_API_KEY"{
"data": [
{
"time": "2025-11-17T00:00:00.000Z",
"hashrate": 938612125089000000000,
"difficulty": 152271405447597.4,
"supply": 19950262.5
},
{
"time": "2025-11-18T00:00:00.000Z",
"hashrate": 1.00673719868e+21,
"difficulty": 152271405447597.4,
"supply": 19950678.125
}
],
"meta": {
"as_of": "2026-11-16T00:00:00.000Z",
"stale": false,
"count": 2,
"next_start": "2025-11-18T00:00:00.001Z"
}
}Good practice
- Leave out
symbolto get every coin in one request: one request for the whole market costs far less than one per coin. - Ask no more often than the data changes (see When data updates). A screener changes once per candle: ask about a minute after the close and compare
meta.as_ofwith the one you have. - On a 429 or 503, wait the
Retry-Afterseconds before trying again. - Use one key per app or server, so you can revoke one without stopping the others.
Frequently asked questions
Is there a liquidation heatmap API?
Yes, on Dev: three endpoints give the liquidation heatmap of every Binance USDT-M perpetual as data, for 24 hours, 3, 7 or 30 days, updated every minute: the full grid (340 price bands across time, with each column's price candle), the liquidation levels standing now, and the largest liquidation clusters over the period (standing, swept or faded). Values are estimated liquidation amounts in USD. AI assistants read them through the MCP server.
Can I use the data in ChatGPT, Claude or Cursor?
Yes, on Dev: add our MCP server, https://www.tradingdigits.io/api/mcp/v1, to the app and sign in with your Trading Digits account, or give it a Dev API key where the app takes one. The assistant then reads the data as tools, and each tool call counts as one request.
How do I get an API key?
Choose a paid plan, then create a key on your account page. The key is shown once, when it is made: store it safely. You can revoke it, and make others, at any time.
Why do I get 401 although my key is right?
Use the base URL https://www.tradingdigits.io exactly, with www. The address without www redirects to it, and HTTP clients drop the Authorization header when a redirect changes the host, so the request arrives without a key.
Can I call the API from a web page?
Not with your key in the page: anyone who opens it can read the key. Call the API from your server or your scripts, and pass on only what the page needs.
How do I get every coin at once?
Leave out the symbol parameter: the list endpoints (screeners, open interest, funding, the visual screener, market performance, the latest daily indicators) answer for the whole market in one request, which costs far less than one request per coin.
How do I read a long history?
Ask for a range with start and end. A request returns 100 items, or up to 1,000 with limit; a full page carries meta.next_start, the start of the next page, and the last page has null there.
What counts as a request?
Every request that passes the key check, including those answered with 400, 404 or 503 (a liquidation heatmap request answered with 503 excepted). Requests refused with 401, 403 or 429 do not count. Limits count per account, not per key.
What does meta.stale mean?
It is true when newer data should have arrived by now and has not. The answer is still the newest data there is; the When data updates table shows when each dataset turns stale.
What time zone are times in?
UTC. Times go out as ISO 8601 and come in as ISO 8601 or Unix time in milliseconds; a number that looks like seconds is refused.
Which plan includes the liquidation heatmap?
Dev. Its three endpoints count as ordinary requests; when the heatmap is busy, a request is answered 503 with Retry-After and does not count.
What happens when the monthly quota runs out?
Requests are answered with 429 monthly_quota_exceeded until the quota starts over on the 1st at 00:00 UTC. Moving up to a larger plan raises the quota as soon as it is paid.
Questions or problems: contact@tradingdigits.io.
Changelog
Changes to the API and the MCP server, newest first.
- The Data API (v1) and its MCP server are available on every paid plan.