---
title: "Get ranked legacy opportunity pools"
method: GET
path: "/v1/trade/opportunities"
tags: ["trade"]
---

# Get ranked legacy opportunity pools

`GET /v1/trade/opportunities`

## Request

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

Curated feed, legacy pools only.

## Query parameters

- `limit` number

## Response `200`

- TradePoolListResponseDto
  - `status` number, required
  - `error` false, required
  - `message` string
  - `data` TradePoolListDataResponseDto, required
    - `pools` TradePoolAttributesResponseDto[], required
      - `poolPair` string, required
      - `poolHash` string, required
      - `token0` string, required
      - `token0Image` string, required
      - `token1` string, required
      - `token1Image` string, required
      - `token0CompositeKey` string, nullable, required
      - `token1CompositeKey` string, nullable, required
      - `token0OriginChain` string, nullable, required
      - `token1OriginChain` string, nullable, required
      - `token0Price` string, required
      - `token1Price` string, required
      - `poolName` string, required
      - `fee` string, required
      - `fee24h` number, required
      - `token0Tvl` number, required
      - `token0TvlUsd` number, required
      - `token1Tvl` number, required
      - `token1TvlUsd` number, required
      - `tvl` number, required
      - `volume1d` number, required
      - `volume30d` number, required
      - `volume7d` number, required
      - `trades1d` number, required
      - `poolCreatedAt` string, nullable, required
      - `dayPerTvl` number, required
      - `apr1d` number, required
      - `signals` string[], required
      - `opportunityScore` number, required
      - `contractVersion` 'v1' | 'v2', required
    - `count` number, required

## 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)