Data versioning
Kaiko takes transparency and accountability very seriously. Therefore, our provided datasets are versioned. Dataset versioning is orthogonal to API versioning. Any potential breaking changes in results (e.g. semantical changes or corrections of historically incorrect data) will result in a new dataset version - no corrections or adjustments will be done in the dark. Addition of new data will not result in a new dataset version. Data is versioned on a per-base-data level.
The versioning is selected by selecting a base data set and a version. All current Market Data API endpoints take the commodity
and data_version
parameters.
By setting this to latest
, you will get the most recent version. The returned version is always included in the query
field and can be referred to if you would ever need to compare results, should we ever need to adjust historical data. Paginating over a request with version set to latest
will preserve the current version across subsequent pagination requests.
We recommend using the most current version explicitly in production integrations as the latest
label might move at any time to a breaking change. For the trades
and order_book_snapshots
commodities the latest version is currently v1
Last updated