GET /macro/rates

Endpoint

GET https://api.marketdataset.ai/macro/rates

Interest rate differentials are a primary driver of forex prices. This endpoint provides historical policy rates for all major central banks.

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"

import requests

response = requests.get(
    "https://api.marketdataset.ai/macro/rates",
    params={"country": "US", "limit": 12},
    headers={"X-API-KEY": "sk_your_key"},
)
print(response.json())

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)

Forex

Crypto

Macro

Endpoint

Parameters

Covered central banks

Credit cost

Example request

Example response

Fields

​Endpoint

​Parameters

​Covered central banks

​Credit cost

​Example request

​Example response

​Fields

Endpoint

Parameters

Covered central banks

Credit cost

Example request

Example response

Fields