REST API

宏观与流动性

加密市场所处的宏观环境：利率、美元、流动性、指数、黄金和原油，含日度与日内数据。这些接口都是全市场数据。

#日度宏观序列

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，并列出它提供的周期，而不是返回空列表，以免让人误以为数据有缺口。