API 文檔

SAGE REST API — 任何語言均可接入。Base URL: https://sage-api.wtechhk.com

認證

所有端點需 API Key。註冊後獲得，登入 Dashboard 查看。

# 所有請求帶上
X-API-Key: sk-your-key-here

端點

curl https://sage-api.wtechhk.com/health
→ {"status":"ok","version":"0.1.0","model_loaded":true}

curl -X POST https://sage-api.wtechhk.com/predict \
  -H "Content-Type: application/json" \
  -d '{"market":"US","lookback":120,"seq_len":60}'

→ {
  "weights":      [0.18, 0.15, 0.11, ...],   // 資產配置權重
  "risk":         [0.028, 0.022, 0.026, ...], // 預測風險
  "expected_return": [0.052, 0.038, 0.031, ...], // 預期收益
  "sharpe":       1.84,                       // Sharpe ratio
  "tickers":      ["NVDA","MSFT","AVGO",...]  // 股票代號
}

curl -X POST https://sage-api.wtechhk.com/signals \
  -H "Content-Type: application/json" \
  -d '{"market":"HK"}'

→ {
  "signals": [{
    "ticker":          "0700.HK",
    "price":           428.00,
    "action":          "🟢 強烈買入",
    "target_weight":   0.16,
    "expected_return": 0.045,
    "risk":            0.030,
    "confidence":      0.89
  }, ...],
  "summary": {
    "sharpe":          1.42,
    "buy_count":       6,
    "sell_count":      3,
    "risk_level":      "MEDIUM"
  }
}

curl https://sage-api.wtechhk.com/stats \
  -H "X-API-Key: sk-wangtry-xxx"

→ {"total_calls":1283, "plan":"hobby", "calls_limit":1000, ...}

curl -X POST https://sage-api.wtechhk.com/register \
  -H "Content-Type: application/json" \
  -d '{"username":"myapp","password":"secure123","refer_code":"ilovewtech"}'
→ {"username":"myapp","api_key":"sk-myapp-xxx","plan":"hobby","discount_pct":30}

參數說明

Python SDK

from sage import SagePredictor

predictor = SagePredictor(model_path="output/model.pth")
result = predictor.predict(market="US")
# result['weights'], result['risk'], result['sharpe']

signals = predictor.generate_signals(market="HK")
# signals → [{ticker, action, confidence, ...}]

Rate Limits