REST API

宏观、ETF 与情绪

加密市场所处的宏观环境:利率、美元、流动性、指数、黄金和原油,以及 ETF 基本面、资产供应和情绪指数。这些接口都是全市场数据,只有代币经济接口需要交易对。

#日度宏观序列

GET/v1/macrodata_type · macro
GET/v1/macro/seriesdata_type · macro_series
GET/v1/macro/historydata_type · macro_history

约二十个美国官方序列外加黄金,分为八个类别。第一个接口返回每个序列的最新值;第二个提供目录;第三个返回由 ?series= 指定的某个序列的历史。

类别序列
外汇广义美元、新兴市场美元、EUR/USD、USD/JPY
利率联邦基金利率、2 年期、10 年期、30 年期,以及 10 年减 2 年、10 年减 3 个月的利差
通胀CPI、PCE、5 年与 10 年盈亏平衡通胀率
流动性M2、基础货币、美联储资产负债表、财政部一般账户、隔夜逆回购
波动率VIX
股票标普 500、纳斯达克综合指数
就业失业率、非农就业
大宗商品黄金、WTI 原油
curl
# The catalogue of the series served
curl -H "X-API-KEY: $BYTNODE_KEY" "https://api.bytnode.com/v1/macro/series"

# The history of one series
curl -H "X-API-KEY: $BYTNODE_KEY" \
  "https://api.bytnode.com/v1/macro/history?series=DGS10&limit=90"
字段类型说明
series_idstring传入 ?series= 的标识符。
categorystring八个类别之一。
labelstring序列的可读名称。
unitsstring数值的单位。各序列不同:未经确认切勿将两个序列相加。
datestring观测日期。
valuefloat观测值。

#衍生指标

四个综合读数,基于原始序列和比特币价格按需计算。

GET/v1/macro/correlationsdata_type · macro_correlations

比特币与美元、标普 500、黄金和 VIX 的滚动相关性,窗口为三十天和九十天,基于共同日期的日收益率计算。在对齐的历史不足时,相关性保持为 null。

GET/v1/macro/net-liquiditydata_type · macro_net_liquidity
GET/v1/macro/net-liquidity/historydata_type · macro_net_liquidity_history

净流动性:美联储资产负债表减去财政部一般账户,再减去隔夜逆回购。响应包含公式及各组成部分,并明确标注单位,因为三个源序列的单位不同。

GET/v1/macro/momentumdata_type · macro_momentum

取值 −100 到 +100 的评分,基于 M2、美联储资产负债表和美元在三十天和九十天内的动态。货币供应上升、美元走弱会推高评分。

GET/v1/macro/riskdata_type · macro_risk

基于五个信号、取值 0 到 100 的评分:VIX 低位、美元回落、收益率曲线斜率为正、标普高于五十日均线、黄金回落。没有数据的信号会被排除在计算之外,而不是被视为不利。

#日内宏观

GET/v1/macro/intraday/seriesdata_type · macro_intraday_series
GET/v1/macro/intraday/historydata_type · macro_intraday_history

十个宏观品种的 OHLC K 线,用于按小时而非按天与加密资产比较。其中五个提供六个周期:EUR/USD、USD/JPY、WTI 原油、美元指数和代币化黄金。另外五个仅提供日线:10 年和 30 年期利率、VIX、标普和纳斯达克。

参数类型默认值说明
seriesstring必填品种标识符,与目录返回的一致。
timeframestring必填1m、5m、15m、1h、4h、1d。该数据族没有 30m 周期。
limitinteger100K 线数量。
curl
curl -H "X-API-KEY: $BYTNODE_KEY" \
  "https://api.bytnode.com/v1/macro/intraday/history?series=EURUSD&timeframe=1h&limit=200"

请求某个序列不提供的周期会返回 400,并列出它提供的周期,而不是返回空列表,以免让人误以为数据有缺口。

#ETF 基本面

GET/v1/etf/fundamentalsdata_type · etf_fundamentals
GET/v1/etf/fundamentals/historydata_type · etf_fundamentals_history

发行方提交的官方锚定数据:份额数、资产净值、持有的比特币和净资产,按发行方列出。共跟踪十个比特币发行方和九个以太坊发行方。

#代币经济与全球市场

GET/v1/tokenomicsdata_type · tokenomics
GET/v1/tokenomics/historydata_type · tokenomics_history

资产的供应及由此得出的数据。这是本页唯一需要 ?symbol= 的数据族。

字段类型说明
circulating_supplyfloat流通供应量。
total_supplyfloat已发行总量。
max_supplyfloat | null供应上限(如有)。
pricefloat计算所用的基准价格。
market_capfloat市值,按需计算(供应量乘以价格),从不直接照搬第三方数据。
fdvfloat | null完全稀释估值。没有上限时按总供应计算;稳定币为 null。
GET/v1/globaldata_type · global_market
GET/v1/global/historydata_type · global_market_history
字段类型说明
total_market_cap_usdfloat全市场市值。
total_volume_usdfloat24 小时成交量。
btc_dominance / eth_dominancefloat两大主要资产的占比。
others_dominancefloat | null其余部分,推算得出:100 减去两者。任一缺失时为 null。
active_cryptocurrenciesinteger上市资产数量。

#恐惧与贪婪指数

GET/v1/fear-greeddata_type · fear_greed
GET/v1/fear-greed/historydata_type · fear_greed_history

加密市场的恐惧与贪婪指数:0 到 100 的数值及其分类,从 Extreme Fear 到 Extreme Greed。全市场数据:不接受交易对。

响应
{
  "status": "ok",
  "data_type": "fear_greed",
  "data": {
    "timestamp": "2026-08-29T00:00:00+00:00",
    "value": 61,
    "value_classification": "Greed"
  }
}

每天一个数据点

该指数每天发布一次,对齐到 UTC 午夜。历史可追溯至 2018 年,超过三千个数据点。每天查询超过一次只会消耗配额而得不到新信息。