面向 AI 智能体的代币经济 API
一个 API 获取每个资产的供应与估值：流通量、总供应量与最大供应量、市值与完全稀释估值，以及总市值、成交量与 BTC、ETH 市占率。无需再对照其他市值网站：这些数据与您的市场数据使用同一密钥、同一格式。
每个资产的供应量及由此得出的市值与完全稀释估值，以及全市场状况。代币经济接口需要 ?symbol=；全球市场接口则不需要。全球市场计入“市场”市场数据族（价格与成交量），而不是代币经济：凡包含市场数据的方案均可使用。
#面向 AI 智能体与 LLM 的代币经济数据
“SOL 的完全稀释估值是多少？”“XRP 的供应有多少在流通？”“比特币今天的市占率是多少？”：AI 智能体通过 MCP 工具 get_pair_data 回答单个资产的问题，通过 get_market_overview 回答全市场的问题。
{
"name": "get_pair_data",
"arguments": {
"symbol": "SOLUSDT",
"fields": ["tokenomics"]
}
}- 给 LLM 的提示：FDV 不是市值：它按最大供应量估值，无上限时按总供应量，稳定币上为
null。 - 给开发者：
/v1/tokenomics与/v1/global可作为你自己 AI 智能体（tool calling）的两个工具：一个针对单个资产，一个针对全市场。 - 适用环境：Claude、ChatGPT、Cursor 及任何 MCP 客户端，包括支持 MCP 的 AI 智能体框架，如 LangChain 或 n8n。
通过 MCP 服务器指南接入你的 AI 智能体，或用开源的 Agent Skills 教它使用 BytNode。
#代币经济与全球市场
此接口的全部 8 个字段（取自接口契约）
time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Point-in-time value: the instant of the measurement (when the source was read). |
circulating_supply | coins | Coins in circulation. |
total_supply | coins | Total coins issued (circulating + locked), net of burns. |
max_supply | coins | Hard cap on supply. `null` = no cap. |
price_usd | USD | Price used for market_cap_usd and fdv_usd: the close of the latest closed one-minute candle (the USDT price of the pair, read as USD), refreshed every minute. Not the latest trade price: that is the `price` of `/v1/price-change`, i.e. the close of `/v1/klines?live=1`. |
priced_at | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Instant of `price_usd` (the row's `time` is the instant of the supply data). `null` when the price is the stablecoin peg. |
market_cap_usd | USD | circulating_supply × current price, in USD, derived at request time. |
fdv_usd | USD | Fully diluted valuation: max_supply (or total_supply if uncapped) × price. `null` for stablecoins. |
此接口的全部 8 个字段（取自接口契约）
time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | The day the value refers to, at midnight UTC. |
price_usd | USD | Daily closing price used for the derived values. |
circulating_supply | coins | Coins in circulation. |
total_supply | coins | Total coins issued (circulating + locked), net of burns. |
max_supply | coins | Hard cap on supply. `null` = no cap. |
market_cap_usd | USD | circulating_supply × current price, in USD, derived at request time. |
fdv_usd | USD | Fully diluted valuation: max_supply (or total_supply if uncapped) × price. `null` for stablecoins. |
is_closed | `true` = the row is final; `false` = provisional: the latest bucket while it still settles (a few seconds after its end, e.g. a candle whose volumes are not final yet), or the period in progress with `?live=1` on the routes that take it. Exception, rare: when a venue delivers trades LATE (seconds to minutes, e.g. during a burst), a closed row built from trades (trade candles, candle volumes, CVD, buy/sell ratio, trades per second) is corrected afterwards to include them, usually within minutes and at most one hour later; the correction only adds the late trades. |
资产的供应及由此得出的数据。这是本页唯一需要 ?symbol= 的市场数据族。
| 字段 | 类型 | 说明 |
|---|---|---|
circulating_supply | float | 流通供应量。 |
total_supply | float | 已发行总量。 |
max_supply | float | null | 供应上限（如有）。 |
price_usd | float | 计算所用的基准价格，以美元计。 |
priced_at | string | null | price_usd 的时间点（time 是供应数据的时间点）；当价格为稳定币锚定价时为 null。 |
market_cap_usd | float | 市值，按需计算（供应量乘以价格），从不直接照搬第三方数据。 |
fdv_usd | float | null | 完全稀释估值。没有上限时按总供应计算；稳定币为 null。 |
此接口的全部 7 个字段（取自接口契约）
time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | Point-in-time value: the instant the source states for its measurement (often the last millisecond of its minute, `…:59.999Z`). |
market_cap_total_usd | USD | Total crypto market capitalisation. |
volume_total_usd | USD | Total traded volume, USD. |
btc_dominance_pct | percent (58.5 = 58.5 %) | Bitcoin share of the total market cap. |
eth_dominance_pct | percent (58.5 = 58.5 %) | Ether share of the total market cap. |
others_dominance_pct | percent (58.5 = 58.5 %) | Share of every other asset. |
active_cryptocurrency_count | count | Number of tracked crypto assets. |
此接口的全部 8 个字段（取自接口契约）
time | ISO 8601 UTC, milliseconds (2026-09-28T14:00:00.000Z) | The instant the source states for each measurement. |
market_cap_total_usd | USD | Total crypto market capitalisation. |
volume_total_usd | USD | Total traded volume, USD. |
btc_dominance_pct | percent (58.5 = 58.5 %) | Bitcoin share of the total market cap. |
eth_dominance_pct | percent (58.5 = 58.5 %) | Ether share of the total market cap. |
others_dominance_pct | percent (58.5 = 58.5 %) | Share of every other asset. |
active_cryptocurrency_count | count | Number of tracked crypto assets. |
is_closed | `true` = the row is final; `false` = provisional: the latest bucket while it still settles (a few seconds after its end, e.g. a candle whose volumes are not final yet), or the period in progress with `?live=1` on the routes that take it. Exception, rare: when a venue delivers trades LATE (seconds to minutes, e.g. during a burst), a closed row built from trades (trade candles, candle volumes, CVD, buy/sell ratio, trades per second) is corrected afterwards to include them, usually within minutes and at most one hour later; the correction only adds the late trades. |
| 字段 | 类型 | 说明 |
|---|---|---|
market_cap_total_usd | float | 全市场市值。 |
volume_total_usd | float | 24 小时成交量。 |
btc_dominance_pct / eth_dominance_pct | float | 两大主要资产的占比，以百分比表示：58.5 表示 58.5%。 |
others_dominance_pct | float | null | 其余部分，推算得出：100 减去两者。任一缺失时为 null。 |
active_cryptocurrency_count | integer | 上市资产数量。 |
/v1/global/history 默认每次数据源发布返回一行，节奏不固定；?timeframe=1h、4h 或 1d 则保留每个已收盘 bucket 的最后一个值，时间为 bucket 的开始时刻。