We’ve redesigned our spot, futures and swaps market data endpoints to be familiar and simpler to use, resulting in the following benefits
-
Combining the separate /latest and /historical endpoints for each data type.
-
Consistent pagination for large queries.
-
Increased max range of 2 years (731 days) for startDate and endDate.
-
Combining futures and swaps endpoints.
-
Deprecation of /latest and /historical endpoints
-
Removal of
/api/v2in the path
Here are tables showing the consolidation of /latest and /historical for spot, futures and swaps
Spot
| Data Type | New Endpoints | Legacy (Deprecated Endpoints) | Old Documentation URL |
|---|---|---|---|
| Trades | https://api.amberdata.com/markets/spot/trades/{pair} | https://web3api.io/api/v2/market/spot/trades/{pair}/historical | https://docs.amberdata.io/reference/market-trades |
| Tickers | https://api.amberdata.com/markets/spot/tickers/{pair} | https://web3api.io/api/v2/market/spot/tickers/{pair}/historical | https://docs.amberdata.io/reference/get-market-ticker-pair-historical |
https://web3api.io/api/v2/market/spot/tickers/{pair}/latest | https://docs.amberdata.io/reference/get-latest-market-ticker | ||
| Order Book Events | https://api.amberdata.com/markets/spot/order-book-events/{pair} | https://web3api.io/api/v2/market/spot/order-book-events/{pair}/historical | https://docs.amberdata.io/reference/order-book-updates |
| Order Book Snapshots | https://api.amberdata.com/markets/spot/order-book-snapshots/{pair} | https://web3api.io/api/v2/market/spot/order-book-snapshots/{pair}/historical | https://docs.amberdata.io/reference/get-market-orders |
Futures & Swaps
| Data Type | New Endpoints | Legacy (Deprecated) Endpoints | Old Documentation URL |
|---|---|---|---|
| Funding Rates | https://api.amberdata.com/markets/futures/funding-rates/{instrument} | https://web3api.io/api/v2/market/{futures|swaps}/funding-rates/{instrument}/historical | https://docs.amberdata.io/reference/futures-funding-rates-historical-old |
https://web3api.io/api/v2/market/{futures|swaps}/funding-rates/{instrument}/latest | https://docs.amberdata.io/reference/futures-funding-rates-latest | ||
| Insurance Fund | https://api.amberdata.com/markets/futures/insurance-fund/{instrument} | https://web3api.io/api/v2/market/{futures|swaps}/insurance-fund/{instrument}/historical | https://docs.amberdata.io/reference/futures-insurance-fund-historical |
https://web3api.io/api/v2/market/{futures|swaps}/insurance-fund/{instrument}/latest | https://docs.amberdata.io/reference/futures-insurance-fund-latest | ||
| Liquidations | https://api.amberdata.com/markets/futures/liquidations/{instrument} | https://web3api.io/api/v2/market/{futures|swaps}/liquidations/{instrument}/historical | https://docs.amberdata.io/reference/futures-liquidations-historical-old |
https://web3api.io/api/v2/market/{futures|swaps}/liquidations/{instrument}/latest | https://docs.amberdata.io/reference/futures-liquidations-latest | ||
| Long/Short Ratio | https://api.amberdata.com/markets/futures/long-short-ratio/{instrument} | https://web3api.io/api/v2/market/{futures|swaps}/long-short-ratio/{instrument}/historical | https://docs.amberdata.io/reference/futures-long-short-ratio-historical-old |
https://web3api.io/api/v2/market/{futures|swaps}/long-short-ratio/{instrument}/latest | https://docs.amberdata.io/reference/futures-long-short-ratio-latest | ||
| Open Interest | https://api.amberdata.com/markets/futures/open-interest/{instrument} | https://web3api.io/api/v2/market/{futures|swaps}/open-interest/{instrument}/historical | https://docs.amberdata.io/reference/futures-open-interest-historical-old |
https://web3api.io/api/v2/market/{futures|swaps}/open-interest/{instrument}/latest | https://docs.amberdata.io/reference/futures-open-interest-latest | ||
| Order Books Events | https://api.amberdata.com/markets/futures/order-book-events/{instrument} | https://web3api.io/api/v2/market/{futures|swaps}/order-book-events/{instrument}/historical | https://docs.amberdata.io/reference/futures-order-book-events-historical |
| Order Book Snapshots | https://api.amberdata.com/markets/futures/order-book-snapshots/{instrument} | https://web3api.io/api/v2/market/{futures|swaps}/order-book-snapshots/{instrument}/historical | https://docs.amberdata.io/reference/futures-order-book-snapshots-historical |
| Tickers | https://api.amberdata.com/markets/futures/tickers/{instrument} | https://web3api.io/api/v2/market/{futures|swaps}/tickers/{instrument}/historical | https://docs.amberdata.io/reference/futures-tickers-historical-old |
https://web3api.io/api/v2/market/{futures|swaps}/tickers/{instrument}/latest | https://docs.amberdata.io/reference/futures-tickers-latest | ||
| Trades | https://api.amberdata.com/markets/futures/trades/{instrument} | https://web3api.io/api/v2/market/{futures|swaps}/trades/{instrument}/historical | https://docs.amberdata.io/reference/futures-trades-historical-old |
Deprecation for */latest */historical
All the endpoints listed in the column
Legacy (Deprecated) Endpointswill be deprecated on June 28, 2024. These endpoints will be shut off and all requests to them will return errors.
What about Market Data Options?
We will be launching a similar consolidation of the Options API endpoints in an upcoming version.