快速入门
三分钟，一把密钥，一个请求。本页从创建账户讲到读取第一个响应，然后介绍如何在一次调用中获取多个数据族。
#获取密钥
创建账户：你的第一把密钥会自动生成，并在控制台中等你。免费方案无需绑卡即可开放四个数据族（价格与成交量、衍生品、指标、宏观）：足够你用一个晚上判断这些数据是否适合你。
密钥在控制台中以隐藏形式显示：需要时显示或复制，然后保存在密钥管理器或环境变量中。如果泄露，一次轮换即可替换。
#第一次调用
比特币的综合资金费率，在所有发布该数据的交易所间聚合，并换算为八小时基准。
export BYTNODE_KEY="your_key"
curl -H "X-API-KEY: $BYTNODE_KEY" \
"https://api.bytnode.com/v1/funding/rate?symbol=BTCUSDT"只有两样是必需的：X-API-KEY 请求头和 symbol 参数。没有默认交易对。没有交易对的请求会被拒绝，而不是默认返回比特币——那不一定是你想要的。
#读取响应
{
"status": "ok",
"timestamp": 1775648290510,
"data_type": "funding_rate_8h",
"data": {
"bucket": "2026-08-29T08:00:00+00:00",
"rate": 0.000082,
"apr": 0.08979,
"exchange_count": 7
}
}响应包装的四个键
status：ok或error。timestamp：响应生成的时刻，单位为毫秒。它不是数据的时间戳：数据自带timestamp或bucket。data_type：返回类型的名称。无需依赖调用的路径即可分发响应。data：数据主体，可能是对象、列表，或在无可用数据时为null。
这个响应具体说明了什么
bucket表示计算该费率的八小时窗口的起点，对齐到 UTC 00:00、08:00 和 16:00。apr是年化后的费率，这里约为每年 9%。exchange_count表示综合值基于多少个交易所计算。这个数量在不同窗口间会变化：它是一项信息，而不是常量。
#一次请求获取多个数据族
为了填充一个仪表盘调用十个端点是一种浪费：/v1/snapshot 一次往返即可完成。每个参数是一个字段名，其值是请求的深度：根据字段不同，表示行数或分钟数；对于只有当前值的字段则为 true。
curl -H "X-API-KEY: $BYTNODE_KEY" \
"https://api.bytnode.com/v1/snapshot?symbol=BTCUSDT\
&klines_1h=24\
&funding_rate_8h=true\
&oi_delta=60\
&liq_cumulative=120\
&cvd@1h=24\
&fear_greed=true"多周期字段通过 @tf 后缀请求（cvd@1h），该键会原样出现在响应中。六十一个字段的详细说明，以及响应中附带的 unavailable 和 coverage 键，见快照页面。