Felo API PlatformFelo API Platform
Todos os endpoints de CoinGecko
v0.2.0-beta
OpenAPI 3.1.0

Dados da moeda por endereço do token

Servidor:https://openapi.felo.ai
Bibliotecas Cliente

CoinGecko

​

Cryptocurrency prices, market data and historical series.

Dados da moeda por endereço do token

​

Perfil completo de uma moeda consultado por endereço de contrato em vez do id do CoinGecko. id é a plataforma de ativos e contract_address o token; ambos são obrigatórios e não há outros parâmetros. Retorna o mesmo formato de get_coingecko_coins_id — description, links, image, categories, platforms, detail_platforms, market_cap_rank, um bloco market_data e um array tickers incorporado — além do próprio contract_address. Use para identificar um token desconhecido a partir de um endereço. Se precisar apenas do preço atual, get_coingecko_simple_token_price_id é muito mais leve.

Pricing reference

  • Medição: unidades de recursos do plano.
  • Estimativa de referência por requisição: USD 0.008.
  • Base de custo unitário: USD 0.0.
  • Unidade de recurso: provider_credit.
  • As bases de custo não definem o preço final do cliente, inclusive quando forem zero.

Apenas metadados de referência, não uma cotação da conta, um preço garantido nem um limite de gastos. Créditos de recursos não são créditos Felo. As cobranças finais seguem os registros de cobrança da Felo.

Parâmetros de Caminho
  • contract_address
    Tipo: string
    obrigatório

    O endereço de contrato do token.

  • id
    Tipo: string
    obrigatório

    ID da plataforma de ativos. *consulte /asset_platforms.

Respostas
  • 200
    Tipo: object · Response860C3Ae68Ea5_CoinsContractAddress

    Dados da moeda por endereço de contrato do token

    • additional_notices
      Tipo: array string[]
      obrigatório

      Avisos adicionais

    • asset_platform_id
      Tipo: string | null
      obrigatório

      ID da plataforma do ativo da moeda

    • block_time_in_minutes
      Tipo: number
      obrigatório

      Tempo de bloco da blockchain em minutos

    • categories
      Tipo: array string[]
      obrigatório

      Categorias da moeda

    • contract_address
      Tipo: string
      obrigatório

      Endereço de contrato da moeda

    • country_origin
      Tipo: string
      obrigatório

      País de origem

    • description
      Tipo: object
      obrigatório

      Descrição da moeda

      • propertyName
        Tipo: string
    • detail_platforms
      Tipo: object
      obrigatório

      Plataforma do ativo e endereço de contrato detalhados da moeda

      • propertyName
        Tipo: object
        • contract_address
          Tipo: string

          Endereço de contrato do token

        • decimal_place
          Tipo: integer | null

          Casas decimais do token

        • geckoterminal_url
          Tipo: string

          URL do GeckoTerminal

    • genesis_date
      Tipo: string | null
      obrigatório

      Data de gênese

    • has_supply_breakdown
      Tipo: boolean
      obrigatório

      Se dados detalhados de composição da oferta estão disponíveis via /coins/supply_breakdown

    • hashing_algorithm
      Tipo: string | null
      obrigatório

      Algoritmo de hash da blockchain

    • id
      Tipo: string
      obrigatório

      ID da moeda

    • image
      Tipo: object
      obrigatório

      URL da imagem da moeda

      • large
        Tipo: string
      • small
        Tipo: string
      • thumb
        Tipo: string
    • last_updated
      Tipo: string
      obrigatório

      Carimbo de data/hora da última atualização

    • Tipo: object
      obrigatório

      Links de página

      • announcement_url
        Tipo: array string[]

        URL do anúncio

      • bitcointalk_thread_identifier
        Tipo: integer | null

        Identificador do tópico no Bitcointalk

      • blockchain_site
        Tipo: array string[]

        URL do explorador de blocos

      • chat_url
        Tipo: array string[]

        URL do chat

      • facebook_username
        Tipo: string

        Nome de usuário do Facebook

      • homepage
        Tipo: array string[]

        URL do site

      • official_forum_url
        Tipo: array string[]

        URL do fórum oficial

      • repos_url
        Tipo: object

        URL do repositório

        • bitbucket
          Tipo: array string[]

          URL do repositório Bitbucket

        • github
          Tipo: array string[]

          URL do repositório GitHub

      • snapshot_url
        Tipo: string | null

        URL do snapshot

      • subreddit_url
        Tipo: string | null

        URL do subreddit

      • telegram_channel_identifier
        Tipo: string

        Identificador do canal do Telegram

      • twitter_screen_name
        Tipo: string

        Identificador do Twitter

      • whitepaper
        Tipo: string

        URL do whitepaper

    • market_cap_rank
      Tipo: integer | null
      obrigatório

      Rank de capitalização de mercado

    • market_cap_rank_with_rehypothecated
      Tipo: integer | null
      obrigatório

      Rank de capitalização de mercado incluindo tokens rehipotecados

    • name
      Tipo: string
      obrigatório

      Nome da moeda

    • platforms
      Tipo: object
      obrigatório

      Plataforma de ativos e endereço de contrato da moeda

      • propertyName
        Tipo: string
    • preview_listing
      Tipo: boolean
      obrigatório

      Moeda em listagem de pré-visualização

    • public_notice
      Tipo: string | null
      obrigatório

      Aviso público

    • sentiment_votes_down_percentage
      Tipo: number | null
      obrigatório

      Percentual de votos negativos de sentimento

    • sentiment_votes_up_percentage
      Tipo: number | null
      obrigatório

      Percentual de votos positivos de sentimento

    • status_updates
      Tipo: array object[]
      obrigatório

      Atualizações de status

      • category
        Tipo: string

        Categoria da atualização de status

      • created_at
        Tipo: string

        Hora de criação da atualização de status

      • description
        Tipo: string

        Descrição da atualização de status

      • user
        Tipo: string

        Usuário da atualização de status

      • user_title
        Tipo: string

        Cargo do usuário da atualização de status

    • symbol
      Tipo: string
      obrigatório

      Símbolo da moeda

    • watchlist_portfolio_users
      Tipo: number
      obrigatório

      Número de usuários que acompanham esta moeda no portfólio

    • web_slug
      Tipo: string
      obrigatório

      Slug web da moeda

    • localization
      Tipo: object

      Localização do nome da moeda

      • propertyName
        Tipo: string
    • market_data
      Tipo: object

      Dados de mercado

      • ath
        Tipo: object

        Máxima histórica na moeda de destino

        • propertyName
          Tipo: number
      • ath_change_percentage
        Tipo: object

        Percentual de variação da máxima histórica

        • propertyName
          Tipo: number
      • ath_date
        Tipo: object

        Data da máxima histórica

        • propertyName
          Tipo: string
      • atl
        Tipo: object

        Mínima histórica na moeda de destino

        • propertyName
          Tipo: number
      • atl_change_percentage
        Tipo: object

        Percentual de variação da mínima histórica

        • propertyName
          Tipo: number
      • atl_date
        Tipo: object

        Data da mínima histórica

        • propertyName
          Tipo: string
      • circulating_supply
        Tipo: number

        Oferta em circulação

      • current_price
        Tipo: object

        Preço atual na moeda de destino

        • propertyName
          Tipo: number
      • fdv_to_tvl_ratio
        Tipo: number | null

        Relação entre FDV e TVL

      • fully_diluted_valuation
        Tipo: object

        Avaliação totalmente diluída na moeda de destino

        • propertyName
          Tipo: number
      • high_24h
        Tipo: object

        Alta de preço em 24h na moeda de destino

        • propertyName
          Tipo: number
      • last_updated
        Tipo: string

        Timestamp da última atualização dos dados de mercado

      • low_24h
        Tipo: object

        Baixa de preço em 24h na moeda de destino

        • propertyName
          Tipo: number
      • market_cap
        Tipo: object

        Capitalização de mercado na moeda de destino

        • propertyName
          Tipo: number
      • market_cap_change_24h
        Tipo: number

        Variação da capitalização de mercado em 24h na moeda de destino

      • market_cap_change_24h_in_currency
        Tipo: object

        Variação da capitalização de mercado em 24h na moeda de destino

        • propertyName
          Tipo: number
      • market_cap_change_percentage_24h
        Tipo: number

        Percentual de variação da capitalização de mercado em 24h

      • market_cap_change_percentage_24h_in_currency
        Tipo: object

        Percentual de variação da capitalização de mercado em 24h por moeda

        • propertyName
          Tipo: number
      • market_cap_fdv_ratio
        Tipo: number

        Relação entre capitalização de mercado e FDV

      • market_cap_rank
        Tipo: integer | null

        Rank de capitalização de mercado

      • market_cap_rank_with_rehypothecated
        Tipo: integer | null

        Rank de capitalização de mercado incluindo tokens rehipotecados

      • max_supply
        Tipo: number | null

        Oferta máxima

      • max_supply_infinite
        Tipo: boolean

        Oferta máxima infinita

      • mcap_to_tvl_ratio
        Tipo: number | null

        Relação entre capitalização de mercado e TVL

      • outstanding_supply
        Tipo: number | null

        Tokens em circulação no mercado

      • outstanding_token_value_usd
        Tipo: number | null

        Valor dos tokens em circulação em USD

      • price_change_24h
        Tipo: number

        Variação de preço em 24h na moeda de destino

      • price_change_24h_in_currency
        Tipo: object

        Variação de preço em 24h na moeda de destino

        • propertyName
          Tipo: number
      • price_change_percentage_14d
        Tipo: number

        Percentual de variação de preço em 14 dias

      • price_change_percentage_14d_in_currency
        Tipo: object

        Percentual de variação de preço em 14 dias por moeda

        • propertyName
          Tipo: number
      • price_change_percentage_1h_in_currency
        Tipo: object

        Percentual de variação de preço em 1h por moeda

        • propertyName
          Tipo: number
      • price_change_percentage_1y
        Tipo: number

        Percentual de variação de preço em 1 ano

      • price_change_percentage_1y_in_currency
        Tipo: object

        Percentual de variação de preço em 1 ano por moeda

        • propertyName
          Tipo: number
      • price_change_percentage_200d
        Tipo: number

        Percentual de variação de preço em 200 dias

      • price_change_percentage_200d_in_currency
        Tipo: object

        Percentual de variação de preço em 200 dias por moeda

        • propertyName
          Tipo: number
      • price_change_percentage_24h
        Tipo: number

        Percentual de variação de preço em 24h

      • price_change_percentage_24h_in_currency
        Tipo: object

        Percentual de variação de preço em 24h por moeda

        • propertyName
          Tipo: number
      • price_change_percentage_30d
        Tipo: number

        Percentual de variação de preço em 30 dias

      • price_change_percentage_30d_in_currency
        Tipo: object

        Percentual de variação de preço em 30 dias por moeda

        • propertyName
          Tipo: number
      • price_change_percentage_60d
        Tipo: number

        Percentual de variação de preço em 60 dias

      • price_change_percentage_60d_in_currency
        Tipo: object

        Percentual de variação de preço em 60 dias por moeda

        • propertyName
          Tipo: number
      • price_change_percentage_7d
        Tipo: number

        Percentual de variação de preço em 7 dias

      • price_change_percentage_7d_in_currency
        Tipo: object

        Percentual de variação de preço em 7 dias por moeda

        • propertyName
          Tipo: number
      • roi
        Tipo: object | null

        Retorno sobre investimento

        • currency
          Tipo: string

          Moeda do ROI

        • percentage
          Tipo: number

          Percentual do ROI

        • times
          Tipo: number

          Multiplicador do ROI

      • sparkline_7d
        Tipo: array number[]

        Dados de preço de sparkline de 7 dias

      • total_supply
        Tipo: number

        Oferta total

      • total_value_locked
        Tipo: number | null

        Valor total bloqueado

      • total_volume
        Tipo: object

        Volume total negociado na moeda de destino

        • propertyName
          Tipo: number
    • tickers
      Tipo: array object[]

      Tickers de negociação

      • base
        Tipo: string

        Moeda base do ticker

      • bid_ask_spread_percentage
        Tipo: number

        Percentual de spread bid-ask do ticker

      • coin_id
        Tipo: string

        ID da moeda base do ticker

      • coin_mcap_usd
        Tipo: number

        Capitalização de mercado em USD

      • converted_last
        Tipo: object

        Último preço convertido do ticker

        • btc
          Tipo: number
        • eth
          Tipo: number
        • usd
          Tipo: number
      • converted_volume
        Tipo: object

        Volume convertido do ticker

        • btc
          Tipo: number
        • eth
          Tipo: number
        • usd
          Tipo: number
      • is_anomaly
        Tipo: boolean

        Anomalia do ticker

      • is_stale
        Tipo: boolean

        Ticker desatualizado

      • last
        Tipo: number

        Último preço do ticker

      • last_fetch_at
        Tipo: string

        Timestamp da última coleta do ticker

      • last_traded_at
        Tipo: string

        Timestamp da última negociação do ticker

      • market
        Tipo: object

        Exchange do ticker

        • has_trading_incentive
          Tipo: boolean

          Incentivo de negociação da exchange

        • identifier
          Tipo: string

          Identificador da exchange

        • name
          Tipo: string

          Nome da exchange

      • target
        Tipo: string

        Moeda de destino do ticker

      • target_coin_id
        Tipo: string

        ID da moeda de destino do ticker

      • timestamp
        Tipo: string

        Timestamp do ticker

      • token_info_url
        Tipo: string | null

        URL de informações do token do ticker

      • trade_url
        Tipo: string

        URL de negociação do ticker

      • trust_score
        Tipo: string | null

        Pontuação de confiança do ticker

      • volume
        Tipo: number

        Volume do ticker

    application/json
  • 400

    Não foi possível processar a requisição. Verifique os parâmetros da requisição.

  • 401

    É necessária uma chave de API da Felo válida.

  • 402

    A requisição não pode prosseguir porque um requisito de cobrança não foi atendido.

  • 403

    A conta não tem permissão para realizar esta operação.

  • 429

    Um limite de requisições ou de gastos foi atingido.

  • 502

    O serviço não pôde concluir a requisição.

  • 503

    A API ou o serviço de cobrança está temporariamente indisponível.

  • 504

    O serviço atingiu o tempo limite ao processar a requisição.

  • default

    Resposta de erro; respostas repassadas do upstream podem usar formatos do provedor

    application/json
Request Example for get/v1/beta/coingecko/coins/{id}/contract/{contract_address}
curl https://openapi.felo.ai/v1/beta/coingecko/coins/ethereum/contract/0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2 \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
  "id": "weth",
  "symbol": "weth",
  "name": "WETH",
  "web_slug": "weth",
  "asset_platform_id": "ethereum",
  "platforms": {
    "ethereum": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
    "terra-2": "ibc/BC8A77AFBD872FDC32A348D3FB10CC09277C266CFE52081DE341C7EC6752E674",
    "tron": "THb4CqiFdwNHsWsQCs4JhzwjMWys4aqCbF"
  },
  "detail_platforms": {
    "ethereum": {
      "decimal_place": 18,
      "contract_address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
      "geckoterminal_url": "https://www.geckoterminal.com/eth/tokens/0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"
    },
    "terra-2": {
      "decimal_place": 18,
      "contract_address": "ibc/BC8A77AFBD872FDC32A348D3FB10CC09277C266CFE52081DE341C7EC6752E674"
    },
    "tron": {
      "decimal_place": 18,
      "contract_address": "THb4CqiFdwNHsWsQCs4JhzwjMWys4aqCbF",
      "geckoterminal_url": "https://www.geckoterminal.com/tron/tokens/THb4CqiFdwNHsWsQCs4JhzwjMWys4aqCbF"
    }
  },
  "block_time_in_minutes": 0,
  "hashing_algorithm": null,
  "categories": [
    "Crypto-Backed Tokens",
    "Wrapped-Tokens",
    "Terra Ecosystem",
    "Ethereum Ecosystem",
    "FTX Holdings",
    "Tron Ecosystem",
    "Index Coop Defi Index"
  ],
  "preview_listing": false,
  "public_notice": null,
  "additional_notices": [],
  "has_supply_breakdown": false,
  "localization": {
    "en": "WETH",
    "de": "",
    "es": "",
    "fr": "",
    "it": "",
    "pl": "",
    "ro": "",
    "hu": "",
    "nl": "",
    "pt": ""
  },
  "description": {
    "en": "What is WETH (Wrapped ETH)?\nWETH is the tokenized/packaged form of ETH..."
  },
  "links": {
    "homepage": [
      "https://ethereum.org/en/wrapped-eth"
    ],
    "whitepaper": "",
    "blockchain_site": [
      "https://etherscan.io/token/0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
      "https://intel.arkm.com/explorer/token/weth"
    ],
    "official_forum_url": [],
    "chat_url": [],
    "announcement_url": [],
    "snapshot_url": null,
    "twitter_screen_name": "",
    "facebook_username": "",
    "bitcointalk_thread_identifier": null,
    "telegram_channel_identifier": "",
    "subreddit_url": null,
    "repos_url": {
      "github": [],
      "bitbucket": []
    }
  },
  "image": {
    "thumb": "https://coin-images.coingecko.com/coins/images/2518/thumb/weth.png?1696503332",
    "small": "https://coin-images.coingecko.com/coins/images/2518/small/weth.png?1696503332",
    "large": "https://coin-images.coingecko.com/coins/images/2518/large/weth.png?1696503332"
  },
  "country_origin": "",
  "genesis_date": "2016-06-17",
  "contract_address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
  "sentiment_votes_up_percentage": null,
  "sentiment_votes_down_percentage": null,
  "watchlist_portfolio_users": 34782,
  "market_cap_rank": null,
  "market_cap_rank_with_rehypothecated": 30,
  "market_data": {
    "current_price": {
      "btc": 0.02728343,
      "eth": 0.99972363,
      "usd": 2115.04
    },
    "total_value_locked": null,
    "mcap_to_tvl_ratio": null,
    "fdv_to_tvl_ratio": null,
    "roi": null,
    "ath": {
      "btc": 0.14280504,
      "eth": 3.614831,
      "usd": 4950.08
    },
    "ath_change_percentage": {
      "btc": -80.89678,
      "eth": -72.33124,
      "usd": -57.2622
    },
    "ath_date": {
      "btc": "2018-09-02T00:00:00.000Z",
      "eth": "2018-09-13T00:00:00.000Z",
      "usd": "2025-08-24T19:28:11.411Z"
    },
    "atl": {
      "btc": 0.00890197,
      "eth": 0.22395179,
      "usd": 82.1
    },
    "atl_change_percentage": {
      "btc": 206.45314,
      "eth": 346.6045,
      "usd": 2476.69436
    },
    "atl_date": {
      "btc": "2025-09-02T07:56:48.935Z",
      "eth": "2025-09-02T07:56:48.935Z",
      "usd": "2018-12-15T00:00:00.000Z"
    },
    "market_cap": {
      "btc": 61868,
      "eth": 2267403,
      "usd": 4793905266
    },
    "market_cap_rank": null,
    "outstanding_token_value_usd": null,
    "market_cap_rank_with_rehypothecated": 30,
    "fully_diluted_valuation": {
      "btc": 61868,
      "eth": 2267403,
      "usd": 4793905266
    },
    "market_cap_fdv_ratio": 1,
    "total_volume": {
      "btc": 107.294,
      "eth": 3931,
      "usd": 8317546
    },
    "high_24h": {
      "btc": 0.02756131,
      "eth": 1.00272,
      "usd": 2125.08
    },
    "low_24h": {
      "btc": 0.02717062,
      "eth": 0.99799697,
      "usd": 2068.79
    },
    "price_change_24h": -3.316519511214,
    "price_change_percentage_24h": -0.15656,
    "price_change_percentage_7d": -0.0669,
    "price_change_percentage_14d": -9.45938,
    "price_change_percentage_30d": -8.82256,
    "price_change_percentage_60d": 1.63545,
    "price_change_percentage_200d": -37.57849,
    "price_change_percentage_1y": -14.56267,
    "market_cap_change_24h": -12121742.79577,
    "market_cap_change_percentage_24h": -0.25222,
    "price_change_24h_in_currency": {
      "btc": -0.000274386252168236,
      "eth": -0.000212661454704888,
      "usd": -3.3165195112137553
    },
    "price_change_percentage_1h_in_currency": {
      "btc": -0.19183,
      "eth": 0.00019,
      "usd": -0.00865
    },
    "price_change_percentage_24h_in_currency": {
      "btc": -0.99568,
      "eth": -0.02127,
      "usd": -0.15656
    },
    "price_change_percentage_7d_in_currency": {
      "btc": -0.89914,
      "eth": -0.05304,
      "usd": -0.0669
    },
    "price_change_percentage_14d_in_currency": {
      "btc": -5.49184,
      "eth": -0.04201,
      "usd": -9.45938
    },
    "price_change_percentage_30d_in_currency": {
      "btc": -8.68383,
      "eth": -0.02751,
      "usd": -8.82256
    },
    "price_change_percentage_60d_in_currency": {
      "btc": -8.8249,
      "eth": 0.0505,
      "usd": 1.63545
    },
    "price_change_percentage_200d_in_currency": {
      "btc": -17.15793,
      "eth": -0.10813,
      "usd": -37.57849
    },
    "price_change_percentage_1y_in_currency": {
      "btc": 18.09057,
      "eth": 0.19761,
      "usd": -14.56267
    },
    "market_cap_change_24h_in_currency": {
      "btc": -635.7460114267669,
      "eth": -986.7877555103041,
      "usd": -12121742.795770645
    },
    "market_cap_change_percentage_24h_in_currency": {
      "btc": -1.01713,
      "eth": -0.0435,
      "usd": -0.25222
    },
    "total_supply": 2267926.915444636,
    "max_supply": null,
    "max_supply_infinite": true,
    "circulating_supply": 2267926.915444636,
    "outstanding_supply": null,
    "last_updated": "2026-05-25T10:09:02.821Z"
  },
  "status_updates": [],
  "last_updated": "2026-05-25T10:09:02.821Z",
  "tickers": [
    {
      "base": "WETH",
      "target": "USDC",
      "market": {
        "name": "Native",
        "identifier": "native",
        "has_trading_incentive": false
      },
      "last": 2114.7318378964214,
      "volume": 2999.739679821518,
      "converted_last": {
        "btc": 0.02728106,
        "eth": 1.000065,
        "usd": 2114.1
      },
      "converted_volume": {
        "btc": 81.256,
        "eth": 2979,
        "usd": 6296774
      },
      "trust_score": null,
      "bid_ask_spread_percentage": 0.04287,
      "timestamp": "2026-05-25T10:04:42+00:00",
      "last_traded_at": "2026-05-25T10:04:42+00:00",
      "last_fetch_at": "2026-05-25T10:04:42+00:00",
      "is_anomaly": false,
      "is_stale": false,
      "trade_url": "https://native.org/app/swap/",
      "token_info_url": null,
      "coin_id": "weth",
      "target_coin_id": "usd-coin",
      "coin_mcap_usd": 4793905265.563903
    }
  ]
}
Coin Data by Token Address