Felo API PlatformFelo API Platform
All CoinGecko endpoints
v0.2.0-beta
OpenAPI 3.1.0

Trending Search

Server:https://openapi.felo.ai
Client Libraries

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.

Query Parameters
  • show_max
    Type: string

    Show max number of results available for the given type. Available values: coins, nfts, categories e.g. coins or coins,nfts,categories

Responses
  • 200
    Type: object · Response860C3Ae68Ea5_TrendingSearch

    Trending search coins, NFTs and categories

    • categories
      Type: array object[]
      required
      • coins_count
        Type: string
        required

        Number of coins in the category

      • data
        Type: object
        required
        • market_cap
          Type: number
          required

          Category market cap

        • market_cap_btc
          Type: number
          required

          Category market cap in BTC

        • market_cap_change_percentage_24h
          Type: object
          required

          Category market cap change percentage in 24 hours by currency

          • propertyName
            Type: number
        • sparkline
          Type: string
          required

          Category sparkline image URL

        • total_volume
          Type: number
          required

          Category total volume

        • total_volume_btc
          Type: number
          required

          Category total volume in BTC

      • id
        Type: integer
        required

        Category ID

      • market_cap_1h_change
        Type: number
        required

        Category market cap 1 hour change

      • name
        Type: string
        required

        Category name

      • slug
        Type: string
        required

        Category web slug

      • top_3_coins_images
        Type: array string[]
        required

        Top 3 coins image URLs in the category

    • coins
      Type: array object[]
      required
      • item
        Type: object
        required
        • coin_id
          Type: integer
          required

          Coin internal ID

        • data
          Type: object
          required
          • content
            Type: object | null
            required
            • description
              Type: string
            • title
              Type: string
          • market_cap
            Type: string
            required

            Coin market cap in USD

          • market_cap_btc
            Type: string
            required

            Coin market cap in BTC

          • price
            Type: number
            required

            Coin price in USD

          • price_btc
            Type: string
            required

            Coin price in BTC

          • price_change_percentage_24h
            Type: object
            required

            Coin price change percentage in 24 hours by currency

            • propertyName
              Type: number
          • sparkline
            Type: string
            required

            Coin sparkline image URL

          • total_volume
            Type: string
            required

            Coin total volume in USD

          • total_volume_btc
            Type: string
            required

            Coin total volume in BTC

        • id
          Type: string
          required

          Coin ID

        • large
          Type: string
          required

          Coin large image URL

        • market_cap_rank
          Type: integer
          required

          Coin market cap rank

        • name
          Type: string
          required

          Coin name

        • price_btc
          Type: number
          required

          Coin price in BTC

        • score
          Type: integer
          required

          Coin trending rank (0-based)

        • slug
          Type: string
          required

          Coin web slug

        • small
          Type: string
          required

          Coin small image URL

        • symbol
          Type: string
          required

          Coin symbol

        • thumb
          Type: string
          required

          Coin thumb image URL

    • nfts
      Type: array object[]
      required
      • data
        Type: object
        required
        • content
          Type: object | null
          required
          • description
            Type: string
          • title
            Type: string
        • floor_price
          Type: string
          required

          NFT collection floor price

        • floor_price_in_usd_24h_percentage_change
          Type: string
          required

          NFT collection floor price in USD 24 hours percentage change

        • h24_average_sale_price
          Type: string
          required

          NFT collection 24 hours average sale price

        • h24_volume
          Type: string
          required

          NFT collection volume in 24 hours

        • sparkline
          Type: string
          required

          NFT collection sparkline image URL

      • floor_price_24h_percentage_change
        Type: number
        required

        NFT collection floor price 24 hours percentage change

      • floor_price_in_native_currency
        Type: number
        required

        NFT collection floor price in native currency

      • id
        Type: string
        required

        NFT collection ID

      • name
        Type: string
        required

        NFT collection name

      • native_currency_symbol
        Type: string
        required

        NFT collection native currency symbol

      • nft_contract_id
        Type: integer
        required

        NFT contract internal ID

      • symbol
        Type: string
        required

        NFT collection symbol

      • thumb
        Type: string
        required

        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
Request Example for get/v1/beta/coingecko/search/trending
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"
      }
    }
  ]
}
Trending Search

Need help?