Skip to main content
GET
/
futures
/
trades
/
{instrument}
Historical
curl --request GET \
  --url https://api.amberdata.com/markets/futures/trades/{instrument} \
  --compressed \
  --header 'Accept-Encoding: <accept-encoding>' \
  --header 'x-api-key: <api-key>'
{
  "status": 200,
  "title": "OK",
  "description": "Successful request",
  "payload": {
    "metadata": {
      "next": "https://api.amberdata.com/markets/futures/trades/BTCUSD_PERP?cursor=N4IgpgHgxgFghgOwOZhALhAIwJYMVVAGhCgFcAnAZwHtz0FSAbR4ygFznLYBE43U0ARgDsIgKyCAHAE5hAZgBMwycTAIAJr37oRIgGwAGMUcEK5KkLiiNS6sAFUElUgAcXtfuoCi0eMjCU6ABmcIyUYMRs2AC2YABitNF86CDR2MzY4VDUGoHEQYnJGABWNAggrB4A0mAAnim6whIy8kqSAPoG7Th4CATtkoLSkpJGI%2B0AQgAqAML2AMrc7QAKXgBKyyAAvkA",
      "api-version": "2023-09-30"
    },
    "data": [
      {
        "instrument": "BTCUSD_PERP",
        "exchange": "binance",
        "exchangeTimestamp": 1717518651671,
        "exchangeTimestampNanoseconds": 0,
        "isBuySide": false,
        "price": 70845.5,
        "volume": 21,
        "tradeId": "819875589",
        "quoteVolume": null,
        "sequence": null
      },
      {
        "instrument": "BTCUSD_PERP",
        "exchange": "binance",
        "exchangeTimestamp": 1717518651671,
        "exchangeTimestampNanoseconds": 0,
        "isBuySide": false,
        "price": 70845.5,
        "volume": 64,
        "tradeId": "819875590",
        "quoteVolume": null,
        "sequence": null
      }
    ]
  }
}
BitMEX’s volume field represents the number of contracts traded, not the volume in the base asset.To obtain the correct volume, users must adjust for contract size using the underlyingToPositionMultiplier from our Reference endpoint.For details on this calculation and how to retrieve the correct values, see our Changelog Update.
The maximum time range (difference between startDate and endDate) is 731 days (2 years).
If the startDate and endDate query parameters are not provided, the API will return the data from the previous 24 hours.

Authorizations

​
x-api-key
string
header
required

Headers

​
Accept-Encoding
string
default:gzip, deflate, br
required
​
api-version
string

Path Parameters

​
instrument
string
default:BTCUSD_PERP
required

Query Parameters

​
exchange
string
default:binance
required

The exchange for which data should be retrieved. Only 1 exchange is allowed.

​
startDate
string<date-time>

[Optional] Payload only includes data after this date (inclusive). [Defaults] Beginning of the current hour (max time range is 1 hour). [Formats] seconds | milliseconds | iso8601 [Examples] 1578531600 | 1578531600000 | 2020-09-01T01:00:00

​
endDate
string<date-time>

[Optional] Payload only includes data before this date (exclusive). [Defaults] One hour after the beginning of the current hour (max time range is 1 hour). [Formats] seconds | milliseconds | iso8601 [Examples] 1578531600 | 1578531600000 | 2020-09-01T01:00:00

​
timeFormat
enum<string>
default:hr

[Optional] Time format of the timestamps in the response.

Available options:
milliseconds,
ms*,
iso,
iso8601,
hr,
human_readable
​
sortDirection
string

[Optional] Specifies the direction in which the data is sorted (by timestamp). [Defaults] asc (ascending order). [Usage Conditions] This parameter can only be used if the startDate and endDate timeframe is within the most recent 24 hours, or if the startDate and endDate parameters are not used at all. [Examples] ascending | descending | asc | desc

Response

200

​
status
integer
​
title
string
​
description
string
​
payload
object