CoinGecko
Cryptocurrency prices, market data and historical series.
依代幣地址取得幣種資料
依合約地址而非 CoinGecko id 查詢的完整幣種檔案。id 是資產平台,contract_address 是代幣;兩者皆為必填,且沒有其他參數。傳回的結構與 get_coingecko_coins_id 相同——description、links、image、categories、platforms、detail_platforms、market_cap_rank、market_data 區塊與內嵌的 tickers 陣列——再加上 contract_address 本身。可用於從地址辨識未知代幣。若只需要目前價格,get_coingecko_simple_token_price_id 輕量許多。
定價參考
- 計量方式:方案資源單位。
- 參考請求預估:USD 0.008。
- 單位成本基礎:USD 0.0。
- 資源單位:
provider_credit。 - 成本基礎不構成最終客戶價格,即使為零亦同。
僅供參考的中繼資料,並非帳戶報價、保證價格或消費上限。資源額度並非 Felo 額度。最終費用依 Felo 計費記錄為準。
- 類型: stringcontract
_address 必填代幣的合約地址。
- 類型: stringid必填
資產平台 ID。 *參見
/asset_platforms。
- 類型: object · Response860C3Ae68Ea5_CoinsContractAddress200
依代幣合約地址取得幣種資料
- 類型: array string[]additional
_notices 必填其他聲明
- 類型: string | nullasset
_platform _id 必填代幣資產平台 ID
- 類型: numberblock
_time _in _minutes 必填區塊鏈出塊時間(分鐘)
- 類型: array string[]categories必填
代幣類別
- 類型: stringcontract
_address 必填代幣合約地址
- 類型: stringcountry
_origin 必填原產國
- 類型: objectdescription必填
代幣說明
- property類型: string
Name
- 類型: objectdetail
_platforms 必填詳細的代幣資產平台與合約地址
- property類型: object
Name - contract類型: string
_address 代幣合約地址
- decimal類型: integer | null
_place 代幣小數位數
- geckoterminal類型: string
_url GeckoTerminal 的 URL
- 類型: string | nullgenesis
_date 必填創世日期
- 類型: booleanhas
_supply _breakdown 必填是否可透過 /coins/supply_breakdown 取得詳細的供應量明細資料
- 類型: string | nullhashing
_algorithm 必填區塊鏈雜湊演算法
- 類型: stringid必填
代幣 ID
- 類型: objectimage必填
代幣圖片 URL
- large類型: string
- small類型: string
- thumb類型: string
- 類型: stringlast
_updated 必填最後更新時間戳記
- 類型: objectlinks必填
連結
- announcement類型: array string[]
_url 公告 URL
- bitcointalk類型: integer | null
_thread _identifier Bitcointalk 討論串識別碼
- blockchain類型: array string[]
_site 區塊瀏覽器 URL
- chat類型: array string[]
_url 聊天 URL
- facebook類型: string
_username Facebook 使用者名稱
- homepage類型: array string[]
網站 URL
- official類型: array string[]
_forum _url 官方論壇 URL
- repos類型: object
_url 程式碼倉庫 URL
- bitbucket類型: array string[]
Bitbucket 倉庫 URL
- github類型: array string[]
GitHub 倉庫 URL
- snapshot類型: string | null
_url 快照 URL
- subreddit類型: string | null
_url Subreddit 的 URL
- telegram類型: string
_channel _identifier Telegram 頻道識別碼
- twitter類型: string
_screen _name Twitter 使用者名稱
- whitepaper類型: string
白皮書 URL
- 類型: integer | nullmarket
_cap _rank 必填市值排名
- 類型: integer | nullmarket
_cap _rank _with _rehypothecated 必填包含再抵押代幣的市值排名
- 類型: stringname必填
代幣名稱
- 類型: objectplatforms必填
代幣資產平台與合約地址
- property類型: string
Name
- 類型: booleanpreview
_listing 必填預覽上架代幣
- 類型: string | nullpublic
_notice 必填公告
- 類型: number | nullsentiment
_votes _down _percentage 必填看跌票數百分比
- 類型: number | nullsentiment
_votes _up _percentage 必填看漲票數百分比
- 類型: array object[]status
_updates 必填狀態更新
- category類型: string
狀態更新類別
- created類型: string
_at 狀態更新建立時間
- description類型: string
狀態更新說明
- user類型: string
狀態更新使用者
- user類型: string
_title 狀態更新使用者職稱
- 類型: stringsymbol必填
代幣符號
- 類型: numberwatchlist
_portfolio _users 必填在投資組合中追蹤此代幣的使用者數
- 類型: stringweb
_slug 必填代幣網頁 slug
- 類型: objectlocalization
代幣名稱在地化
- property類型: string
Name
- 類型: objectmarket
_data 市場資料
- ath類型: object
以目標貨幣計價的歷史最高價
- property類型: number
Name
- ath類型: object
_change _percentage 歷史最高價變化百分比
- property類型: number
Name
- ath類型: object
_date 歷史最高價日期
- property類型: string
Name
- atl類型: object
以目標貨幣計價的歷史最低價
- property類型: number
Name
- atl類型: object
_change _percentage 歷史最低價變化百分比
- property類型: number
Name
- atl類型: object
_date 歷史最低價日期
- property類型: string
Name
- circulating類型: number
_supply 流通供應量
- current類型: object
_price 以目標貨幣計的當前價格
- property類型: number
Name
- fdv類型: number | null
_to _tvl _ratio 完全稀釋估值與總鎖定價值比
- fully類型: object
_diluted _valuation 以目標貨幣計的完全稀釋估值
- property類型: number
Name
- high類型: object
_24h 以目標貨幣計的 24 小時最高價
- property類型: number
Name
- last類型: string
_updated 市場資料最後更新時間戳
- low類型: object
_24h 以目標貨幣計的 24 小時最低價
- property類型: number
Name
- market類型: object
_cap 以目標貨幣計的市值
- property類型: number
Name
- market類型: number
_cap _change _24h 以目標貨幣計的 24 小時市值變動
- market類型: object
_cap _change _24h _in _currency 以目標貨幣計的 24 小時市值變動
- property類型: number
Name
- market類型: number
_cap _change _percentage _24h 24 小時市值變動百分比
- market類型: object
_cap _change _percentage _24h _in _currency 各貨幣的 24 小時市值變動百分比
- property類型: number
Name
- market類型: number
_cap _fdv _ratio 市值與完全稀釋估值比
- market類型: integer | null
_cap _rank 市值排名
- market類型: integer | null
_cap _rank _with _rehypothecated 包含再抵押代幣的市值排名
- max類型: number | null
_supply 最大供給量
- max類型: boolean
_supply _infinite 最大供給量無上限
- mcap類型: number | null
_to _tvl _ratio 市值與總鎖定價值比
- outstanding類型: number | null
_supply 市場上的流通代幣數量
- outstanding類型: number | null
_token _value _usd 流通代幣價值(美元)
- price類型: number
_change _24h 以目標貨幣計的 24 小時價格變動
- price類型: object
_change _24h _in _currency 以目標貨幣計的 24 小時價格變動
- property類型: number
Name
- price類型: number
_change _percentage _14d 14 天價格漲跌幅
- price類型: object
_change _percentage _14d _in _currency 各貨幣的 14 天價格漲跌幅
- property類型: number
Name
- price類型: object
_change _percentage _1h _in _currency 各貨幣的 1 小時價格漲跌幅
- property類型: number
Name
- price類型: number
_change _percentage _1y 1 年價格漲跌幅
- price類型: object
_change _percentage _1y _in _currency 各貨幣的 1 年價格漲跌幅
- property類型: number
Name
- price類型: number
_change _percentage _200d 200 天價格漲跌幅
- price類型: object
_change _percentage _200d _in _currency 各貨幣的 200 天價格漲跌幅
- property類型: number
Name
- price類型: number
_change _percentage _24h 24 小時價格漲跌幅
- price類型: object
_change _percentage _24h _in _currency 各貨幣的 24 小時價格漲跌幅
- property類型: number
Name
- price類型: number
_change _percentage _30d 30 天價格漲跌幅
- price類型: object
_change _percentage _30d _in _currency 各貨幣的 30 天價格漲跌幅
- property類型: number
Name
- price類型: number
_change _percentage _60d 60 天價格漲跌幅
- price類型: object
_change _percentage _60d _in _currency 各貨幣的 60 天價格漲跌幅
- property類型: number
Name
- price類型: number
_change _percentage _7d 7 天價格漲跌幅
- price類型: object
_change _percentage _7d _in _currency 各貨幣的 7 天價格漲跌幅
- property類型: number
Name
- roi類型: object | null
投資報酬率
- currency類型: string
投資報酬率貨幣
- percentage類型: number
投資報酬率百分比
- times類型: number
投資報酬率倍數
- sparkline類型: array number[]
_7d 7 天 sparkline 價格資料
- total類型: number
_supply 總供給量
- total類型: number | null
_value _locked 總鎖定價值
- total類型: object
_volume 以目標貨幣計的總交易量
- property類型: number
Name
- 類型: array object[]tickers
Ticker 資料
- base類型: string
Ticker 基礎貨幣
- bid類型: number
_ask _spread _percentage Ticker 買賣價差百分比
- coin類型: string
_id Ticker 基礎貨幣代幣 ID
- coin類型: number
_mcap _usd 市值(美元)
- converted類型: object
_last Ticker 換算後最新價格
- btc類型: number
- eth類型: number
- usd類型: number
- converted類型: object
_volume Ticker 換算後成交量
- btc類型: number
- eth類型: number
- usd類型: number
- is類型: boolean
_anomaly Ticker 異常
- is類型: boolean
_stale Ticker 資料過舊
- last類型: number
Ticker 最新價格
- last類型: string
_fetch _at Ticker 最後擷取時間戳
- last類型: string
_traded _at Ticker 最後成交時間戳
- market類型: object
Ticker 交易所
- has類型: boolean
_trading _incentive 交易所交易獎勵
- identifier類型: string
交易所識別碼
- name類型: string
交易所名稱
- target類型: string
Ticker 目標貨幣
- target類型: string
_coin _id Ticker 目標貨幣代幣 ID
- timestamp類型: string
Ticker 時間戳
- token類型: string | null
_info _url Ticker 代幣資訊 URL
- trade類型: string
_url Ticker 交易 URL
- trust類型: string | null
_score Ticker 信任分數
- volume類型: number
Ticker 成交量
application/json - 400
無法處理該要求。請檢查請求參數。
- 401
需要有效的 Felo API 金鑰。
- 402
由於未符合計費要求,要求無法繼續。
- 403
該帳戶無權執行此操作。
- 429
已達到要求或支出上限。
- 502
服務無法完成該要求。
- 503
API 或計費服務暫時無法使用。
- 504
服務在處理要求時逾時。
- default
錯誤回應;上游透傳回應可能採用供應商格式
application/json
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
}
]
}