宏观、ETF 与情绪
加密市场所处的宏观环境:利率、美元、流动性、指数、黄金和原油,以及 ETF 基本面、资产供应和情绪指数。这些接口都是全市场数据,只有代币经济接口需要交易对。
#日度宏观序列
约二十个美国官方序列外加黄金,分为八个类别。第一个接口返回每个序列的最新值;第二个提供目录;第三个返回由 ?series= 指定的某个序列的历史。
| 类别 | 序列 |
|---|---|
| 外汇 | 广义美元、新兴市场美元、EUR/USD、USD/JPY |
| 利率 | 联邦基金利率、2 年期、10 年期、30 年期,以及 10 年减 2 年、10 年减 3 个月的利差 |
| 通胀 | CPI、PCE、5 年与 10 年盈亏平衡通胀率 |
| 流动性 | M2、基础货币、美联储资产负债表、财政部一般账户、隔夜逆回购 |
| 波动率 | VIX |
| 股票 | 标普 500、纳斯达克综合指数 |
| 就业 | 失业率、非农就业 |
| 大宗商品 | 黄金、WTI 原油 |
# 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_id | string | 传入 ?series= 的标识符。 |
category | string | 八个类别之一。 |
label | string | 序列的可读名称。 |
units | string | 数值的单位。各序列不同:未经确认切勿将两个序列相加。 |
date | string | 观测日期。 |
value | float | 观测值。 |
#衍生指标
四个综合读数,基于原始序列和比特币价格按需计算。
比特币与美元、标普 500、黄金和 VIX 的滚动相关性,窗口为三十天和九十天,基于共同日期的日收益率计算。在对齐的历史不足时,相关性保持为 null。
净流动性:美联储资产负债表减去财政部一般账户,再减去隔夜逆回购。响应包含公式及各组成部分,并明确标注单位,因为三个源序列的单位不同。
取值 −100 到 +100 的评分,基于 M2、美联储资产负债表和美元在三十天和九十天内的动态。货币供应上升、美元走弱会推高评分。
基于五个信号、取值 0 到 100 的评分:VIX 低位、美元回落、收益率曲线斜率为正、标普高于五十日均线、黄金回落。没有数据的信号会被排除在计算之外,而不是被视为不利。
#日内宏观
十个宏观品种的 OHLC K 线,用于按小时而非按天与加密资产比较。其中五个提供六个周期:EUR/USD、USD/JPY、WTI 原油、美元指数和代币化黄金。另外五个仅提供日线:10 年和 30 年期利率、VIX、标普和纳斯达克。
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
series | string | 必填 | 品种标识符,与目录返回的一致。 |
timeframe | string | 必填 | 1m、5m、15m、1h、4h、1d。该数据族没有 30m 周期。 |
limit | integer | 100 | K 线数量。 |
curl -H "X-API-KEY: $BYTNODE_KEY" \
"https://api.bytnode.com/v1/macro/intraday/history?series=EURUSD&timeframe=1h&limit=200"请求某个序列不提供的周期会返回 400,并列出它提供的周期,而不是返回空列表,以免让人误以为数据有缺口。
#ETF 基本面
发行方提交的官方锚定数据:份额数、资产净值、持有的比特币和净资产,按发行方列出。共跟踪十个比特币发行方和九个以太坊发行方。
#代币经济与全球市场
资产的供应及由此得出的数据。这是本页唯一需要 ?symbol= 的数据族。
| 字段 | 类型 | 说明 |
|---|---|---|
circulating_supply | float | 流通供应量。 |
total_supply | float | 已发行总量。 |
max_supply | float | null | 供应上限(如有)。 |
price | float | 计算所用的基准价格。 |
market_cap | float | 市值,按需计算(供应量乘以价格),从不直接照搬第三方数据。 |
fdv | float | null | 完全稀释估值。没有上限时按总供应计算;稳定币为 null。 |
| 字段 | 类型 | 说明 |
|---|---|---|
total_market_cap_usd | float | 全市场市值。 |
total_volume_usd | float | 24 小时成交量。 |
btc_dominance / eth_dominance | float | 两大主要资产的占比。 |
others_dominance | float | null | 其余部分,推算得出:100 减去两者。任一缺失时为 null。 |
active_cryptocurrencies | integer | 上市资产数量。 |
#恐惧与贪婪指数
加密市场的恐惧与贪婪指数: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 年,超过三千个数据点。每天查询超过一次只会消耗配额而得不到新信息。