CoinGecko
Cryptocurrency prices, market data and historical series.
Trending Search
Retrieve trending crypto assets. Use the documented show_max input when needed; inspect the response schema for the returned categories.
Pricing reference
- Metering: Plan resource units.
- Reference request estimate: USD 0.008.
- Unit cost basis: USD 0.0.
- Resource unit:
provider_credit. - Cost bases do not establish the final customer price, including when zero.
Reference metadata only, not an account quote, a guaranteed price or a spending cap. Resource credits are not Felo credits. Final charges follow Felo billing records.
- Type: stringshow
_max Show max number of results available for the given type. Available values:
coins,nfts,categoriese.g.coinsorcoins,nfts,categories
- Type: object · Response860C3Ae68Ea5_TrendingSearch200
Trending search coins, NFTs and categories
- Type: array object[]categoriesrequired
- coinsType: string
_count requiredNumber of coins in the category
- dataType: objectrequired
- marketType: number
_cap requiredCategory market cap
- marketType: number
_cap _btc requiredCategory market cap in BTC
- marketType: object
_cap _change _percentage _24h requiredCategory market cap change percentage in 24 hours by currency
- propertyType: number
Name
- sparklineType: stringrequired
Category sparkline image URL
- totalType: number
_volume requiredCategory total volume
- totalType: number
_volume _btc requiredCategory total volume in BTC
- idType: integerrequired
Category ID
- marketType: number
_cap _1h _change requiredCategory market cap 1 hour change
- nameType: stringrequired
Category name
- slugType: stringrequired
Category web slug
- topType: array string[]
_3 _coins _images requiredTop 3 coins image URLs in the category
- Type: array object[]coinsrequired
- itemType: objectrequired
- coinType: integer
_id requiredCoin internal ID
- dataType: objectrequired
- contentType: object | nullrequired
- descriptionType: string
- titleType: string
- marketType: string
_cap requiredCoin market cap in USD
- marketType: string
_cap _btc requiredCoin market cap in BTC
- priceType: numberrequired
Coin price in USD
- priceType: string
_btc requiredCoin price in BTC
- priceType: object
_change _percentage _24h requiredCoin price change percentage in 24 hours by currency
- propertyType: number
Name
- sparklineType: stringrequired
Coin sparkline image URL
- totalType: string
_volume requiredCoin total volume in USD
- totalType: string
_volume _btc requiredCoin total volume in BTC
- idType: stringrequired
Coin ID
- largeType: stringrequired
Coin large image URL
- marketType: integer
_cap _rank requiredCoin market cap rank
- nameType: stringrequired
Coin name
- priceType: number
_btc requiredCoin price in BTC
- scoreType: integerrequired
Coin trending rank (0-based)
- slugType: stringrequired
Coin web slug
- smallType: stringrequired
Coin small image URL
- symbolType: stringrequired
Coin symbol
- thumbType: stringrequired
Coin thumb image URL
- Type: array object[]nftsrequired
- dataType: objectrequired
- contentType: object | nullrequired
- descriptionType: string
- titleType: string
- floorType: string
_price requiredNFT collection floor price
- floorType: string
_price _in _usd _24h _percentage _change requiredNFT collection floor price in USD 24 hours percentage change
- h24Type: string
_average _sale _price requiredNFT collection 24 hours average sale price
- h24Type: string
_volume requiredNFT collection volume in 24 hours
- sparklineType: stringrequired
NFT collection sparkline image URL
- floorType: number
_price _24h _percentage _change requiredNFT collection floor price 24 hours percentage change
- floorType: number
_price _in _native _currency requiredNFT collection floor price in native currency
- idType: stringrequired
NFT collection ID
- nameType: stringrequired
NFT collection name
- nativeType: string
_currency _symbol requiredNFT collection native currency symbol
- nftType: integer
_contract _id requiredNFT contract internal ID
- symbolType: stringrequired
NFT collection symbol
- thumbType: stringrequired
NFT collection thumb image URL
application/json - 400
The request could not be processed. Check the request parameters.
- 401
A valid Felo API key is required.
- 402
The request cannot proceed because a billing requirement is not met.
- 403
The account is not permitted to perform this operation.
- 429
A request or spending limit has been reached.
- 502
The service could not complete the request.
- 503
The API or billing service is temporarily unavailable.
- 504
The service timed out while processing the request.
- default
Error response; upstream passthrough responses may use provider formats
application/json
curl https://openapi.felo.ai/v1/beta/coingecko/search/trending \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
"coins": [
{
"item": {
"id": "bonk",
"coin_id": 28600,
"name": "Bonk",
"symbol": "BONK",
"market_cap_rank": 103,
"thumb": "https://coin-images.coingecko.com/coins/images/28600/standard/bonk.jpg?1696527587",
"small": "https://coin-images.coingecko.com/coins/images/28600/small/bonk.jpg?1696527587",
"large": "https://coin-images.coingecko.com/coins/images/28600/large/bonk.jpg?1696527587",
"slug": "bonk",
"price_btc": 7.821066970851871e-11,
"score": 0,
"data": {
"price": 0.000005938674704566297,
"price_btc": "0.00000000007821066970851871",
"price_change_percentage_24h": {
"usd": -3.2712597351582655,
"btc": -1.2567575303632434
},
"market_cap": "$521,967,819",
"market_cap_btc": "6883.418982779206",
"total_volume": "$31,701,707",
"total_volume_btc": "417.50253280497",
"sparkline": "https://www.coingecko.com/coins/28600/sparkline.svg",
"content": null
}
}
}
],
"nfts": [
{
"id": "beeple-everydays-the-2020-collection",
"name": "BEEPLE: EVERYDAYS - THE 2020 COLLECTION",
"symbol": "BEEPLE2",
"thumb": "https://coin-images.coingecko.com/nft_contracts/images/1327/standard/beeple-everydays-the-2020-collection.jpg?1707287783",
"nft_contract_id": 1327,
"native_currency_symbol": "eth",
"floor_price_in_native_currency": 6.98,
"floor_price_24h_percentage_change": 8.231790820932737,
"data": {
"floor_price": "6.98 ETH",
"floor_price_in_usd_24h_percentage_change": "8.231790820932737",
"h24_volume": "6.10 ETH",
"h24_average_sale_price": "6.10 ETH",
"sparkline": "https://www.coingecko.com/nft/1327/sparkline.svg",
"content": null
}
}
],
"categories": [
{
"id": 102120809,
"name": "Base Native",
"top_3_coins_images": [
"https://assets.coingecko.com/coins/images/40008/small/USR_LOGO.png?1725222638",
"https://assets.coingecko.com/coins/images/13187/small/7739.png?1696512969",
"https://assets.coingecko.com/coins/images/70556/small/elizaOS_token_logo_high_quality.png?1763494093"
],
"market_cap_1h_change": 0.1591461077485745,
"slug": "base-native",
"coins_count": "573",
"data": {
"market_cap": 117316549202.14426,
"market_cap_btc": 1545658.5276991604,
"total_volume": 16971131961.734743,
"total_volume_btc": 223596.5430262045,
"market_cap_change_percentage_24h": {
"usd": 0.14714515711689605,
"btc": 1.5918443786835867
},
"sparkline": "https://www.coingecko.com/categories/102120809/sparkline.svg"
}
}
]
}