Documentation Index
Fetch the complete documentation index at: https://docs.marketdataset.ai/llms.txt
Use this file to discover all available pages before exploring further.
Endpoint
GET https://api.marketdataset.ai/macro/rates
Parameters
| Name | Type | Required | Description |
|---|
country | string | No | Country code: US, EU, GB, JP, CH, AU, NZ, CA, NO, SE |
start_date | string | No | ISO 8601 date |
end_date | string | No | ISO 8601 date |
limit | integer | No | Records to return (default: 100, max: 500) |
cursor | string | No | Pagination cursor |
Covered central banks
| Country | Central Bank | Currency |
|---|
| US | Federal Reserve | USD |
| EU | European Central Bank | EUR |
| GB | Bank of England | GBP |
| JP | Bank of Japan | JPY |
| CH | Swiss National Bank | CHF |
| AU | Reserve Bank of Australia | AUD |
| NZ | Reserve Bank of New Zealand | NZD |
| CA | Bank of Canada | CAD |
| NO | Norges Bank | NOK |
| SE | Riksbank | SEK |
Credit cost
$0.010 per request
Example request
curl "https://api.marketdataset.ai/macro/rates?country=US&limit=12" \
-H "X-API-KEY: sk_your_key"
Example response
{
"rates": [
{
"country": "US",
"bank_name": "Federal Reserve",
"rate": 5.33,
"effective_date": "2024-09-01",
"change": -0.25
},
{
"country": "US",
"bank_name": "Federal Reserve",
"rate": 5.58,
"effective_date": "2024-08-01",
"change": 0.0
}
],
"next_page_url": null,
"meta": {
"request_id": "req_abc123",
"credits_used": 0.01,
"credits_remaining": 49.99
}
}
Fields
| Field | Description |
|---|
rate | Policy rate in percent (e.g. 5.33 = 5.33%) |
effective_date | Date the rate took effect (monthly resolution) |
change | Change from previous month (in percentage points) |
