Felo API PlatformFelo API Platform
全部 CoinGecko 端點
v0.2.0-beta
OpenAPI 3.1.0

依 ID 取得幣種資料

伺服器:https://openapi.felo.ai
用戶端程式庫

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 計費記錄為準。

路徑參數
  • id
    類型: string
    必填

    幣種 ID。 *參見 /coins/list

查詢參數
  • community_data
    類型: boolean
    已棄用

    包含社群資料。 已棄用:自 2026 年 8 月 28 日起不再生效;不再傳回 community_data 物件。

  • developer_data
    類型: boolean
    已棄用

    包含開發者資料。 已棄用:自 2026 年 8 月 28 日起不再生效;不再傳回 developer_data 物件。

  • dex_pair_format
    類型: string 列舉

    設為 symbol 可將 DEX 交易對的基礎貨幣與目標貨幣顯示為符號。 預設:contract_address

    值
    • contract_address
    • symbol
  • include_categories_details
    類型: boolean

    包含類別詳細資料。 預設:false

  • localization
    類型: boolean

    在回應中包含所有在地化語言。 預設:true

  • market_data
    類型: boolean

    包含市場資料。 預設:true

  • sparkline
    類型: boolean

    包含 7 天 sparkline 資料。 預設:false

  • tickers
    類型: boolean

    包含交易對資料。 預設:true

回應
  • 200
    類型: object · Response860C3Ae68Ea5_CoinsID

    幣種資料

    • additional_notices
      類型: array string[]
      必填

      其他聲明

    • asset_platform_id
      類型: string | null
      必填

      代幣資產平台 ID

    • block_time_in_minutes
      類型: number
      必填

      區塊鏈出塊時間(分鐘)

    • categories
      類型: array string[]
      必填

      代幣類別

    • country_origin
      類型: string
      必填

      原產國

    • description
      類型: object
      必填

      代幣說明

      • propertyName
        類型: string
    • detail_platforms
      類型: object
      必填

      詳細的代幣資產平台與合約地址

      • propertyName
        類型: object
        • contract_address
          類型: string

          代幣合約地址

        • decimal_place
          類型: integer | null

          代幣小數位數

    • genesis_date
      類型: string | null
      必填

      創世日期

    • has_supply_breakdown
      類型: boolean
      必填

      是否可透過 /coins/supply_breakdown 取得詳細的供應量明細資料

    • hashing_algorithm
      類型: string | null
      必填

      區塊鏈雜湊演算法

    • id
      類型: string
      必填

      代幣 ID

    • image
      類型: object
      必填

      代幣圖片 URL

      • large
        類型: string
      • small
        類型: string
      • thumb
        類型: string
    • last_updated
      類型: string
      必填

      最後更新時間戳記

    • 類型: object
      必填

      連結

      • announcement_url
        類型: array string[]

        公告 URL

      • bitcointalk_thread_identifier
        類型: integer | null

        Bitcointalk 討論串識別碼

      • blockchain_site
        類型: array string[]

        區塊瀏覽器 URL

      • chat_url
        類型: array string[]

        聊天 URL

      • facebook_username
        類型: string

        Facebook 使用者名稱

      • homepage
        類型: array string[]

        網站 URL

      • official_forum_url
        類型: array string[]

        官方論壇 URL

      • repos_url
        類型: object

        程式碼倉庫 URL

        • bitbucket
          類型: array string[]

          Bitbucket 倉庫 URL

        • github
          類型: array string[]

          GitHub 倉庫 URL

      • snapshot_url
        類型: string | null

        快照 URL

      • subreddit_url
        類型: string

        Subreddit 的 URL

      • telegram_channel_identifier
        類型: string

        Telegram 頻道識別碼

      • twitter_screen_name
        類型: string

        Twitter 使用者名稱

      • whitepaper
        類型: string

        白皮書 URL

    • market_cap_rank
      類型: integer | null
      必填

      市值排名

    • market_cap_rank_with_rehypothecated
      類型: integer | null
      必填

      包含再抵押代幣的市值排名

    • name
      類型: string
      必填

      代幣名稱

    • platforms
      類型: object
      必填

      代幣資產平台與合約地址

      • propertyName
        類型: string
    • preview_listing
      類型: boolean
      必填

      預覽上架代幣

    • public_notice
      類型: string | null
      必填

      公告

    • sentiment_votes_down_percentage
      類型: number | null
      必填

      看跌票數百分比

    • sentiment_votes_up_percentage
      類型: number | null
      必填

      看漲票數百分比

    • status_updates
      類型: array object[]
      必填

      狀態更新

      • category
        類型: string

        狀態更新類別

      • created_at
        類型: string

        狀態更新建立時間

      • description
        類型: string

        狀態更新說明

      • user
        類型: string

        狀態更新使用者

      • user_title
        類型: string

        狀態更新使用者職稱

    • symbol
      類型: string
      必填

      代幣符號

    • watchlist_portfolio_users
      類型: number
      必填

      在投資組合中追蹤此代幣的使用者數

    • web_slug
      類型: string
      必填

      代幣網頁 slug

    • categories_details
      類型: array object[]

      代幣詳細分類

      • id
        類型: string

        類別 ID

      • name
        類型: string

        類別名稱

    • ico_data
      類型: object | null

      ICO 資料

      • accepting_currencies
        類型: string

        接受的貨幣

      • amount_for_sale
        類型: number

        出售數量

      • base_pre_sale_amount
        類型: number

        基礎貨幣預售數量

      • base_public_sale_amount
        類型: number

        基礎貨幣公開販售數量

      • bounty_detail_url
        類型: string

        賞金詳細資料 URL

      • country_origin
        類型: string

        原產國

      • description
        類型: string

        詳細說明

      • hardcap_amount
        類型: number

        硬頂金額

      • hardcap_currency
        類型: string

        硬頂貨幣

      • ico_end_date
        類型: string

        ICO 結束日期

      • ico_start_date
        類型: string

        ICO 開始日期

      • kyc_required
        類型: boolean

        需要 KYC

      • links
        類型: object

        ICO 相關連結

        • propertyName
          類型: string
      • pre_sale_available
        類型: boolean

        可預售

      • pre_sale_end_date
        類型: string

        預售結束日期

      • pre_sale_ended
        類型: boolean

        預售已結束

      • pre_sale_start_date
        類型: string

        預售開始日期

      • quote_pre_sale_amount
        類型: number

        計價貨幣預售數量

      • quote_pre_sale_currency
        類型: string

        預售計價貨幣

      • quote_public_sale_amount
        類型: number

        計價貨幣公開販售數量

      • quote_public_sale_currency
        類型: string

        公開販售計價貨幣

      • short_desc
        類型: string

        簡短說明

      • softcap_amount
        類型: number

        軟頂金額

      • softcap_currency
        類型: string

        軟頂貨幣

      • total_raised
        類型: number

        募資總額

      • total_raised_currency
        類型: string

        募資總額貨幣

      • whitelist_available
        類型: boolean

        可加入白名單

      • whitelist_end_date
        類型: string

        白名單結束日期

      • whitelist_start_date
        類型: string

        白名單開始日期

      • whitelist_url
        類型: string

        白名單 URL

    • localization
      類型: object

      代幣名稱在地化

      • propertyName
        類型: string
    • market_data
      類型: object

      市場資料

      • ath
        類型: object

        以目標貨幣計價的歷史最高價

        • propertyName
          類型: number
      • ath_change_percentage
        類型: object

        歷史最高價變化百分比

        • propertyName
          類型: number
      • ath_date
        類型: object

        歷史最高價日期

        • propertyName
          類型: string
      • atl
        類型: object

        以目標貨幣計價的歷史最低價

        • propertyName
          類型: number
      • atl_change_percentage
        類型: object

        歷史最低價變化百分比

        • propertyName
          類型: number
      • atl_date
        類型: object

        歷史最低價日期

        • propertyName
          類型: string
      • circulating_supply
        類型: number

        流通供應量

      • current_price
        類型: object

        以目標貨幣計的當前價格

        • propertyName
          類型: number
      • fdv_to_tvl_ratio
        類型: number | null

        完全稀釋估值與總鎖定價值比

      • fully_diluted_valuation
        類型: object

        以目標貨幣計的完全稀釋估值

        • propertyName
          類型: number
      • high_24h
        類型: object

        以目標貨幣計的 24 小時最高價

        • propertyName
          類型: number
      • last_updated
        類型: string

        市場資料最後更新時間戳

      • low_24h
        類型: object

        以目標貨幣計的 24 小時最低價

        • propertyName
          類型: number
      • market_cap
        類型: object

        以目標貨幣計的市值

        • propertyName
          類型: number
      • market_cap_change_24h
        類型: number

        以目標貨幣計的 24 小時市值變動

      • market_cap_change_24h_in_currency
        類型: object

        以目標貨幣計的 24 小時市值變動

        • propertyName
          類型: number
      • market_cap_change_percentage_24h
        類型: number

        24 小時市值變動百分比

      • market_cap_change_percentage_24h_in_currency
        類型: object

        各貨幣的 24 小時市值變動百分比

        • propertyName
          類型: number
      • market_cap_fdv_ratio
        類型: number

        市值與完全稀釋估值比

      • market_cap_rank
        類型: integer | null

        市值排名

      • market_cap_rank_with_rehypothecated
        類型: integer | null

        包含再抵押代幣的市值排名

      • max_supply
        類型: number | null

        最大供給量

      • max_supply_infinite
        類型: boolean

        最大供給量無上限

      • mcap_to_tvl_ratio
        類型: number | null

        市值與總鎖定價值比

      • outstanding_supply
        類型: number | null

        市場上的流通代幣數量

      • outstanding_token_value_usd
        類型: number | null

        流通代幣價值(美元)

      • price_change_24h
        類型: number

        以目標貨幣計的 24 小時價格變動

      • price_change_24h_in_currency
        類型: object

        以目標貨幣計的 24 小時價格變動

        • propertyName
          類型: number
      • price_change_percentage_14d
        類型: number

        14 天價格漲跌幅

      • price_change_percentage_14d_in_currency
        類型: object

        各貨幣的 14 天價格漲跌幅

        • propertyName
          類型: number
      • price_change_percentage_1h_in_currency
        類型: object

        各貨幣的 1 小時價格漲跌幅

        • propertyName
          類型: number
      • price_change_percentage_1y
        類型: number

        1 年價格漲跌幅

      • price_change_percentage_1y_in_currency
        類型: object

        各貨幣的 1 年價格漲跌幅

        • propertyName
          類型: number
      • price_change_percentage_200d
        類型: number

        200 天價格漲跌幅

      • price_change_percentage_200d_in_currency
        類型: object

        各貨幣的 200 天價格漲跌幅

        • propertyName
          類型: number
      • price_change_percentage_24h
        類型: number

        24 小時價格漲跌幅

      • price_change_percentage_24h_in_currency
        類型: object

        各貨幣的 24 小時價格漲跌幅

        • propertyName
          類型: number
      • price_change_percentage_30d
        類型: number

        30 天價格漲跌幅

      • price_change_percentage_30d_in_currency
        類型: object

        各貨幣的 30 天價格漲跌幅

        • propertyName
          類型: number
      • price_change_percentage_60d
        類型: number

        60 天價格漲跌幅

      • price_change_percentage_60d_in_currency
        類型: object

        各貨幣的 60 天價格漲跌幅

        • propertyName
          類型: number
      • price_change_percentage_7d
        類型: number

        7 天價格漲跌幅

      • price_change_percentage_7d_in_currency
        類型: object

        各貨幣的 7 天價格漲跌幅

        • propertyName
          類型: number
      • roi
        類型: object | null

        投資報酬率

        • currency
          類型: string

          投資報酬率貨幣

        • percentage
          類型: number

          投資報酬率百分比

        • times
          類型: number

          投資報酬率倍數

      • sparkline_7d
        類型: array number[]

        7 天 sparkline 價格資料

      • total_supply
        類型: number

        總供給量

      • total_value_locked
        類型: number | null

        總鎖定價值

      • total_volume
        類型: object

        以目標貨幣計的總交易量

        • propertyName
          類型: number
    • tickers
      類型: array object[]

      Ticker 資料

      • base
        類型: string

        Ticker 基礎貨幣

      • bid_ask_spread_percentage
        類型: number

        Ticker 買賣價差百分比

      • coin_id
        類型: string

        Ticker 基礎貨幣代幣 ID

      • coin_mcap_usd
        類型: number

        市值(美元)

      • converted_last
        類型: object

        Ticker 換算後最新價格

        • btc
          類型: number
        • eth
          類型: number
        • usd
          類型: number
      • converted_volume
        類型: object

        Ticker 換算後成交量

        • btc
          類型: number
        • eth
          類型: number
        • usd
          類型: number
      • is_anomaly
        類型: boolean

        Ticker 異常

      • is_stale
        類型: boolean

        Ticker 資料過舊

      • last
        類型: number

        Ticker 最新價格

      • last_fetch_at
        類型: string

        Ticker 最後擷取時間戳

      • last_traded_at
        類型: string

        Ticker 最後成交時間戳

      • market
        類型: object

        Ticker 交易所

        • has_trading_incentive
          類型: boolean

          交易所交易獎勵

        • identifier
          類型: string

          交易所識別碼

        • name
          類型: string

          交易所名稱

      • target
        類型: string

        Ticker 目標貨幣

      • target_coin_id
        類型: string

        Ticker 目標貨幣代幣 ID

      • timestamp
        類型: string

        Ticker 時間戳

      • token_info_url
        類型: string | null

        Ticker 代幣資訊 URL

      • trade_url
        類型: string

        Ticker 交易 URL

      • trust_score
        類型: string | null

        Ticker 信任分數

      • volume
        類型: number

        Ticker 成交量

    application/json
  • 400

    無法處理該要求。請檢查請求參數。

  • 401

    需要有效的 Felo API 金鑰。

  • 402

    由於未符合計費要求,要求無法繼續。

  • 403

    該帳戶無權執行此操作。

  • 429

    已達到要求或支出上限。

  • 502

    服務無法完成該要求。

  • 503

    API 或計費服務暫時無法使用。

  • 504

    服務在處理要求時逾時。

  • default

    錯誤回應;上游透傳回應可能採用供應商格式

    application/json
Request Example for get/v1/beta/coingecko/coins/{id}
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
    }
  ]
}
Coin Data by ID

需要協助嗎?