Historical rates for currency pairs
GET {{baseUrl}}/v1beta1/forex/rates?currency_pairs=USDJPY,USDMXN
Get historical forex rates for the given currency pairs in the given time interval, and at the given timeframe (snapshot frequency).
Request Params
| Key | Datatype | Required | Description |
|---|---|---|---|
currency_pairs | string | (Required) | |
timeframe | string | ||
start | string | The inclusive start of the interval. Format: RFC-3339 or YYYY-MM-DD. | |
| If missing, the default value is the beginning of the current day. | |||
end | string | The inclusive end of the interval. Format: RFC-3339 or YYYY-MM-DD. | |
| If missing, the default value is the current time. | |||
limit | number | The maximum number of data points to return in the response. | |
| The API may return less, even if there are more available data points in the requested interval. | |||
| Always check the next_page_token for more pages. | |||
| The limit applies to the total number of data points, not per symbol! | |||
sort | string | Sort data in ascending or descending order. | |
page_token | string | Pagination token to continue from. The value to pass here is returned in specific requests when more data is available than the request limit allows. |
HEADERS
| Key | Datatype | Required | Description |
|---|---|---|---|
Accept | string |
RESPONSES
status: OK
{"next_page_token":"VVNESlBZfDIwMjItMDEtMDNUMDA6MDM6MDBa","rates":{"USDJPY":[{"bp":114.192,"mp":115.144,"ap":115.18,"t":"2022-01-03T00:01:00Z"},{"bp":114.189,"mp":115.138,"ap":115.185,"t":"2022-01-03T00:02:00Z"},{"bp":115.122,"mp":115.131,"ap":115.148,"t":"2022-01-03T00:03:00Z"}]}}