跳至主要内容

訂單簿

獲取訂單簿數據​

獲取特定市場結果嘅訂單簿。

端點： GET /api/v1/orderbook/{outcomeId}

路徑參數：

參數類型描述
outcomeIdstring唯一結果識別碼

代碼範例​

// 獲取訂單簿數據
const API_KEY = 'YOUR_API_KEY'
const BASE_URL = 'https://engine.xmarket.app/api/v1';

async function getOrderbook(outcomeId) {
  const response = await fetch(
    `${BASE_URL}/orderbook/${outcomeId}`,
    {
      headers: {
        'x-api-key': API_KEY,
        'Content-Type': 'application/json'
      }
    }
  );

  const orderbook = await response.json();
  return orderbook;
}

獲取價差​

獲取特定市場結果嘅訂單簿價差。

端點： GET /api/v1/orderbook/spread/{outcomeId}

路徑參數：

參數類型描述
outcomeIdstring唯一結果識別碼

最佳實踐​

  1. 輪詢頻率：唔好太頻繁輪詢；遵守速率限制
  2. 數據緩存：以適當嘅 TTL 緩存訂單簿數據
  3. 錯誤處理：優雅咁處理網絡錯誤同無效回應
  4. 價格驗證：驗證價格喺有效範圍內（0-1）
  5. 深度分析：落大單時考慮市場深度
  6. 實時更新：對於高頻更新，喺可用時考慮使用 WebSocket 連接

效能提示​

  • 使用分頁嚟限制回應大小
  • 為最近查看嘅市場緩存訂單簿數據
  • 對重試邏輯實施指數退避
  • 考慮並行聚合多個結果訂單簿
  • 監控速率限制標頭以避免節流

相關文檔​