Provides detailed metadata and trading activity timelines for futures instruments across exchanges, including funding rates, liquidations, long/short ratios, OHLCV, open interest, order book snapshots and events, ticker updates, and trade history.

get/futures/exchanges/information

Request

  • Base URL
    https://api.amberdata.com/markets
  • URL
    https://api.amberdata.com/markets/futures/exchanges/information
  • Auth
    API key in header x-api-key

Query parameters

exchangestring

[Optional] Only return data for the given exchange(s) (comma separated)

instrumentstring

Only return data for the given pair.

includeInactiveboolean

[Optional] If true, endpoint returns all instruments, including delisted ones. [Defaults] True | False*.

timeFormatstring

[Optional] Time format of the timestamps in the return payload. [Defaults] milliseconds | ms* | iso | iso8601 | hr | human_readable

sizeinteger

[Optional] The number of records per page (only available when includeInactive=true).

Headers

Accept-Encodingstring required
api-versionstring

Response

200

statusinteger
titlestring
descriptionstring

Example response

{
  "status": 200,
  "title": "OK",
  "description": "Successful request",
  "payload": {
    "metadata": {
      "next": "https://api.amberdata.com/markets/futures/exchanges/information?cursor=N4IglgdgxgNgrgEwKYEkIEMoBcwDckgBcAZujAM5IA0408yAqhOXAA6sD2ATlkggKIAPKAAt0EAOZJyRUhWogcAWyQAxbkvRYiIJWBgwwlKBwgIZNYhq06AVuVMgardFKIBGGuTAAvAoQBWAAYggF8gA",
      "api-version": "2023-09-30"
    },
    "data": [
      {
        "exchange": "binance",
        "instrument": "1000BONKUSDC",
        "fundingRate": {
          "startDate": 1714521600000,
          "endDate": 1722369601000
        },
        "liquidation": {
          "startDate": 1714639265467,
          "endDate": 1722370187666
        },
        "longShortRatio": {
          "startDate": 1714636800000,
          "endDate": 1722369600000
        },
        "ohlcv": {
          "startDate": 1714608000000,
          "endDate": 1722211200000
        },
        "openInterest": {
          "startDate": 1714635667663,
          "endDate": 1722373127413
        },
        "orderBookSnapshot": {
          "startDate": 1714635300000,
          "endDate": 1722373440667
        },
        "orderBookEvent": {
          "startDate": 1714635333956,
          "endDate": 1722373199545
        },
        "ticker": {
          "startDate": 1714635454117,
          "endDate": 1722373199496
        },
        "trade": {
          "startDate": 1714635667663,
          "endDate": 1722373188111
        }
      }
    ]
  }
}

Changes