面向 AI 智能体的宏观数据 API

#面向 AI 智能体与 LLM 的宏观数据

“美国 10 年期收益率在上升吗？”“净流动性相对比特币如何变化？”“当前哪些宏观序列与 BTC 同步？”：AI 智能体通过 MCP 工具 get_macro_data 读取宏观背景，可逐个读取目录序列，也可读取衍生指标。

{
  "name": "get_macro_data",
  "arguments": {
    "series": "DGS10",
    "fields": ["macro"]
  }
}

• 给 LLM 的提示：序列以其目录标识符命名（DGS10 即美国 10 年期收益率），不要猜测：get_system_info 会列出目录。
• 给开发者：/v1/macro?series= 与 /v1/macro/series 为你自己的 AI 智能体提供用于 tool calling 的工具及其目录，与 MCP 服务器所用的组合相同。
• 适用环境：Claude、ChatGPT、Cursor 及任何 MCP 客户端，包括支持 MCP 的 AI 智能体框架，如 LangChain 或 n8n。

通过 MCP 服务器指南接入你的 AI 智能体，或用开源的 Agent Skills 教它使用 BytNode。

#日度宏观序列

约二十个美国官方序列外加黄金，分为八个类别。/v1/macro 返回由 ?series=（必填）指定的某一个序列的最新值；/v1/macro/series 是目录，附每个序列的最新值；/v1/macro/history 返回由 ?series= 指定的某个序列的历史。

# The catalogue of the series served
curl -H "X-API-KEY: $BYTNODE_API_KEY" "https://api.bytnode.com/v1/macro/series"

# The history of one series
curl -H "X-API-KEY: $BYTNODE_API_KEY" \
  "https://api.bytnode.com/v1/macro/history?series=DGS10&limit=90"

#衍生指标

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

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

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

取值 −100 到 +100 的评分，基于 M2、美联储资产负债表和美元在三十天和九十天内的动态。货币供应上升、美元走弱会推高评分。每个组成部分都带有以百分比表示的变化率 change_pct。

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

#日内宏观

五个宏观品种的 OHLC K 线，用于按小时而非按天与加密资产比较：EUR/USD、USD/JPY、WTI 原油、ICE 美元指数和代币化黄金，每个提供六个周期（1m 至 1d，无 30m）。10 年和 30 年期利率、VIX、标普 500 和纳斯达克是 FRED 每日序列，由 /v1/macro 提供。

curl -H "X-API-KEY: $BYTNODE_API_KEY" \
  "https://api.bytnode.com/v1/macro/intraday/history?series=PAXGUSDT&timeframe=1h&limit=200"

请求某个序列不提供的周期会返回 422 timeframe_not_served，并列出它提供的周期，而不是返回空列表，以免让人误以为数据有缺口。data 是 K 线列表，按时间从新到旧排列；series 和 timeframe 在外层信封中给出。