FXMacroData GraphQL API を導入する

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

ニュースは?

グラフQL エンドポイントは POST /api/v1/graphql and exposes three root query fields that mirror the production REST surface:

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

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

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

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 利率差層を追加する. 利息差層は,

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

新しいモデルを作成する前に,通貨のすべての指標を,その更新頻度,そして中央銀行の公式予測がリリースに付与されているかどうかをリストするために,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 キーですべてのサブスクライバーに利用可能である.追加の構成は必要ありません.