Opennan

经济时间序列

已上线

探索美国月度CPI和失业率。

Free持OpenNan密钥免费使用,每个账户每分钟最多30次金融请求。
GET /v1/finance/macro/{series_id}Free · 30 requests/min

Request

Get observations for supported US inflation and labor market series.

Sign in or use an API key to run live.

Economic series

Example output

US Bureau of Labor Statistics · index points

Consumer Price Index

Observation

Observation 323.048 index points

Data table
PeriodValue
323.048
323.976
324.8
324.122
324.054
Response
{
  "data": [
    {
      "period": "2025-07",
      "value": 323.048
    },
    {
      "period": "2025-08",
      "value": 323.976
    },
    {
      "period": "2025-09",
      "value": 324.8
    },
    {
      "period": "2025-11",
      "value": 324.122
    },
    {
      "period": "2025-12",
      "value": 324.054
    }
  ],
  "meta": {
    "sources": [
      "US Bureau of Labor Statistics"
    ],
    "retrieved_at": "2026-11-11T01:36:33.445096+00:00",
    "series_id": "CUUR0000SA0",
    "unit": "index points",
    "frequency": "monthly",
    "example_output": true
  }
}
Highlighted lines match the selected record.
Tool discovery · GET /v1/tools · MCP tools/list

运作方式

  1. 01选择输入输入股票代码、序列或按时间排序的OHLCV数据。
  2. 02检查结果选择图表记录以高亮显示完全对应的JSON值。

从代码调用 经济时间序列

REST和MCP共用输入、结果和验证错误。

GEThttps://api.opennan.com/v1/finance/macro/{series_id}
  1. 获取 API 密钥

    在控制台创建密钥。它与试用区使用同一余额。

    创建密钥
  2. 发送第一个请求

    与试用区发送的请求相同。把 OPENNAN_KEY 设为你的密钥。

    curl 'https://api.opennan.com/v1/finance/macro/CUUR0000SA0?from=2025-07-01&to=2026-01-01' \
      -H 'Authorization: Bearer <OPENNAN_API_KEY>'
  3. 读取结果

    结果在同一个响应里返回。X-Usage-Cost-Usd 响应头写明本次调用的费用。

错误及解决方法

  • 401缺少密钥或密钥错误

    用 Authorization: Bearer 请求头发送控制台中的密钥。

  • 402余额不足

    在账单页面充值,然后重新发送同一请求。

  • 400有值不被接受

    查看 error.message,它会指出字段。请使用参数表中的值。

  • 429请求过多

    等几秒再试,每次遇到 429 都等得更久一些。

MCPhttps://api.opennan.com/v1/finance/mcp

在 AI 智能体中使用

把 Opennan MCP 服务器加到你的智能体中,然后调用此工具。

工具
macro_series
示例参数
{
  "series_id": "CUUR0000SA0",
  "from": "2025-07-01",
  "to": "2026-01-01"
}

经济时间序列:常见问题

免费吗?

持OpenNan密钥免费使用,每个账户每分钟最多30次金融请求。

示例来自哪里?

示例输出记录自已发布的端点。点击Run live请求当前数据。加密货币预览标记为Sample data。

有哪些限制?

股票支持SEC申报公司及以美元计价的US-GAAP数据。缺失值为null。宏观数据涵盖最近三个日历年并提供覆盖信息。图表接受2–5,000根K线。SMA需要period根,RSI和收益率需要period加一根。period范围为2–500。包含from,不包含to。

我们只使用网站必需的 Cookie,例如你的语言和推荐码。没有广告。我们使用不依赖 Cookie 的分析工具统计页面访问量。详情请参阅我们的 Cookie 政策 。