查詢目標代幣的 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 調用做好準備。

測試 CoinGecko API

在正式將 在線 API 文檔測試接口是否能夠正確返回數據。

使用 API 文檔進行測試

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

返回結果示例：

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

通過這種方式，可以確保 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 請求次數，可以對數據進行本地緩存。

封裝通用方法

為了提升代碼的可復用性，可以將 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 調用時遇到錯誤怎么辦？

檢查以下幾點：

• 確保 API ID 和參數拼寫正確。
• 檢查網絡連接是否正常。
• 遵守 API 請求頻率限制。

4. 是否需要 API 密鑰？

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

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

• 使用多線程或異步請求。
• 對數據進行本地緩存，減少重復請求。

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