---
title: "Megafilter for Pools"
method: GET
path: "/onchain/pools/megafilter"
---

# Megafilter for Pools

`GET /onchain/pools/megafilter`

To query pools based on various filters across all networks on GeckoTerminal

## Query parameters

- `networks` string
- `dexes` string
- `include` string
- `page` integer
- `sort` 'm5_trending' | 'h1_trending' | 'h6_trending' | 'h24_trending' | 'h24_tx_count_desc' | 'h24_tx_count_asc' | 'h24_volume_usd_desc' | 'h24_volume_usd_asc' | 'm5_price_change_percentage_asc' | 'h1_price_change_percentage_asc' | 'h6_price_change_percentage_asc' | 'h24_price_change_percentage_asc' | 'm5_price_change_percentage_desc' | 'h1_price_change_percentage_desc' | 'h6_price_change_percentage_desc' | 'h24_price_change_percentage_desc' | 'fdv_usd_asc' | 'fdv_usd_desc' | 'reserve_in_usd_asc' | 'reserve_in_usd_desc' | 'price_asc' | 'price_desc' | 'pool_created_at_desc'
- `fdv_usd_min` number
- `fdv_usd_max` number
- `reserve_in_usd_min` number
- `reserve_in_usd_max` number
- `h24_volume_usd_min` number
- `h24_volume_usd_max` number
- `pool_created_hour_min` number
- `pool_created_hour_max` number
- `tx_count_min` integer
- `tx_count_max` integer
- `tx_count_duration` '5m' | '1h' | '6h' | '24h'
- `buys_min` integer
- `buys_max` integer
- `buys_duration` '5m' | '1h' | '6h' | '24h'
- `sells_min` integer
- `sells_max` integer
- `sells_duration` '5m' | '1h' | '6h' | '24h'
- `price_change_percentage_min` number
- `price_change_percentage_max` number
- `price_change_percentage_duration` '5m' | '1h' | '6h' | '24h'
- `buy_tax_percentage_min` number
- `buy_tax_percentage_max` number
- `sell_tax_percentage_min` number
- `sell_tax_percentage_max` number
- `checks` string
- `include_unknown_honeypot_tokens` boolean

## Response `200`

Filtered pools across all networks

- Pool
  - `data` object[], required
    - `id` string, required — Pool identifier
    - `type` string, required — Resource type
    - `attributes` object, required
      - `base_token_price_usd` string, required — Base token price in USD
      - `base_token_price_native_currency` string, nullable, required — Base token price in native currency
      - `quote_token_price_usd` string, required — Quote token price in USD
      - `quote_token_price_native_currency` string, nullable, required — Quote token price in native currency
      - `base_token_price_quote_token` string, nullable, required — Base token price in quote token
      - `quote_token_price_base_token` string, nullable, required — Quote token price in base token
      - `address` string, required — Pool contract address
      - `name` string, required — Pool name
      - `pool_created_at` string, required — Pool creation timestamp
      - `fdv_usd` string, nullable, required — Fully diluted valuation in USD
      - `market_cap_usd` string, nullable, required — Market cap in USD
      - `price_change_percentage` object, required — Price change percentage over various timeframes
        - `m5` string
        - `m15` string
        - `m30` string
        - `h1` string
        - `h6` string
        - `h24` string
      - `transactions` object, required — Transaction counts over various timeframes
        - `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
        - `h6` object
          - `buys` integer
          - `sells` integer
          - `buyers` integer
          - `sellers` integer
        - `h24` object
          - `buys` integer
          - `sells` integer
          - `buyers` integer
          - `sellers` integer
      - `volume_usd` object, required — Volume in USD over various timeframes
        - `m5` string
        - `m15` string
        - `m30` string
        - `h1` string
        - `h6` string
        - `h24` string
      - `reserve_in_usd` string, nullable, required — Total reserve in USD
      - `token_price_usd` string — Price of the queried token in USD, present when querying pools by token address
      - `sentiment_vote_positive_percentage` number — GeckoTerminal community positive sentiment vote percentage
      - `sentiment_vote_negative_percentage` number — GeckoTerminal community negative sentiment vote percentage
      - `community_sus_report` integer — GeckoTerminal community suspicious reports count
    - `relationships` object, required — Related resources
      - `base_token` object
        - `data` object
          - `id` string
          - `type` string
      - `quote_token` object
        - `data` object
          - `id` string
          - `type` string
      - `network` object
        - `data` object
          - `id` string
          - `type` string
      - `dex` object
        - `data` object
          - `id` string
          - `type` string
  - `included` object[] — Included related resources, present when include parameter is specified
    - `id` string
    - `type` string
    - `attributes` object
      - `address` string
      - `name` string
      - `symbol` string
      - `decimals` integer
      - `image_url` string, nullable
      - `coingecko_coin_id` string, nullable
      - `coingecko_asset_platform_id` string

## Changes

- **2026-05-28** `11cc9e00fd86` — 14 breaking, 26 info
  - for the `query` request parameter `buys_duration`, default value `24h` was removed
  - for the `query` request parameter `checks`, default value `no_honeypot` was removed
  - for the `query` request parameter `include`, default value `base_token` was removed
  - for the `query` request parameter `page`, default value `1` was removed
  - …36 more
- **2026-04-30** `fb6b6a203ce6` — 2 breaking, 2 info
  - the response property `data/items/attributes/fdv_usd` became nullable for the status `200`
  - the response property `data/items/attributes/market_cap_usd` became nullable for the status `200`
  - added the optional property `data/items/attributes/transactions/h6` to the response with the `200` status
  - added the optional property `data/items/relationships/network` to the response with the `200` status
- **2026-02-25** `e88de4e81cdb` — 7 info
  - added the new optional `query` request parameter `price_change_percentage_duration`
  - added the new optional `query` request parameter `price_change_percentage_max`
  - added the new optional `query` request parameter `price_change_percentage_min`
  - added the new enum value `h24_tx_count_asc` to the `query` request parameter `sort`
  - …3 more
- …earlier changes not shown

[Full history](https://skmtc.dev/coingecko/apis/coingecko-api/changes/onchain/pools/megafilter/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/006c13c1a566/schema)