FXMacroData GraphQL API를 소개합니다

FXMacroData GraphQL API는 이제 실행중입니다. 기존의 REST 엔드포인트와 함께 모든 핵심 데이터 표면 지표 시간 시리즈, 데이터 카탈로그 질의 및 릴리스 캘린더 검색 은 단일, 입력된 GraphSQL 스키마를 통해 사용할 수 있습니다. 한 번의 왕복으로 필요한 필드를 정확하게 가져와 단일 요청 몸에서 멀티 통화 질의를 작성하고 내장된 GraphiQL IDE를 통해 전체 스키마가 상호 작용적으로 탐색됩니다.

무슨 일이야?

그래프QL 엔드포인트는 POST /api/v1/graphql 그리고 생산 REST 표면을 반영하는 세 개의 루트 쿼리 필드를 노출합니다:

인증은 REST 표면과 같은 API 키를 사용합니다. api_key 요청 URL에 대한 질의 매개 변수. 스키마는 강력하게 입력됩니다: 모든 필드, 논증 및 반환 객체는 스키마에 직접 문서화되어 있으므로 내성 탐구 및 IDE 자동 채우는 상자에서 작동합니다.

왜 상인 과 개발자 들 에게 중요 합니까?

REST 엔드포인트는 단일 지표 검색에 효율적입니다. 그래프QL는 작업 흐름이 단일 분석 사이클에서 여러 화폐, 여러 지표 또는 여러 데이터 표면을 포괄하는 순간 가치가 있습니다.

Consider a cross-currency spread model that needs inflation and policy rate history for six G10 currencies simultaneously. With REST you issue twelve sequential HTTP requests. With GraphQL you send one request body containing six announcements 현장 별명으로 연결하고 단일 왕복으로 조합 응답을 수신합니다.

실용적인 예제: 여러 통화 인플레이션 쿼리

Suppose you are building a G3 inflation dashboard and need the last twelve months of CPI data for the USD, EUR, and GBP in one shot. Rather than three sequential REST calls, you alias the announcements field three times within a single GraphQL document:

curl -X POST "https://fxmacrodata.com/api/v1/graphql?api_key=YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "{ usd: announcements(currency: \"USD\", indicator: \"inflation\", startDate: \"2025-04-01\") { currency indicator data { date val announcementDatetime } } eur: announcements(currency: \"EUR\", indicator: \"inflation\", startDate: \"2025-04-01\") { currency indicator data { date val announcementDatetime } } gbp: announcements(currency: \"GBP\", indicator: \"inflation\", startDate: \"2025-04-01\") { currency indicator data { date val announcementDatetime } } }"
  }'

대표적인 답변:

{
  "data": {
    "usd": {
      "currency": "USD",
      "indicator": "inflation",
      "data": [
        { "date": "2026-03-01", "val": 2.8, "announcementDatetime": 1743253200 },
        { "date": "2026-02-01", "val": 3.0, "announcementDatetime": 1740747600 }
      ]
    },
    "eur": {
      "currency": "EUR",
      "indicator": "inflation",
      "data": [
        { "date": "2026-03-01", "val": 2.3, "announcementDatetime": 1743340800 },
        { "date": "2026-02-01", "val": 2.4, "announcementDatetime": 1740834000 }
      ]
    },
    "gbp": {
      "currency": "GBP",
      "indicator": "inflation",
      "data": [
        { "date": "2026-03-01", "val": 2.6, "announcementDatetime": 1743253200 },
        { "date": "2026-02-01", "val": 2.8, "announcementDatetime": 1740747600 }
      ]
    }
  }
}

Three currencies, one HTTP round-trip. The announcementDatetime 각 데이터 포인트의 시대는 인쇄물이 출시된 정확한 초를 제공합니다. 따라서 시장 반응을 모델링 할 때 달보다 이벤트 시간에 일련을 조정 할 수 있습니다. USD 정책금리 최종점 그리고 그 EUR와 GBP의 동등한 값으로 환율차별층을 추가합니다.

실용적 예: 사용 가능한 지표 를 발견

새로운 모델을 만들기 전에, 당신은 GraphQL를 통해 데이터 카탈로그에 문의하여 통화에 대한 모든 가시자를 수록할 수 있습니다.

curl -X POST "https://fxmacrodata.com/api/v1/graphql?api_key=YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "{ dataCatalogue(currency: \"AUD\") { currency indicators { slug name unit frequency hasOfficialForecast } } }"
  }'

대표적인 응답 (단어):

{
  "data": {
    "dataCatalogue": {
      "currency": "AUD",
      "indicators": [
        {
          "slug": "policy_rate",
          "name": "Cash Rate Target",
          "unit": "%",
          "frequency": "irregular",
          "hasOfficialForecast": false
        },
        {
          "slug": "inflation",
          "name": "CPI Inflation",
          "unit": "%",
          "frequency": "quarterly",
          "hasOfficialForecast": false
        },
        {
          "slug": "unemployment",
          "name": "Unemployment Rate",
          "unit": "%",
          "frequency": "monthly",
          "hasOfficialForecast": false
        }
      ]
    }
  }
}

돌아온 총알은 바로 indicator 론의 announcements 별도의 문서 패스가 필요하지 않습니다. 당신은 발견 단계를 스크립트하고 자동으로 모델이 필요로 하는 지표에 대한 요청 팩을 만들 수 있습니다. 전체 AUD 지표 세트를 검색 AUD API 문서-

실용적 예제: 발매 달력 검색

다음의 큰 영향력 인쇄가 언제 될지 아는 것은 이벤트 위험에 대한 위치 크기를 결정하는 데 중요합니다. calendar 쿼리는 지원된 모든 화폐에 대한 다가오는 출시 시간표를 노출합니다. 결과를 좁히기 위해 선택적 인 지표 필터를 사용합니다.

curl -X POST "https://fxmacrodata.com/api/v1/graphql?api_key=YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "{ calendar(currency: \"CAD\", indicator: \"policy_rate\") { currency indicator data { release announcementDatetime } } }"
  }'

대표적인 답변:

{
  "data": {
    "calendar": {
      "currency": "CAD",
      "indicator": "policy_rate",
      "data": [
        {
          "release": "policy_rate",
          "announcementDatetime": 1747400400
        },
        {
          "release": "policy_rate",
          "announcementDatetime": 1752580800
        }
      ]
    }
  }
}

- announcementDatetime 값은 유닉스 시대 정수입니다. 날짜 분석 단계 없이 스케줄러나 알림 시스템에 직접 입력합니다. calendar 당신이 할 것처럼 announcements: CAD, AUD 및 NZD 정책금리 날짜를 포함하는 하나의 질의를 작성하고 단일 통합 달력 응답을 수신합니다. 전체 참조 CAD 정책금리 기준 REST 대용량에 대한 것입니다.

GraphQL vs REST: 둘 다 언제 사용해야 할까요?

두 인터페이스 모두 같은 Firestore 지원 데이터 저장소에서 가져와 동일한 announcement_datetime 정밀성. 선택은 작업 흐름 결정입니다:

시작 하십시오

GraphQL 엔드포인트는 REST 표면에 사용되는 동일한 API 키에서 모든 가입자에게 사용할 수 있습니다. 추가 구성이 필요하지 않습니다.