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

# Markets

> Returns a list of markets metadata.



## OpenAPI

````yaml /coinmetrics/openapi/coinmetrics.yaml get /reference-data/markets
openapi: 3.0.2
info:
  title: Coin Metrics API v4
  description: >-
    [Coin Metrics Homepage](https://coinmetrics.io/)<br/> [API Backward
    Compatibility
    Policy](https://docs.coinmetrics.io/access-our-data/api#backward-compatibility)<br/>
    [Python API
    Client](https://coinmetrics.github.io/api-client-python/site/index.html)<br/><br/>

    HTTP API root endpoint URL is `https://api.coinmetrics.io/v4`. Coin
    Metrics&apos; paid product.<br/> WebSocket API root endpoint is
    `wss://api.coinmetrics.io/v4`. Coin Metrics&apos; paid product.<br/><br/>
    The Community HTTP API root endpoint URL is
    `https://community-api.coinmetrics.io/v4`. API key is not required when
    accessing community endpoints. Available to the community under the
    [Creative Commons](https://creativecommons.org/licenses/by-nc/4.0/) license.

    # Authentication

    <!-- ReDoc-Inject: <security-definitions> -->

    # Response headers

    Note that Coin Metrics API responses have a `CF-RAY` HTTP header e.g.
    `88a6ec1d2f930774-IAD` which can be used for diagnostic purposes. When
    raising Support requests, please ensure to provide the value of this
    header. 
  termsOfService: https://coinmetrics.io/api/terms
  contact:
    name: Coin Metrics Support
    url: https://coinmetrics.io/support/
    email: support@coinmetrics.io
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0.html
  version: 4.0.0
servers:
  - url: https://api.coinmetrics.io/v4
  - url: wss://api.coinmetrics.io/v4
  - url: https://community-api.coinmetrics.io/v4
security: []
tags:
  - name: Rate limits
    description: >-
      To ensure the quality of Coin Metrics services, API is subject to rate
      limiting.<br/> <table> <tr><th>Rate Limit Plan</th><th>REST API: Requests
      per Second (sliding window)</th><th>REST API: Download Speed</th><th>REST
      API: Max Parallel Requests</th><th>WebSocket API: Max Parallel
      Connections</th></tr> <tr><td>Community</td><td>10 requests per 6 seconds
      per IP address</td><td>Reduced speed</td><td>10</td><td>N/A</td></tr>
      <tr><td>Trial</td><td>10 requests per 6 seconds per API key</td><td>Max
      speed</td><td>10</td><td>200</td></tr> <tr><td>Default (PRO)</td><td>6000
      requests per 20 seconds per API key</td><td>Standard
      speed</td><td>10</td><td>200</td></tr> <tr><td>Download (PRO)</td><td>6000
      requests per 20 seconds per API key</td><td>Max
      speed</td><td>10</td><td>200</td></tr> </table> <br/> All PRO keys by
      default get the "default" rate limits. To download historical data at max
      speed, you need to switch to the "download" plan. <br/> <br/> The paid and
      community versions of the API have a limit of 10 parallel REST API
      requests. After this limit is reached, further parallel requests will be
      queued, so performance will be slower.<br/> <br/> If you reach the
      request-per-second limit, API starts to return `429 Too Many Requests`
      HTTP response status.<br/> API also provides `X-RateLimit-*` response
      headers formatted according to
      https://tools.ietf.org/html/draft-polli-ratelimit-headers-03.<br/>
      Additionally, the API provides the `X-RateLimit-Plan` header which
      indicates the current rate limiting plan. This header may have values:
      `default`, `trial`, `download`, or `community`.
    x-cm-gitbook:
      foldIntoInfo: true
  - name: Reference Data
    description: Metadata information of entities supported by Coin Metrics.
    x-cm-gitbook:
      tag: Meta Data
      icon: book
  - name: Catalog
    x-displayName: Catalog (deprecated)
    description: >-
      Catalog of available for your `api_key` data.<br/> Use the [Full
      catalog](#tag/Full-catalog) endpoints for the full list of supported by
      Coin Metrics data. <br/>DEPRECATED: See
      https://coinmetrics.io/important-changes-to-coin-metrics-api-catalog-endpoints/.
    x-cm-gitbook:
      remove: true
  - name: Catalog v2
    description: >-
      Catalog of available for your `api_key` data.<br/> Use the [Full catalog
      V2](#tag/Full-catalog-v2) endpoints for the full list of supported by Coin
      Metrics data.
    x-cm-gitbook:
      icon: list-check
  - name: Full catalog
    x-displayName: Full catalog (deprecated)
    description: >-
      The Full catalog returns the full range of data that is supported by Coin
      Metrics across all our products.<br/> If you are a client looking to
      understand the data that is available for your API key and data license,
      please use the [Catalog](#tag/Catalog) endpoint. <br/>DEPRECATED: See
      https://coinmetrics.io/important-changes-to-coin-metrics-api-catalog-endpoints/.
    x-cm-gitbook:
      remove: true
  - name: Full catalog v2
    description: >-
      The Full catalog returns the full range of data that is supported by Coin
      Metrics across all our products.<br/> If you are a client looking to
      understand the data that is available for your API key and data license,
      please use the [Catalog](#tag/Catalog-v2) endpoint.
    x-cm-gitbook:
      tag: Catalog v2
      icon: layer-group
  - name: Timeseries
    description: >-
      Endpoints for fetching metrics, market data, indexes and other time series
      data.
    x-cm-gitbook:
      icon: chart-line
      renameOperationsTo: Timeseries REST
  - name: Timeseries stream
    description: >-
      WebSocket endpoints for getting a real-time stream of metrics, market
      data, indexes and other time series data.
    x-cm-gitbook:
      tag: Timeseries
      icon: wifi
  - name: Taxonomy
    description: Taxonomy endpoints
    x-cm-gitbook:
      icon: sitemap
  - name: Taxonomy Metadata
    description: Taxonomy Metadata endpoints
    x-cm-gitbook:
      tag: Taxonomy
      icon: tags
  - name: Profile
    description: Profile endpoints
    x-cm-gitbook:
      tag: Meta Data
      icon: id-card
  - name: List of blockchain entities v2
    description: Endpoints for fetching lists of blockchain entities.
    x-cm-gitbook:
      tag: ATLAS
      icon: list
  - name: Full blockchain entities v2
    description: Endpoints for fetching full blockchain entities.
    x-cm-gitbook:
      tag: List of blockchain entities v2
      icon: database
  - name: Jobs
    description: Jobs API endpoints
    x-cm-gitbook:
      tag: ATLAS
      icon: briefcase
  - name: Blockchain Explorer Job
    description: Endpoints for creating async jobs for blockchain entities.
    x-cm-gitbook:
      tag: ATLAS
      icon: clock
  - name: Blockchain Explorer Job Results
    description: Schema definitions of results of Blockchain Explorer Job endpoints.
    x-cm-gitbook:
      foldInto: Blockchain Explorer Job
  - name: Chain Monitor tools
    description: Endpoints for working with chain monitor data.
    x-cm-gitbook:
      tag: ATLAS
      icon: wrench
  - name: Security Master
    description: Security Master endpoints
    x-cm-gitbook:
      tag: Meta Data
      icon: shield
  - name: Constituent Snapshots
    description: Endpoints for getting the snapshots of various constituents
    x-cm-gitbook:
      tag: Meta Data
      icon: camera
  - name: Constituent Timeframes
    description: Endpoints for getting the timeframes of various constituents
    x-cm-gitbook:
      tag: Meta Data
      icon: calendar
  - name: Blockchain Metadata
    description: Blockchain metadata endpoints
    x-cm-gitbook:
      tag: Meta Data
      icon: database
  - name: Meta Data
    x-cm-gitbook:
      icon: database
  - name: ATLAS
    x-cm-gitbook:
      icon: map
  - name: Timeseries REST
    x-cm-gitbook:
      tag: Timeseries
      icon: table
paths:
  /reference-data/markets:
    servers:
      - url: https://api.coinmetrics.io/v4
      - url: https://community-api.coinmetrics.io/v4
    get:
      tags:
        - Reference Data
      summary: Markets
      description: Returns a list of markets metadata.
      operationId: getReferenceDataMarkets
      parameters:
        - $ref: '#/components/parameters/CatalogMarketId'
        - $ref: '#/components/parameters/Exchange'
        - $ref: '#/components/parameters/MarketTypeWithEventContract'
        - $ref: '#/components/parameters/MarketBase'
        - $ref: '#/components/parameters/MarketQuote'
        - $ref: '#/components/parameters/MarketAsset'
        - $ref: '#/components/parameters/MarketSymbol'
        - $ref: '#/components/parameters/AssetClass'
        - $ref: '#/components/parameters/SourceType'
        - $ref: '#/components/parameters/MarketCusip'
        - $ref: '#/components/parameters/MarketFigi'
        - $ref: '#/components/parameters/MarketIsin'
        - $ref: '#/components/parameters/ReferenceDataNamespacesInclude'
        - $ref: '#/components/parameters/ReferenceDataMarketsIncludeExpired'
        - $ref: '#/components/parameters/PageSize'
        - $ref: '#/components/parameters/PagingFromWithStartByDefault'
        - $ref: '#/components/parameters/NextPageToken'
        - $ref: '#/components/parameters/CatalogResponseFormat'
        - $ref: '#/components/parameters/Pretty'
      responses:
        '200':
          $ref: '#/components/responses/ReferenceDataMarkets'
        '400':
          $ref: '#/components/responses/MarketNotFound'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '414':
          $ref: '#/components/responses/UriTooLong'
      security:
        - api_key: []
      x-codeSamples:
        - lang: Shell
          label: Shell
          source: >
            curl --compressed
            "https://api.coinmetrics.io/v4/reference-data/markets?api_key=<your_key>"
        - lang: Python
          label: Python
          source: >
            import requests

            response =
            requests.get('https://api.coinmetrics.io/v4/reference-data/markets?api_key=<your_key>').json()

            print(response)
        - lang: Python
          label: Python Client
          source: |
            from coinmetrics.api_client import CoinMetricsClient
            client = CoinMetricsClient(<your_key>)

            response = client.reference_data_markets().to_list()
            print(response)
components:
  parameters:
    CatalogMarketId:
      description: Comma separated list of markets. By default all markets are returned.
      in: query
      name: markets
      schema:
        type: array
        items:
          type: string
      explode: false
    Exchange:
      description: Unique name of an exchange.
      in: query
      name: exchange
      schema:
        type: string
    MarketTypeWithEventContract:
      description: Return markets of the specified instrument type.
      in: query
      name: type
      schema:
        enum:
          - spot
          - future
          - option
          - event_contract
        type: string
    MarketBase:
      description: Base asset of markets.
      in: query
      name: base
      schema:
        type: string
    MarketQuote:
      description: Quote asset of markets.
      in: query
      name: quote
      schema:
        type: string
    MarketAsset:
      description: Any asset of markets.
      in: query
      name: asset
      schema:
        type: string
    MarketSymbol:
      description: Symbol of derivative markets, full instrument name.
      in: query
      name: symbol
      schema:
        type: string
    AssetClass:
      description: Return markets with exposure to the specified underlying asset class.
      in: query
      name: asset_class
      schema:
        $ref: '#/components/schemas/AssetClass'
    SourceType:
      description: Return markets whose prices have the specified provenance.
      in: query
      name: source_type
      schema:
        $ref: '#/components/schemas/SourceType'
    MarketCusip:
      description: >-
        Return markets with the specified CUSIP. Only one of `cusip`, `figi`, or
        `isin` may be supplied in a request.
      in: query
      name: cusip
      schema:
        type: string
    MarketFigi:
      description: >-
        Return markets with the specified FIGI. Only one of `cusip`, `figi`, or
        `isin` may be supplied in a request.
      in: query
      name: figi
      schema:
        type: string
    MarketIsin:
      description: >-
        Return markets with the specified ISIN. Only one of `cusip`, `figi`, or
        `isin` may be supplied in a request.
      in: query
      name: isin
      schema:
        type: string
    ReferenceDataNamespacesInclude:
      description: >-
        Comma-separated list of namespaces to include in response. Currently,
        the only supported value is `talos`.
      in: query
      name: include
      schema:
        type: string
    ReferenceDataMarketsIncludeExpired:
      description: >-
        Whether to include markets with a known past expiration. Only supported
        when the request selects prediction markets (`type=event_contract`,
        `asset_class=event`, or a prediction market `exchange` alone) without an
        explicit `markets` list. Defaults to `false`.
      in: query
      name: include_expired
      schema:
        type: boolean
    PageSize:
      description: >-
        Number of items per single page of results.<br/> The value of this
        parameter is ignored if the endpoint supports the `format` parameter and
        its value is set to `json_stream`.
      in: query
      name: page_size
      schema:
        default: 100
        type: integer
        format: int32
        minimum: 1
        maximum: 10000
    PagingFromWithStartByDefault:
      description: >-
        Where does the first page start, at the start of the interval or at the
        end.<br/> The value of this parameter is ignored if the endpoint
        supports the `format` parameter and its value is set to `json_stream`.
      in: query
      name: paging_from
      schema:
        default: start
        enum:
          - start
          - end
        type: string
        format: PagingFrom
    NextPageToken:
      description: >-
        Token for receiving the results from the next page of a query.<br/>
        Should not be used directly. To iterate through pages just use
        `next_page_url` response field.
      in: query
      name: next_page_token
      schema:
        type: string
    CatalogResponseFormat:
      description: Format of the response. Supported values are `json`, `json_stream`.
      in: query
      name: format
      schema:
        type: string
        default: json
    Pretty:
      description: Human-readable formatting of JSON responses.
      in: query
      name: pretty
      schema:
        type: boolean
        default: false
  responses:
    ReferenceDataMarkets:
      description: List of markets metadata.
      content:
        application/json:
          example:
            data:
              - market: binance-btc-usdt-spot
                exchange: binance
                type: spot
                base: btc
                quote: usdt
                pair: btc-usdt
                symbol: BTCUSDT
              - market: binance-1000FLOKIUSDT-future
                exchange: binance
                type: future
                base: floki
                quote: usdt
                pair: floki-usdt
                symbol: 1000FLOKIUSDT
                size_asset: floki
                margin_asset: usdt
                contract_size: '1000'
                tick_size: '0.00001'
                listing: '2023-05-06T00:00:00.000000000Z'
                order_amount_increment: '1'
                order_amount_min: '1'
                order_amount_max: '10000000'
                order_price_increment: '0.0000100'
                order_price_min: '0.0000100'
                order_price_max: '200'
                order_size_min: '5.0'
              - market: deribit-BTC-10DEC22-17500-C-option
                exchange: deribit
                type: option
                base: btc
                quote: usd
                pair: btc-usd
                symbol: BTC-10DEC22-17500-C
                size_asset: btc
                strike: '17500'
                option_contract_type: call
                is_european: true
                contract_size: '1'
                listing: '2022-12-08T08:01:00.000000000Z'
                expiration: '2022-12-10T08:00:00.000000000Z'
                settlement_price: '17160.85'
                status: offline
                order_amount_min: '0.1'
                order_price_increment: '0.0005'
                order_taker_fee: '0.0003'
                order_maker_fee: '0.0003'
            next_page_token: ZGVyaWJpdC1CVEMtMTBERUMyMi0xNzUwMC1QLW9wdGlvbg
            next_page_url: >-
              https://api.coinmetrics.io/v4/reference-data/markets?api_key=<your_key>&page_size=3&next_page_token=ZGVyaWJpdC1CVEMtMTBERUMyMi0xNzUwMC1QLW9wdGlvbg
          schema:
            $ref: '#/components/schemas/ReferenceDataMarketsResponse'
    MarketNotFound:
      content:
        application/json:
          example:
            error:
              type: bad_parameter
              message: >-
                Bad parameter 'markets'. Market 'sdvwbtc-as-asd-spot' is not
                supported.
          schema:
            $ref: '#/components/schemas/ErrorResponse'
      description: Market not found.
    Unauthorized:
      description: Requested resource requires authorization.
      content:
        application/json:
          examples:
            unauthorized:
              summary: Unauthorized error response.
              value:
                error:
                  type: unauthorized
                  message: Requested resource requires authorization.
            wrong_credentials:
              summary: Wrong credentials error response.
              value:
                error:
                  type: wrong_credentials
                  message: Supplied credentials are not valid.
          schema:
            $ref: '#/components/schemas/ErrorResponse'
    UriTooLong:
      description: Provided URI is too long. It must not be greater than 10000 symbols.
  schemas:
    AssetClass:
      description: Asset class of the market.
      type: string
      enum:
        - digital
        - equity
        - fixed_income
        - event
    SourceType:
      description: Source type of the exchange.
      type: string
      enum:
        - exchange
        - platform
        - composite
        - evaluated
    ReferenceDataMarketsResponse:
      description: List of markets.
      properties:
        data:
          items:
            $ref: '#/components/schemas/ReferenceDataMarketInfo'
          type: array
        next_page_token:
          $ref: '#/components/schemas/NextPageToken'
        next_page_url:
          $ref: '#/components/schemas/NextPageUrl'
      required:
        - data
      type: object
    ErrorResponse:
      properties:
        error:
          $ref: '#/components/schemas/ErrorObject'
      required:
        - error
      type: object
    ReferenceDataMarketInfo:
      description: Information about a market.
      properties:
        market:
          $ref: '#/components/schemas/MarketId'
        exchange:
          $ref: '#/components/schemas/Exchange'
        base:
          $ref: '#/components/schemas/AssetIdBase'
        quote:
          $ref: '#/components/schemas/AssetIdQuote'
        pair:
          $ref: '#/components/schemas/Pair'
        symbol:
          $ref: '#/components/schemas/MarketSymbol'
        type:
          $ref: '#/components/schemas/MarketType'
        asset_class:
          $ref: '#/components/schemas/AssetClass'
        source_type:
          $ref: '#/components/schemas/SourceType'
        size_asset:
          $ref: '#/components/schemas/DerivativeContractSizeAsset'
        margin_asset:
          $ref: '#/components/schemas/DerivativeContractMarginAsset'
        strike:
          $ref: '#/components/schemas/OptionStrike'
        option_contract_type:
          $ref: '#/components/schemas/OptionContractType'
        is_european:
          $ref: '#/components/schemas/IsEuropean'
        contract_size:
          $ref: '#/components/schemas/MarketContractSize'
        tick_size:
          $ref: '#/components/schemas/FutureTickSize'
        multiplier_size:
          $ref: '#/components/schemas/FutureMultiplierSize'
        listing:
          $ref: '#/components/schemas/DerivativeContractListing'
        expiration:
          $ref: '#/components/schemas/DerivativeContractExpiration'
        settlement_price:
          $ref: '#/components/schemas/SettlementPrice'
        pool_config_id:
          $ref: '#/components/schemas/DefiPoolConfigId'
        contract_address:
          $ref: '#/components/schemas/DefiContractAddress'
        fee:
          $ref: '#/components/schemas/DefiFee'
        price_includes_fee:
          $ref: '#/components/schemas/DefiPriceIncludesFee'
        variable_fee:
          $ref: '#/components/schemas/DefiVariableFee'
        base_address:
          $ref: '#/components/schemas/DefiBaseAddress'
        quote_address:
          $ref: '#/components/schemas/DefiQuoteAddress'
        status:
          $ref: '#/components/schemas/Status'
        order_amount_increment:
          $ref: '#/components/schemas/OrderAmountIncrement'
        order_amount_min:
          $ref: '#/components/schemas/OrderAmountMin'
        order_amount_max:
          $ref: '#/components/schemas/OrderAmountMax'
        order_price_increment:
          $ref: '#/components/schemas/OrderPriceIncrement'
        order_price_min:
          $ref: '#/components/schemas/OrderPriceMin'
        order_price_max:
          $ref: '#/components/schemas/OrderPriceMax'
        order_size_min:
          $ref: '#/components/schemas/OrderSizeMin'
        order_taker_fee:
          $ref: '#/components/schemas/OrderTakerFee'
        order_maker_fee:
          $ref: '#/components/schemas/OrderMakerFee'
        margin_trading_enabled:
          $ref: '#/components/schemas/MarginTradingEnabled'
        experimental:
          $ref: '#/components/schemas/ExperimentalMarket'
        base_native:
          $ref: '#/components/schemas/AssetIdBaseNative'
        quote_native:
          $ref: '#/components/schemas/AssetIdQuoteNative'
        publisher:
          $ref: '#/components/schemas/Publisher'
        cusip:
          $ref: '#/components/schemas/Cusip'
        figi:
          $ref: '#/components/schemas/Figi'
        isin:
          $ref: '#/components/schemas/Isin'
        lei:
          $ref: '#/components/schemas/Lei'
        sedol:
          $ref: '#/components/schemas/Sedol'
        security_type:
          $ref: '#/components/schemas/SecurityType'
        security_term:
          $ref: '#/components/schemas/SecurityTerm'
        description:
          $ref: '#/components/schemas/SecurityDescription'
        coupon_rate:
          $ref: '#/components/schemas/CouponRate'
        issue_date:
          $ref: '#/components/schemas/IssueDate'
        maturity_date:
          $ref: '#/components/schemas/MaturityDate'
        price_per100:
          $ref: '#/components/schemas/PricePer100'
        talos:
          description: >-
            Mappings from this Coin Metrics market to Talos security-master
            identifiers and attributes. Returned only when `include=talos` is
            requested and a mapping exists.
          type: array
          items:
            $ref: '#/components/schemas/TalosMarketMetadata'
        event:
          description: >-
            Canonical Coin Metrics identifier of the parent event in
            `/reference-data/events`.
          type: string
        event_ticker:
          description: >-
            Parent event identifier exactly as reported by the venue, such as a
            Kalshi event ticker or Polymarket event slug.
          type: string
        title:
          description: >-
            Concise human-readable market question or title displayed by the
            venue.
          type: string
        contract_type:
          description: >-
            Settlement structure of the event contract. Binary contracts settle
            the default outcome to 0 or 1; scalar contracts may settle to an
            intermediate value determined by the contract rules.
          type: string
          enum:
            - binary
            - scalar
        native_status:
          description: >-
            Lifecycle status reported by, or directly derived from, the venue.
            Values are venue-specific and preserve more detail than normalized
            `status`.
          type: string
        result:
          description: >-
            Resolved outcome classification. Yes and no identify the winning
            binary side; scalar indicates value-based settlement; partial
            indicates equal or partial payout when supplied by the venue.
          type: string
          enum:
            - 'yes'
            - 'no'
            - scalar
            - partial
        settlement_value:
          description: >-
            Final settlement value of the default outcome, usually the Yes side,
            returned as a decimal string. Binary values are normally 0 or 1;
            partial or scalar contracts may use intermediate values.
          type: string
          format: decimal
        settlement_time:
          description: UTC timestamp at which the venue settled or resolved the contract.
          type: string
          format: date-time
        close_time:
          description: UTC timestamp at which trading in the contract actually closed.
          type: string
          format: date-time
        expected_expiration_time:
          description: >-
            UTC timestamp at which the venue currently expects the contract to
            expire. This estimate may differ from the latest allowed expiration
            returned in `expiration`.
          type: string
          format: date-time
        active:
          description: >-
            Whether the venue considers the contract active for trading. This
            preserves the collected venue flag or its direct status-based
            derivation.
          type: boolean
        closed:
          description: >-
            Whether the venue considers the contract past its open or active
            lifecycle. A closed contract is not necessarily finally settled if
            the venue supports determination or dispute stages.
          type: boolean
        default_outcome:
          description: >-
            Venue label of the outcome represented by the default side of the
            contract, usually Yes.
          type: string
        inverse_outcome:
          description: >-
            Venue label of the outcome represented by the inverse side of the
            contract, usually No.
          type: string
        yes_title:
          description: >-
            Human-readable text explaining the Yes or default side in the
            context of this contract.
          type: string
        no_title:
          description: >-
            Human-readable text explaining the No or inverse side in the context
            of this contract.
          type: string
        condition_id:
          description: >-
            Polymarket Conditional Tokens condition identifier used to identify
            the on-chain condition for this contract.
          type: string
        question_id:
          description: >-
            Polymarket question identifier associated with the oracle question
            that determines the contract's resolution.
          type: string
        neg_risk_other:
          description: >-
            Whether this is the catch-all Other contract within a Polymarket
            negative-risk event.
          type: boolean
        uma_resolution_status:
          description: Polymarket-reported UMA oracle resolution status for the contract.
          type: string
        default_token_id:
          description: >-
            Polymarket CLOB token identifier for the default outcome, usually
            the Yes side, used in venue order-book and trade APIs.
          type: string
        inverse_token_id:
          description: >-
            Polymarket CLOB token identifier for the inverse outcome, usually
            the No side, used in venue order-book and trade APIs.
          type: string
        strike_type:
          $ref: '#/components/schemas/EventContractStrikeType'
        floor_strike:
          description: >-
            Lower strike boundary used by the event contract's resolution rule,
            returned as a decimal string.
          type: string
          format: decimal
        cap_strike:
          description: >-
            Upper strike boundary used by the event contract's resolution rule,
            returned as a decimal string.
          type: string
          format: decimal
        custom_strike:
          description: Structured custom strike definition supplied by the venue.
          type: object
        functional_strike:
          description: >-
            Venue-defined expression or mapping from observed values to
            settlement values for a functional strike contract.
          type: string
        can_close_early:
          description: >-
            Whether the contract rules allow trading to close before its
            scheduled close or expiration time.
          type: boolean
        price_ranges:
          description: >-
            Ordered price bands that define the permitted price interval and
            increment for the contract.
          type: array
          items:
            $ref: '#/components/schemas/PriceRange'
        last_updated_time:
          description: >-
            UTC timestamp at which Coin Metrics last observed a change to this
            market's stored reference metadata.
          type: string
          format: date-time
      type: object
      required:
        - market
        - exchange
        - type
    NextPageToken:
      description: Token of the next page results for a given request.
      type: string
    NextPageUrl:
      description: URL of the next page results for a given request.
      type: string
    ErrorObject:
      properties:
        type:
          description: Error type string. Can be used for error identification.
          type: string
        message:
          description: >-
            Human-friendly error description. Can be amended without prior
            notification. Do not use for error identification in your code.
          type: string
      required:
        - type
        - description
      type: object
    MarketId:
      description: Unique name of the market.
      type: string
    Exchange:
      description: Name of the exchange.
      type: string
    AssetIdBase:
      description: Unique name of the base asset.
      type: string
    AssetIdQuote:
      description: Unique name of the quote asset.
      type: string
    Pair:
      description: Pair string representation as `<base>-<quote>`.
      type: string
    MarketSymbol:
      description: Unique name of the derivative market symbol.
      type: string
    MarketType:
      description: Type of the market (spot, future).
      type: string
    DerivativeContractSizeAsset:
      description: Name of the derivative contract size asset.
      type: string
    DerivativeContractMarginAsset:
      description: Name of the derivative margin asset.
      type: string
    OptionStrike:
      description: Strike price for option trade.
      type: string
      format: decimal
    OptionContractType:
      description: '''call or ''put'' option contract type.'
      type: string
    IsEuropean:
      description: shows if the options contract is european or not.
      type: boolean
    MarketContractSize:
      description: Market contract size.
      type: string
      format: decimal
    FutureTickSize:
      description: Futures tick size.
      type: string
      format: decimal
    FutureMultiplierSize:
      description: Futures multiplier size.
      type: string
      format: decimal
    DerivativeContractListing:
      description: Derivative contract listing date.
      type: string
      format: date-time
    DerivativeContractExpiration:
      description: Derivative contract expiration date.
      type: string
      format: date-time
    SettlementPrice:
      description: Price of underlying asset at contract expiration.
      type: string
      format: decimal
    DefiPoolConfigId:
      description: DeFi pooling config ID.
      type: string
    DefiContractAddress:
      description: DeFi contract address.
      type: string
    DefiFee:
      description: DeFi fee (in percents).
      type: string
      format: decimal
    DefiPriceIncludesFee:
      description: >-
        Whether the reported price for a trade is inclusive (true) or exclusive
        (false) of fee.
      type: boolean
    DefiVariableFee:
      description: Whether the market has a variable (true) or fixed (false) fee structure.
      type: boolean
    DefiBaseAddress:
      description: DeFi base address.
      type: string
    DefiQuoteAddress:
      description: DeFi quote address.
      type: string
    Status:
      description: Market status (online/offline).
      type: string
    OrderAmountIncrement:
      description: Volume precision.
      type: string
      format: decimal
    OrderAmountMin:
      description: Minimum amount size.
      type: string
      format: decimal
    OrderAmountMax:
      description: Maximum amount size.
      type: string
      format: decimal
    OrderPriceIncrement:
      description: Price precision.
      type: string
      format: decimal
    OrderPriceMin:
      description: Minimum price.
      type: string
      format: decimal
    OrderPriceMax:
      description: Maximum price.
      type: string
      format: decimal
    OrderSizeMin:
      description: Minimum order size, where order size is amount * price.
      type: string
      format: decimal
    OrderTakerFee:
      type: string
      format: decimal
    OrderMakerFee:
      type: string
      format: decimal
    MarginTradingEnabled:
      type: boolean
    ExperimentalMarket:
      description: >-
        If set to true, indicates that market collection is under active
        development - there is a chance of temporary discrepancies in the served
        dataset.
      type: boolean
    AssetIdBaseNative:
      description: Exchange name of the base asset.
      type: string
    AssetIdQuoteNative:
      description: Exchange name of the quote asset.
      type: string
    Publisher:
      description: >-
        Organization that publishes or supplies the market or security reference
        data.
      type: string
    Cusip:
      description: >-
        Nine-character CUSIP identifier assigned to the security, when
        available.
      type: string
    Figi:
      description: >-
        Financial Instrument Global Identifier assigned to the security or
        listing, when available.
      type: string
    Isin:
      description: >-
        Twelve-character International Securities Identification Number assigned
        to the security, when available.
      type: string
    Lei:
      description: >-
        Legal Entity Identifier of the security's issuer, when available; this
        identifies the issuer rather than the market itself.
      type: string
    Sedol:
      description: >-
        Seven-character Stock Exchange Daily Official List identifier for the
        security listing, when available.
      type: string
    SecurityType:
      description: >-
        Human-readable classification of the security, such as Treasury Bill,
        Treasury Note, corporate bond, or common stock.
      type: string
    SecurityTerm:
      description: >-
        Original term from issuance to maturity, such as 4-Week or 10-Year. This
        is not the remaining time to maturity.
      type: string
    SecurityDescription:
      description: >-
        Human-readable description of the market, instrument, security, or its
        primary trading and resolution terms.
      type: string
    CouponRate:
      description: >-
        Annual coupon rate of the security, returned as a decimal string in the
        source's documented rate units.
      type: string
      format: decimal
    IssueDate:
      description: >-
        Calendar date on which the security was issued, formatted as ISO-8601
        YYYY-MM-DD.
      type: string
      format: date
    MaturityDate:
      description: >-
        Calendar date on which the security's principal becomes due, formatted
        as ISO-8601 YYYY-MM-DD.
      type: string
      format: date
    PricePer100:
      description: Quoted price per 100 units of face value, returned as a decimal string.
      type: string
      format: decimal
    TalosMarketMetadata:
      description: >-
        Provider metadata for markets. Contains `cm_ext_market` (Coin Metrics
        symbol using provider namespace, e.g. "talos:kucoin:BTC-USDT") and
        `cm_ext_market_by_id` (Coin Metrics ID using provider namespace, e.g.
        "talos:by-id:1050:10") as optional fields, plus any additional
        provider-specific fields.
      type: object
      properties:
        cm_ext_market:
          description: >-
            Coin Metrics symbol using provider namespace (e.g.
            "talos:kucoin:BTC-USDT").
          nullable: true
          type: string
        cm_ext_market_by_id:
          description: >-
            Coin Metrics ID using provider namespace (e.g.
            "talos:by-id:1050:10").
          nullable: true
          type: string
        market:
          description: Exchange name in the provider's namespace.
          nullable: true
          type: string
        market_id:
          description: Numeric market identifier in the provider's system.
          nullable: true
          type: integer
        symbol:
          description: Trading pair symbol in the provider's notation.
          nullable: true
          type: string
        security_id:
          description: Numeric security identifier in the provider's system.
          nullable: true
          type: integer
          format: int64
        market_symbol:
          description: Market symbol as used by the provider.
          nullable: true
          type: string
        product_type:
          description: Product type (e.g. "Spot", "Future").
          nullable: true
          type: string
        base_currency_id:
          description: Numeric identifier of the base currency in the provider's system.
          nullable: true
          type: integer
        quote_currency_id:
          description: Numeric identifier of the quote currency in the provider's system.
          nullable: true
          type: integer
        end_time:
          description: End time for the market.
          nullable: true
          type: string
        display_name:
          description: Human-readable display name for the market.
          nullable: true
          type: string
        normal_size:
          description: Normal order size for the market.
          nullable: true
          type: string
        description:
          description: Human-readable description of the market.
          nullable: true
          type: string
        base_currency:
          description: Base currency symbol (e.g. "BTC").
          nullable: true
          type: string
        quote_currency:
          description: Quote currency symbol (e.g. "USD").
          nullable: true
          type: string
        counter_currency:
          description: Counter currency symbol for options.
          nullable: true
          type: string
        option_type:
          description: Option type (e.g. "Call", "Put").
          nullable: true
          type: string
        strike_price:
          description: Strike price for the option.
          nullable: true
          type: string
          format: decimal
        settlement_currency:
          description: Settlement currency symbol.
          nullable: true
          type: string
        notional_multiplier:
          description: Contract notional multiplier.
          nullable: true
          type: string
        expiration:
          description: Contract expiration date.
          nullable: true
          type: string
        settle_value_type:
          description: Settlement value type (e.g. "Regular", "Inverted").
          nullable: true
          type: string
        size_buckets:
          description: Order size buckets for the market.
          nullable: true
          type: array
          items:
            $ref: '#/components/schemas/TalosMarketSizeBucket'
        position_currency_id:
          description: >-
            Numeric identifier of the position currency in the provider's
            system.
          nullable: true
          type: integer
        underlying_security_id:
          description: Numeric identifier of the underlying security.
          nullable: true
          type: integer
          format: int64
        underlying_quote_currency:
          description: Underlying quote currency symbol.
          nullable: true
          type: string
        underlying_code:
          description: Underlying asset code.
          nullable: true
          type: string
    EventContractStrikeType:
      description: >-
        Rule family used to compare the observed value with the contract's
        strike condition.
      type: string
      enum:
        - greater
        - greater_or_equal
        - less
        - less_or_equal
        - between
        - functional
        - custom
        - structured
    PriceRange:
      description: A tradable price band for an event contract market.
      type: object
      properties:
        start:
          description: Lower boundary of the price band, returned as a decimal string.
          type: string
          format: decimal
        end:
          description: Upper boundary of the price band, returned as a decimal string.
          type: string
          format: decimal
        step:
          description: >-
            Minimum permitted price increment within the price band, returned as
            a decimal string.
          type: string
          format: decimal
      required:
        - start
        - end
        - step
    TalosMarketSizeBucket:
      description: A size bucket for order sizing.
      type: object
      properties:
        size:
          description: The bucket size value.
          type: string
  securitySchemes:
    api_key:
      description: Coin Metrics API key can be specified as `?api_key=` query parameter.
      in: query
      name: api_key
      type: apiKey

````