How to Connect FXMacroData to ChatGPT Custom GPTs banner image

Implementation

How-To Guides

How to Connect FXMacroData to ChatGPT Custom GPTs

Step-by-step guide to wiring FXMacroData into a ChatGPT Custom GPT using OpenAPI Actions so your GPT can answer live macro questions out of the box.

By the end of this guide your Custom GPT will be able to answer live macroeconomic questions — policy-rate history, upcoming central-bank release dates, COT positioning, precious-metals prices, FX spot rates — without you writing a single line of backend code. All it takes is one OpenAPI Actions block pointing at the FXMacroData API.

What you will achieve

  • Live macro data in any Custom GPT conversation — ask “What is the current AUD policy rate?” or “When is the next ECB meeting?” and get an answer drawn from the FXMacroData API in real time
  • OpenAPI Actions configuration — import the FXMacroData schema from a URL and ChatGPT auto-discovers every available endpoint
  • Secure API-key setup — authenticate using a query-parameter key so your GPT can access any of the 18 supported currencies
  • MCP alternative — a brief note for ChatGPT desktop app users who prefer the Model Context Protocol path

Prerequisites

  • ChatGPT Plus, Team, or Enterprise subscription — Custom GPT creation and Actions require a paid plan
  • A FXMacroData API key — sign up at fxmacrodata.com/subscribe; USD indicator data is free with no key, but a key unlocks all 18 currencies
  • Basic familiarity with the ChatGPT Custom GPT builder (the Create and Configure tabs)

Why macro data inside a Custom GPT matters

A Custom GPT can already reason about FX strategy, carry trades, or central-bank policy in the abstract — but until it has live data it is reasoning from training knowledge that may be months out of date. By adding FXMacroData as an Action, your GPT can fetch the actual latest CPI print, the real COT positioning figure, or the exact release schedule for the week ahead, and weave those figures directly into its answer.

This is especially useful for trading assistants, macro briefing bots, and research co-pilots: the GPT handles the language and reasoning while FXMacroData handles the data — a clean separation that keeps your GPT accurate and up-to-date without you maintaining any data pipeline.


Path A — OpenAPI Actions Recommended for Custom GPTs

Custom GPTs use Actions to call external APIs. You provide an OpenAPI 3.x schema and ChatGPT maps every operation in that schema to a callable tool. FXMacroData publishes a public OpenAPI schema that describes all its endpoints, so a single import step gives your GPT access to the entire data catalogue.

Step 1 — Open the Custom GPT builder

In ChatGPT, click Explore GPTs in the left sidebar, then + Create in the top-right corner. Switch to the Configure tab to access the schema and actions settings.

Tip: Give your GPT a focused system prompt before adding Actions. For example: “You are a macroeconomic analyst assistant. When asked about interest rates, inflation, employment, GDP, or FX data, always call the FXMacroData tools to retrieve the latest figures before answering.” This ensures the GPT prefers live data over stale training knowledge.

Step 2 — Add FXMacroData as an Action

Scroll to the Actions section at the bottom of the Configure tab and click Add actions. On the actions editor page, click Import from URL and paste the FXMacroData OpenAPI schema URL:

https://fxmacrodata.com/api/openapi.json

Click Import. ChatGPT fetches the schema and automatically populates the list of available operations. You should see endpoints for announcements, the release calendar, FX spot rates, COT data, commodities, and more appear in the actions list.

Operation What ChatGPT can fetch Example question
/v1/announcements/{currency}/{indicator} Historical indicator values with announcement timestamps “What is the current AUD policy rate?”
/v1/calendar/{currency} Upcoming macro release schedule for a currency “When is the next Fed decision?”
/v1/forex/{base}/{quote} Daily FX spot rates with optional technical overlays “What is EUR/USD trading at?”
/v1/cot/{currency} CFTC Commitments of Traders positioning data “What is the COT net position for JPY?”
/v1/commodities/{indicator} Precious-metals prices (gold, silver, platinum) “What is the current gold price?”
/v1/catalogue/{currency} Available indicators and currencies in the data catalogue “What indicators are available for NZD?”

Step 3 — Configure authentication

Directly below the imported schema, find the Authentication section and click the pencil icon to edit it. Set the auth type to API Key, choose Query parameter as the delivery method, and set the parameter name to api_key. Paste your FXMacroData API key in the value field and save.

Auth type

API Key

Auth location

Query parameter

Parameter name

api_key

With this configuration, ChatGPT appends ?api_key=<your-key> to every request it makes to fxmacrodata.com. The key is stored securely by OpenAI and never exposed in conversation output.

No key yet? USD indicator data is available without authentication. Leave the auth field blank to test with USD endpoints first, then add your key to unlock all 18 currencies. Sign up at fxmacrodata.com/subscribe.

Step 4 — Set the privacy policy URL and save

ChatGPT requires a privacy policy URL for any GPT that calls external APIs. Enter https://fxmacrodata.com/privacy in the Privacy policy field, then click Save to finalise your GPT configuration.

Step 5 — Test the connection

Open the GPT preview panel on the right side of the builder and ask a live macro question. A good first test:

“What is the current USD policy rate and when is the next Fed decision?”

ChatGPT calls the announcements endpoint for usd/policy_rate and the calendar endpoint for usd in the background, then synthesises both results into its answer. The underlying REST calls are:

# Latest USD policy rate series
curl "https://fxmacrodata.com/api/v1/announcements/usd/policy_rate?api_key=YOUR_API_KEY"

# Upcoming USD release schedule
curl "https://fxmacrodata.com/api/v1/calendar/usd?api_key=YOUR_API_KEY"

Representative announcements response:

{
  "currency": "USD",
  "indicator": "policy_rate",
  "data": [
    { "date": "2026-03-19", "val": 4.50, "announcement_datetime": 1742414400 },
    { "date": "2026-01-29", "val": 4.50, "announcement_datetime": 1738184400 },
    { "date": "2025-12-18", "val": 4.50, "announcement_datetime": 1734541200 },
    { "date": "2025-11-07", "val": 4.75, "announcement_datetime": 1731002400 }
  ]
}

Your GPT can now state the current rate and announce the next meeting date with second-level timestamp precision — drawn from live data, not training knowledge.

Step 6 — Try real analyst workflows

Once the connection is confirmed, your Custom GPT is ready for more sophisticated multi-step queries. A few examples:

Carry-trade setup

“Compare the USD and AUD policy rates over the last year and tell me the current rate differential. Is a long AUD/USD carry attractive right now?”

Pre-release briefing

“What high-impact macro releases are scheduled for GBP and EUR this week? Summarise the prior values and consensus forecasts where available.”

COT positioning check

“What is the latest CFTC COT positioning for JPY futures? Is the net position near a historical extreme?”

Gold and safe-haven flows

“Show me gold prices for the last 3 months alongside USD inflation. What does the relationship suggest about real yields?”

For each of these prompts, ChatGPT selects the right Action(s) from the imported schema — you never need to specify which endpoint to call or construct a URL. Indicator documentation is at /api-data-docs if you want to understand the full field schema or explore less common indicators like non-farm payrolls or EUR inflation.


Path B — MCP via the ChatGPT Desktop App Alternative

OpenAI has added Model Context Protocol (MCP) support to the ChatGPT desktop app (macOS and Windows). If you are using the desktop app rather than the web-based Custom GPT builder, you can connect FXMacroData as an MCP server instead of configuring OpenAPI Actions. MCP works in the standard ChatGPT chat interface and does not require a Custom GPT.

Scope note: MCP in the ChatGPT desktop app is separate from Custom GPT Actions. It applies to your personal ChatGPT session on macOS or Windows, not to a shareable Custom GPT. Use Path A (Actions) if you want a Custom GPT that others can access.

Option A — Hosted MCP endpoint (zero install)

Add the following entry to your ChatGPT desktop app’s MCP configuration (found under Settings → Extensions → Model Context Protocol or by editing ~/Library/Application Support/ChatGPT/mcp_config.json on macOS):

{
  "mcpServers": {
    "fxmacrodata": {
      "type": "streamable-http",
      "url": "https://fxmacrodata.com/mcp?api_key=YOUR_API_KEY"
    }
  }
}

Option B — Local server via uvx

Use this if you prefer a local process or need to pass the API key through an environment variable rather than in the URL. The mcp-server-fxmacrodata PyPI package is downloaded and executed automatically by uvx:

{
  "mcpServers": {
    "fxmacrodata": {
      "command": "uvx",
      "args": ["mcp-server-fxmacrodata"],
      "env": {
        "FXMACRODATA_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

After saving the config, restart the ChatGPT desktop app. You can then ask FXMacroData questions directly in the ChatGPT conversation window — the MCP tools are resolved in the background. Type “Ping the FXMacroData server” to verify connectivity before running your first data query.


Summary

You have connected FXMacroData to a ChatGPT Custom GPT in three steps: imported the OpenAPI schema from https://fxmacrodata.com/api/openapi.json, configured query-parameter API-key authentication, and verified the connection with a live policy-rate query. Your GPT can now answer macro questions with real data — not training-set approximations.

Quick-start recap
1. Open ChatGPT → Explore GPTs → + Create → Configure.
2. Scroll to Actions → Add actions → Import from URL: paste https://fxmacrodata.com/api/openapi.json.
3. Set Authentication: API Key / Query parameter / api_key and enter your key.
4. Add privacy policy URL: https://fxmacrodata.com/privacy and click Save.
5. Test: “What is the current USD policy rate and when is the next Fed decision?”

Ready to extend the integration? Browse the FXMacroData API docs for the full indicator catalogue across all 18 currencies, or explore the MCP server reference for desktop app configuration options. If you do not yet have a key, subscribe to unlock the complete currency set and all indicators.