Skip to main content

​
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

NameTypeRequiredDescription
countrystringNoCountry code: US, EU, GB, JP, CH, AU, NZ, CA, NO, SE
start_datestringNoISO 8601 date
end_datestringNoISO 8601 date
limitintegerNoRecords to return (default: 100, max: 500)
cursorstringNoPagination cursor

​
Covered central banks

CountryCentral BankCurrency
USFederal ReserveUSD
EUEuropean Central BankEUR
GBBank of EnglandGBP
JPBank of JapanJPY
CHSwiss National BankCHF
AUReserve Bank of AustraliaAUD
NZReserve Bank of New ZealandNZD
CABank of CanadaCAD
NONorges BankNOK
SERiksbankSEK

​
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

FieldDescription
ratePolicy rate in percent (e.g. 5.33 = 5.33%)
effective_dateDate the rate took effect (monthly resolution)
changeChange from previous month (in percentage points)