CoinGecko
Cryptocurrency prices, market data and historical series.
Dữ liệu đồng tiền theo địa chỉ token
Hồ sơ đầy đủ của một đồng tiền tra theo địa chỉ hợp đồng thay vì id CoinGecko. id là nền tảng tài sản và contract_address là token; cả hai đều bắt buộc và không có tham số nào khác. Trả về cùng hình dạng như get_coingecko_coins_id — description, links, image, categories, platforms, detail_platforms, market_cap_rank, khối market_data và mảng tickers nhúng — cộng thêm chính contract_address. Dùng để nhận diện một token chưa biết từ địa chỉ. Nếu chỉ cần giá hiện tại, get_coingecko_simple_token_price_id nhẹ hơn nhiều.
Tham chiếu giá
- Đo lường: Đơn vị tài nguyên theo gói.
- Ước tính tham chiếu cho mỗi yêu cầu: USD 0.008.
- Cơ sở chi phí đơn vị: USD 0.0.
- Đơn vị tài nguyên:
provider_credit. - Cơ sở chi phí không xác lập giá cuối cùng cho khách hàng, kể cả khi bằng 0.
Chỉ là siêu dữ liệu tham chiếu, không phải báo giá cho tài khoản, mức giá được bảo đảm hay hạn mức chi tiêu. Tín dụng tài nguyên không phải tín dụng Felo. Khoản phí cuối cùng tuân theo bản ghi thanh toán của Felo.
- Kiểu: stringcontract
_address bắt buộcĐịa chỉ hợp đồng của token.
- Kiểu: stringidbắt buộc
ID nền tảng tài sản. *tham chiếu
/asset_platforms.
- Kiểu: object · Response860C3Ae68Ea5_CoinsContractAddress200
Dữ liệu đồng tiền theo địa chỉ hợp đồng token
- Kiểu: array string[]additional
_notices bắt buộcThông báo bổ sung
- Kiểu: string | nullasset
_platform _id bắt buộcID nền tảng tài sản của đồng tiền
- Kiểu: numberblock
_time _in _minutes bắt buộcThời gian khối của chuỗi khối tính bằng phút
- Kiểu: array string[]categoriesbắt buộc
Danh mục đồng tiền
- Kiểu: stringcontract
_address bắt buộcĐịa chỉ hợp đồng của đồng tiền
- Kiểu: stringcountry
_origin bắt buộcQuốc gia xuất xứ
- Kiểu: objectdescriptionbắt buộc
Mô tả đồng tiền
- propertyKiểu: string
Name
- Kiểu: objectdetail
_platforms bắt buộcNền tảng tài sản và địa chỉ hợp đồng chi tiết của đồng tiền
- propertyKiểu: object
Name - contractKiểu: string
_address Địa chỉ hợp đồng token
- decimalKiểu: integer | null
_place Số chữ số thập phân của token
- geckoterminalKiểu: string
_url URL GeckoTerminal
- Kiểu: string | nullgenesis
_date bắt buộcNgày khởi tạo
- Kiểu: booleanhas
_supply _breakdown bắt buộcLiệu dữ liệu phân tích nguồn cung chi tiết có sẵn qua /coins/supply_breakdown hay không
- Kiểu: string | nullhashing
_algorithm bắt buộcThuật toán băm của chuỗi khối
- Kiểu: stringidbắt buộc
ID đồng tiền
- Kiểu: objectimagebắt buộc
URL hình ảnh của đồng tiền
- largeKiểu: string
- smallKiểu: string
- thumbKiểu: string
- Kiểu: stringlast
_updated bắt buộcDấu thời gian cập nhật lần cuối
- Kiểu: objectlinksbắt buộc
Liên kết
- announcementKiểu: array string[]
_url URL thông báo
- bitcointalkKiểu: integer | null
_thread _identifier Mã định danh chủ đề Bitcointalk
- blockchainKiểu: array string[]
_site URL trình khám phá khối
- chatKiểu: array string[]
_url URL trò chuyện
- facebookKiểu: string
_username Tên người dùng Facebook
- homepageKiểu: array string[]
URL trang web
- officialKiểu: array string[]
_forum _url URL diễn đàn chính thức
- reposKiểu: object
_url URL kho lưu trữ
- bitbucketKiểu: array string[]
URL kho lưu trữ Bitbucket
- githubKiểu: array string[]
URL kho lưu trữ GitHub
- snapshotKiểu: string | null
_url URL Snapshot
- subredditKiểu: string | null
_url URL Subreddit
- telegramKiểu: string
_channel _identifier Mã định danh kênh Telegram
- twitterKiểu: string
_screen _name Tên người dùng Twitter
- whitepaperKiểu: string
URL sách trắng
- Kiểu: integer | nullmarket
_cap _rank bắt buộcXếp hạng vốn hóa thị trường
- Kiểu: integer | nullmarket
_cap _rank _with _rehypothecated bắt buộcXếp hạng vốn hóa thị trường bao gồm các token tái thế chấp
- Kiểu: stringnamebắt buộc
Tên đồng tiền
- Kiểu: objectplatformsbắt buộc
Nền tảng tài sản và địa chỉ hợp đồng của đồng tiền
- propertyKiểu: string
Name
- Kiểu: booleanpreview
_listing bắt buộcĐồng tiền niêm yết xem trước
- Kiểu: string | nullpublic
_notice bắt buộcThông báo công khai
- Kiểu: number | nullsentiment
_votes _down _percentage bắt buộcPhần trăm phiếu cảm xúc tiêu cực
- Kiểu: number | nullsentiment
_votes _up _percentage bắt buộcPhần trăm phiếu cảm xúc tích cực
- Kiểu: array object[]status
_updates bắt buộcCập nhật trạng thái
- categoryKiểu: string
Danh mục cập nhật trạng thái
- createdKiểu: string
_at Thời điểm tạo cập nhật trạng thái
- descriptionKiểu: string
Mô tả cập nhật trạng thái
- userKiểu: string
Người dùng cập nhật trạng thái
- userKiểu: string
_title Chức danh người dùng trong cập nhật trạng thái
- Kiểu: stringsymbolbắt buộc
Ký hiệu đồng tiền
- Kiểu: numberwatchlist
_portfolio _users bắt buộcSố người dùng theo dõi đồng tiền này trong danh mục đầu tư
- Kiểu: stringweb
_slug bắt buộcSlug web của đồng tiền
- Kiểu: objectlocalization
Bản địa hóa tên đồng tiền
- propertyKiểu: string
Name
- Kiểu: objectmarket
_data Dữ liệu thị trường
- athKiểu: object
Mức cao nhất mọi thời đại tính theo đơn vị tiền tệ mục tiêu
- propertyKiểu: number
Name
- athKiểu: object
_change _percentage Tỷ lệ thay đổi mức cao nhất mọi thời đại
- propertyKiểu: number
Name
- athKiểu: object
_date Ngày đạt mức cao nhất mọi thời đại
- propertyKiểu: string
Name
- atlKiểu: object
Mức thấp nhất mọi thời đại tính theo đơn vị tiền tệ mục tiêu
- propertyKiểu: number
Name
- atlKiểu: object
_change _percentage Tỷ lệ thay đổi mức thấp nhất mọi thời đại
- propertyKiểu: number
Name
- atlKiểu: object
_date Ngày đạt mức thấp nhất mọi thời đại
- propertyKiểu: string
Name
- circulatingKiểu: number
_supply Nguồn cung lưu hành
- currentKiểu: object
_price Giá hiện tại theo đơn vị tiền tệ đích
- propertyKiểu: number
Name
- fdvKiểu: number | null
_to _tvl _ratio Tỷ lệ FDV trên TVL
- fullyKiểu: object
_diluted _valuation Định giá pha loãng hoàn toàn theo đơn vị tiền tệ đích
- propertyKiểu: number
Name
- highKiểu: object
_24h Giá cao nhất 24 giờ theo đơn vị tiền tệ đích
- propertyKiểu: number
Name
- lastKiểu: string
_updated Dấu thời gian cập nhật dữ liệu thị trường gần nhất
- lowKiểu: object
_24h Giá thấp nhất 24 giờ theo đơn vị tiền tệ đích
- propertyKiểu: number
Name
- marketKiểu: object
_cap Vốn hóa thị trường theo đơn vị tiền tệ đích
- propertyKiểu: number
Name
- marketKiểu: number
_cap _change _24h Thay đổi vốn hóa thị trường 24 giờ theo đơn vị tiền tệ đích
- marketKiểu: object
_cap _change _24h _in _currency Thay đổi vốn hóa thị trường 24 giờ theo đơn vị tiền tệ đích
- propertyKiểu: number
Name
- marketKiểu: number
_cap _change _percentage _24h Phần trăm thay đổi vốn hóa thị trường 24 giờ
- marketKiểu: object
_cap _change _percentage _24h _in _currency Phần trăm thay đổi vốn hóa thị trường 24 giờ theo từng loại tiền tệ
- propertyKiểu: number
Name
- marketKiểu: number
_cap _fdv _ratio Tỷ lệ vốn hóa thị trường trên FDV
- marketKiểu: integer | null
_cap _rank Xếp hạng vốn hóa thị trường
- marketKiểu: integer | null
_cap _rank _with _rehypothecated Xếp hạng vốn hóa thị trường bao gồm các token tái thế chấp
- maxKiểu: number | null
_supply Nguồn cung tối đa
- maxKiểu: boolean
_supply _infinite Nguồn cung tối đa vô hạn
- mcapKiểu: number | null
_to _tvl _ratio Tỷ lệ vốn hóa thị trường trên TVL
- outstandingKiểu: number | null
_supply Số token đang lưu hành trên thị trường
- outstandingKiểu: number | null
_token _value _usd Giá trị token đang lưu hành tính bằng USD
- priceKiểu: number
_change _24h Thay đổi giá 24 giờ theo đơn vị tiền tệ đích
- priceKiểu: object
_change _24h _in _currency Thay đổi giá 24 giờ theo đơn vị tiền tệ đích
- propertyKiểu: number
Name
- priceKiểu: number
_change _percentage _14d Phần trăm thay đổi giá 14 ngày
- priceKiểu: object
_change _percentage _14d _in _currency Phần trăm thay đổi giá 14 ngày theo từng loại tiền tệ
- propertyKiểu: number
Name
- priceKiểu: object
_change _percentage _1h _in _currency Phần trăm thay đổi giá 1 giờ theo từng loại tiền tệ
- propertyKiểu: number
Name
- priceKiểu: number
_change _percentage _1y Phần trăm thay đổi giá 1 năm
- priceKiểu: object
_change _percentage _1y _in _currency Phần trăm thay đổi giá 1 năm theo từng loại tiền tệ
- propertyKiểu: number
Name
- priceKiểu: number
_change _percentage _200d Phần trăm thay đổi giá 200 ngày
- priceKiểu: object
_change _percentage _200d _in _currency Phần trăm thay đổi giá 200 ngày theo từng loại tiền tệ
- propertyKiểu: number
Name
- priceKiểu: number
_change _percentage _24h Phần trăm thay đổi giá 24 giờ
- priceKiểu: object
_change _percentage _24h _in _currency Phần trăm thay đổi giá 24 giờ theo từng loại tiền tệ
- propertyKiểu: number
Name
- priceKiểu: number
_change _percentage _30d Phần trăm thay đổi giá 30 ngày
- priceKiểu: object
_change _percentage _30d _in _currency Phần trăm thay đổi giá 30 ngày theo từng loại tiền tệ
- propertyKiểu: number
Name
- priceKiểu: number
_change _percentage _60d Phần trăm thay đổi giá 60 ngày
- priceKiểu: object
_change _percentage _60d _in _currency Phần trăm thay đổi giá 60 ngày theo từng loại tiền tệ
- propertyKiểu: number
Name
- priceKiểu: number
_change _percentage _7d Phần trăm thay đổi giá 7 ngày
- priceKiểu: object
_change _percentage _7d _in _currency Phần trăm thay đổi giá 7 ngày theo từng loại tiền tệ
- propertyKiểu: number
Name
- roiKiểu: object | null
Lợi tức đầu tư
- currencyKiểu: string
Đơn vị tiền tệ của ROI
- percentageKiểu: number
Phần trăm ROI
- timesKiểu: number
Hệ số nhân ROI
- sparklineKiểu: array number[]
_7d Dữ liệu giá sparkline 7 ngày
- totalKiểu: number
_supply Tổng nguồn cung
- totalKiểu: number | null
_value _locked Tổng giá trị khóa
- totalKiểu: object
_volume Tổng khối lượng giao dịch theo đơn vị tiền tệ đích
- propertyKiểu: number
Name
- Kiểu: array object[]tickers
Các ticker
- baseKiểu: string
Đơn vị tiền tệ cơ sở của ticker
- bidKiểu: number
_ask _spread _percentage Phần trăm chênh lệch giá mua-bán của ticker
- coinKiểu: string
_id ID đồng tiền của đơn vị tiền tệ cơ sở trong ticker
- coinKiểu: number
_mcap _usd Vốn hóa thị trường tính bằng USD
- convertedKiểu: object
_last Giá gần nhất quy đổi của ticker
- btcKiểu: number
- ethKiểu: number
- usdKiểu: number
- convertedKiểu: object
_volume Khối lượng quy đổi của ticker
- btcKiểu: number
- ethKiểu: number
- usdKiểu: number
- isKiểu: boolean
_anomaly Bất thường của ticker
- isKiểu: boolean
_stale Ticker lỗi thời
- lastKiểu: number
Giá gần nhất của ticker
- lastKiểu: string
_fetch _at Dấu thời gian lấy dữ liệu ticker gần nhất
- lastKiểu: string
_traded _at Dấu thời gian giao dịch gần nhất của ticker
- marketKiểu: object
Sàn của ticker
- hasKiểu: boolean
_trading _incentive Ưu đãi giao dịch của sàn
- identifierKiểu: string
Mã định danh sàn
- nameKiểu: string
Tên sàn
- targetKiểu: string
Đơn vị tiền tệ đích của ticker
- targetKiểu: string
_coin _id ID đồng tiền của đơn vị tiền tệ đích trong ticker
- timestampKiểu: string
Dấu thời gian của ticker
- tokenKiểu: string | null
_info _url URL thông tin token của ticker
- tradeKiểu: string
_url URL giao dịch của ticker
- trustKiểu: string | null
_score Điểm tin cậy của ticker
- volumeKiểu: number
Khối lượng giao dịch của ticker
application/json - 400
Không thể xử lý yêu cầu. Hãy kiểm tra các tham số yêu cầu.
- 401
Cần có khóa API Felo hợp lệ.
- 402
Không thể tiếp tục yêu cầu vì chưa đáp ứng yêu cầu thanh toán.
- 403
Tài khoản không được phép thực hiện thao tác này.
- 429
Đã đạt giới hạn yêu cầu hoặc giới hạn chi tiêu.
- 502
Dịch vụ không thể hoàn tất yêu cầu.
- 503
API hoặc dịch vụ thanh toán tạm thời không khả dụng.
- 504
Dịch vụ đã hết thời gian chờ khi xử lý yêu cầu.
- default
Phản hồi lỗi; phản hồi chuyển tiếp từ thượng nguồn có thể dùng định dạng của nhà cung cấp
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
}
]
}