Day 0
Prove access
Create the key, complete one authenticated request, and save the first response with its metadata.
Open step →API workflow guide
What do you want to build?
Choose the outcome closest to your job. Each path gives you one working request, what the response should contain, how to check it worked, and the next useful step.
Five practical paths
Start with the outcome, not the endpoint list.
Selected: Plan release jobs
Path 1
Fetch macro data
Retrieve a clean time series and keep the source and quality metadata beside it.
Path 2
Plan release jobs
Use the release calendar to run targeted jobs around known publication times.
Path 3
Measure surprises
Join pre-release forecasts to the published value without introducing lookahead bias.
Path 4
Receive live updates
Use SSE as an invalidation signal, then fetch the complete record from REST.
Path 5
Build a macro model
Turn a small group of related indicators into a source-labelled currency scorecard.
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.
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 →Scheduled workflow
Plan around confirmed releases
The calendar tells your scheduler when a release is expected. Your job can then fetch the full announcement record after publication instead of polling every series continuously.
Working example
Keep your key in FXMD_API_KEY; never paste it into source control.
from datetime import date, timedelta
import os
import requests
events = requests.get(
"https://api.fxmacrodata.com/v1/calendar/eur",
params={
"api_key": os.environ["FXMD_API_KEY"],
"start_date": date.today().isoformat(),
"end_date": (date.today() + timedelta(days=14)).isoformat(),
"timezone": "UTC",
},
timeout=20,
).json()["data"]
print(events[:3])Expected result: Upcoming EUR releases with dates, times, indicator paths, and confirmation fields that your scheduler can evaluate before creating a job.
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.
| Guide | Use it when | Start |
|---|---|---|
| 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 → |