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/v2
in 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 | ||
(batch) | https://api.amberdata.com/markets/futures/batch-funding-rates/{exchange} | https://web3api.io/api/v2/market/{futures|swaps}/funding-rates/exchange/{exchange}/historical | |
https://web3api.io/api/v2/market/{futures|swaps}/funding-rates/exchange/{exchange}/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 | ||
(batch) | https://api.amberdata.com/markets/futures/batch-open-interest/{exchange} | https://web3api.io/api/v2/market/{futures|swaps}/open-interest/exchange/{exchange}/historical | |
https://web3api.io/api/v2/market/{futures|swaps}/open-interest/exchange/{exchange}/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) Endpoints
will be deprecated. 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.