Skip to content

API workflow guide

What do you want to build?

Start with a research workflow and a spreadsheet, or follow an API guide to build your own application.

Start with a research workflow

Choose a starting point, review the evidence, and keep a workbook you can rebuild.

Starter access · USD macro

Inflation monitor

Track US headline and core inflation alongside EUR/USD.

Open workflow
Subscription required

Central-bank policy comparison

Compare US and euro-area policy rates alongside EUR/USD.

Open workflow
Subscription required

Release and revision review

Inspect retained US inflation releases, values and publication evidence.

Open workflow

Check coverage before choosing a plan. Already use a spreadsheet integration? Follow the Excel guide or Google Sheets guide for supported functions and refresh behaviour.

Evaluating the API? Inspect the restricted historical developer sample and its response fields.

Five practical paths

Start with the outcome, not the endpoint list.

Selected: Troubleshoot a request

Your 14-day API trial

Move from first request to a job worth keeping.

The goal is not to visit every product page. It is to complete useful authenticated API work, return on another day, and leave with a repeatable dataset or application workflow.

Check API progress

Day 0

Prove access

Create the key, complete one authenticated request, and save the first response with its metadata.

Open step →

Days 1-2

Make the request dependable

Resolve authentication or filter problems and turn the first script into a named repeatable job.

Open step →

Days 3-4

Add release timing

Use the calendar as a second endpoint family and schedule the next useful API run.

Open step →

Days 5-7

Build the research output

Add expectations or a small group of macro series, then produce one saved comparison, table, or scorecard.

Open step →

Days 8-10

Automate updates

Choose scheduled REST, SSE, or webhooks and complete another successful API run on a different day.

Open step →

Days 11-13

Harden the client

Add timeouts, bounded retries, response validation, credential-safe logging, and stale-data monitoring.

Open step →

Day 14

Review evidence

Confirm the API supplies a repeatable job your team will keep, then choose the next dataset or application workflow.

Open step →

Request help

Diagnose a failed or empty response

Inspect the status and a short error body, then follow the matching fix. Never paste an API key or a full authenticated URL into a support message.

10 minutes Troubleshooting authenticationannouncements

Working example

Keep your key in FXMD_API_KEY; never paste it into source control.

import os
import requests

key = os.getenv("FXMD_API_KEY", "").strip()
if not key:
    raise RuntimeError("FXMD_API_KEY is not set")

response = requests.get(
    "https://api.fxmacrodata.com/v1/announcements/eur/inflation",
    params={"limit": 1},
    headers={"X-API-Key": key},
    timeout=20,
)
print(response.status_code, response.text[:300])

Expected result: A 200 confirms the key and path work. A 401 or 403 points to authentication or access, a 404 to the path, and a 429 to request pacing.

When the first script becomes a real system

Troubleshooting and production guidance

Use these guides when a response fails, returns no data, or needs production controls such as caching, timeouts, retries, and event delivery.

GuideUse it whenStart
Diagnose a failed or empty response Separate authentication, access, path, rate-limit, and data-availability problems without exposing your key. Open guide →
Make an API client production-ready Add timeouts, bounded retries, caching, conditional requests, and the right delivery pattern. Open guide →