UAT 測試指南
本次用戶驗收測試（UAT）旨在於受控沙盒環境（api-uat.habittrade.com）驗證 Habittrade 交易 API 的核心功能。目標是確保交易訂單生命週期——包括下單、部分成交、全部成交、拒單及查詢——在不同市場（加密貨幣、美股、港股）下均能如預期運作。
模擬撮合引擎根據預設規則，依據輸入數量值返回一致的回應。這讓測試人員可驗證各種訂單狀態行為，例如：
- 新建 / 待成交
- 部分成交
- 全部成交
- 拒單
測試案例包括：
- 建立訂單（
POST /trade/v1/orders） - 撤銷訂單
- 查詢有效及歷史訂單
- 預估可買/可賣數量
- 簽名驗證與錯誤處理
認證需使用 API Key、Timestamp 及 HMAC 簽名標頭。所有端點均遵循 RESTful 原則，明確版本管理，可通過 cURL、Postman 或 SDK 集成。
本次 UAT 確保系統穩定、可預測並準備好上線，讓開發者、合作夥伴及 QA 團隊能有信心模擬真實交易行為。
✅ 市場標識
| 市場 | 標的範例 | 備註 |
|---|---|---|
| 香港 | 00700 | 騰訊控股 |
| 美股 | AAPL | 蘋果公司 |
| 加密貨幣 | DODO-USDT | 幣對 |
下單測試請使用上述標的。
📋 訂單場景與預期回應
1. 訂單提交（待成交）
✅ 預期：
status = new
| 數量 | 價格 | 預期結果 |
|---|---|---|
| 100 | 任意 | 訂單已提交 |
| 1000 | 任意 | 訂單已提交 |
| 0.1 | 任意 | 訂單已提交，僅美股市場 |
| 0.01 | 任意 | 訂單已提交，僅美股市場 |
測試範例：
bash
curl --location --request POST 'https://api-uat.habittrade.com/trade/v1/orders' \
--header 'X-API-Key: YOUR_API_KEY' \
--header 'X-API-Signature: YOUR_GENERATED_SIGNATURE' \
--header 'X-API-Timestamp: 1746774142' \
--header 'Content-Type: application/json' \
--data-raw '{
"market": "hkex",
"order_type": "enhanced_limit_order",
"symbol": "00700",
"order_side": "buy",
"price": 423.83,
"qty": 1000
}'2. 部分成交（1 筆成交記錄）
✅ 預期：
status = partially_filled，回應含 1 筆成交明細
| 數量 | 價格 | 預期結果 |
|---|---|---|
| 200 | 任意 | 部分成交（1 筆） |
| 2000 | 任意 | 部分成交（1 筆） |
| 0.2 | 任意 | 部分成交（1 筆），僅美股市場 |
| 0.02 | 任意 | 部分成交（1 筆），僅美股市場 |
3. 拒單（無效訂單）
❌ 預期：
status = rejected，回應含錯誤訊息
| 數量 | 價格 | 預期結果 |
|---|---|---|
| 300 | 任意 | 拒單（無效訂單） |
| 3000 | 任意 | 拒單（無效訂單） |
| 0.3 | 任意 | 拒單（無效訂單），僅美股市場 |
| 0.03 | 任意 | 拒單（無效訂單），僅美股市場 |
4. 部分成交（3 筆成交記錄）
✅ 預期：
status = partially_filled，回應含 3 筆成交明細
| 數量 | 價格 | 預期結果 |
|---|---|---|
| 400 | 任意 | 部分成交（3 筆） |
| 4000 | 任意 | 部分成交（3 筆） |
| 0.4 | 任意 | 部分成交（3 筆），僅美股市場 |
| 0.04 | 任意 | 部分成交（3 筆），僅美股市場 |
5. 全部成交（3 筆成交記錄）
✅ 預期：
status = filled，回應含 3 筆成交明細
| 數量 | 價格 | 預期結果 |
|---|---|---|
| 600 | 任意 | 全部成交（3 筆） |
| 6000 | 任意 | 全部成交（3 筆） |
| 0.6 | 任意 | 全部成交（3 筆），僅美股市場 |
| 0.06 | 任意 | 全部成交（3 筆），僅美股市場 |
🧪 測試矩陣範例
| 市場 | 標的 | 數量 | 預期結果 |
|---|---|---|---|
| 港股 | 00700 | 100 | 已提交 |
| 美股 | AAPL | 2000 | 部分成交（1 筆） |
| 幣安 | DODO-USDT | 3000 | 拒單 |
| 幣安 | ENJ-USDT | 4000 | 部分成交（3 筆） |
| 幣安 | DODO-USDT | 6000 | 全部成交（3 筆） |
🛠 其他提示
每筆測試請使用唯一的
reference_id以便追蹤。訂單可通過以下方式查詢：
GET /trade/v1/orders/{order_no}GET /trade/v1/orders
WebSocket 驗證時，請訂閱私人用戶頻道以獲取即時更新。