경제 시계열

사용 가능

미국 월간 CPI와 실업률을 살펴봅니다.

FreeOpenNan 키로 무료. 계정당 금융 요청은 분당 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 키 받기
콘솔에서 키를 만드세요. 플레이그라운드와 같은 잔액을 씁니다.
키 만들기

첫 요청 보내기

플레이그라운드가 보내는 것과 같은 요청입니다. 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" }