trade-v2

All new-contract pools with price and TVL (chain-direct)

search/sortBy/sortOrder/page/limit are optional — omit all of them for the original unsorted full array (SDK/bot contract, unchanged); pass any of them for the same search+sort+paginate behavior /explore/pools offered its v2 rows.

get/v2/trade/pools

Request

Query parameters

sortBy'tvl' | 'volume30d' | 'volume1d'
Example:tvl

Sort by field

sortOrder'asc' | 'desc'
Example:desc

Sort order

searchstring
Example:GALA

Search term for filtering pools

pagenumber
Example:1

Page number for pagination (starts at 1)

limitnumber
Example:10

Maximum number of pools per page; omit to return all

poolVersion'v1' | 'v2' | 'all'
Example:v2

Which contract's pools to include. Comma-separated: "v1" (legacy DexV3Contract), "v2" (new GalaChainDex), "all", or a combination such as "v1,v2" (equivalent to "all"). Omit to include both.

Response

statusnumber required
messagestring required
errorboolean required

Example response

{
  "status": 200,
  "message": "Response fetched successfully",
  "data": [
    {
      "fee": 3000,
      "tickSpacing": 60,
      "protocolFees": 100,
      "tradingFees": 3000,
      "creator": "client|000000000000000000000000",
      "token0CompositeKey": "GALA$Unit$none$none",
      "token1CompositeKey": "GUSDC$Unit$none$none",
      "contractVersion": "v2",
      "token0": "GALA",
      "token1": "GUSDC",
      "poolName": "GALA/GUSDC",
      "poolRef": "GALA$GUSDC$3000",
      "price": "1.25",
      "sqrtPrice": "1.118",
      "tick": 1234,
      "token0Tvl": "10",
      "token1Tvl": "20",
      "tvlUsd": 1000,
      "volume1d": 500,
      "volume7d": 3500,
      "volume30d": 14000,
      "trades1d": 25,
      "fee24h": 1.5,
      "apr1d": 54.75,
      "token0Price": 0.025,
      "token1Price": 1
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.