FXMacroData GraphQL API を導入する

FXMacroData GraphQL API は現在稼働中です.既存の REST エンドポイントに加えて,すべてのコアデータ表面 インディケーター時間系列,データカタログクエリ,リリースカレンダー検索 は,単一のタイプされた GraphSQL スキーマを通じて利用できます. 1 回回で必要なフィールドを正確に取得し,単一のリクエストボディで複数の通貨クエリを構成し,内蔵された GraphiQL IDE を介してインタラクティブに完全なスキーマを探索します. 詳細は,Forex のデータ処理システムで提供されています.

ニュースは?

グラフQL エンドポイントは POST /api/v1/graphql そして,REST 表面を反映する3つのルートクエリフィールドを暴露します:

認証は,REST 表面と同じ API キーを使用します. api_key シェーマは強くタイプされています:各フィールド,引数,および返却オブジェクトは,シェーマに直接文書化されています.したがって,自己調査とIDEの自動補完は,ボックスから動作します.

商人や 開発 者 に とっ て 重要 な 理由

RESTエンドポイントは単一指標検索に効率的です. ワークフローが単一の分析サイクルで複数の通貨,複数の指標,または複数のデータ表面をカバーする瞬間,GraphQLは価値があります.

G10の6つの通貨のインフレと政策レートの歴史を同時に必要とするクロス通貨スプレッドモデルを考えてみましょう. RESTでは12回の連続HTTPリクエストを発行します. GraphQLでは6つのリクエリボディを送信します. announcements 遅延を削減し,接続オーバーヘッドを削減して,クライアントコードを線形に保つ.

実践例: 多通貨通胀に関する問い合わせ

順序的なRESTコール3回ではなく,あなたは,過去12ヶ月間のCPIデータを1回で必要とします. announcements 単一の GraphQL ドキュメント内で3回フィールド:

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 }
      ]
    }
  }
}

3つの通貨で HTTPの往復です announcementDatetime 市場反応をモデル化する際に,カレンダー月ではなくイベント時間に並べることができます. これを, 政策金利の最終値はUSD 利率差層を追加する. 利息差層は,

実践的な例: 入手可能な指標を 発見

新しいモデルを作成する前に,通貨のすべての指標を,その更新頻度,そして中央銀行の公式予測がリリースに付与されているかどうかをリストするために,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 単数値は Unix 時代整数です. 単数を単数でスキャンするには, calendar フィールドは,ちょうどあなたがアリアス announcements単一の統合カレンダー応答を受け取る. 詳細を見る. CAD 政策利率基準 REST の相当値の値です.

GraphQL vs REST: どちらを使うか

両方のインターフェースは同じFirestoreサポートデータストアから抽出され,同一のデータを持ちます announcement_datetime 選択はワークフローの決定です

始めよう

GraphQLエンドポイントは,REST 表面で使用される同じ API キーですべてのサブスクライバーに利用可能である.追加の構成は必要ありません.