get_search
Read-only
Search for cryptocurrencies, categories, markets, exchanges, and NFTs on CoinGecko to find specific data using queries and filter results for efficiency.
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 coins, categories and markets listed on CoinGecko
Response Schema
{
$ref: '#/$defs/search_get_response',
$defs: {
search_get_response: {
type: 'object',
properties: {
categories: {
type: 'array',
items: {
type: 'object',
properties: {
id: {
type: 'string',
description: 'category ID'
},
name: {
type: 'string',
description: 'category name'
}
}
}
},
coins: {
type: 'array',
items: {
type: 'object',
properties: {
id: {
type: 'string',
description: 'coin ID'
},
api_symbol: {
type: 'string',
description: 'coin api symbol'
},
large: {
type: 'string',
description: 'coin large image url'
},
market_cap_rank: {
type: 'number',
description: 'coin market cap rank'
},
name: {
type: 'string',
description: 'coin name'
},
symbol: {
type: 'string',
description: 'coin symbol'
},
thumb: {
type: 'string',
description: 'coin thumb image url'
}
}
}
},
exchanges: {
type: 'array',
items: {
type: 'object',
properties: {
id: {
type: 'string',
description: 'exchange ID'
},
large: {
type: 'string',
description: 'exchange large image url'
},
market_type: {
type: 'string',
description: 'exchange market type'
},
name: {
type: 'string',
description: 'exchange name'
},
thumb: {
type: 'string',
description: 'exchange thumb image url'
}
}
}
},
icos: {
type: 'array',
items: {
type: 'string'
}
},
nfts: {
type: 'array',
items: {
type: 'object',
properties: {
id: {
type: 'string',
description: 'NFT collection ID'
},
name: {
type: 'string',
description: 'NFT name'
},
symbol: {
type: 'string',
description: 'NFT collection symbol'
},
thumb: {
type: 'string',
description: 'NFT collection thumb image url'
}
}
}
}
}
}
}
}Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | 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/). |