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

# Get Liquidity Pairs

> Retrieve all available liquidity pairs sorted by liquidity

## Description

Returns all liquidity pairs available on InkySwap, sorted by total liquidity in USD descending. This endpoint automatically converts WETH addresses to native ETH representation for easier integration.

## Response

<ResponseField name="pairs" type="array">
  Array of liquidity pair objects

  <Expandable title="Pair Object">
    <ResponseField name="address" type="string">
      Liquidity pair contract address
    </ResponseField>

    <ResponseField name="token0" type="object">
      First token in the pair

      <Expandable title="Token Object">
        <ResponseField name="address" type="string">
          Token contract address
        </ResponseField>

        <ResponseField name="symbol" type="string">
          Token symbol
        </ResponseField>

        <ResponseField name="name" type="string">
          Token name
        </ResponseField>

        <ResponseField name="decimals" type="number">
          Token decimals
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="token1" type="object">
      Second token in the pair

      <Expandable title="Token Object">
        <ResponseField name="address" type="string">
          Token contract address
        </ResponseField>

        <ResponseField name="symbol" type="string">
          Token symbol
        </ResponseField>

        <ResponseField name="name" type="string">
          Token name
        </ResponseField>

        <ResponseField name="decimals" type="number">
          Token decimals
        </ResponseField>
      </Expandable>
    </ResponseField>

    <ResponseField name="liquidity_usd" type="number">
      Total liquidity value in USD
    </ResponseField>

    <ResponseField name="reserve0" type="string">
      Reserve amount of token0
    </ResponseField>

    <ResponseField name="reserve1" type="string">
      Reserve amount of token1
    </ResponseField>

    <ResponseField name="volume_24h" type="number">
      24-hour trading volume in USD
    </ResponseField>

    <ResponseField name="fee_tier" type="number">
      Trading fee percentage (e.g., 0.003 for 0.3%)
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json theme={null}
  [
    {
      "address": "0x1234567890abcdef1234567890abcdef12345678",
      "token0": {
        "address": "0x0000000000000000000000000000000000000000",
        "symbol": "ETH",
        "name": "Ethereum",
        "decimals": 18
      },
      "token1": {
        "address": "0xabcdef1234567890abcdef1234567890abcdef12",
        "symbol": "USDC",
        "name": "USD Coin",
        "decimals": 6
      },
      "liquidity_usd": 5000000,
      "reserve0": "1250000000000000000000",
      "reserve1": "2500000000000",
      "volume_24h": 125000,
      "fee_tier": 0.003
    }
  ]
  ```
</ResponseExample>

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "https://inkyswap.com/api/pairs"
  ```

  ```typescript TypeScript theme={null}
  const response = await fetch('https://inkyswap.com/api/pairs');
  const pairs = await response.json();
  ```

  ```python Python theme={null}
  import requests

  response = requests.get("https://inkyswap.com/api/pairs")
  pairs = response.json()
  ```
</RequestExample>