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

# List expiries

> Listed option or future expiries for an asset. By default only monthly expiries (last Friday of the month) are returned; set `last_friday_only=false` for weeklies and dailies, and `active_only=true` to drop expiries that have already settled.



## OpenAPI

````yaml GET /v1/expiries
openapi: 3.0.3
info:
  title: Sandmark Volatility API
  version: 1.0.0
  description: >-
    Continuous implied and realised volatility for crypto options, with the
    reference data to query it.
  contact:
    name: Sandmark
    url: https://sandmark.com
servers:
  - url: https://api.sandmark.com/volatility
    description: Production
security:
  - apiKey: []
tags:
  - name: Reference
    description: Assets, frequencies and expiries.
  - name: Timeseries
    description: Continuous IV and RV series.
paths:
  /v1/expiries:
    get:
      tags:
        - Reference
      summary: List expiries
      description: >-
        Listed option or future expiries for an asset. By default only monthly
        expiries (last Friday of the month) are returned; set
        `last_friday_only=false` for weeklies and dailies, and
        `active_only=true` to drop expiries that have already settled.
      operationId: listExpiries
      parameters:
        - name: asset
          in: query
          required: true
          schema:
            type: string
            enum:
              - DER.BTC_USD
              - DER.ETH_USD
              - DER.BTC_USDC
              - DER.ETH_USDC
              - DER.SOL_USDC
              - DER.XRP_USDC
              - DER.AVAX_USDC
              - DER.TRX_USDC
              - DER.HYPE_USDC
              - OKX.BTC_USD
              - OKX.ETH_USD
              - BIN.BTC_USDT
              - BIN.ETH_USDT
              - BYB.BTC_USDT
              - BYB.ETH_USDT
          description: >-
            Underlying identifier, `VENUE.BASE_QUOTE`. `DER` is Deribit; `OKX`,
            `BIN` (Binance) and `BYB` (Bybit) are the other venues.
            `DER.BTC_USD` and `DER.ETH_USD` are the inverse contracts and carry
            the deepest history; the `_USDC` underlyings are linear.
          example: DER.BTC_USD
        - name: instrument_type
          in: query
          required: false
          schema:
            type: string
            enum:
              - option
              - future
            default: option
          description: Whether to list option or future expiries.
        - name: last_friday_only
          in: query
          required: false
          schema:
            type: boolean
            default: true
          description: Keep only expiries on the last Friday of the month.
        - name: active_only
          in: query
          required: false
          schema:
            type: boolean
            default: false
          description: Keep only expiries strictly after now.
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ExpiryListResponse'
              example:
                asset: DER.BTC_USD
                instrument_type: option
                last_friday_only: true
                active_only: true
                expiries:
                  - '2026-11-27'
                  - '2026-12-25'
                  - '2027-01-29'
                  - '2027-03-26'
                  - '2027-06-25'
                  - '2027-09-24'
        '401':
          description: Missing or invalid API key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                statusCode: 401
                message: >-
                  Access denied due to missing subscription key. Make sure to
                  include subscription key when making requests to an API.
        '422':
          description: A parameter failed validation. `detail` names the field.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ValidationError'
        '429':
          description: >-
            Rate limit exceeded. Retry after the number of seconds in
            `Retry-After`.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
              example:
                statusCode: 429
                message: Rate limit is exceeded. Try again in 12 seconds.
components:
  schemas:
    ExpiryListResponse:
      properties:
        asset:
          type: string
          title: Asset
        instrument_type:
          $ref: '#/components/schemas/InstrumentTypeEnum'
        last_friday_only:
          type: boolean
          title: Last Friday Only
        active_only:
          type: boolean
          title: Active Only
        expiries:
          items:
            type: string
          type: array
          title: Expiries
      type: object
      required:
        - asset
        - instrument_type
        - last_friday_only
        - active_only
        - expiries
      title: ExpiryListResponse
    Error:
      type: object
      properties:
        statusCode:
          type: integer
          example: 403
        message:
          type: string
      required:
        - statusCode
        - message
    ValidationError:
      type: object
      properties:
        detail:
          type: array
          items:
            type: object
            properties:
              loc:
                type: array
                items:
                  type: string
              msg:
                type: string
              type:
                type: string
    InstrumentTypeEnum:
      type: string
      enum:
        - option
        - future
      title: InstrumentTypeEnum
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: X-API-Key
      description: Your Sandmark API key.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.