快速入门：首次 API 调用或接入 AI 智能体
三分钟，一把密钥，一个请求。本页从创建账户讲到读取第一个响应，然后介绍如何在一次调用中获取多个市场数据族。若要把数据交给 AI 智能体，请将它接入 MCP 服务器：无需编写代码。
#获取密钥
创建账户：你的第一把密钥会自动生成，并在控制台中等你。免费方案开放四个市场数据族（价格与成交量、衍生品、指标、宏观），每月 10,000 次请求：足够你用一个晚上判断这些数据是否适合你。
密钥在控制台中以隐藏形式显示：需要时显示或复制，然后保存在密钥管理器或环境变量中。如果泄露，一次轮换即可替换。
一把密钥通用于所有通道：你的代码用它调用 REST 和 WebSocket 数据流，MCP 服务器也接受它，供你的 AI 智能体使用，适用同一方案。
#第一次调用
比特币的综合资金费率，在所有发布该数据的交易所间聚合，并换算为八小时基准。
export BYTNODE_API_KEY="your_key"
curl -H "X-API-KEY: $BYTNODE_API_KEY" \
"https://api.bytnode.com/v1/funding/rate?symbol=BTCUSDT"只有两样是必需的：X-API-KEY 请求头和 symbol 参数。没有默认交易对。没有交易对的请求会被拒绝，而不是默认返回比特币——那不一定是你想要的。
#读取响应
{
"status": "ok",
"server_time": "2026-11-08T12:51:38.169Z",
"data_type": "funding_rate",
"symbol": "BTCUSDT",
"market": "futures",
"data": {
"time": "2026-11-08T00:00:00.000Z",
"period_end_at": "2026-11-08T08:00:00.000Z",
"settled_at": "2026-11-08T08:00:00.009Z",
"rate_pct": 0.00825097837214,
"apr_pct": 9.0348213175,
"is_closed": true
}
}响应包装的各个键
status：ok或error。server_time：响应生成的时刻，ISO 8601 格式。它不是数据的时间：数据自带time。data_type：返回类型的名称。无需依赖调用的路径即可分发响应。symbol、timeframe、market…：对请求的回显（此处market: "futures"，资金费率只有这一个市场），仅当接口具有这些项时出现，这样保存下来的响应无需原始请求也能读懂。data：数据主体，可能是对象、列表，或在无可用数据时为null。
这个响应具体说明了什么
time表示该费率所适用的八小时窗口的起点，对齐到 UTC 00:00、08:00 和 16:00；period_end_at是窗口的终点，settled_at是支付该窗口的结算时刻。rate_pct是该窗口的费率，以百分比表示；apr_pct是其年化值（rate_pct × 每年 1095 次 8 小时结算）。time是每个带时间戳对象唯一的时间键（这里是资金费率窗口的起点），因此通用客户端只需读取一个键；is_closed: true表示该值为最终值，不会再变化。
#一次请求获取多个市场数据族
为了填充一个仪表盘调用十个端点是一种浪费：/v1/snapshot 一次往返即可完成。每个参数是一个字段名，其值是请求的深度：行数；仅需最新值时为 1（或 true）。快照从 Traders 方案起提供。
curl -H "X-API-KEY: $BYTNODE_API_KEY" \
"https://api.bytnode.com/v1/snapshot?symbol=BTCUSDT\
&klines@1h=24\
&funding_rate=1\
&oi_change=1\
&liquidations_cumulative=1\
&cvd@1h=24\
&buy_sell_ratio@1h=24"多周期字段使用 @tf 后缀请求（cvd@1h），该键会原样出现在响应中。四十八个字段的详细说明，以及响应附带的 unavailable 键，见 快照 页面。
AI 智能体只需一次 MCP 调用即可获得相同字段：get_pair_data 工具在一次请求中返回一个交易对的快照字段，也可并排比较最多十个交易对。见 MCP 服务器。