> ## Documentation Index
> Fetch the complete documentation index at: https://docs.amberdata.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Decorated Trades

> This endpoint returns option “times and sales” data decorated with pre-trade level-1 order book data, along with Greeks and implied volatility metrics.Order book impact logic is used internally for GEX (“Gamma Exposure”) modeling. The TradFi decorated trades response does not include aggressor classification or direction fields such as amberdataDirection or exchangeDirection.



## OpenAPI

````yaml get /analytics/trades-flow/decorated-trades/tradfi
openapi: 3.1.0
info:
  title: derivatives-api
  version: '2'
servers:
  - url: https://api.amberdata.com/markets/derivatives
security:
  - sec0: []
paths:
  /analytics/trades-flow/decorated-trades/tradfi:
    get:
      summary: Decorated Trades
      description: >-
        This endpoint returns option “times and sales” data decorated with
        pre-trade level-1 order book data, along with Greeks and implied
        volatility metrics.Order book impact logic is used internally for GEX
        (“Gamma Exposure”) modeling. The TradFi decorated trades response does
        not include aggressor classification or direction fields such as
        amberdataDirection or exchangeDirection.
      operationId: tradfi-trades-flow-decorated-trades
      parameters:
        - name: currency
          in: query
          description: >
            **[Required]** The underlying currency for which there are listed
            option instruments. 

            **[Examples]** ` IBIT | COIN ` 
          required: true
          schema:
            type: string
            default: IBIT
        - name: expiration
          in: query
          description: >-
            **[Optional]** Filter records based on the specified expiration
            date. 

            **[Examples]** `1578531600 | 1578531600000 | 2026-01-16`
          schema:
            type: string
            format: date-time
        - name: instrument
          in: query
          description: >-
            **[Optional]** Users can pass a single instrument in order to
            retrieve trade data for only the specified instrument. 

            **[Examples]** ` IBIT-16JAN26-100-C`
          schema:
            type: string
        - name: startDate
          in: query
          description: >-
            **[Optional]** Payload only includes data after this date
            (inclusive). 

            **[Formats]** `seconds | milliseconds | iso8601`

            **[Examples]** `1578531600 | 1578531600000 | 2020-09-01T01:00:00`
          schema:
            type: string
            format: date-time
            default: '2024-11-21T15:00:00.000Z'
        - name: endDate
          in: query
          description: >-
            **[Optional]** Payload only includes data before this date
            (exclusive). 

            **[Formats]** `seconds | milliseconds | iso8601`

            **[Examples]** `1578531600 | 1578531600000 | 2020-09-01T01:00:00`
          schema:
            type: string
            format: date-time
            default: '2024-11-21T16:00:00.000Z'
        - name: strike
          in: query
          description: >-
            **[Optional]** The option instrument subset with a given strike
            price. 

            **[Examples]** ` 100 | 35 `
          schema:
            type: integer
            format: int32
        - name: timeFormat
          in: query
          description: >-
            **[Optional]** Time format of the timestamps in the return payload.

            **[Defaults]** `milliseconds | ms* | iso | iso8601 | hr |
            human_readable`
          schema:
            type: string
            default: hr
        - name: Accept-Encoding
          in: header
          schema:
            type: string
            default: gzip
        - name: tradeAmountMinimum
          in: query
          description: >-
            **[Optional]** This endpoint allows users to filter trades that meet
            a select trade size criteria.
          schema:
            type: string
        - name: tradeAmountMaximum
          in: query
          description: >-
            **[Optional]** This endpoint allows users to filter trades that do
            not exceed a select trade size criteria.
          schema:
            type: string
      responses:
        '200':
          description: '200'
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: integer
                  title:
                    type: string
                  description:
                    type: string
                  payload:
                    type: object
              examples:
                Result:
                  value:
                    status: 200
                    title: OK
                    description: Successful request
                    payload:
                      data:
                        - currency: IBIT
                          delta: 0.43959
                          exchange: tradfi
                          exchangeDirection: Mid
                          exchangeTimestamp: -62135596800000
                          expirationTimestamp: -62135596800000
                          gamma: 0.00903
                          instrument: IBIT-16JAN26-100-C
                          instrumentNormalized: TRADFI-IBIT-16JAN26-100.0-C
                          postTradeAskPrice: 9.7
                          postTradeBidPrice: 9.6
                          postTradeMarkIv: 0.77772
                          postTradeMarkPrice: 9.73688
                          preTradeAskIv: 77.5999984741211
                          preTradeAskPrice: 9.7
                          preTradeAskVolume: 24
                          preTradeBidIv: 77.18000030517578
                          preTradeBidPrice: 9.6
                          preTradeBidVolume: 2
                          preTradeMidIv: 77.38668060302734
                          preTradeMidPrice: 9.649999618530273
                          priceUsd: 9.6
                          putCall: C
                          rho: 0.16573
                          theta: -0.03028
                          tradeAmount: 1
                          tradeIv: 0.77178
                          underlyingPrice: 54.755
                          vega: 0.23938
                          volume24h: 1299
        '400':
          description: '400'
          content:
            application/json:
              examples:
                Result:
                  value: {}
              schema:
                type: object
                properties: {}
      deprecated: false
      security:
        - ApiKeyAuth: []
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````