🔗 REST API - HistoricalExchange Rates

Timeseries data

Get the historical exchange rates between two assets in the form of the timeseries.

GET
/v1/exchangerate/{asset_id_base}/{asset_id_quote}/history

Authorization

APIKey
headerX-CoinAPI-Key<token>

CoinAPI API key needed to access the endpoints

Path Parameters

asset_id_base*string

Requested exchange rates base asset identifier (from the Metadata -> Assets)

asset_id_quote*string

Requested exchange rates base asset identifier (from the Metadata -> Assets)

Query Parameters

period_id?string

Identifier of requested timeseries period (required, e.g. 5SEC or 1HRS)

time_start?string

Timeseries starting time in ISO 8601 (required)

time_end?string

Timeseries ending time in ISO 8601 (required)

limit?integer

Amount of items to return (optional, mininum is 1, maximum is 100000, default value is 100, if the parameter is used then every 100 output items are counted as one request)

Formatint32
Default100
extended_gap_filling?boolean

If true, enables extended gap filling that considers rates before time_start and after time_end for proper gap filling at boundaries (optional, default is false)

Defaultfalse

Response Body

successful operation

  1. response
[index: integer]?

Represents an item in the exchange rate timeseries.

curl -X GET 'https://api-historical.fx.finfeedapi.com/v1/exchangerate/string/string/history'
[  {    "time_period_start": "2016-01-01T00:00:00.0000000Z",    "time_period_end": "2016-01-01T00:01:00.0000000Z",    "time_open": "2016-01-01T00:00:00.0000000Z",    "time_close": "2016-01-01T00:00:00.0000000Z",    "rate_open": 430.586617904731,    "rate_high": 430.586617904731,    "rate_low": 430.586617904731,    "rate_close": 430.586617904731  },  {    "time_period_start": "2016-01-01T00:01:00.0000000Z",    "time_period_end": "2016-01-01T00:02:00.0000000Z",    "time_open": "2016-01-01T00:01:00.0000000Z",    "time_close": "2016-01-01T00:01:00.0000000Z",    "rate_open": 430.38999999999993,    "rate_high": 430.38999999999993,    "rate_low": 430.38999999999993,    "rate_close": 430.38999999999993  },  {    "time_period_start": "2016-01-01T00:02:00.0000000Z",    "time_period_end": "2016-01-01T00:03:00.0000000Z",    "time_open": "2016-01-01T00:02:00.0000000Z",    "time_close": "2016-01-01T00:02:00.0000000Z",    "rate_open": 430.6522189770523,    "rate_high": 430.6522189770523,    "rate_low": 430.6522189770523,    "rate_close": 430.6522189770523  }]