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 轻量得多。
计费参考
- 计量方式:套餐资源单位。
- 参考请求估算:0.008 美元。
- 单位成本基准: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
}
]
}