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

Datos de la moneda por dirección del token

Felo API Support
MIT
Servidor:https://openapi.felo.ai
Bibliotecas cliente
Shell Curl

CoinGecko

​

Cryptocurrency prices, market data and historical series.

CoinGecko Operaciones

Datos de la moneda por dirección del token

​

Perfil completo de una moneda consultado por dirección de contrato en lugar de por id de CoinGecko. id es la plataforma de activos y contract_address el token; ambos son obligatorios y no hay otros parámetros. Devuelve la misma forma que get_coingecko_coins_id — description, links, image, categories, platforms, detail_platforms, market_cap_rank, un bloque market_data y un array tickers incrustado — más el propio contract_address. Úsalo para identificar un token desconocido a partir de una dirección. Si solo necesitas el precio actual, get_coingecko_simple_token_price_id es mucho más ligero.

Pricing reference

  • Medición: unidades de recursos del plan.
  • Estimación de referencia por solicitud: USD 0.008.
  • Base de costo unitario: USD 0.0.
  • Unidad de recurso: provider_credit.
  • Las bases de costo no determinan el precio final del cliente, incluso cuando son cero.

Solo metadatos de referencia; no son una cotización de la cuenta, un precio garantizado ni un límite de gasto. Los créditos de recursos no son créditos de Felo. Los cargos finales se rigen por los registros de facturación de Felo.

Parámetros de ruta
  • contract_address
    Tipo: string
    obligatorio

    La dirección de contrato del token.

  • id
    Tipo: string
    obligatorio

    ID de la plataforma de activos. *consulta /asset_platforms.

Respuestas
  • 200
    Tipo: object · Response860C3Ae68Ea5_CoinsContractAddress

    Datos de la moneda por dirección de contrato del token

    • additional_notices
      Tipo: array string[]
      obligatorio

      Avisos adicionales

    • asset_platform_id
      Tipo: string | null
      obligatorio

      ID de la plataforma del activo de la moneda

    • block_time_in_minutes
      Tipo: number
      obligatorio

      Tiempo de bloque de la cadena de bloques en minutos

    • categories
      Tipo: array string[]
      obligatorio

      Categorías de la moneda

    • contract_address
      Tipo: string
      obligatorio

      Dirección de contrato de la moneda

    • country_origin
      Tipo: string
      obligatorio

      País de origen

    • description
      Tipo: object
      obligatorio

      Descripción de la moneda

      • propertyName
        Tipo: string
    • detail_platforms
      Tipo: object
      obligatorio

      Plataforma del activo y dirección de contrato detalladas de la moneda

      • propertyName
        Tipo: object
        • contract_address
          Tipo: string

          Dirección de contrato del token

        • decimal_place
          Tipo: integer | null

          Decimales del token

        • geckoterminal_url
          Tipo: string

          URL de GeckoTerminal

    • genesis_date
      Tipo: string | null
      obligatorio

      Fecha de génesis

    • has_supply_breakdown
      Tipo: boolean
      obligatorio

      Si hay datos detallados de desglose de suministro disponibles mediante /coins/supply_breakdown

    • hashing_algorithm
      Tipo: string | null
      obligatorio

      Algoritmo de hash de la cadena de bloques

    • id
      Tipo: string
      obligatorio

      ID de la moneda

    • image
      Tipo: object
      obligatorio

      URL de la imagen de la moneda

      • large
        Tipo: string
      • small
        Tipo: string
      • thumb
        Tipo: string
    • last_updated
      Tipo: string
      obligatorio

      Marca de tiempo de la última actualización

    • Tipo: object
      obligatorio

      Enlaces

      • announcement_url
        Tipo: array string[]

        URL del anuncio

      • bitcointalk_thread_identifier
        Tipo: integer | null

        Identificador del hilo de Bitcointalk

      • blockchain_site
        Tipo: array string[]

        URL del explorador de bloques

      • chat_url
        Tipo: array string[]

        URL del chat

      • facebook_username
        Tipo: string

        Nombre de usuario de Facebook

      • homepage
        Tipo: array string[]

        URL del sitio web

      • official_forum_url
        Tipo: array string[]

        URL del foro oficial

      • repos_url
        Tipo: object

        URL del repositorio

        • bitbucket
          Tipo: array string[]

          URL del repositorio de Bitbucket

        • github
          Tipo: array string[]

          URL del repositorio de GitHub

      • snapshot_url
        Tipo: string | null

        URL del snapshot

      • subreddit_url
        Tipo: string | null

        URL del subreddit

      • telegram_channel_identifier
        Tipo: string

        Identificador del canal de Telegram

      • twitter_screen_name
        Tipo: string

        Usuario de Twitter

      • whitepaper
        Tipo: string

        URL del whitepaper

    • market_cap_rank
      Tipo: integer | null
      obligatorio

      Rank de capitalización de mercado

    • market_cap_rank_with_rehypothecated
      Tipo: integer | null
      obligatorio

      Rank de capitalización de mercado incluidos los tokens rehipotecados

    • name
      Tipo: string
      obligatorio

      Nombre de la moneda

    • platforms
      Tipo: object
      obligatorio

      Plataforma de activos y dirección de contrato de la moneda

      • propertyName
        Tipo: string
    • preview_listing
      Tipo: boolean
      obligatorio

      Moneda de la lista de vista previa

    • public_notice
      Tipo: string | null
      obligatorio

      Aviso público

    • sentiment_votes_down_percentage
      Tipo: number | null
      obligatorio

      Porcentaje de votos negativos de sentimiento

    • sentiment_votes_up_percentage
      Tipo: number | null
      obligatorio

      Porcentaje de votos positivos de sentimiento

    • status_updates
      Tipo: array object[]
      obligatorio

      Actualizaciones de estado

      • category
        Tipo: string

        Categoría de la actualización de estado

      • created_at
        Tipo: string

        Hora de creación de la actualización de estado

      • description
        Tipo: string

        Descripción de la actualización de estado

      • user
        Tipo: string

        Usuario de la actualización de estado

      • user_title
        Tipo: string

        Cargo del usuario de la actualización de estado

    • symbol
      Tipo: string
      obligatorio

      Símbolo de la moneda

    • watchlist_portfolio_users
      Tipo: number
      obligatorio

      Número de usuarios que siguen esta moneda en la cartera

    • web_slug
      Tipo: string
      obligatorio

      Slug web de la moneda

    • localization
      Tipo: object

      Localización del nombre de la moneda

      • propertyName
        Tipo: string
    • market_data
      Tipo: object

      Datos de mercado

      • ath
        Tipo: object

        Máximo histórico en la moneda de destino

        • propertyName
          Tipo: number
      • ath_change_percentage
        Tipo: object

        Porcentaje de cambio del máximo histórico

        • propertyName
          Tipo: number
      • ath_date
        Tipo: object

        Fecha del máximo histórico

        • propertyName
          Tipo: string
      • atl
        Tipo: object

        Mínimo histórico en la moneda de destino

        • propertyName
          Tipo: number
      • atl_change_percentage
        Tipo: object

        Porcentaje de cambio del mínimo histórico

        • propertyName
          Tipo: number
      • atl_date
        Tipo: object

        Fecha del mínimo histórico

        • propertyName
          Tipo: string
      • circulating_supply
        Tipo: number

        Suministro circulante

      • current_price
        Tipo: object

        Precio actual en la moneda de destino

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

        Relación entre FDV y TVL

      • fully_diluted_valuation
        Tipo: object

        Valoración totalmente diluida en la moneda de destino

        • propertyName
          Tipo: number
      • high_24h
        Tipo: object

        Precio máximo de 24 h en la moneda de destino

        • propertyName
          Tipo: number
      • last_updated
        Tipo: string

        Marca temporal de la última actualización de los datos de mercado

      • low_24h
        Tipo: object

        Precio mínimo de 24 h en la moneda de destino

        • propertyName
          Tipo: number
      • market_cap
        Tipo: object

        Capitalización de mercado en la moneda de destino

        • propertyName
          Tipo: number
      • market_cap_change_24h
        Tipo: number

        Variación de la capitalización de mercado en 24 h en la moneda de destino

      • market_cap_change_24h_in_currency
        Tipo: object

        Variación de la capitalización de mercado en 24 h en la moneda de destino

        • propertyName
          Tipo: number
      • market_cap_change_percentage_24h
        Tipo: number

        Porcentaje de variación de la capitalización de mercado en 24 h

      • market_cap_change_percentage_24h_in_currency
        Tipo: object

        Porcentaje de variación de la capitalización de mercado en 24 h por moneda

        • propertyName
          Tipo: number
      • market_cap_fdv_ratio
        Tipo: number

        Relación entre capitalización de mercado y FDV

      • market_cap_rank
        Tipo: integer | null

        Rank de capitalización de mercado

      • market_cap_rank_with_rehypothecated
        Tipo: integer | null

        Rank de capitalización de mercado incluidos los 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

        Relación entre capitalización de mercado y TVL

      • outstanding_supply
        Tipo: number | null

        Tokens en circulación en el mercado

      • outstanding_token_value_usd
        Tipo: number | null

        Valor de los tokens en circulación en USD

      • price_change_24h
        Tipo: number

        Variación de precio en 24 h en la moneda de destino

      • price_change_24h_in_currency
        Tipo: object

        Variación de precio en 24 h en la moneda de destino

        • propertyName
          Tipo: number
      • price_change_percentage_14d
        Tipo: number

        Porcentaje de variación de precio en 14 días

      • price_change_percentage_14d_in_currency
        Tipo: object

        Porcentaje de variación de precio en 14 días por moneda

        • propertyName
          Tipo: number
      • price_change_percentage_1h_in_currency
        Tipo: object

        Porcentaje de variación de precio en 1 h por moneda

        • propertyName
          Tipo: number
      • price_change_percentage_1y
        Tipo: number

        Porcentaje de variación de precio en 1 año

      • price_change_percentage_1y_in_currency
        Tipo: object

        Porcentaje de variación de precio en 1 año por moneda

        • propertyName
          Tipo: number
      • price_change_percentage_200d
        Tipo: number

        Porcentaje de variación de precio en 200 días

      • price_change_percentage_200d_in_currency
        Tipo: object

        Porcentaje de variación de precio en 200 días por moneda

        • propertyName
          Tipo: number
      • price_change_percentage_24h
        Tipo: number

        Porcentaje de variación de precio en 24 h

      • price_change_percentage_24h_in_currency
        Tipo: object

        Porcentaje de variación de precio en 24 h por moneda

        • propertyName
          Tipo: number
      • price_change_percentage_30d
        Tipo: number

        Porcentaje de variación de precio en 30 días

      • price_change_percentage_30d_in_currency
        Tipo: object

        Porcentaje de variación de precio en 30 días por moneda

        • propertyName
          Tipo: number
      • price_change_percentage_60d
        Tipo: number

        Porcentaje de variación de precio en 60 días

      • price_change_percentage_60d_in_currency
        Tipo: object

        Porcentaje de variación de precio en 60 días por moneda

        • propertyName
          Tipo: number
      • price_change_percentage_7d
        Tipo: number

        Porcentaje de variación de precio en 7 días

      • price_change_percentage_7d_in_currency
        Tipo: object

        Porcentaje de variación de precio en 7 días por moneda

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

        Retorno de la inversión

        • currency
          Tipo: string

          Moneda del ROI

        • percentage
          Tipo: number

          Porcentaje del ROI

        • times
          Tipo: number

          Multiplicador del ROI

      • sparkline_7d
        Tipo: array number[]

        Datos de precio de minigráfico de 7 días

      • total_supply
        Tipo: number

        Oferta total

      • total_value_locked
        Tipo: number | null

        Valor total bloqueado

      • total_volume
        Tipo: object

        Volumen total negociado en la moneda de destino

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

      Tickers de negociación

      • base
        Tipo: string

        Moneda base del ticker

      • bid_ask_spread_percentage
        Tipo: number

        Porcentaje de spread bid-ask del ticker

      • coin_id
        Tipo: string

        ID de la moneda base del ticker

      • coin_mcap_usd
        Tipo: number

        Capitalización de mercado en USD

      • converted_last
        Tipo: object

        Último precio convertido del ticker

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

        Volumen convertido del ticker

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

        Anomalía del ticker

      • is_stale
        Tipo: boolean

        Ticker obsoleto

      • last
        Tipo: number

        Último precio del ticker

      • last_fetch_at
        Tipo: string

        Marca temporal de la última consulta del ticker

      • last_traded_at
        Tipo: string

        Marca temporal de la última negociación del ticker

      • market
        Tipo: object

        Exchange del ticker

        • has_trading_incentive
          Tipo: boolean

          Incentivo de negociación del exchange

        • identifier
          Tipo: string

          Identificador del exchange

        • name
          Tipo: string

          Nombre del exchange

      • target
        Tipo: string

        Moneda de destino del ticker

      • target_coin_id
        Tipo: string

        ID de la moneda de destino del ticker

      • timestamp
        Tipo: string

        Marca temporal del ticker

      • token_info_url
        Tipo: string | null

        URL de información del token del ticker

      • trade_url
        Tipo: string

        URL de negociación del ticker

      • trust_score
        Tipo: string | null

        Puntuación de confianza del ticker

      • volume
        Tipo: number

        Volumen del ticker

    application/json
  • 400

    No se pudo procesar la solicitud. Comprueba los parámetros de la solicitud.

  • 401

    Se requiere una clave de API de Felo válida.

  • 402

    La solicitud no puede continuar porque no se cumple un requisito de facturación.

  • 403

    La cuenta no tiene permiso para realizar esta operación.

  • 429

    Se ha alcanzado un límite de solicitudes o de gasto.

  • 502

    El servicio no pudo completar la solicitud.

  • 503

    La API o el servicio de facturación no están disponibles temporalmente.

  • 504

    El servicio agotó el tiempo de espera al procesar la solicitud.

  • default

    Respuesta de error; las respuestas de paso del upstream pueden usar formatos del proveedor

    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
    }
  ]
}

Datos de la moneda por dirección de contrato del token

Coin Data by Token Address