引入FXMacroData GraphQL API 程序

现在FXMacroData GraphQL API已经启用.除了现有的REST终端点,每个核心数据表面指标时间序列,数据目录查询和发布日历查询现在可以通过单个类型的GraphQL模式.在一次往返中获取您需要的字段,在单个请求体中编写多货币查询,并通过内置的GraphiQL IDE互动探索完整的模式.

什么是新的

图形QL终点安装在 POST /api/v1/graphql 并且暴露了三个反映生产REST表面的根查询字段:

认证使用与REST表面相同的API键 将其传递为 api_key 查询参数在请求URL上. 模式是强烈打字的:每个字段,参数和返回对象都直接记录在模式中,因此自我检查和IDE自动填写可以从盒子中完成.

为什么这对商人和开发商来说很重要

REST终端对单个指标查找非常有效.当您的工作流在单个分析周期中跨越多种货币,多个指数或多个数据表面时,GraphQL变得有价值.

考虑一个跨货币传播模型,需要同时为六个G10货币提供通货膨胀和政策利率历史.使用REST,您会发出十二个顺序的HTTP请求.使用GraphQL,您将发送一个包含六个请求的请求体. announcements 减少延迟,减少连接开销,并保持客户端代码线性.

实用例子:多货币通货膨胀查询

假设您正在构建G3通胀仪表板,需要过去12个月的CPI数据,以一次拍摄美元,欧元和英. announcements 在一个 GraphQL 文档中三次:

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

现在,我们已经开始使用 announcementDatetime 每个数据点的时代给出了印刷品发布的确切秒,因此您可以将系列调整为事件时间而不是日历月份, 美元政策利率终点 并且其欧元和英等值,以添加利率差异层.

实用例子:发现可用的指标

在构建新模型之前,您可以通过 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指标设置在 澳元国际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,AUD和NZD政策利率日期,并收到单个合并日历回复. 查看全文 美国加密货币政策利率参考 对于REST等值.

图像QL 与 REST:何时使用每一个

两个接口都从同一个FireStore支持的数据库中获取,并且携带相同的数据. announcement_datetime 精度.选择是一个工作流程决定:

开始

GraphQL终端点可用于所有用户,使用用于 REST 表面的相同 API 键.不需要额外的配置.