CoinGecko
Cryptocurrency prices, market data and historical series.
依 ID 取得幣種資料
CoinGecko 針對單一幣種(以 id 指定)持有的所有資料:description、links、image、categories、platforms 與 detail_platforms(各鏈的合約地址)、market_cap_rank,以及包含 current_price、market_cap、total_volume、fully_diluted_valuation、ath 與 atl(含日期與漲跌百分比)的 market_data 區塊。較龐大的區段須透過 market_data、community_data、developer_data、tickers、sparkline 與 localization 選擇啟用——除非必要,否則不要開啟,完整內容相當大。適用於建立幣種檔案。若需要涵蓋多個幣種的價格表,請用 get_coingecko_coins_markets;若要以合約地址查詢同一幣種,請用 get_coingecko_token_data。
定價參考
- 計量方式:方案資源單位。
- 參考請求預估:USD 0.008。
- 單位成本基礎:USD 0.0。
- 資源單位:
provider_credit。 - 成本基礎不構成最終客戶價格,即使為零亦同。
僅供參考的中繼資料,並非帳戶報價、保證價格或消費上限。資源額度並非 Felo 額度。最終費用依 Felo 計費記錄為準。
- 類型: stringid必填
幣種 ID。 *參見
/coins/list
- 類型: booleancommunity
_data 已棄用包含社群資料。 已棄用:自 2026 年 8 月 28 日起不再生效;不再傳回
community_data物件。 - 類型: booleandeveloper
_data 已棄用包含開發者資料。 已棄用:自 2026 年 8 月 28 日起不再生效;不再傳回
developer_data物件。 - 類型: string 列舉dex
_pair _format 設為
symbol可將 DEX 交易對的基礎貨幣與目標貨幣顯示為符號。 預設:contract_address值- contract
_address - symbol
- 類型: booleaninclude
_categories _details 包含類別詳細資料。 預設:false
- 類型: booleanlocalization
在回應中包含所有在地化語言。 預設:true
- 類型: booleanmarket
_data 包含市場資料。 預設:true
- 類型: booleansparkline
包含 7 天 sparkline 資料。 預設:false
- 類型: booleantickers
包含交易對資料。 預設:true
- 類型: object · Response860C3Ae68Ea5_CoinsID200
幣種資料
- 類型: array string[]additional
_notices 必填其他聲明
- 類型: string | nullasset
_platform _id 必填代幣資產平台 ID
- 類型: numberblock
_time _in _minutes 必填區塊鏈出塊時間(分鐘)
- 類型: array string[]categories必填
代幣類別
- 類型: stringcountry
_origin 必填原產國
- 類型: objectdescription必填
代幣說明
- property類型: string
Name
- 類型: objectdetail
_platforms 必填詳細的代幣資產平台與合約地址
- property類型: object
Name - contract類型: string
_address 代幣合約地址
- decimal類型: integer | null
_place 代幣小數位數
- 類型: 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
_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
- 類型: array object[]categories
_details 代幣詳細分類
- id類型: string
類別 ID
- name類型: string
類別名稱
- 類型: object | nullico
_data ICO 資料
- accepting類型: string
_currencies 接受的貨幣
- amount類型: number
_for _sale 出售數量
- base類型: number
_pre _sale _amount 基礎貨幣預售數量
- base類型: number
_public _sale _amount 基礎貨幣公開販售數量
- bounty類型: string
_detail _url 賞金詳細資料 URL
- country類型: string
_origin 原產國
- description類型: string
詳細說明
- hardcap類型: number
_amount 硬頂金額
- hardcap類型: string
_currency 硬頂貨幣
- ico類型: string
_end _date ICO 結束日期
- ico類型: string
_start _date ICO 開始日期
- kyc類型: boolean
_required 需要 KYC
- links類型: object
ICO 相關連結
- property類型: string
Name
- pre類型: boolean
_sale _available 可預售
- pre類型: string
_sale _end _date 預售結束日期
- pre類型: boolean
_sale _ended 預售已結束
- pre類型: string
_sale _start _date 預售開始日期
- quote類型: number
_pre _sale _amount 計價貨幣預售數量
- quote類型: string
_pre _sale _currency 預售計價貨幣
- quote類型: number
_public _sale _amount 計價貨幣公開販售數量
- quote類型: string
_public _sale _currency 公開販售計價貨幣
- short類型: string
_desc 簡短說明
- softcap類型: number
_amount 軟頂金額
- softcap類型: string
_currency 軟頂貨幣
- total類型: number
_raised 募資總額
- total類型: string
_raised _currency 募資總額貨幣
- whitelist類型: boolean
_available 可加入白名單
- whitelist類型: string
_end _date 白名單結束日期
- whitelist類型: string
_start _date 白名單開始日期
- whitelist類型: string
_url 白名單 URL
- 類型: 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/bitcoin \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
"id": "bitcoin",
"symbol": "btc",
"name": "Bitcoin",
"web_slug": "bitcoin",
"asset_platform_id": null,
"platforms": {
"": ""
},
"detail_platforms": {
"": {
"decimal_place": null,
"contract_address": ""
}
},
"block_time_in_minutes": 10,
"hashing_algorithm": "SHA-256",
"categories": [
"Cryptocurrency",
"Layer 1 (L1)"
],
"preview_listing": false,
"public_notice": null,
"additional_notices": [],
"has_supply_breakdown": false,
"description": {
"en": "Bitcoin is the first successful internet money based on peer-to-peer technology..."
},
"links": {
"homepage": [
"http://www.bitcoin.org",
"",
""
],
"whitepaper": "https://bitcoin.org/bitcoin.pdf",
"blockchain_site": [
"https://mempool.space/",
"https://blockchair.com/bitcoin/"
],
"official_forum_url": [
"https://bitcointalk.org/"
],
"chat_url": [
""
],
"announcement_url": [
"",
""
],
"snapshot_url": null,
"twitter_screen_name": "bitcoin",
"facebook_username": "bitcoins",
"bitcointalk_thread_identifier": null,
"telegram_channel_identifier": "",
"subreddit_url": "https://www.reddit.com/r/Bitcoin/",
"repos_url": {
"github": [
"https://github.com/bitcoin/bitcoin",
"https://github.com/bitcoin/bips"
],
"bitbucket": []
}
},
"image": {
"thumb": "https://assets.coingecko.com/coins/images/1/thumb/bitcoin.png?1696501400",
"small": "https://assets.coingecko.com/coins/images/1/small/bitcoin.png?1696501400",
"large": "https://assets.coingecko.com/coins/images/1/large/bitcoin.png?1696501400"
},
"country_origin": "",
"genesis_date": "2009-01-03",
"sentiment_votes_up_percentage": 84.07,
"sentiment_votes_down_percentage": 15.93,
"watchlist_portfolio_users": 1541900,
"market_cap_rank": 1,
"market_cap_rank_with_rehypothecated": 1,
"status_updates": [],
"last_updated": "2024-04-07T15:24:51.021Z",
"market_data": {
"current_price": {
"btc": 1,
"eur": 64375,
"usd": 69840
},
"total_value_locked": null,
"mcap_to_tvl_ratio": null,
"fdv_to_tvl_ratio": null,
"roi": null,
"ath": {
"btc": 1.003301,
"eur": 67405,
"usd": 73738
},
"ath_change_percentage": {
"btc": -0.32896,
"eur": -4.54383,
"usd": -5.33399
},
"ath_date": {
"btc": "2024-03-02T16:05:19.446Z",
"eur": "2024-03-14T07:10:36.635Z",
"usd": "2024-03-14T07:10:36.635Z"
},
"atl": {
"btc": 0.99895134,
"eur": 51.3,
"usd": 67.81
},
"atl_change_percentage": {
"btc": 0.10408,
"eur": 125385.41242,
"usd": 102882.36498
},
"atl_date": {
"btc": "2019-10-21T00:00:00.000Z",
"eur": "2013-07-05T00:00:00.000Z",
"usd": "2013-07-06T00:00:00.000Z"
},
"market_cap": {
"btc": 19675377,
"eur": 1265825267281,
"usd": 1373296629498
},
"fully_diluted_valuation": {
"btc": 21000000,
"eur": 1351831155,
"usd": 1466577759
},
"market_cap_fdv_ratio": 1,
"market_cap_rank": 1,
"outstanding_token_value_usd": null,
"market_cap_rank_with_rehypothecated": 1,
"total_volume": {
"btc": 270165,
"eur": 17368113665,
"usd": 18867210007
},
"high_24h": {
"btc": 1,
"eur": 64343,
"usd": 69805
},
"low_24h": {
"btc": 1,
"eur": 62695,
"usd": 67985
},
"price_change_24h": 1619,
"price_change_percentage_24h": 2.37311,
"price_change_percentage_7d": -0.89706,
"price_change_percentage_14d": 6.36178,
"price_change_percentage_30d": 1.81171,
"price_change_percentage_60d": 62.54292,
"price_change_percentage_200d": 157.51875,
"price_change_percentage_1y": 149.76989,
"market_cap_change_24h": 31172487848,
"market_cap_change_percentage_24h": 2.32219,
"price_change_24h_in_currency": {
"btc": 0,
"eur": 1461.64,
"usd": 1618.95
},
"price_change_percentage_1h_in_currency": {
"btc": 0,
"eur": 0.79523,
"usd": 0.79523
},
"price_change_percentage_24h_in_currency": {
"btc": 0,
"eur": 2.32219,
"usd": 2.37311
},
"price_change_percentage_7d_in_currency": {
"btc": 0,
"eur": -1.01955,
"usd": -0.89706
},
"price_change_percentage_14d_in_currency": {
"btc": 0,
"eur": 5.84662,
"usd": 6.36178
},
"price_change_percentage_30d_in_currency": {
"btc": 0,
"eur": 2.28048,
"usd": 1.81171
},
"price_change_percentage_60d_in_currency": {
"btc": 0,
"eur": 60.98834,
"usd": 62.54292
},
"price_change_percentage_200d_in_currency": {
"btc": 0,
"eur": 148.68948,
"usd": 157.51875
},
"price_change_percentage_1y_in_currency": {
"btc": 0,
"eur": 138.20277,
"usd": 149.76989
},
"market_cap_change_24h_in_currency": {
"btc": -49432,
"eur": 28668703539,
"usd": 31172487848
},
"market_cap_change_percentage_24h_in_currency": {
"btc": -0.25084,
"eur": 2.31801,
"usd": 2.32219
},
"total_supply": 21000000,
"max_supply": 21000000,
"max_supply_infinite": false,
"circulating_supply": 19675377,
"outstanding_supply": null,
"last_updated": "2024-04-07T15:24:51.021Z"
},
"tickers": [
{
"base": "BTC",
"target": "USDT",
"market": {
"name": "Binance",
"identifier": "binance",
"has_trading_incentive": false
},
"last": 69816,
"volume": 19988.82111,
"converted_last": {
"btc": 0.99999255,
"eth": 20.441016,
"usd": 69835
},
"converted_volume": {
"btc": 19783,
"eth": 404380,
"usd": 1381537193
},
"trust_score": null,
"bid_ask_spread_percentage": 0.010014,
"timestamp": "2024-04-07T15:23:02+00:00",
"last_traded_at": "2024-04-07T15:23:02+00:00",
"last_fetch_at": "2024-04-07T15:24:00+00:00",
"is_anomaly": false,
"is_stale": false,
"trade_url": "https://www.binance.com/en/trade/BTC_USDT?ref=37754157",
"token_info_url": null,
"coin_id": "bitcoin",
"target_coin_id": "tether",
"coin_mcap_usd": 230926944910.5146
}
]
}