> ## 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.

# Options Yields

> The "Covered Call" strategy assumes the trader is long exactly one unit of underlying
asset after proceeds from selling their call.

Example: Underlying price = \$500, Trader position in underlying before selling the call = \$475
Short \$700 call proceeds = \$25 Trader positioning in underlying after short call proceeds = \$500
(one whole unit)

RETURN CALCULATIONS
Absolute Yield: \$25/\$475 Annualized Yield: \$25/\$475 * (525,600 / minutes left until expiration)

The "Cash Secured Put" yield assumes the trader maintains enough cash on hand AFTER proceeds
from selling the put.

Example: Trader's cash position BEFORE selling put = \$275 Short \$300 Put Proceeds = \$25
Trader cash balance AFTER short put proceeds = \$300 (100% cash secured)

RETURN CALCULATIONS
Absolute Yield: \$25/\$275 Annualized Yield: \$25/\$275 * (525,600 / minutes left until expiration)




## OpenAPI

````yaml get /analytics/trades-flow/options-yields
openapi: 3.1.0
info:
  title: derivatives-api
  version: '2'
servers:
  - url: https://api.amberdata.com/markets/derivatives
security:
  - sec0: []
paths:
  /analytics/trades-flow/options-yields:
    get:
      summary: Options Yields
      description: >
        The "Covered Call" strategy assumes the trader is long exactly one unit
        of underlying

        asset after proceeds from selling their call.


        Example: Underlying price = \$500, Trader position in underlying before
        selling the call = \$475

        Short \$700 call proceeds = \$25 Trader positioning in underlying after
        short call proceeds = \$500

        (one whole unit)


        RETURN CALCULATIONS

        Absolute Yield: \$25/\$475 Annualized Yield: \$25/\$475 * (525,600 /
        minutes left until expiration)


        The "Cash Secured Put" yield assumes the trader maintains enough cash on
        hand AFTER proceeds

        from selling the put.


        Example: Trader's cash position BEFORE selling put = \$275 Short \$300
        Put Proceeds = \$25

        Trader cash balance AFTER short put proceeds = \$300 (100% cash secured)


        RETURN CALCULATIONS

        Absolute Yield: \$25/\$275 Annualized Yield: \$25/\$275 * (525,600 /
        minutes left until expiration)
      operationId: derivatives-trades-flow-options-yields
      parameters:
        - name: exchange
          in: query
          description: >
            **[Required]** The exchange for which to retrieve the listed option
            level 1 quotes. **[Examples]** `deribit | okex | bybit`
          required: true
          schema:
            type: string
            default: deribit
        - name: currency
          in: query
          description: >
            **[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)
          required: true
          schema:
            type: string
            default: BTC
        - name: timestamp
          in: query
          description: >
            **[Optional]** Payload only includes data for this timestamp.
            **[Formats]** `seconds | milliseconds | iso8601` **[Examples]**
            `1578531600 | 1578531600000 | 2024-04-03`
          schema:
            type: string
        - 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
      responses:
        '200':
          description: Successful request
          content:
            application/json:
              schema:
                type: object
                properties:
                  status:
                    type: integer
                    example: 200
                    default: 0
                  title:
                    type: string
                    example: OK
                  description:
                    type: string
                    example: Successful request
                  payload:
                    type: object
                    properties:
                      data:
                        type: array
                        items:
                          type: object
                          properties:
                            timestamp:
                              type: integer
                              example: 1717708620000
                            instrumentNormalized:
                              type: string
                              example: DERIBIT-BTC-28MAR25-300000.0-C
                            expirationTimestamp:
                              type: integer
                              example: 1743148800000
                            strike:
                              type: integer
                              example: 300000
                            putCall:
                              type: string
                              example: C
                            indexPrice:
                              type: number
                              example: 70766.43
                            markPrice:
                              type: number
                              example: 0.0137
                            yieldStrategy:
                              type: string
                              example: coveredCall
                            annualization:
                              type: number
                              example: 1.2396138706565756
                            absoluteYield:
                              type: number
                              example: 0.013890297069857043
                            annualizedYield:
                              type: number
                              example: 0.01721860491533518
                      metadata:
                        type: object
                        properties:
                          api-version:
                            type: string
                            example: '2023-09-30'
              examples:
                success_response:
                  summary: Options yields response
                  value:
                    status: 200
                    title: OK
                    description: Successful request
                    payload:
                      data:
                        - timestamp: 1717708620000
                          instrumentNormalized: DERIBIT-BTC-28MAR25-300000.0-C
                          expirationTimestamp: 1743148800000
                          strike: 300000
                          putCall: C
                          indexPrice: 70766.43
                          markPrice: 0.0137
                          yieldStrategy: coveredCall
                          annualization: 1.2396138706565756
                          absoluteYield: 0.013890297069857043
                          annualizedYield: 0.01721860491533518
                        - timestamp: 1717708620000
                          instrumentNormalized: DERIBIT-BTC-28MAR25-250000.0-C
                          expirationTimestamp: 1743148800000
                          strike: 250000
                          putCall: C
                          indexPrice: 70766.43
                          markPrice: 0.02
                          yieldStrategy: coveredCall
                          annualization: 1.2396138706565756
                          absoluteYield: 0.020408163265306124
                          annualizedYield: 0.025298242258297462
                        - timestamp: 1717708620000
                          instrumentNormalized: DERIBIT-BTC-28MAR25-220000.0-C
                          expirationTimestamp: 1743148800000
                          strike: 220000
                          putCall: C
                          indexPrice: 70766.82
                          markPrice: 0.0278
                          yieldStrategy: coveredCall
                          annualization: 1.2396138706565756
                          absoluteYield: 0.028594939312898582
                          annualizedYield: 0.03544668340285209
                        - timestamp: 1717708620000
                          instrumentNormalized: DERIBIT-BTC-28MAR25-200000.0-C
                          expirationTimestamp: 1743148800000
                          strike: 200000
                          putCall: C
                          indexPrice: 70766.82
                          markPrice: 0.0361
                          yieldStrategy: coveredCall
                          annualization: 1.2396138706565756
                          absoluteYield: 0.037452017844174706
                          annualizedYield: 0.046426040803716546
                        - timestamp: 1717708620000
                          instrumentNormalized: DERIBIT-BTC-28MAR25-180000.0-C
                          expirationTimestamp: 1743148800000
                          strike: 180000
                          putCall: C
                          indexPrice: 70766.82
                          markPrice: 0.0449
                          yieldStrategy: coveredCall
                          annualization: 1.2396138706565756
                          absoluteYield: 0.04701078421107738
                          annualizedYield: 0.05827522017849466
                        - timestamp: 1717708620000
                          instrumentNormalized: DERIBIT-BTC-28MAR25-160000.0-C
                          expirationTimestamp: 1743148800000
                          strike: 160000
                          putCall: C
                          indexPrice: 70766.82
                          markPrice: 0.0585
                          yieldStrategy: coveredCall
                          annualization: 1.2396138706565756
                          absoluteYield: 0.06213489113117366
                          annualizedYield: 0.07702327289793912
                        - timestamp: 1717708620000
                          instrumentNormalized: DERIBIT-BTC-28MAR25-150000.0-C
                          expirationTimestamp: 1743148800000
                          strike: 150000
                          putCall: C
                          indexPrice: 70766.43
                          markPrice: 0.0677
                          yieldStrategy: coveredCall
                          annualization: 1.2396138706565756
                          absoluteYield: 0.07261611069398262
                          annualizedYield: 0.09001593804939415
                        - timestamp: 1717708620000
                          instrumentNormalized: DERIBIT-BTC-28MAR25-140000.0-C
                          expirationTimestamp: 1743148800000
                          strike: 140000
                          putCall: C
                          indexPrice: 70766.82
                          markPrice: 0.0791
                          yieldStrategy: coveredCall
                          annualization: 1.2396138706565756
                          absoluteYield: 0.08589423390161798
                          annualizedYield: 0.10647568375386592
                      metadata:
                        api-version: '2023-09-30'
        '400':
          description: Bad request
          content:
            application/json:
              schema:
                type: object
                properties: {}
              examples:
                error_response:
                  summary: Bad request example
                  value: {}
      deprecated: false
      security:
        - ApiKeyAuth: []
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````