端点目录：MCP 工具背后的接口
所有可调用的接口都在这一页。每个接口的参数读取自 OpenAPI 契约，因此不会与实际服务脱节。详细内容（响应字段、单位、注意事项）在每节开头链接的市场数据族页面中，也在交互式参考中。
主机：https://api.bytnode.com。每个接口都需要 X-API-KEY 请求头（/v1/health 除外），并支持 ?fields=（/v1/health、/v1/status 与 POST /v1/indicators 除外，它们以其他方式选择输出）。参数列会在接口接受时列出 symbol；整体市场类接口（宏观、链上、ETF、全球市场、情绪、系统）不接受该参数，传入会被拒绝。
AI 智能体不需要这份目录：它会发现 MCP 服务器的十一个工具，阅读其描述，并通过它们调用这些接口。
#系统与元数据
| 接口 | 说明 | 参数 | 市场数据族 |
|---|---|---|---|
GET /v1/health no key | API 是否正常响应。 | — | — |
GET /v1/status | 各数据流的新鲜度，逐一列出。 | — | price_volume |
GET /v1/symbols | 已启用的交易对。 | — | price_volume |
GET /v1/capabilities | 该交易对能计算什么、不能计算什么。 | symbol (required) | price_volume |
GET /v1/limits | 你的密钥能做什么：市场数据族、历史窗口、剩余速率和配额。 | — | — |
POST /v1/ws/token | 供网页使用的短期 WebSocket 令牌：60 秒、一个连接，绝不暴露你的密钥。 | — | — |
#快照
| 接口 | 说明 | 参数 | 市场数据族 |
|---|---|---|---|
GET /v1/snapshot | 一次请求最多 52 个字段。 | one parameter per field (value = depth or true) | snapshot |
#价格与成交量
| 接口 | 说明 | 参数 | 市场数据族 |
|---|---|---|---|
GET /v1/klines | 最近一根已收盘的 OHLCV K 线，周期从 1m 到 1w。 | timeframe (required), live, symbol (required) | price_volume |
GET /v1/klines/history | OHLCV K 线，周期从 1m 到 1w，从新到旧。 | timeframe (required), since_ms, until_ms, limit, symbol (required), before_ms, order | price_volume |
GET /v1/price-change | 八个周期的涨跌幅（%）。 | symbol (required) | price_volume |
GET /v1/trades/spot | 逐笔现货成交。 | limit, since_ms, until_ms, before_ms, after_id, order, symbol (required) | trades |
GET /v1/trades/futures | 逐笔期货成交。 | limit, since_ms, until_ms, before_ms, after_id, order, symbol (required) | trades |
GET /v1/trades/large | 大额订单，按金额筛选。 | min_usd, limit, since_ms, until_ms, before_ms, after_id, order, symbol (required) | trades |
GET /v1/trades-kline/futures/seconds | 按秒聚合的期货成交，覆盖所有交易所。 | limit, since_ms, until_ms, order, symbol (required), before_ms | trades |
GET /v1/trades-kline | 成交 K 线，现货与期货合计。 | symbol (required), timeframe (required), live | microstructure |
GET /v1/trades-kline/history | 成交 K 线的历史。 | symbol (required), timeframe (required), since_ms, until_ms, limit, before_ms, order | microstructure |
GET /v1/trades-kline/spot | 成交 K 线，仅现货。 | symbol (required), timeframe (required), live | microstructure |
GET /v1/trades-kline/spot/history | 现货历史。 | symbol (required), timeframe (required), since_ms, until_ms, limit, before_ms, order | microstructure |
GET /v1/trades-kline/futures | 成交 K 线，仅期货。 | symbol (required), timeframe (required), live | microstructure |
GET /v1/trades-kline/futures/history | 期货历史。 | symbol (required), timeframe (required), since_ms, until_ms, limit, before_ms, order | microstructure |
#衍生品
| 接口 | 说明 | 参数 | 市场数据族 |
|---|---|---|---|
GET /v1/oi | 当前持仓量，各交易所合计。 | symbol (required) | derivatives |
GET /v1/oi/history | 聚合持仓量，按 bucket。 | since_ms, until_ms, limit, timeframe (required), symbol (required), before_ms, order | derivatives |
GET /v1/oi/change | 持仓量变化。 | symbol (required) | derivatives |
GET /v1/oi/change/history | 持仓量变化的历史。 | since_ms, until_ms, limit, timeframe (required), symbol (required), before_ms, order | derivatives |
GET /v1/funding/rate | 最近一次适用的资金费率。 | live, symbol (required) | derivatives |
GET /v1/funding/rate/history | 已适用费率的历史。 | since_ms, until_ms, limit, symbol (required), before_ms, order | derivatives |
GET /v1/funding/next | 下一次预估资金费率。 | symbol (required) | derivatives |
GET /v1/funding/cumulative | 24 小时累计资金费率。 | symbol (required) | derivatives |
GET /v1/funding/cumulative/history | 累计资金费率的历史。 | since_ms, until_ms, limit, symbol (required), before_ms, order | derivatives |
GET /v1/liquidations/events | 逐笔爆仓。 | limit, min_usd, symbol (required) | derivatives |
GET /v1/liquidations/cumulative | 累计爆仓，多头对空头。 | symbol (required) | derivatives |
GET /v1/liquidations/cumulative/history | 累计爆仓的历史。 | since_ms, until_ms, limit, timeframe (required), symbol (required), before_ms, order | derivatives |
GET /v1/liquidations/big-small-ratio | 大额爆仓对小额爆仓。 | timeframe (required), symbol (required) | derivatives |
GET /v1/liquidations/big-small-ratio/history | 比率的历史。 | since_ms, until_ms, limit, timeframe (required), symbol (required), before_ms, order | derivatives |
GET /v1/basis | 期货与现货的价差。 | symbol (required) | derivatives |
GET /v1/basis/history | 基差的历史。 | since_ms, until_ms, limit, timeframe (required), symbol (required), before_ms, order | derivatives |
GET /v1/spread/interexchange | 各交易所相对基准的溢价。 | timeframe (required), live, symbol (required) | microstructure |
GET /v1/spread/interexchange/history | 溢价的历史。 | timeframe (required), since_ms, until_ms, limit, symbol (required), before_ms, order | microstructure |
#资金流与微观结构
| 接口 | 说明 | 参数 | 市场数据族 |
|---|---|---|---|
GET /v1/cvd | 累计成交量差，现货与期货合计。 | timeframe (required), live, symbol (required) | microstructure |
GET /v1/cvd/history | CVD 的历史，现货与期货合计。 | timeframe (required), since_ms, until_ms, limit, symbol (required), before_ms, order | microstructure |
GET /v1/cvd/spot | 累计成交量差，仅现货。 | timeframe (required), live, symbol (required) | microstructure |
GET /v1/cvd/spot/history | CVD 的历史，仅现货。 | timeframe (required), since_ms, until_ms, limit, symbol (required), before_ms, order | microstructure |
GET /v1/cvd/futures | 累计成交量差，仅期货。 | timeframe (required), live, symbol (required) | microstructure |
GET /v1/cvd/futures/history | CVD 的历史，仅期货。 | timeframe (required), since_ms, until_ms, limit, symbol (required), before_ms, order | microstructure |
GET /v1/orderbook | 按价格区间的订单簿深度，现货与期货合计。 | timeframe (required), symbol (required) | microstructure |
GET /v1/orderbook/history | 订单簿的历史，现货与期货合计。 | timeframe (required), since_ms, until_ms, limit, symbol (required), before_ms, order | microstructure |
GET /v1/orderbook/spot | 按价格区间的订单簿深度，仅现货。 | timeframe (required), symbol (required) | microstructure |
GET /v1/orderbook/spot/history | 订单簿的历史，仅现货。 | timeframe (required), since_ms, until_ms, limit, symbol (required), before_ms, order | microstructure |
GET /v1/orderbook/futures | 按价格区间的订单簿深度，仅期货。 | timeframe (required), symbol (required) | microstructure |
GET /v1/orderbook/futures/history | 订单簿的历史，仅期货。 | timeframe (required), since_ms, until_ms, limit, symbol (required), before_ms, order | microstructure |
GET /v1/buy-sell-ratio | 最近一个已收盘分桶的买卖比，现货与期货合计。 | timeframe (required), symbol (required) | microstructure |
GET /v1/buy-sell-ratio/history | 买卖比的历史，现货与期货合计。 | since_ms, until_ms, limit, timeframe (required), symbol (required), before_ms, order | microstructure |
GET /v1/buy-sell-ratio/spot | 最近一个已收盘分桶的买卖比，仅现货。 | timeframe (required), symbol (required) | microstructure |
GET /v1/buy-sell-ratio/spot/history | 买卖比的历史，仅现货。 | since_ms, until_ms, limit, timeframe (required), symbol (required), before_ms, order | microstructure |
GET /v1/buy-sell-ratio/futures | 最近一个已收盘分桶的买卖比，仅期货。 | timeframe (required), symbol (required) | microstructure |
GET /v1/buy-sell-ratio/futures/history | 买卖比的历史，仅期货。 | since_ms, until_ms, limit, timeframe (required), symbol (required), before_ms, order | microstructure |
GET /v1/trades/avg-size | 平均成交规模，现货与期货合计。 | timeframe (required), symbol (required) | microstructure |
GET /v1/trades/avg-size/history | 平均规模的历史，现货与期货合计。 | since_ms, until_ms, limit, timeframe (required), symbol (required), before_ms, order | microstructure |
GET /v1/trades/avg-size/spot | 平均成交规模，仅现货。 | timeframe (required), symbol (required) | microstructure |
GET /v1/trades/avg-size/spot/history | 平均规模的历史，仅现货。 | since_ms, until_ms, limit, timeframe (required), symbol (required), before_ms, order | microstructure |
GET /v1/trades/avg-size/futures | 平均成交规模，仅期货。 | timeframe (required), symbol (required) | microstructure |
GET /v1/trades/avg-size/futures/history | 平均规模的历史，仅期货。 | since_ms, until_ms, limit, timeframe (required), symbol (required), before_ms, order | microstructure |
#技术指标
| 接口 | 说明 | 参数 | 市场数据族 |
|---|---|---|---|
POST /v1/indicators | 十九种指标，每次调用最多 50 个实例。 | — | indicators |
#期权
| 接口 | 说明 | 参数 | 市场数据族 |
|---|---|---|---|
GET /v1/options/summary | 该资产的概览。 | asset (required) | options |
GET /v1/options/oi | 期权持仓量。 | asset (required) | options |
GET /v1/options/oi/history | 持仓量的历史。 | timeframe (required), since_ms, until_ms, limit, asset (required), before_ms, order | options |
GET /v1/options/oi/change | 持仓量变化。 | timeframe (required), asset (required) | options |
GET /v1/options/oi/change/history | 变化量的历史。 | timeframe (required), since_ms, until_ms, limit, asset (required), before_ms, order | options |
GET /v1/options/oi/distribution | 按行权价和到期日划分的持仓分布。 | expiry, asset (required) | options |
GET /v1/options/volume | 期权成交量（美元）。 | asset (required) | options |
GET /v1/options/volume/history | 成交量的历史。 | timeframe (required), since_ms, until_ms, limit, asset (required), before_ms, order | options |
GET /v1/options/put-call-ratio | 看跌 / 看涨比率。 | asset (required) | options |
GET /v1/options/put-call-ratio/history | 看跌 / 看涨比率的历史。 | timeframe (required), since_ms, until_ms, limit, asset (required), before_ms, order | options |
GET /v1/options/max-pain | 各到期日的最大痛点。 | asset (required) | options |
GET /v1/options/max-pain/history | 最大痛点的历史。 | expiry (required), since_ms, until_ms, limit, asset (required), before_ms, order | options |
GET /v1/options/iv | 加权隐含波动率。 | asset (required) | options |
GET /v1/options/iv/klines | 隐含波动率最近一根已收盘的 OHLC K 线。 | timeframe (required), asset (required) | options |
GET /v1/options/iv/klines/history | 隐含波动率的 OHLC K 线，从新到旧。 | timeframe (required), since_ms, until_ms, limit, asset (required), before_ms, order | options |
GET /v1/options/greeks | 聚合希腊值。 | asset (required) | options |
GET /v1/options/expiry | 按到期日汇总。 | asset (required) | options |
#比特币网络
| 接口 | 说明 | 参数 | 市场数据族 |
|---|---|---|---|
GET /v1/btc/network | 区块高度、难度、下次调整。 | — | onchain |
GET /v1/btc/network/history | 网络历史。 | since_ms, until_ms, limit, before_ms, order | onchain |
GET /v1/btc/mempool | 待确认交易、权重、手续费。 | — | onchain |
GET /v1/btc/mempool/history | 内存池历史。 | since_ms, until_ms, limit, before_ms, order | onchain |
GET /v1/btc/fees | 按优先级的推荐手续费。 | — | onchain |
GET /v1/btc/fees/history | 手续费的历史。 | since_ms, until_ms, limit, timeframe, before_ms, order | onchain |
GET /v1/btc/mining | 矿池集中度、区块奖励。 | — | onchain |
GET /v1/btc/mining/history | 挖矿历史。 | dataset, since_ms, until_ms, limit, before_ms, order | onchain |
#比特币链上估值
| 接口 | 说明 | 参数 | 市场数据族 |
|---|---|---|---|
GET /v1/btc/mvrv | MVRV 及估值区间。 | — | onchain |
GET /v1/btc/mvrv/history | MVRV 历史。 | since_ms, until_ms, limit, before_ms, order | onchain |
GET /v1/btc/nvt | NVT 及其平滑信号。 | — | onchain |
GET /v1/btc/nvt/history | NVT 历史。 | since_ms, until_ms, limit, before_ms, order | onchain |
GET /v1/btc/active-addresses | 活跃地址及动量。 | — | onchain |
GET /v1/btc/active-addresses/history | 活跃地址的历史。 | since_ms, until_ms, limit, before_ms, order | onchain |
GET /v1/btc/revenue-per-difficulty | 矿工压力。 | — | onchain |
GET /v1/btc/revenue-per-difficulty/history | 矿工压力的历史。 | since_ms, until_ms, limit, before_ms, order | onchain |
#以太坊链上
| 接口 | 说明 | 参数 | 市场数据族 |
|---|---|---|---|
GET /v1/eth/supply | 供应、质押、销毁、净发行。 | — | onchain |
GET /v1/eth/supply/history | 供应的历史。 | since_ms, until_ms, limit, before_ms, order | onchain |
GET /v1/eth/gas | Gas 价格与拥堵。 | — | onchain |
GET /v1/eth/gas/history | Gas 的历史。 | since_ms, until_ms, limit, before_ms, order | onchain |
GET /v1/eth/gas-momentum | Gas 动量与状态。 | — | onchain |
GET /v1/eth/gas-momentum/history | 动量的历史。 | since_ms, until_ms, limit, before_ms, order | onchain |
GET /v1/eth/staking | 质押率与收益。 | — | onchain |
GET /v1/eth/staking/history | 质押的历史。 | since_ms, until_ms, limit, before_ms, order | onchain |
GET /v1/eth/deflation | 销毁对发行。 | — | onchain |
GET /v1/eth/deflation/history | 通缩的历史。 | since_ms, until_ms, limit, before_ms, order | onchain |
GET /v1/eth/defi | 以太坊 TVL 与 DEX 成交量。 | — | onchain |
GET /v1/eth/defi/history | DeFi 历史。 | since_ms, until_ms, limit, before_ms, order | onchain |
GET /v1/eth/squeeze | 轧空指数。 | — | onchain |
GET /v1/eth/squeeze/history | 轧空指数的历史。 | since_ms, until_ms, limit, before_ms, order | onchain |
GET /v1/eth/price-btc | ETH/BTC 比率及动量。 | — | onchain |
GET /v1/eth/price-btc/history | 比率的历史。 | since_ms, until_ms, limit, before_ms, order | onchain |
#宏观
| 接口 | 说明 | 参数 | 市场数据族 |
|---|---|---|---|
GET /v1/macro | 单个序列的最新值（series 必填）。 | series (required) | macro |
GET /v1/macro/series | 可用序列的目录。 | category | macro |
GET /v1/macro/history | 某个序列的历史。 | since_ms, until_ms, limit, series (required), before_ms, order | macro |
GET /v1/macro/correlations | BTC 与宏观的相关性。 | — | macro |
GET /v1/macro/net-liquidity | 净流动性。 | — | macro |
GET /v1/macro/net-liquidity/history | 净流动性的历史。 | since_ms, until_ms, limit, before_ms, order | macro |
GET /v1/macro/momentum | 宏观动量评分。 | — | macro |
GET /v1/macro/risk | 风险偏好 / 避险状态。 | — | macro |
GET /v1/macro/intraday/series | 日内品种目录。 | — | macro |
GET /v1/macro/intraday/history | 某个宏观品种的 OHLC K 线。 | since_ms, until_ms, limit, series (required), timeframe (required), before_ms, order | macro |
#ETF、代币经济与情绪
| 接口 | 说明 | 参数 | 市场数据族 |
|---|---|---|---|
GET /v1/etf/fundamentals | 各发行方的季度锚定数据。 | asset (required) | etf |
GET /v1/etf/fundamentals/history | 基本面的历史。 | ticker, since_ms, until_ms, limit, asset (required), before_ms, order | etf |
GET /v1/tokenomics | 该交易对的供应量、市值与 FDV。 | symbol (required) | tokenomics |
GET /v1/tokenomics/history | 代币经济历史。 | since_ms, until_ms, limit, symbol (required), before_ms, order | tokenomics |
GET /v1/global | 总市值与市占率。 | — | price_volume |
GET /v1/global/history | 全球市场的历史。 | since_ms, until_ms, limit, timeframe, before_ms, order | price_volume |
GET /v1/fear-greed | 当日恐惧与贪婪指数。 | — | sentiment |
GET /v1/fear-greed/history | 自 2018 年以来的历史。 | since_ms, until_ms, limit, before_ms, order | sentiment |
GET /v1/fear-greed/cmc | CoinMarketCap 恐惧与贪婪指数，日内更新。 | — | sentiment |
GET /v1/fear-greed/cmc/history | 自 2023 年起每日一个点。 | since_ms, until_ms, limit, before_ms, order | sentiment |
GET /v1/altcoin-season | 山寨币季节指数、山寨币总市值及一年内的极值。 | — | sentiment |
GET /v1/altcoin-season/history | 每日一个点，最近 90 天起持续累积。 | since_ms, until_ms, limit, before_ms, order | sentiment |
GET /v1/indices/cmc20 | CMC20 指数、24 小时变化及其 20 个成分。 | — | sentiment |
GET /v1/indices/cmc20/history | 自 2024 年起每日一个值。 | since_ms, until_ms, limit, before_ms, order | sentiment |
GET /v1/indices/cmc100 | CMC100 指数、24 小时变化及其 100 个成分。 | — | sentiment |
GET /v1/indices/cmc100/history | 自 2024 年起每日一个值。 | since_ms, until_ms, limit, before_ms, order | sentiment |