get_search_onchain_pools
Search for on-chain liquidity pools across networks, retrieving detailed data such as token prices, market cap, and transaction volumes. Use the jq_filter parameter to customize response fields and optimize performance.
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
{
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
| Name | Required | Description | Default |
|---|---|---|---|
| include | No | attributes to include, comma-separated if more than one to include <br> Available values: `base_token`, `quote_token`, `dex` | |
| 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/). | |
| network | No | network ID <br> *refers to [/networks](/reference/networks-list) | |
| page | No | page through results <br> Default value: 1 | |
| query | No | search query |
Input Schema (JSON Schema)
{
"properties": {
"include": {
"description": "attributes to include, comma-separated if more than one to include <br> Available values: `base_token`, `quote_token`, `dex`",
"type": "string"
},
"jq_filter": {
"description": "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.\n\nFor example: to include only the `name` field in every object of a results array, you can provide \".results[].name\".\n\nFor more information, see the [jq documentation](https://jqlang.org/manual/).",
"title": "jq Filter",
"type": "string"
},
"network": {
"description": "network ID <br> *refers to [/networks](/reference/networks-list)",
"type": "string"
},
"page": {
"description": "page through results <br> Default value: 1",
"type": "integer"
},
"query": {
"description": "search query",
"type": "string"
}
},
"required": [],
"type": "object"
}