経済時系列

提供中

米国の月次CPIと失業率を調べます。

FreeOpenNanキーで無料。1アカウントあたり金融リクエストは毎分30回まで。

ToolGET /v1/finance/macro/{series_id}Free · 30 requests/min

Economic series

Example output

US Bureau of Labor Statistics · index points

Consumer Price Index

Observation

Inspect record

Observation 323.048 index points

Data table

Period	Value
	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

仕組み

01入力を選ぶ銘柄、系列、または時刻順のOHLCV足を入力します。
02結果を確認チャートのデータを選ぶと対応するJSON値が強調されます。

コードから経済時系列を呼び出す

RESTとMCPは入力、結果、検証エラーを共有します。

GEThttps://api.opennan.com/v1/finance/macro/{series_id}

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>'
結果を読む
結果は同じレスポンスで返ります。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" }