說明與格式

匯入格式、真實資料來源與常見狀況。

Zip 檔案結構

run_folder/
  manifest.json
  config.json
  metrics.json
  equity_curve.csv
  trades.csv
  orders.csv
  fills.csv
  positions.csv
  symbol_summary.csv
  cost_summary.csv
  candidate_snapshot.csv
  notes.md
  attachments/

manifest.json 範例

{
  "schema_version": "1.0",
  "run_id": "bitget_20260507_readonly_001",
  "title": "Bitget 唯讀下單紀錄匯入",
  "exchange": "bitget",
  "market_type": "perp",
  "base_currency": "USDT",
  "initial_capital": 100000,
  "start_time": "2026-05-07T18:30:00+08:00",
  "end_time": "2026-05-07T23:59:00+08:00",
  "data_source": "bitget_api_v2"
}

orders.csv 欄位

order_id,trade_id,symbol,side,order_type,order_time,status,price,qty,filled_qty,reduce_only,position_effect,parent_order_id

fills.csv 欄位

fill_id,order_id,trade_id,symbol,side,fill_time,price,qty,notional,fee,fee_currency,liquidity,reduce_only,position_effect,realized_pnl,order_time

Bitget 唯讀 API 匯入

POST /api/bitget/import-readonly
GET /api/bitget/recorded-data

只會計入 2026-05-07 18:30 Asia/Taipei 之後的訂單與成交。請使用只有讀取權限的 Bitget API key。

常見狀況

缺少 manifest.json、config.json 或 metrics.json 時，Zip 匯入會停止。
run_id 重複時會停止匯入，避免覆蓋舊資料。
2026-05-07 18:30 +08:00 之前的資料不會計入核心統計；若是檔案匯入，會保留在原始檔或列入匯入問題。
成交資料若有 order_time，系統會優先用 order_time 判斷是否落在計入時間之後。
前台若一直載入，請到「設定」確認前台 API_BASE_URL 是否指到正確的後端 /api 網址。