---
title: "All new-contract pools with price and TVL (chain-direct)"
method: GET
path: "/v2/trade/pools"
tags: ["trade-v2"]
---

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

`GET /v2/trade/pools`

## Request

- Base URL: `https://swap-backend.stage.defi.ovh.gala.com`
- URL: `https://swap-backend.stage.defi.ovh.gala.com/v2/trade/pools`
- Auth: none declared
- TypeScript: <https://skmtc.dev/gala/apis/gala-defi-backend-api/docs/v2/trade/pools/get.ts> (a function with typed inputs; its response is checked against the schema)

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.

## Query parameters

- `sortBy` 'tvl' | 'volume30d' | 'volume1d'
- `sortOrder` 'asc' | 'desc'
- `search` string
- `page` number
- `limit` number
- `poolVersion` 'v1' | 'v2' | 'all'

## Response `200`

- PoolsResponseDto
  - `status` number, required
  - `message` string, required
  - `error` boolean, required
  - `data` PoolListRowResponseDto[], required
    - `fee` number, required
    - `tickSpacing` number, required
    - `protocolFees` number, required
    - `tradingFees` number, required
    - `creator` string
    - `token0CompositeKey` string
    - `token1CompositeKey` string
    - `token0Image` string, required
    - `token1Image` string, required
    - `contractVersion` 'v2', required
    - `token0` string, required
    - `token1` string, required
    - `poolName` string, required
    - `poolRef` string, required
    - `price` string
    - `sqrtPrice` string
    - `tick` number
    - `token0Tvl` string
    - `token1Tvl` string
    - `tvlUsd` number
    - `volume1d` number
    - `volume7d` number
    - `volume30d` number
    - `trades1d` number
    - `fee24h` number
    - `apr1d` number
    - `token0Price` number
    - `token1Price` number

## Other responses

- `400`
- `default`: An error response using the shared backend error envelope.

---

[API](https://skmtc.dev/gala/apis/gala-defi-backend-api.md) - [All operations](https://skmtc.dev/gala/apis/gala-defi-backend-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gala/apis/gala-defi-backend-api/revisions/84f8184e2828?raw)