加密貨幣 API 演示

測試和了解加密貨幣 API 端點的工作原理 - 需要 API Key 認證

實時數據
API 端點正常運行
支援 {{ supportedCurrencies.length }} 種幣別
實時價格更新

認證方式

• 查詢參數方式：API Key 會自動添加到 URL 查詢參數中

• 格式：?apikey=YOUR_API_KEY

• 範例：/api/v1/cryptocurrencies/btc?currency=MYR&apikey=xxx

API 請求詳情

{{ apiRequestUrl }}
GET
Accept: application/json
X-API-Key: YOUR_API_KEY

API 回應結果

{{ apiResponse.success ? '成功' : '錯誤' }} 回應時間: {{ apiResponse.request_time }} 
{{ JSON.stringify(apiResponse, null, 2) }}

工作原理說明

1. 請求處理流程

  1. 接收 HTTP GET 請求到 /api/v1/cryptocurrencies/{symbol}?currency={currency}
  2. 驗證加密貨幣代碼是否存在於資料庫中
  3. 驗證目標幣別是否支援
  4. 從資料庫取得最新的價格數據
  5. 將 USD 價格轉換為目標幣別
  6. 格式化回應數據並返回 JSON

2. 數據來源

  • 價格數據: 來自 CoinGecko API，每 5 分鐘自動更新
  • 幣別轉換: 使用實時匯率進行 USD 到目標幣別的轉換
  • 加密貨幣資訊: 從本地資料庫取得基本資訊和圖標

3. 回應字段說明

字段 類型 說明
name string 加密貨幣名稱
symbol string 加密貨幣代碼
base_currency string 基礎幣別 (USD)
base_price string USD 價格
currency string 目標幣別
price string 轉換後的價格
change float 24小時價格變化百分比
last_updated string 最後更新時間 (ISO 8601)