FXMacroData 엔드포인트 및 인증 사용 방법

이 가이드의 끝으로 당신은 올바르게 인증 할 수 있습니다, 각 작업에 대한 올바른 엔드포인트 가족을 선택 하 고, 경로 구조 또는 지표 커버리지 추측 없이 FXMacroData API에서 생산 준비 요청.

단계 1 - 생산 기본 URL에서 시작

모든 공개된 예제는 생산 API 기반에서 시작해야 합니다:

https://fxmacrodata.com/api/v1

가장 많이 사용하는 최종점 가족들은:

• /announcements/{currency}/{indicator} 정확한 기록값을 announcement_datetime
• /calendar/{currency} 앞으로 출시될 시간표
• /catalogue/{currency} 지원된 지표의 발견 가능성
• /cot/{currency} 거래자의 포지셔닝 의 약속
• /commodities/{indicator} 재화 및 에너지 시리즈에 대해
• /forex/{pair} 그리고 /market-sessions 시장 컨텍스트에

단계 2 - 질의 매개 변수로 올바르게 인증

FXMacroData는 공개 사용 예제에서 질의 매개 변수 인증을 사용합니다:

?api_key=YOUR_API_KEY

USD 엔드포인트 접근은 키 없이 사용할 수 있지만, USD가 아닌 루트에는 유효한 키가 필요합니다.

# USD endpoint (no key required)
curl "https://fxmacrodata.com/api/v1/announcements/usd/inflation"

# Non-USD endpoint (key required)
curl "https://fxmacrodata.com/api/v1/announcements/aud/policy_rate?api_key=YOUR_API_KEY"

단계 3 - 코딩 전에 사용할 수 있는 것을 발견

화폐에 대한 지표가 무엇인지 확실하지 않을 때 먼저 카탈로그 경로를 호출하십시오. 이것은 하드 코딩 가정을 피합니다.

curl "https://fxmacrodata.com/api/v1/catalogue/eur?api_key=YOUR_API_KEY"

다음 에서 지표 페이지 인덱스를 사용 문서 표시자 지수 경로 경로와 예상된 필드를 확인하기 위해서입니다.

단계 4 - 발표 엔드포인트에서 공개된 데이터를 가져오기

발표 엔드포인트는 상위 레벨 객체 더하기 a를 반환합니다. data 역사적인 발표의 배열입니다. 각 줄에는 기간 종료가 포함됩니다. date, a val그리고 announcement_datetime 시간표

curl "https://fxmacrodata.com/api/v1/announcements/gbp/unemployment?api_key=YOUR_API_KEY"

{
  "currency": "GBP",
  "indicator": "unemployment",
  "has_official_forecast": false,
  "start_date": "2025-01-31",
  "end_date": "2026-03-31",
  "data": [
    {
      "date": "2026-01-31",
      "val": 4.39,
      "announcement_datetime": 1770521400
    }
  ]
}

정확한 지표 의미와 단위를 확인하려면 와 같은 최종 포인트 페이지를 확인하십시오. 미국 달러 정책금리 그리고 유로 인플레이션-

단계 5 - 이벤트 기반 워크플로우에 대한 릴리스 캘린더를 사용

발매 일정은 계속적으로 투표하는 대신 출판 시간에 맞춰 검색을 할 예정하도록 도와줍니다.

curl "https://fxmacrodata.com/api/v1/calendar/usd?indicator=non_farm_payrolls"

강력한 패턴은: 질의 달력 -> 다음을 읽으십시오 announcement_datetime -> 출시 시간에 일치하는 발표 경로를 가져옵니다.

단계 6 - 추가적인 최종점 가족들을 추가합니다.

핵심 알림 흐름이 안정되면, 도메인별로 특정 경로로 커버리지를 확장하세요:

• COT: /api/v1/cot/{currency} 선물 포지셔닝 컨텍스트
• 금속: /api/v1/commodities/{indicator} 금, 은, 플래티넘 및 관련 안전 피난처 원료
• 외환: /api/v1/forex/{pair} 매크로 릴리스와 스팟 정렬을 위해
• 시장 세션: /api/v1/market-sessions 세션 상태 인식 자동화

curl "https://fxmacrodata.com/api/v1/cot/usd"
curl "https://fxmacrodata.com/api/v1/commodities/gold"
curl "https://fxmacrodata.com/api/v1/forex/eurusd"
curl "https://fxmacrodata.com/api/v1/market-sessions"

단계 7 - 끝에서 끝까지 파이썬 예제

아래의 단편은 사용 가능성을 확인하고, 하나의 지표 시리즈를 가져와, 최신 인쇄물을 반환합니다.

import requests

BASE = "https://fxmacrodata.com/api/v1"
API_KEY = "YOUR_API_KEY"


def fetch_latest(currency: str, indicator: str, api_key: str | None = None) -> dict | None:
    params = {}
    if api_key:
        params["api_key"] = api_key

    catalogue = requests.get(f"{BASE}/catalogue/{currency}", params=params, timeout=10)
    catalogue.raise_for_status()

    endpoint = requests.get(
        f"{BASE}/announcements/{currency}/{indicator}",
        params=params,
        timeout=10,
    )
    endpoint.raise_for_status()

    rows = endpoint.json().get("data", [])
    return rows[-1] if rows else None


latest = fetch_latest("aud", "policy_rate", API_KEY)
print(latest)

다음으로 무엇을 만들 수 있을까요?

이제 인증, 커버리지를 발견, 역사적인 릴리스 시리즈를 요청, 달력 기반 자동화로 확장하는 완전한 경로가 있습니다. 릴리스 캘린더 API를 사용하는 방법 그래서 새로운 매크로 데이터가 공개될 때 시스템이 정확히 반응합니다.