GET
/
analytics
/
options-scanner
/
top-trades
Top Trades
curl --request GET \
  --url https://api.amberdata.com/markets/derivatives/analytics/options-scanner/top-trades \
  --header 'x-api-key: <api-key>'
{
  "status": 200,
  "title": "OK",
  "description": "Successful request",
  "payload": {
    "data": [
      {
        "exchange": "deribit",
        "currency": "BTC",
        "exchangeTimestamp": 1717199992528,
        "indexPrice": 67481.38,
        "instrument": "BTC-7JUN24-71000-C",
        "exchangeDirection": "buy",
        "amberdataDirection": "sell",
        "blockTradeId": null,
        "numberOfLegs": 0,
        "tradeAmount": 0.1,
        "blockAmount": null,
        "tradeIv": 43.04,
        "price": 0.0065,
        "priceUsd": 440.034985,
        "openInterestChange": 0,
        "sizeUSD": 44.003498500000006,
        "sizeDelta": 0.021013000000000004,
        "sizeVega": 2.5712,
        "sizeGamma": 0.000007,
        "sizeTheta": -8.781606,
        "hedgeInstrument": null,
        "hedgeIsBuySide": null,
        "hedgePrice": null,
        "hedgeVolume": null
      },
      {
        "exchange": "deribit",
        "currency": "BTC",
        "exchangeTimestamp": 1717199915036,
        "indexPrice": 67493.38,
        "instrument": "BTC-7JUN24-67000-P",
        "exchangeDirection": "sell",
        "amberdataDirection": "sell",
        "blockTradeId": null,
        "numberOfLegs": 0,
        "tradeAmount": 0.1,
        "blockAmount": null,
        "tradeIv": 42.71,
        "price": 0.0175,
        "priceUsd": 1184.8509750000003,
        "openInterestChange": 0,
        "sizeUSD": 118.48509750000004,
        "sizeDelta": -0.041572,
        "sizeVega": 3.4785719999999998,
        "sizeGamma": 0.00001,
        "sizeTheta": -11.875451,
        "hedgeInstrument": null,
        "hedgeIsBuySide": null,
        "hedgePrice": null,
        "hedgeVolume": null
      },
      {
        "exchange": "deribit",
        "currency": "BTC",
        "exchangeTimestamp": 1717199908178,
        "indexPrice": 67493.66,
        "instrument": "BTC-7JUN24-67000-P",
        "exchangeDirection": "sell",
        "amberdataDirection": "sell",
        "blockTradeId": null,
        "numberOfLegs": 0,
        "tradeAmount": 0.1,
        "blockAmount": null,
        "tradeIv": 42.71,
        "price": 0.0175,
        "priceUsd": 1184.852725,
        "openInterestChange": 0,
        "sizeUSD": 118.48527250000001,
        "sizeDelta": -0.04159,
        "sizeVega": 3.478832,
        "sizeGamma": 0.00001,
        "sizeTheta": -11.876933000000001,
        "hedgeInstrument": null,
        "hedgeIsBuySide": null,
        "hedgePrice": null,
        "hedgeVolume": null
      }
    ],
    "metadata": {
      "api-version": "2023-09-30"
    }
  }
}

Authorizations

​
x-api-key
string
header
required

Query Parameters

​
exchange
string
default:deribit
required

[Required] The exchange for which to retrieve the listed option level 1 quotes. [Examples] deribit | okex | bybit

​
currency
string
default:BTC
required

[Required] The underlying currency for which there are listed option instruments. [Examples] BTC | SOL_USDC Note: inverse options have underlying currencies formatted as (BTC, ETH) while linear option currency formats include the stable coin in the same (SOL_USDC)

​
startDate
string<date-time>
default:2024-05-21
required

[Required] Payload only includes data after this date (inclusive). [Formats] seconds | milliseconds | iso8601 [Examples] 1578531600 | 1578531600000 | 2020-09-01T01:00:00

​
endDate
string
default:2024-05-22
required

[Required] Payload only includes data before this date (exclusive). [Formats] seconds | milliseconds | iso8601 [Examples] 1578531600 | 1578531600000 | 2020-09-01T01:00:00

​
timeFormat
string

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

Response

200
application/json

Successful request

The response is of type object.