get_search_onchain_pools
Read-only
Search for cryptocurrency liquidity pools on specific blockchain networks to find trading pairs, price data, and transaction metrics for analysis.
Instructions
When using this tool, always use the jq_filter parameter to reduce the response size and improve performance.
Only omit if you're sure you don't need the data.
This endpoint allows you to search for pools on a network
Response Schema
{
$ref: '#/$defs/pool_get_response',
$defs: {
pool_get_response: {
type: 'object',
properties: {
data: {
type: 'array',
items: {
type: 'object',
properties: {
id: {
type: 'string'
},
attributes: {
type: 'object',
properties: {
address: {
type: 'string'
},
base_token_price_native_currency: {
type: 'string'
},
base_token_price_quote_token: {
type: 'string'
},
base_token_price_usd: {
type: 'string'
},
fdv_usd: {
type: 'string'
},
market_cap_usd: {
type: 'string'
},
name: {
type: 'string'
},
pool_created_at: {
type: 'string'
},
price_change_percentage: {
type: 'object',
properties: {
h1: {
type: 'string'
},
h24: {
type: 'string'
},
h6: {
type: 'string'
},
m15: {
type: 'string'
},
m30: {
type: 'string'
},
m5: {
type: 'string'
}
}
},
quote_token_price_base_token: {
type: 'string'
},
quote_token_price_native_currency: {
type: 'string'
},
quote_token_price_usd: {
type: 'string'
},
reserve_in_usd: {
type: 'string'
},
transactions: {
type: 'object',
properties: {
h1: {
type: 'object',
properties: {
buyers: {
type: 'integer'
},
buys: {
type: 'integer'
},
sellers: {
type: 'integer'
},
sells: {
type: 'integer'
}
}
},
h24: {
type: 'object',
properties: {
buyers: {
type: 'integer'
},
buys: {
type: 'integer'
},
sellers: {
type: 'integer'
},
sells: {
type: 'integer'
}
}
},
m15: {
type: 'object',
properties: {
buyers: {
type: 'integer'
},
buys: {
type: 'integer'
},
sellers: {
type: 'integer'
},
sells: {
type: 'integer'
}
}
},
m30: {
type: 'object',
properties: {
buyers: {
type: 'integer'
},
buys: {
type: 'integer'
},
sellers: {
type: 'integer'
},
sells: {
type: 'integer'
}
}
},
m5: {
type: 'object',
properties: {
buyers: {
type: 'integer'
},
buys: {
type: 'integer'
},
sellers: {
type: 'integer'
},
sells: {
type: 'integer'
}
}
}
}
},
volume_usd: {
type: 'object',
properties: {
h1: {
type: 'string'
},
h24: {
type: 'string'
},
h6: {
type: 'string'
},
m15: {
type: 'string'
},
m30: {
type: 'string'
},
m5: {
type: 'string'
}
}
}
}
},
relationships: {
type: 'object',
properties: {
base_token: {
type: 'object',
properties: {
data: {
type: 'object',
properties: {
id: {
type: 'string'
},
type: {
type: 'string'
}
}
}
}
},
dex: {
type: 'object',
properties: {
data: {
type: 'object',
properties: {
id: {
type: 'string'
},
type: {
type: 'string'
}
}
}
}
},
quote_token: {
type: 'object',
properties: {
data: {
type: 'object',
properties: {
id: {
type: 'string'
},
type: {
type: 'string'
}
}
}
}
}
}
},
type: {
type: 'string'
}
}
}
},
included: {
type: 'array',
items: {
type: 'object',
properties: {
id: {
type: 'string'
},
attributes: {
type: 'object',
properties: {
address: {
type: 'string'
},
coingecko_coin_id: {
type: 'string'
},
decimals: {
type: 'integer'
},
image_url: {
type: 'string'
},
name: {
type: 'string'
},
symbol: {
type: 'string'
}
}
},
type: {
type: 'string'
}
}
}
}
}
}
}
}Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| include | No | attributes to include, comma-separated if more than one to include Available values: `base_token`, `quote_token`, `dex` | |
| network | No | network ID *refers to [/networks](/reference/networks-list) | |
| page | No | page through results Default value: 1 | |
| query | No | search query | |
| jq_filter | No | A jq filter to apply to the response to include certain fields. Consult the output schema in the tool description to see the fields that are available. For example: to include only the `name` field in every object of a results array, you can provide ".results[].name". For more information, see the [jq documentation](https://jqlang.org/manual/). |