v0.2.0-beta

OpenAPI 3.1.0

Dati della moneta per indirizzo del token

Felo API Support

MIT

Server

https://openapi.felo.ai

Librerie client

Shell Curl

CoinGecko

Cryptocurrency prices, market data and historical series.

CoinGecko Operazioni

get/v1/beta/coingecko/coins/{id}/contract/{contract_address}

Dati della moneta per indirizzo del token

Un profilo completo della moneta cercato tramite indirizzo del contratto invece che tramite ID CoinGecko. id è la piattaforma asset e contract_address il token; entrambi sono obbligatori e non ci sono altri parametri. Restituisce la stessa struttura di get_coingecko_coins_id – description, links, image, categories, platforms, detail_platforms, market_cap_rank, un blocco market_data e un array tickers incorporato – più contract_address stesso. Usalo per identificare un token sconosciuto da un indirizzo. Se serve solo il prezzo corrente, get_coingecko_simple_token_price_id è molto più leggero.

Riferimento prezzi

Misurazione: unità di risorsa del piano.
Stima di riferimento per richiesta: USD 0.008.
Base di costo unitario: USD 0.0.
Unità di risorsa: provider_credit.
Le basi di costo non determinano il prezzo finale per il cliente, anche quando sono zero.

Solo metadati di riferimento, non un preventivo dell'account, né un prezzo garantito o un limite di spesa. I crediti delle risorse non sono crediti Felo. Gli addebiti finali seguono le registrazioni di fatturazione Felo.

Parametri di percorso

contract_address
Tipo: string
obbligatorio

L'indirizzo del contratto del token.
id
Tipo: string
obbligatorio

ID della piattaforma asset. *Fa riferimento a /asset_platforms.

Risposte

200
Tipo: object · Response860C3Ae68Ea5_CoinsContractAddress

Dati della moneta per indirizzo del contratto del token
additional_notices
Tipo: array string[]
obbligatorio

Avvisi aggiuntivi

asset_platform_id
Tipo: string | null
obbligatorio

ID della piattaforma di asset coin

block_time_in_minutes
Tipo: number
obbligatorio

Tempo di blocco della blockchain in minuti

categories
Tipo: array string[]
obbligatorio

Categorie della coin

contract_address
Tipo: string
obbligatorio

Indirizzo del contratto della coin

country_origin
Tipo: string
obbligatorio

Paese di origine

description
Tipo: object
obbligatorio

Descrizione della coin

propertyName
Tipo: string
detail_platforms
Tipo: object
obbligatorio

Piattaforma di asset coin dettagliata e indirizzo del contratto

propertyName
Tipo: object
contract_address
Tipo: string

Indirizzo del contratto del token

decimal_place
Tipo: integer | null

Cifra decimale del token

geckoterminal_url
Tipo: string

URL GeckoTerminal

genesis_date
Tipo: string | null
obbligatorio

Data di genesi

has_supply_breakdown
Tipo: boolean
obbligatorio

Se i dati dettagliati sulla ripartizione dell'offerta sono disponibili tramite /coins/supply_breakdown

hashing_algorithm
Tipo: string | null
obbligatorio

Algoritmo di hashing della blockchain

id
Tipo: string
obbligatorio

ID della coin

image
Tipo: object
obbligatorio

URL dell'immagine della coin

large
Tipo: string
small
Tipo: string
thumb
Tipo: string
last_updated
Tipo: string
obbligatorio

Timestamp dell'ultimo aggiornamento

links
Tipo: object
obbligatorio

Collegamenti

announcement_url
Tipo: array string[]

URL dell'annuncio

bitcointalk_thread_identifier
Tipo: integer | null

Identificatore del thread Bitcointalk

blockchain_site
Tipo: array string[]

URL del block explorer

chat_url
Tipo: array string[]

URL della chat

facebook_username
Tipo: string

Nome utente Facebook

homepage
Tipo: array string[]

URL del sito web

official_forum_url
Tipo: array string[]

URL del forum ufficiale

repos_url
Tipo: object

URL del repository

bitbucket
Tipo: array string[]

URL del repository Bitbucket

github
Tipo: array string[]

URL del repository GitHub

snapshot_url
Tipo: string | null

URL dello snapshot

subreddit_url
Tipo: string | null

URL del subreddit

telegram_channel_identifier
Tipo: string

Identificatore del canale Telegram

twitter_screen_name
Tipo: string

Handle Twitter

whitepaper
Tipo: string

URL del whitepaper

market_cap_rank
Tipo: integer | null
obbligatorio

Rank di capitalizzazione di mercato

market_cap_rank_with_rehypothecated
Tipo: integer | null
obbligatorio

Rank di capitalizzazione di mercato inclusi i token rehypothecated

name
Tipo: string
obbligatorio

Nome della moneta

platforms
Tipo: object
obbligatorio

Piattaforma asset e indirizzo del contratto della moneta

propertyName
Tipo: string
preview_listing
Tipo: boolean
obbligatorio

Moneta nell'elenco di anteprima

public_notice
Tipo: string | null
obbligatorio

Avviso pubblico

sentiment_votes_down_percentage
Tipo: number | null
obbligatorio

Percentuale di voti negativi del sentiment

sentiment_votes_up_percentage
Tipo: number | null
obbligatorio

Percentuale di voti positivi del sentiment

status_updates
Tipo: array object[]
obbligatorio

Aggiornamenti di stato

category
Tipo: string

Categoria dell'aggiornamento di stato

created_at
Tipo: string

Ora di creazione dell'aggiornamento di stato

description
Tipo: string

Descrizione dell'aggiornamento di stato

user
Tipo: string

Utente dell'aggiornamento di stato

user_title
Tipo: string

Titolo dell'utente dell'aggiornamento di stato

symbol
Tipo: string
obbligatorio

Simbolo della moneta

watchlist_portfolio_users
Tipo: number
obbligatorio

Numero di utenti che seguono questa moneta nel portafoglio

web_slug
Tipo: string
obbligatorio

Slug web della moneta

localization
Tipo: object

Localizzazione del nome della coin

propertyName
Tipo: string
market_data
Tipo: object

Dati di mercato

ath
Tipo: object

Massimo storico nella valuta di destinazione

propertyName
Tipo: number
ath_change_percentage
Tipo: object

Percentuale di variazione del massimo storico

propertyName
Tipo: number
ath_date
Tipo: object

Data del massimo storico

propertyName
Tipo: string
atl
Tipo: object

Minimo storico nella valuta di destinazione

propertyName
Tipo: number
atl_change_percentage
Tipo: object

Percentuale di variazione del minimo storico

propertyName
Tipo: number
atl_date
Tipo: object

Data del minimo storico

propertyName
Tipo: string
circulating_supply
Tipo: number

Offerta in circolazione

current_price
Tipo: object

Prezzo corrente nella valuta di destinazione

propertyName
Tipo: number
fdv_to_tvl_ratio
Tipo: number | null

Rapporto tra FDV e TVL

fully_diluted_valuation
Tipo: object

Valutazione completamente diluita nella valuta di destinazione

propertyName
Tipo: number
high_24h
Tipo: object

Prezzo massimo nelle 24 ore nella valuta di destinazione

propertyName
Tipo: number
last_updated
Tipo: string

Timestamp dell'ultimo aggiornamento dei dati di mercato

low_24h
Tipo: object

Prezzo minimo nelle 24 ore nella valuta di destinazione

propertyName
Tipo: number
market_cap
Tipo: object

Capitalizzazione di mercato nella valuta di destinazione

propertyName
Tipo: number
market_cap_change_24h
Tipo: number

Variazione della capitalizzazione di mercato nelle 24 ore nella valuta di destinazione

market_cap_change_24h_in_currency
Tipo: object

Variazione della capitalizzazione di mercato nelle 24 ore nella valuta di destinazione

propertyName
Tipo: number
market_cap_change_percentage_24h
Tipo: number

Variazione percentuale della capitalizzazione di mercato nelle 24 ore

market_cap_change_percentage_24h_in_currency
Tipo: object

Variazione percentuale della capitalizzazione di mercato nelle 24 ore per valuta

propertyName
Tipo: number
market_cap_fdv_ratio
Tipo: number

Rapporto tra capitalizzazione di mercato e FDV

market_cap_rank
Tipo: integer | null

Rank di capitalizzazione di mercato

market_cap_rank_with_rehypothecated
Tipo: integer | null

Rank di capitalizzazione di mercato inclusi i token rehypothecated

max_supply
Tipo: number | null

Offerta massima

max_supply_infinite
Tipo: boolean

Offerta massima illimitata

mcap_to_tvl_ratio
Tipo: number | null

Rapporto tra capitalizzazione di mercato e TVL

outstanding_supply
Tipo: number | null

Token in circolazione sul mercato

outstanding_token_value_usd
Tipo: number | null

Valore dei token in circolazione in USD

price_change_24h
Tipo: number

Variazione di prezzo nelle 24 ore nella valuta di destinazione

price_change_24h_in_currency
Tipo: object

Variazione di prezzo nelle 24 ore nella valuta di destinazione

propertyName
Tipo: number
price_change_percentage_14d
Tipo: number

Variazione percentuale del prezzo su 14 giorni

price_change_percentage_14d_in_currency
Tipo: object

Variazione percentuale del prezzo su 14 giorni per valuta

propertyName
Tipo: number
price_change_percentage_1h_in_currency
Tipo: object

Variazione percentuale del prezzo su 1 ora per valuta

propertyName
Tipo: number
price_change_percentage_1y
Tipo: number

Variazione percentuale del prezzo su 1 anno

price_change_percentage_1y_in_currency
Tipo: object

Variazione percentuale del prezzo su 1 anno per valuta

propertyName
Tipo: number
price_change_percentage_200d
Tipo: number

Variazione percentuale del prezzo su 200 giorni

price_change_percentage_200d_in_currency
Tipo: object

Variazione percentuale del prezzo su 200 giorni per valuta

propertyName
Tipo: number
price_change_percentage_24h
Tipo: number

Variazione percentuale del prezzo nelle 24 ore

price_change_percentage_24h_in_currency
Tipo: object

Variazione percentuale del prezzo nelle 24 ore per valuta

propertyName
Tipo: number
price_change_percentage_30d
Tipo: number

Variazione percentuale del prezzo su 30 giorni

price_change_percentage_30d_in_currency
Tipo: object

Variazione percentuale del prezzo su 30 giorni per valuta

propertyName
Tipo: number
price_change_percentage_60d
Tipo: number

Variazione percentuale del prezzo su 60 giorni

price_change_percentage_60d_in_currency
Tipo: object

Variazione percentuale del prezzo su 60 giorni per valuta

propertyName
Tipo: number
price_change_percentage_7d
Tipo: number

Variazione percentuale del prezzo su 7 giorni

price_change_percentage_7d_in_currency
Tipo: object

Variazione percentuale del prezzo su 7 giorni per valuta

propertyName
Tipo: number
roi
Tipo: object | null

Rendimento dell'investimento

currency
Tipo: string

Valuta del ROI

percentage
Tipo: number

Percentuale del ROI

times
Tipo: number

Moltiplicatore del ROI

sparkline_7d
Tipo: array number[]

Dati di prezzo sparkline degli ultimi 7 giorni

total_supply
Tipo: number

Offerta totale

total_value_locked
Tipo: number | null

Valore totale bloccato (TVL)

total_volume
Tipo: object

Volume di scambio totale nella valuta di destinazione

propertyName
Tipo: number
tickers
Tipo: array object[]

Ticker

base
Tipo: string

Valuta di base del ticker

bid_ask_spread_percentage
Tipo: number

Spread denaro-lettera del ticker in percentuale

coin_id
Tipo: string

ID della moneta della valuta di base del ticker

coin_mcap_usd
Tipo: number

Capitalizzazione di mercato in USD

converted_last
Tipo: object

Ultimo prezzo convertito del ticker

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

Volume convertito del ticker

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

Anomalia del ticker

is_stale
Tipo: boolean

Ticker obsoleto

last
Tipo: number

Ultimo prezzo del ticker

last_fetch_at
Tipo: string

Timestamp dell'ultimo recupero del ticker

last_traded_at
Tipo: string

Timestamp dell'ultima negoziazione del ticker

market
Tipo: object

Piattaforma del ticker

has_trading_incentive
Tipo: boolean

Incentivo di negoziazione della piattaforma

identifier
Tipo: string

Identificatore della piattaforma

name
Tipo: string

Nome della piattaforma

target
Tipo: string

Valuta di destinazione del ticker

target_coin_id
Tipo: string

ID della moneta della valuta di destinazione del ticker

timestamp
Tipo: string

Timestamp del ticker

token_info_url
Tipo: string | null

URL delle informazioni sul token del ticker

trade_url
Tipo: string

URL di negoziazione del ticker

trust_score
Tipo: string | null

Trust score del ticker

volume
Tipo: number

Volume del ticker
application/json
400

Impossibile elaborare la richiesta. Controlla i parametri della richiesta.
401

È richiesta una chiave API Felo valida.
402

Impossibile procedere con la richiesta perché non è soddisfatto un requisito di fatturazione.
403

L'account non è autorizzato a eseguire questa operazione.
429

È stato raggiunto un limite di richieste o di spesa.
502

Il servizio non è riuscito a completare la richiesta.
503

L'API o il servizio di fatturazione è temporaneamente non disponibile.
504

Si è verificato un timeout durante l'elaborazione della richiesta.
default

Risposta di errore; le risposte passthrough upstream possono usare formati del provider

application/json

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'

Mostra schema

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

Dati della moneta per indirizzo del contratto del token

Dati della moneta per indirizzo del token

AutenticazioneRequired

CoinGecko

Dati della moneta per indirizzo del token

Riferimento prezzi