get_search_trending
Query trending cryptocurrencies, NFTs, and categories on CoinGecko from the last 24 hours. Use the jq_filter
parameter to filter and optimize response data for better 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 query trending search coins, NFTs and categories on CoinGecko in the last 24 hours
Response Schema
{
type: 'object',
properties: {
categories: {
type: 'array',
items: {
type: 'object',
properties: {
id: {
type: 'number'
},
coins_count: {
type: 'number',
description: 'category number of coins'
},
data: {
type: 'object',
properties: {
market_cap: {
type: 'number',
description: 'category market cap'
},
market_cap_btc: {
type: 'number',
description: 'category market cap in btc'
},
market_cap_change_percentage_24h: {
type: 'object',
description: 'category market cap change percentage in 24 hours',
properties: {
btc: {
type: 'number'
},
usd: {
type: 'number'
}
}
},
sparkline: {
type: 'string',
description: 'category sparkline image url'
},
total_volume: {
type: 'number',
description: 'category total volume'
},
total_volume_btc: {
type: 'number',
description: 'category total volume in btc'
}
}
},
market_cap_1h_change: {
type: 'number',
description: 'category market cap 1 hour change'
},
name: {
type: 'string',
description: 'category name'
},
slug: {
type: 'string',
description: 'category web slug'
}
}
}
},
coins: {
type: 'array',
items: {
type: 'object',
properties: {
id: {
type: 'string',
description: 'coin ID'
},
coin_id: {
type: 'number'
},
data: {
type: 'object',
properties: {
content: {
type: 'string'
},
market_cap: {
type: 'string',
description: 'coin market cap in usd'
},
market_cap_btc: {
type: 'string',
description: 'coin market cap in btc'
},
price: {
type: 'number',
description: 'coin price in usd'
},
price_btc: {
type: 'string',
description: 'coin price in btc'
},
price_change_percentage_24h: {
type: 'object',
description: 'coin price change percentage in 24 hours',
properties: {
btc: {
type: 'number'
},
usd: {
type: 'number'
}
}
},
sparkline: {
type: 'string',
description: 'coin sparkline image url'
},
total_volume: {
type: 'string',
description: 'coin total volume in usd'
},
total_volume_btc: {
type: 'string',
description: 'coin total volume in btc'
}
}
},
large: {
type: 'string',
description: 'coin large image url'
},
market_cap_rank: {
type: 'number',
description: 'coin market cap rank'
},
name: {
type: 'string',
description: 'coin name'
},
price_btc: {
type: 'number',
description: 'coin price in btc'
},
score: {
type: 'number',
description: 'coin sequence in the list'
},
slug: {
type: 'string',
description: 'coin web slug'
},
small: {
type: 'string',
description: 'coin small image url'
},
symbol: {
type: 'string',
description: 'coin symbol'
},
thumb: {
type: 'string',
description: 'coin thumb image url'
}
}
}
},
nfts: {
type: 'array',
items: {
type: 'object',
properties: {
id: {
type: 'string',
description: 'NFT collection ID'
},
data: {
type: 'object',
properties: {
content: {
type: 'string'
},
floor_price: {
type: 'string',
description: 'NFT collection floor price'
},
floor_price_in_usd_24h_percentage_change: {
type: 'string',
description: 'NFT collection floor price in usd 24 hours percentage change'
},
h24_average_sale_price: {
type: 'string',
description: 'NFT collection 24 hours average sale price'
},
h24_volume: {
type: 'string',
description: 'NFT collection volume in 24 hours'
},
sparkline: {
type: 'string',
description: 'NFT collection sparkline image url'
}
}
},
floor_price_24h_percentage_change: {
type: 'number',
description: 'NFT collection floor price 24 hours percentage change'
},
floor_price_in_native_currency: {
type: 'number',
description: 'NFT collection floor price in native currency'
},
name: {
type: 'string',
description: 'NFT collection name'
},
native_currency_symbol: {
type: 'string',
description: 'NFT collection native currency symbol'
},
nft_contract_id: {
type: 'number'
},
symbol: {
type: 'string',
description: 'NFT collection symbol'
},
thumb: {
type: 'string',
description: 'NFT collection thumb image url'
}
}
}
}
}
}
Input Schema
Name | Required | Description | Default |
---|---|---|---|
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/). | |
show_max | No | show max number of results available for the given type <br> Available values: `coins`, `nfts`, `categories` <br> Example: `coins` or `coins,nfts,categories` |
Input Schema (JSON Schema)
{
"properties": {
"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"
},
"show_max": {
"description": "show max number of results available for the given type <br> Available values: `coins`, `nfts`, `categories` <br> Example: `coins` or `coins,nfts,categories`",
"type": "string"
}
},
"required": [],
"type": "object"
}