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

# Get Token Pairs

> Retrieve all available token pairs across supported trading platforms

## Overview

This endpoint returns a comprehensive list of all available token pairs across the supported trading platforms (Hyperliquid, Aster, and Lighter). Each token includes information about its availability, platform-specific names, and metadata.

## Request

<RequestExample>
  ```bash cURL theme={null}
  curl 'https://api.tide.ag/api/token-pairs' | jq .
  ```
</RequestExample>

## Response

<ResponseField name="data" type="array">
  Array of token pair objects

  <Expandable title="Token Pair Object">
    <ResponseField name="ticker" type="string">
      The standardized ticker symbol for the token
    </ResponseField>

    <ResponseField name="logoUrl" type="string | null">
      URL to the token's logo image, or null if not available
    </ResponseField>

    <ResponseField name="platform_names" type="object">
      Platform-specific ticker names for each exchange

      <Expandable title="Platform Names">
        <ResponseField name="hyperliquid" type="string | null">
          Token symbol used on Hyperliquid platform
        </ResponseField>

        <ResponseField name="aster" type="string | null">
          Token symbol used on Aster platform
        </ResponseField>

        <ResponseField name="lighter" type="string | null">
          Token symbol used on Lighter platform
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="availability" type="object">
      Indicates which platforms support this token

      <Expandable title="Availability">
        <ResponseField name="hyperliquid" type="boolean">
          Whether the token is available on Hyperliquid
        </ResponseField>

        <ResponseField name="aster" type="boolean">
          Whether the token is available on Aster
        </ResponseField>

        <ResponseField name="lighter" type="boolean">
          Whether the token is available on Lighter
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="platforms" type="object">
      Platform-specific configuration objects

      <Expandable title="Platforms">
        <ResponseField name="hyperliquid" type="object | null">
          Hyperliquid-specific configuration (empty object if available, null if not)
        </ResponseField>

        <ResponseField name="aster" type="object | null">
          Aster-specific configuration (empty object if available, null if not)
        </ResponseField>

        <ResponseField name="lighter" type="object | null">
          Lighter-specific configuration (empty object if available, null if not)
        </ResponseField>
      </Expandable>
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="timestamp" type="number">
  Unix timestamp when the data was generated
</ResponseField>

<ResponseExample>
  ```json Response theme={null}
  {
    "data": [
      {
        "ticker": "BTC",
        "logoUrl": "https://coin-images.coingecko.com/coins/images/1/small/bitcoin.png?1696501400",
        "platform_names": {
          "hyperliquid": "BTC",
          "aster": "BTCUSDT",
          "lighter": "BTC"
        },
        "availability": {
          "hyperliquid": true,
          "aster": true,
          "lighter": true
        },
        "platforms": {
          "hyperliquid": {},
          "aster": {},
          "lighter": {}
        }
      },
      {
        "ticker": "ETH",
        "logoUrl": "https://coin-images.coingecko.com/coins/images/279/small/ethereum.png?1696501628",
        "platform_names": {
          "hyperliquid": "ETH",
          "aster": "ETHUSDT",
          "lighter": "ETH"
        },
        "availability": {
          "hyperliquid": true,
          "aster": true,
          "lighter": true
        },
        "platforms": {
          "hyperliquid": {},
          "aster": {},
          "lighter": {}
        }
      }
    ],
    "timestamp": 1766988481242
  }
  ```
</ResponseExample>

## Use Cases

* **Platform Discovery**: Find which platforms support specific tokens
* **Symbol Mapping**: Get platform-specific ticker symbols for cross-platform trading
* **Token Metadata**: Access token logos and standardized information
* **Availability Checking**: Verify token availability before placing orders

## Notes

* The response includes both cryptocurrency tokens and traditional forex pairs (e.g., USDCAD, USDJPY)
* Some tokens may have different symbols across platforms (e.g., "BTC" vs "BTCUSDT")
* Logo URLs are sourced from CoinGecko and may be null for some tokens
* The `platforms` object contains platform-specific configurations (currently empty objects)