概述快取策略連接池批次操作查詢優化壓縮技術異步模式效能指標基準測試優化建議

API文件

API效能優化與延遲降低

透過Smart Money API實現低於100毫秒的回應時間。掌握快取、連接池、批次操作及查詢優化以達到最大吞吐量。

發佈於2026年3月21日 • 17分鐘閱讀 • 效能

效能概述

Smart Money API專為低延遲與高吞吐量優化。透過在整合端實施建議模式以達到最佳效能。

效能優化層面：

快取 — 本地與CDN快取減少原始請求
連接池 — 重用連接，降低開銷
批次操作 — 將多個請求合併為單一請求
查詢優化 — 僅請求所需數據
異步/並行 — 同時處理多個請求

效能目標： P95延遲<100毫秒，P99<500毫秒，99.9%正常運行時間且錯誤率低於0.1%。

快取策略

回應快取

本地快取
// 遵循Cache-Control標頭
const cache = new Map();
async function cachedFetch(url) {
  const cached = cache.get(url);
  if (cached && !cached.isExpired) {
    return cached.data;
  }
  const response = await fetch(url);
  const ttl = parseCacheControl(response.headers);
  cache.set(url, { data: response, expiry: ttl });
  return response;
}

快取失效

鯨魚累積數據：5分鐘TTL
資金費率：1分鐘TTL
OHLCV數據：1小時TTL
歷史數據：24小時TTL

30秒內取得您的API金鑰

準備開始開發？立即獲取免費API金鑰（每日100次呼叫，無需綁卡），開始提取即時鯨魚數據、資金費率及鏈上數據。

取得您的API金鑰 →

連接池

HTTP連接重用

連接池
// Node.js HTTP Agent with pooling
const http = require('http');
const https = require('https');
const httpAgent = new http.Agent({
  keepAlive: true,
  maxSockets: 50,
  maxFreeSockets: 10
});
const httpsAgent = new https.Agent({
  keepAlive: true,
  maxSockets: 50,
  maxFreeSockets: 10
});
// 在請求中使用agent
fetch(url, { agent: httpsAgent });

連接設定

參數	建議值	原理
maxSockets	50-100	平衡並發與資源使用
maxFreeSockets	10-20	保留空閒連接以供重用
keepAliveTimeout	60000毫秒	匹配伺服器超時設定

批次操作

合併請求

批次查詢
// 取代多個請求
// GET /whales?asset=BTC
// GET /whales?asset=ETH
// GET /whales?asset=SOL
// 使用單一批次請求
GET /v1/whales?asset=BTC,ETH,SOL
// 相比3次連續請求節省約200毫秒

批次限制

每請求最大交易對數：100
最大時間範圍：365天
最大結果數：10,000筆

查詢優化

請求優化

指定字段 — 僅請求必要字段
使用篩選器 — 透過篩選減少回應大小
分頁 — 使用limit參數而非offset
時間範圍 — 僅請求所需數據

優化查詢
// 低效率：大量數據
GET /v1/whales?lookback=90d&limit=10000
// 高效率：特定數據
GET /v1/whales?
  asset=BTC&
  metric=accumulation&
  lookback=7d&
  limit=100

回應壓縮

Gzip壓縮

請求壓縮
// 在請求中啟用壓縮
fetch(url, {
  headers: {
    'Accept-Encoding': 'gzip, deflate'
  }
});
// API 在支援時會自動壓縮
// 典型壓縮效果：減少 70-80% 體積

壓縮節省

資料類型	未壓縮	已壓縮	節省量
JSON 回應	500KB	85KB	83%
大型表格	2MB	350KB	82%

非同步/平行模式

並行請求

平行請求
// 低效：順序執行
const btc = await fetch('/whales/BTC');
const eth = await fetch('/whales/ETH');
const sol = await fetch('/whales/SOL');
// 總耗時：約 300ms
// 高效：平行執行
const [btc, eth, sol] = await Promise.all([
  fetch('/whales/BTC'),
  fetch('/whales/ETH'),
  fetch('/whales/SOL')
]);
// 總耗時：約 100ms (快 3 倍！)

效能指標

關鍵指標

指標	目標	測量值
P50 延遲	<50ms	中位數回應時間
P95 延遲	<100ms	95 百分位數
P99 延遲	<500ms	99 百分位數
吞吐量	>1000 req/s	每秒請求數

監控效能

效能監控
// 追蹤回應時間
const start = performance.now();
const response = await fetch(url);
const duration = performance.now() - start;
// 記錄供分析
console.log(`請求耗時 ${duration}ms`);

基準測試

負載測試

對整合進行基準測試以識別瓶頸：

工具：Apache Bench、wrk 或 Locust
以實際並發量級測試
測量延遲分佈，而非僅平均值
測試快取熱啟動與冷啟動

優化建議

快速改善

啟用 HTTP 連線池 (提升 1-5 倍)
實作本地快取 (重複請求提升 10-50 倍)
使用批次操作 (減少 2-5 倍請求量)
啟用 gzip 壓縮 (減少 3-5 倍頻寬)

進階優化

對歷史資料實作 CDN 快取
使用資料庫連線池進行本地快取
實作斷路器模式
對大型資料集使用串流回應

實現最高效能

Smart Money API 為速度而生。實作這些優化策略可達到低於 100ms 延遲與最大吞吐量。

查看效能等級

Pro 與 Enterprise 方案包含進階快取與效能功能。