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

# Get Contract Specifications

> This endpoint retrieves perpetual contract specifications.



## OpenAPI

````yaml GET /api/v1/contract-specifications
openapi: 3.1.0
info:
  title: Market Data API
  version: 1.0.0
servers:
  - url: https://market-data.sandbox.rails.xyz
security: []
paths:
  /api/v1/contract-specifications:
    get:
      summary: Get contract specifications
      operationId: getContractSpecifications
      responses:
        '200':
          description: ''
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/contractSpecification'
              example:
                - contractName: BTC-USDT
                  underlyingPrice: '63568.7382843144'
                  priceIndex: CCIX (CoinDesk Aggregated Index, formerly CCCAGG)
                  indexUpdateFrequency: 1 second
                  contractType: Linear (USDT-margined)
                  tickSize: '0.01'
                  lotSize: '0.0000001'
                  priceUnit: USDT per BTC
                  quantityUnit: BTC
                  minOrderNotional: 1 USDT
                  tradingHours: 24/7 (except during scheduled maintenance)
                  fundingTimes: Hourly funding
                  fundingRateCap: ±0.5% per 1-hour interval
                  marginType: Isolated, Cross
                - contractName: ETH-USDT
                  underlyingPrice: '1860.22242925263'
                  priceIndex: CCIX (CoinDesk Aggregated Index, formerly CCCAGG)
                  indexUpdateFrequency: 1 second
                  contractType: Linear (USDT-margined)
                  tickSize: '0.01'
                  lotSize: '0.0000001'
                  priceUnit: USDT per ETH
                  quantityUnit: ETH
                  minOrderNotional: 1 USDT
                  tradingHours: 24/7 (except during scheduled maintenance)
                  fundingTimes: Hourly funding
                  fundingRateCap: ±0.5% per 1-hour interval
                  marginType: Isolated, Cross
components:
  schemas:
    contractSpecification:
      type: object
      properties:
        contractName:
          type: string
          description: Identifier for the perpetual contract, such as `BTC-USDT`.
        underlyingPrice:
          type: string
          description: >-
            Current index price of the contract's underlying asset, serialized
            as a decimal string.
        priceIndex:
          type: string
          description: >-
            Reference index used for the underlying price. CCIX is the CoinDesk
            Aggregated Index, formerly CCCAGG.
        indexUpdateFrequency:
          type: string
          description: Frequency at which the reference index is updated.
        contractType:
          type: string
          description: >-
            How the contract is structured and which currency is used for
            margin.
        tickSize:
          type: string
          description: Minimum price movement.
        lotSize:
          type: string
          description: Minimum quantity movement.
        priceUnit:
          type: string
          description: >-
            Unit in which prices are quoted, expressed as quote currency per
            base currency, such as `USDT per BTC`.
        quantityUnit:
          type: string
          description: >-
            Unit in which order and position quantities are expressed, such as
            `BTC`.
        minOrderNotional:
          type: string
          description: >-
            Minimum order notional value, as an amount and quote currency code,
            such as `1 USDT`.
        tradingHours:
          type: string
          description: Hours during which the contract is available for trading.
        fundingTimes:
          type: string
          description: Frequency at which funding is applied.
        fundingRateCap:
          type: string
          description: Upper and lower funding rate limits over a 1-hour interval.
        marginType:
          type: string
          description: Supported margin modes.
      required:
        - contractName
        - underlyingPrice
        - priceIndex
        - indexUpdateFrequency
        - contractType
        - tickSize
        - lotSize
        - priceUnit
        - quantityUnit
        - minOrderNotional
        - tradingHours
        - fundingTimes
        - fundingRateCap
        - marginType

````

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