---
title: "Ranked new-contract opportunity pools"
method: GET
path: "/v2/trade/opportunities"
tags: ["trade-v2"]
---

# Ranked new-contract opportunity pools

`GET /v2/trade/opportunities`

## Request

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

Ranked new-contract opportunity pools

## Query parameters

- `limit` number

## Response `200`

- TradeV2OpportunitiesResponseDto
  - `status` number, required
  - `message` string, required
  - `error` boolean, required
  - `data` TradeV2OpportunitiesDataResponseDto, required
    - `pools` TradeV2OpportunityPoolResponseDto[], 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
      - `signals` string[], required
      - `opportunityScore` number, 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)
