查詢目標代幣的 API ID

在調用 CoinGecko API 之前,必須先知道目標代幣的 API ID。不同的代幣有唯一的標識符,API 需要通過這個 ID 來查詢數據。

如何獲取 API ID

  1. 訪問 CoinGecko 官網:進入 CoinGecko 官方網站
  2. 搜索目標代幣:在搜索框中輸入代幣名稱,例如“Bitcoin”或“Ethereum”。
  3. 查看詳情頁:點擊進入代幣詳情頁,頁面 URL 中的最后部分即為該代幣的 API ID。例如,比特幣的 API ID 為 bitcoin,以太坊為 ethereum

獲取 API ID 示例

通過這一過程,您可以準確獲取目標代幣的唯一標識符,為后續的 API 調用做好準備。

測試 CoinGecko API

在正式將 API 集成到項目中之前,建議先通過 CoinGecko 提供的在線 API 文檔測試接口是否能夠正確返回數據。

使用 API 文檔進行測試

  1. 訪問 API 文檔:前往 CoinGecko API 文檔
  2. 選擇測試接口:找到需要測試的接口,例如 /simple/price
  3. 填寫參數:輸入目標代幣的 API ID (如 bitcoin)和目標法幣(如 usd)。
  4. 執行測試:點擊“Execute”按鈕,查看返回的數據。

返回結果示例:

{
  "bitcoin": {
    "usd": 25000.0
  }
}

API 測試示例

通過這種方式,可以確保 API 能夠正常工作,并驗證參數設置的正確性。

在項目中調用 CoinGecko API

將 CoinGecko API 集成到項目中,需要使用 HTTP 客戶端(如 Axios)發送請求,并處理返回的數據。

使用 Axios 調用 API

以下是一個簡單的代碼示例,用于查詢比特幣的價格:

import axios from 'axios';

(async () => {
  const response = await axios.get('https://api.coingecko.com/api/v3/simple/price', {
    params: {
      ids: 'bitcoin',
      vs_currencies: 'usd',
    },
  });

  console.log(比特幣當前價格:$${response.data.bitcoin.usd});
})();

注意事項

  1. 請求頻率限制:CoinGecko 的免費 API 每分鐘請求次數有限,請避免過于頻繁的調用。
  2. 錯誤處理:確保在代碼中添加錯誤處理邏輯,以應對網絡超時或錯誤參數。
  3. 數據緩存:為減少 API 請求次數,可以對數據進行本地緩存。

API 調用示例

封裝通用方法

為了提升代碼的可復用性,可以將 CoinGecko API 的調用封裝成一個通用方法。

示例代碼

import axios from 'axios';

interface TokenInfo {
  ids: string;
}

type TokenName = 'BTC' | 'ETH';

const Tokens: Record = {
  BTC: { ids: 'bitcoin' },
  ETH: { ids: 'ethereum' },
};

export const getTokenPrice = async (tokenName: TokenName, vsCurrencies: string = 'usd') => {
  const response = await axios.get('https://api.coingecko.com/api/v3/simple/price', {
    params: {
      ids: Tokens[tokenName].ids,
      vs_currencies: vsCurrencies,
    },
  });

  return response.data[Tokens[tokenName].ids][vsCurrencies];
};

(async () => {
  const price = await getTokenPrice('BTC');
  console.log(比特幣價格:$${price});
})();

通過這種封裝方式,可以輕松擴展支持的代幣類型和法幣類型。

常見問題 (FAQ)

1. 如何獲取更多的代幣數據?

可以調用 /coins/list 接口,獲取所有支持代幣的完整列表及其 API ID。

2. CoinGecko API 是否支持歷史數據查詢?

是的,CoinGecko API 提供 /coins/{id}/market_chart 接口,可以查詢指定時間范圍內的歷史價格數據。

3. API 調用時遇到錯誤怎么辦?

檢查以下幾點:

4. 是否需要 API 密鑰?

CoinGecko API 的基礎功能是免費的,不需要 API 密鑰,但有請求頻率限制。

5. 如何提高 API 調用的效率?

通過以上內容,您可以輕松掌握 CoinGecko API 的使用方法,并將其集成到您的項目中。CoinGecko 提供的豐富數據不僅可以滿足實時查詢的需求,還可以用于構建更復雜的應用程序。

上一篇:

使用CoinGecko API 獲取所有加密貨幣的GitHub代碼庫

下一篇:

Cherry Studio 使用教程與全面指南
#你可能也喜歡這些API文章!

我們有何不同?

API服務商零注冊

多API并行試用

數據驅動選型,提升決策效率

查看全部API→
??

熱門場景實測,選對API

#AI文本生成大模型API

對比大模型API的內容創意新穎性、情感共鳴力、商業轉化潛力

25個渠道
一鍵對比試用API 限時免費

#AI深度推理大模型API

對比大模型API的邏輯推理準確性、分析深度、可視化建議合理性

10個渠道
一鍵對比試用API 限時免費