GET
/
analytics
/
trades-flow
/
decorated-trades
Decorated Trades
curl --request GET \
  --url https://api.amberdata.com/markets/derivatives/analytics/trades-flow/decorated-trades
{
  "status": 200,
  "title": "OK",
  "description": "Successful request",
  "payload": {
    "data": [
      {
        "exchange": "deribit",
        "preTradeOrderbookTimestamp": 1716161307196,
        "exchangeTimestamp": 1716161308175,
        "postTradeOrderbookTimestamp": 1716161308179,
        "tradeId": "302085048",
        "instrument": "BTC-24MAY24-68000-C",
        "instrumentNormalized": "DERIBIT-BTC-24MAY24-68000.0-C",
        "currency": "BTC",
        "expirationTimestamp": 1716537600000,
        "strike": 68000,
        "putCall": "C",
        "blockTradeId": null,
        "numberOfLegs": 0,
        "liquidation": null,
        "tickDirection": "Minus Tick",
        "tradeAmount": 0.3,
        "tradeIv": 49.55,
        "price": 0.0115,
        "priceUsd": 762.697135,
        "indexPrice": 66242.94,
        "underlyingPrice": 66321.49,
        "volume24h": 46,
        "priceHigh24h": 0.02,
        "priceLow24h": 0.012,
        "preTradeBidVolume": 21.1,
        "preTradeBidIv": 48.29,
        "preTradeBidPrice": 0.011,
        "preTradeMidIv": 48.92,
        "preTradeMidPrice": 0.01125,
        "preTradeMarkIv": 49.2,
        "preTradeMarkPrice": 0.0114,
        "preTradeAskVolume": 0.3,
        "preTradeAskIv": 49.55,
        "preTradeAskPrice": 0.0115,
        "postTradeBidVolume": 0.7,
        "postTradeBidIv": 49.55,
        "postTradeBidPrice": 0.0115,
        "postTradeMidIv": 50.18,
        "postTradeMidPrice": 0.01175,
        "postTradeMarkIv": 49.2,
        "postTradeMarkPrice": 0.0114,
        "postTradeAskVolume": 63.7,
        "postTradeAskIv": 50.81,
        "postTradeAskPrice": 0.012,
        "delta": 0.33062,
        "gamma": 0.0001,
        "theta": -148.29166,
        "vega": 26.257,
        "rho": 2.52671,
        "preTradeOpenInterest": 541.1,
        "postTradeOpenInterest": 541.1,
        "openInterestChange": 0
      }
    ]
  }
}

Headers

​
Accept-Encoding
string
default:gzip

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)

​
expiration
string<date-time>

[Optional] Filter records based on the specified expiration date. [Examples] 1578531600 | 1578531600000 | 2020-09-01T01:00:00

​
instrument
string

[Optional] Users can pass a single instrument in order to retrieve trade data for only the specified instrument. [Examples] BTC-26APR24-100000-C

​
putCall
string

[Optional] The option type [Examples] C | P

​
startDate
string<date-time>
default:2024-05-01T00:00:00

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

​
endDate
string<date-time>
default:2024-05-01T01:00:00

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

​
strike
integer

[Optional] The option instrument subset with a given strike price. [Examples] 100000 | 3500

​
timeFormat
string

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

​
blockTradeId
boolean

[Optional] This flag enables users to filter for only blockTrade or non-blockTrades. If the user wants everything returned they can choose to leave the parameter blank.

Response

200
application/json

Successful request

The response is of type object.