Search Pools
Searches for DEX liquidity pools by token name, symbol, or contract address across networks. Returns pools with pricing, volumes, and transaction data; filterable by network with pagination support. Ideal for: finding pools for a token, discovering trading pairs, locating liquidity across DEXes.
Catalog action Blockchain Data
Searches for DEX liquidity pools by token name, symbol, or contract address across networks. Returns pools with pricing, volumes, and transaction data; filterable by network with pagination support. Ideal for: finding pools for a token, discovering trading pairs, locating liquidity across DEXes.
At a Glance
| Field | Value |
|---|---|
| Action ID | coingecko-search-pools |
| Category | Blockchain Data |
| Connector | Not required |
| Requires gas | No |
| Funds movement | None declared |
| Tags | coingecko, onchain, pool, dex, search, read |
Payload Schema
| Field | Type | Required | Description |
|---|---|---|---|
query | string | Yes | Search query - can be token name (e.g., 'uniswap'), symbol (e.g., 'UNI'), or contract address (e.g., '0x1f9840a85d5af5bf1d1762f925bdaddc4201f984'). |
include | string | No | Attributes to include in response (comma-separated). Options: 'base_token' (base token details), 'quote_token' (quote token details), 'dex' (DEX info). Example: 'base_token,quote_token,dex' |
page | number | No | Page number for pagination (default: 1). Each page returns multiple pools. Note: Pagination beyond 10 pages requires paid plan. |
network | string | No | Filter by network ID (e.g., 'eth', 'bsc', 'polygon_pos', 'arbitrum', 'optimism'). Use token_lookup(query_type='networks') to get valid network IDs. |
Result Schema
| Field | Type | Required | Description |
|---|---|---|---|
pools | array | Yes | Array of DEX pools matching the search query (flat structure, properties directly on each pool object). |
Examples
json{ "type": "coingecko-search-pools", "payload": { "query": "status:open" }, "children": []}
bashcurl -X POST "https://api.b3os.org/v1/actions/coingecko-search-pools/test" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "inputs": { "query": "status:open" }}'
Payload fields can use workflow expressions such as {{$trigger.body.amount}}, {{$nodes.fetch.result.price}}, and {{$props.asset}} when the value should come from a trigger, prior node, or reusable workflow prop.