---
title: "Top Pools by Network"
method: GET
path: "/onchain/networks/{network}/pools"
tags: ["Pools"]
---

# Top Pools by Network

`GET /onchain/networks/{network}/pools`

This endpoint allows you to **query all the top pools based on the provided network**

## Path parameters

- `network` string, required

## Query parameters

- `include` string
- `page` integer
- `sort` 'h24_tx_count_desc' | 'h24_volume_usd_desc'
- `include_gt_community_data` boolean

## Response `200`

Get top pools on a network

- Pool
  - `data` object[]
    - `id` string
    - `type` string
    - `attributes` object
      - `base_token_price_usd` string
      - `base_token_price_native_currency` string
      - `quote_token_price_usd` string
      - `quote_token_price_native_currency` string
      - `base_token_price_quote_token` string
      - `quote_token_price_base_token` string
      - `address` string
      - `name` string
      - `pool_created_at` string
      - `fdv_usd` string
      - `market_cap_usd` string
      - `price_change_percentage` object
        - `m5` string
        - `m15` string
        - `m30` string
        - `h1` string
        - `h6` string
        - `h24` string
      - `transactions` object
        - `m5` object
          - `buys` integer
          - `sells` integer
          - `buyers` integer
          - `sellers` integer
        - `m15` object
          - `buys` integer
          - `sells` integer
          - `buyers` integer
          - `sellers` integer
        - `m30` object
          - `buys` integer
          - `sells` integer
          - `buyers` integer
          - `sellers` integer
        - `h1` object
          - `buys` integer
          - `sells` integer
          - `buyers` integer
          - `sellers` integer
        - `h24` object
          - `buys` integer
          - `sells` integer
          - `buyers` integer
          - `sellers` integer
      - `volume_usd` object
        - `m5` string
        - `m15` string
        - `m30` string
        - `h1` string
        - `h6` string
        - `h24` string
      - `reserve_in_usd` string
      - `sentiment_vote_positive_percentage` number
      - `sentiment_vote_negative_percentage` number
      - `community_sus_report` number
    - `relationships` object
      - `base_token` object
        - `data` object
          - `id` string
          - `type` string
      - `quote_token` object
        - `data` object
          - `id` string
          - `type` string
      - `dex` object
        - `data` object
          - `id` string
          - `type` string
  - `included` object[]
    - `id` string
    - `type` string
    - `attributes` object
      - `address` string
      - `name` string
      - `symbol` string
      - `decimals` integer
      - `image_url` string
      - `coingecko_coin_id` string

## Changes

- **2025-12-18** `a23494dedfc2` — 4 info
  - added the new optional `query` request parameter `include_gt_community_data`
  - added the optional property `data/items/attributes/community_sus_report` to the response with the `200` status
  - added the optional property `data/items/attributes/sentiment_vote_negative_percentage` to the response with the `200` status
  - added the optional property `data/items/attributes/sentiment_vote_positive_percentage` to the response with the `200` status
- **2025-09-22** `91c83447321b` — 1 breaking
  - for the `query` request parameter `include`, default value `base_token` was added
- **2025-06-23** `385cf003659b` — 4 info
  - added the optional property `data/items/attributes/price_change_percentage/m15` to the response with the `200` status
  - added the optional property `data/items/attributes/price_change_percentage/m30` to the response with the `200` status
  - added the optional property `data/items/attributes/volume_usd/m15` to the response with the `200` status
  - added the optional property `data/items/attributes/volume_usd/m30` to the response with the `200` status
- **2025-05-29** `672da434b7c1` — 1 warning
  - removed the optional property `data/items/relationships/network` from the response with the `200` status

[Change history](https://skmtc.dev/coingecko/apis/coingecko-api/changes/onchain/networks/:network/pools/get.md)

---

[API](https://skmtc.dev/coingecko/apis/coingecko-api.md) · [All operations](https://skmtc.dev/coingecko/apis/coingecko-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/coingecko/coingecko-api/revisions/e88de4e81cdb/schema)