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

# Get Trading Pair Information

> **Feature Overview**
[OpenAPI JSON Spec](/docs/output/v1_crypto_trading-pair_get.json)
Get detailed info for a specified trading pair (configuration, exchange info, validity).

**Parameter Description**

| Parameter | Description | Example | Notes |
|----------|-------------|---------|-------|
| base     | Base currency symbol | BTC, ETH, BNB | Case-insensitive, but uppercase is recommended |
| quote    | Quote currency symbol | USDT, BUSD, BTC | Common quote currencies include USDT, BUSD, etc. |

**Response Data Explanation**

| Field         | Type     | Description                | Example                  |
|--------------|----------|----------------------------|--------------------------|
| id           | integer  | Unique identifier of pair  | 1                        |
| symbol       | string   | Trading pair symbol        | "BTCUSDT"                |
| base         | string   | Base currency              | "BTC"                    |
| quote        | string   | Quote currency             | "USDT"                   |
| exchange     | string   | Exchange name              | "binance"                |
| isValid      | boolean  | Whether the pair is valid  | true                     |
**Common Trading Pair Examples**
1. **Mainstream pairs to USD**: `?base=BTC&quote=USDT`
2. **Ethereum to USD**: `?base=ETH&quote=USDT`
3. **Altcoin to Bitcoin**: `?base=ADA&quote=BTC`
4. **Stablecoin pairs**: `?base=USDT&quote=BUSD`
5. **DeFi token pairs**: `?base=UNI&quote=ETH`

**Notes**

- Both `base` and `quote` parameters are required
- Some pairs may be suspended (`isValid=false` during periods)



## OpenAPI

````yaml /api-reference/openapi.json get /v1/crypto/trading-pair
openapi: 3.0.0
info:
  contact: {}
  description: >-
    Welcome to Arrays!


    Arrays is a unified financial data layer for both financial institutions and
    retail users, delivering comprehensive market data across crypto and equity
    markets. Our datasets cover fundamentals, ETFs, options, crypto, and more.


    Visit [arrays.org](https://arrays.org) to request an API key and start your
    free trial. You can explore our full API offerings in the documentation
    below.


    For any questions regarding APIs or pricing, please contact
    support@arrays.org.
  title: Arrays API
  version: '1.0'
servers:
  - url: https://data-tools.prd.arrays.org/api
security: []
paths:
  /v1/crypto/trading-pair:
    get:
      tags:
        - Crypto
      summary: Get Trading Pair Information
      description: >-
        **Feature Overview**

        [OpenAPI JSON Spec](/docs/output/v1_crypto_trading-pair_get.json)

        Get detailed info for a specified trading pair (configuration, exchange
        info, validity).


        **Parameter Description**


        | Parameter | Description | Example | Notes |

        |----------|-------------|---------|-------|

        | base     | Base currency symbol | BTC, ETH, BNB | Case-insensitive,
        but uppercase is recommended |

        | quote    | Quote currency symbol | USDT, BUSD, BTC | Common quote
        currencies include USDT, BUSD, etc. |


        **Response Data Explanation**


        | Field         | Type     | Description                |
        Example                  |

        |--------------|----------|----------------------------|--------------------------|

        | id           | integer  | Unique identifier of pair  |
        1                        |

        | symbol       | string   | Trading pair symbol        |
        "BTCUSDT"                |

        | base         | string   | Base currency              |
        "BTC"                    |

        | quote        | string   | Quote currency             |
        "USDT"                   |

        | exchange     | string   | Exchange name              |
        "binance"                |

        | isValid      | boolean  | Whether the pair is valid  |
        true                     |

        **Common Trading Pair Examples**

        1. **Mainstream pairs to USD**: `?base=BTC&quote=USDT`

        2. **Ethereum to USD**: `?base=ETH&quote=USDT`

        3. **Altcoin to Bitcoin**: `?base=ADA&quote=BTC`

        4. **Stablecoin pairs**: `?base=USDT&quote=BUSD`

        5. **DeFi token pairs**: `?base=UNI&quote=ETH`


        **Notes**


        - Both `base` and `quote` parameters are required

        - Some pairs may be suspended (`isValid=false` during periods)
      parameters:
        - description: Base currency (e.g., BTC)
          in: query
          name: base
          required: true
          schema:
            type: string
        - description: Quote currency (e.g., USDT)
          in: query
          name: quote
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Successfully retrieved trading pair
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/model.APIResponse'
                  - properties:
                      data:
                        $ref: '#/components/schemas/tradingpairrepo.TradingPair'
                    type: object
        '400':
          description: Invalid parameters
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/model.APIResponse'
                  - properties:
                      data:
                        $ref: '#/components/schemas/model.APIError'
                    type: object
        '404':
          description: Trading pair not found
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/model.APIResponse'
                  - properties:
                      data:
                        $ref: '#/components/schemas/model.APIError'
                    type: object
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/model.APIResponse'
                  - properties:
                      data:
                        $ref: '#/components/schemas/model.APIError'
                    type: object
      security:
        - ApiKeyAuth: []
components:
  schemas:
    model.APIResponse:
      properties:
        data: {}
        error:
          $ref: '#/components/schemas/model.APIError'
        metadata: {}
        pagination: {}
        request_id:
          type: string
        success:
          type: boolean
      type: object
    tradingpairrepo.TradingPair:
      properties:
        base:
          type: string
        created_at:
          type: string
        exchange:
          type: string
        id:
          type: integer
        instrument_type:
          type: integer
        is_valid:
          type: boolean
        quote:
          type: string
        symbol:
          type: string
        updated_at:
          type: string
      type: object
    model.APIError:
      properties:
        code:
          example: RESOURCE_NOT_FOUND
          type: string
        details:
          items:
            $ref: '#/components/schemas/model.APIErrorDetail'
          type: array
        docs_url:
          type: string
        examples:
          items:
            type: string
          type: array
        hint:
          type: string
        message:
          example: The requested resource was not found.
          type: string
        suggestions:
          items:
            type: string
          type: array
      type: object
    model.APIErrorDetail:
      properties:
        field:
          type: string
        got:
          type: string
        reason:
          type: string
      type: object
  securitySchemes:
    ApiKeyAuth:
      description: 'API Key authentication. Example: "your-api-key-here"'
      in: header
      name: X-API-Key
      type: apiKey

````