Skip to main content
GET
/
pools
List Pools
curl --request GET \
  --url https://api.hadron.fi/pools
{
  "total": 3,
  "pages": 1,
  "current_page": 1,
  "page_size": 20,
  "data": [
    {
      "address": "7ZRLTJBvJSy9VDyZmDoGW4b7noorCYnLUisyAXh7hxMz",
      "name": "SOL/USDC",
      "token_x": {
        "address": "So11111111111111111111111111111111111111112",
        "symbol": "SOL",
        "name": "SOL",
        "decimals": 9,
        "icon": "https://raw.githubusercontent.com/solana-labs/token-list/main/assets/mainnet/So11111111111111111111111111111111111111112/logo.png"
      },
      "token_y": {
        "address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
        "symbol": "USDC",
        "name": "USDC",
        "decimals": 6,
        "icon": ""
      },
      "token_x_amount": 5413038034,
      "token_y_amount": 515256215,
      "pool_config": {
        "authority": "Bk2qYNMa4hUkbutBcb4JHhMqAbGEFZq4KjicpMCwC2wn",
        "quoting_authority": "Bk2qYNMa4hUkbutBcb4JHhMqAbGEFZq4KjicpMCwC2wn",
        "oracle_mode": 0,
        "pool_state": "Initialized",
        "base_spread_bps": 5.0
      },
      "tvl": 990.81,
      "current_price": 87.85,
      "volume": { "24h": 364.16 },
      "fees": { "24h": 0.59 }
    }
  ]
}

​
Query Parameters

​
page
integer
default:"1"
1-based page number.
​
page_size
integer
default:"20"
Number of pools per page. Maximum 100.
​
query
string
Search by pool name, token symbol, mint address, or pool address (configPda).
​
sort_by
string
default:"volume_24h:desc"
Sort field and direction. Format: field:direction.Fields: tvl, volume_24h, fees_24hDirections: asc, desc
​
cluster
string
default:"mainnet-beta"
Solana cluster — mainnet-beta or devnet.

​
Response

​
total
integer
Total number of pools matching the query.
​
pages
integer
Total number of pages.
​
current_page
integer
Current page number.
​
page_size
integer
Number of pools per page.
​
data
array
Array of pool objects.
{
  "total": 3,
  "pages": 1,
  "current_page": 1,
  "page_size": 20,
  "data": [
    {
      "address": "7ZRLTJBvJSy9VDyZmDoGW4b7noorCYnLUisyAXh7hxMz",
      "name": "SOL/USDC",
      "token_x": {
        "address": "So11111111111111111111111111111111111111112",
        "symbol": "SOL",
        "name": "SOL",
        "decimals": 9,
        "icon": "https://raw.githubusercontent.com/solana-labs/token-list/main/assets/mainnet/So11111111111111111111111111111111111111112/logo.png"
      },
      "token_y": {
        "address": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
        "symbol": "USDC",
        "name": "USDC",
        "decimals": 6,
        "icon": ""
      },
      "token_x_amount": 5413038034,
      "token_y_amount": 515256215,
      "pool_config": {
        "authority": "Bk2qYNMa4hUkbutBcb4JHhMqAbGEFZq4KjicpMCwC2wn",
        "quoting_authority": "Bk2qYNMa4hUkbutBcb4JHhMqAbGEFZq4KjicpMCwC2wn",
        "oracle_mode": 0,
        "pool_state": "Initialized",
        "base_spread_bps": 5.0
      },
      "tvl": 990.81,
      "current_price": 87.85,
      "volume": { "24h": 364.16 },
      "fees": { "24h": 0.59 }
    }
  ]
}