SDK & Quickstart

Start building in minutes

拿一个 key,设一个环境变量,就能从任意脚本/代理/自动化调用 EasyQuant 的开放端点。 以下是 SDK / CLI 示例与端点参考。

Step 1 — 拿一个 API key

登录后自助签发(开发环境有演示 key:easyquant-demo-2026)。

Manage API keys
Python SDK(requests 即可,无重依赖)
import os, requests

API = "https://api.easyquanttrading.com"
KEY = os.environ["EASYQUANT_API_KEY"]   # 或从 /api/dev/keys 签发

def audit_strategy(payload: dict) -> dict:
    r = requests.post(
        f"{API}/api/audit/strategy",
        headers={"X-API-Key": KEY},
        json=payload,
        timeout=60,
    )
    r.raise_for_status()
    return r.json()

if __name__ == "__main__":
    report = audit_strategy({
        "name": "breakout_v3",
        "dataset": "XAUUSD_H1",
        "parameter_count": 6, "trials": 500,
        "in_sample":  {"sharpe": 2.8, "max_drawdown": 0.12, "trade_count": 400, "bars": 3000},
        "out_of_sample": {"sharpe": 0.4, "max_drawdown": 0.30, "trade_count": 120, "bars": 1000},
        "is_walk_forward": False,
    })
    print(report["overall_verdict_cn"], report["combined_risk_score"])
CLI(curl + jq)
# 设一次环境变量,到处可用
export EASYQUANT_API_KEY=$(your_key_here)

# 健康 + 可观测状态
curl -s https://api.easyquanttrading.com/health | jq
curl -s https://api.easyquanttrading.com/api/status | jq '.queue'

# 审计一个策略
curl -s https://api.easyquanttrading.com/api/audit/strategy \
  -H "X-API-Key: $EASYQUANT_API_KEY" \
  -H "Content-Type: application/json" \
  -d @payload.json | jq '.overall_verdict_cn'
成本与限制
• 认证:X-API-Key 请求头(无 key → 403;余额不足 → 402)。
• 结算:审计端点按次计量(默认 1 积分/次),成功才扣。
• 幂等:/api/audit/strategy 为同步重算;可自行缓存。
• 诚实性:开发者工具是可信度/研究基础设施,不预测收益、
  不承诺利润、不担保本金。历史表现不代表未来。

Endpoint reference

  • POST/api/audit/strategyauth: X-API-Key可信度审计:过拟合 / 数据质量 / 样本内外衰减 / 防守门禁(DFS/PBO/OOS/CSCV)。
    curl -X POST https://api.easyquanttrading.com/api/audit/strategy \
      -H "Content-Type: application/json" \
      -H "X-API-Key: $EASYQUANT_API_KEY" \
      -d '{
        "name": "momentum_breakout_v3",
        "dataset": "XAUUSD_H1",
        "parameter_count": 6,
        "trials": 500,
        "in_sample":    {"sharpe": 2.8, "max_drawdown": 0.12, "trade_count": 400, "bars": 3000},
        "out_of_sample":{"sharpe": 0.4, "max_drawdown": 0.30, "trade_count": 120, "bars": 1000},
        "is_walk_forward": false
      }'
  • GET/healthauth: 服务健康探针(200=可用)。
    curl https://api.easyquanttrading.com/health
  • GET/api/statusauth: 公网可观测状态:API 健康 + 任务队列近 24h 失败率(SLA 目标 ≤5%)。
    curl https://api.easyquanttrading.com/api/status
  • GET/api/dev/docsauth: 机器可读开发者接入清单(SDK / CLI / 端点 / 示例)。
    curl https://api.easyquanttrading.com/api/dev/docs | jq .
  • GET/api/dev/keysauth: Bearer(登录会话)自助列出本人 API keys(脱敏)。
  • POST/api/dev/keysauth: Bearer(登录会话)自助签发新 API key(明文仅返回一次)。
  • DELETE/api/dev/keys/{key}auth: Bearer(登录会话)吊销本人 API key。
  • GET/api/system/isolationauth: 进程隔离 + 计算池 + 回测缓存状态(运维/透明度)。
    curl https://api.easyquanttrading.com/api/system/isolation
Developer tools are credibility & research infrastructure — not investment advice. Historical performance does not guarantee future results. Legal