Search / filter network pools

PRIMARY POOL FUNCTION: top liquidity pools on a network, with optional volume / liquidity / transaction / age filters and an optional token_address filter. Replaces the removed /pools and /pools/filter endpoints, and (via token_address) the removed /tokens/{token_address}/pools endpoint. Rows are returned under results, paginated by cursor (has_next_page + next_cursor).

get/api/networks/{network}/pools/search

Request

  • Base URL: https://mcp.dexpaprika.com
  • URL: https://mcp.dexpaprika.com/api/networks/{network}/pools/search
  • Auth: none declared

Path parameters

networkstring required

Network ID from getNetworks (e.g., 'ethereum', 'solana')

Query parameters

token_addressstring

Restrict results to pools containing this token contract address. Network-scoped only: no cross-network equivalent exists. An unknown address returns 200 with an empty results array, not an error.

limitinteger

Number of items per page (default: 10, max: 100)

cursorstring

Pagination cursor. Pass next_cursor from a previous response to fetch the next page.

sort'asc' | 'desc'

Sort direction (default: 'desc')

order_by'volume_usd_24h' | 'volume_usd_7d' | 'volume_usd_30d' | 'liquidity_usd' | 'txns_24h' | 'created_at' | 'price_usd' | 'price_change_percentage_24h' | 'price_change_percentage_48h' | 'price_change_percentage_6h' | 'price_change_percentage_1h' | 'price_change_percentage_5m'

Field to order by (default: 'volume_usd_24h')

volume_usd_24h_minnumber

Minimum 24h volume in USD

volume_usd_24h_maxnumber

Maximum 24h volume in USD

liquidity_usd_minnumber

Minimum pool liquidity in USD

liquidity_usd_maxnumber

Maximum pool liquidity in USD

txns_24h_mininteger

Minimum transactions in 24h

created_afterstring

Only pools created at or after this time: a relative offset from now such as -24h or -7d, Unix seconds, an RFC3339 timestamp, or yyyy-mm-dd

created_beforestring

Only pools created at or before this time, same formats as created_after

price_change_percentage_24h_minnumber

Minimum 24h price change in percent (negatives allowed)

price_change_percentage_24h_maxnumber

Maximum 24h price change in percent

price_change_percentage_48h_minnumber

Minimum 48h price change in percent

price_change_percentage_48h_maxnumber

Maximum 48h price change in percent

price_change_percentage_6h_minnumber

Minimum 6h price change in percent

price_change_percentage_6h_maxnumber

Maximum 6h price change in percent

price_change_percentage_1h_minnumber

Minimum 1h price change in percent

price_change_percentage_1h_maxnumber

Maximum 1h price change in percent

price_change_percentage_5m_minnumber

Minimum 5m price change in percent

price_change_percentage_5m_maxnumber

Maximum 5m price change in percent

Response

Matching liquidity pools

has_next_pageboolean
next_cursorstring nullable

Changes

No recorded changes to this operation across all 1 revision of this API.