Skip to main content

Quant API — 量化回测与成果

原名 Kolect，2026-09-20 随统一平台改名收口。路径前缀 /v1/quant/*。

PropertyValue
框架Quart（异步 Flask）
Base URLhttps://api.eurybia.xyz
AuthX-API-Key（统一鉴权；策略/因子/产物按 quant_grants 租户能力包过滤）
数据PostgreSQL（twitter、quant_data）、ClickHouse
交互式参考Gateway OpenAPI

拓扑​

/v1/quant/*  → quant-api :1230（frontends，API 面合并 5 模块）
                 └─ 回测执行 → quant_api_backtests :1251（main-db，4 模块）

🗑️ 旧公网路径 /kolect/api/* 已随改名下线（现在返回 HTML 假 200，不可再调）。 过渡期公网直连 /quant/api/* 已下线（2026-09-25，返回 410，请直接切 /v1/quant/*）。

回测流程（向导式，前端依次调用）​

① GET /v1/quant/factors              # 选数据源：sentiment / volume
② GET /v1/quant/factors/{name}       # 拿可用代币 + 可用算法 + 数据变体
   GET /v1/quant/assets              # 全部可回测币种清单（有 alt data + 有 K 线）
③ POST /v1/quant/backtests           # 定参数回测（组件组合式 body）

③ 回测请求（组件组合式）​

curl -X POST https://api.eurybia.xyz/v1/quant/backtests \
  -H "X-API-Key: sk_..." \
  -d '{"strategy": {
        "strategyID": "...",
        "targetAsset": "BTC",
        "data": {"source": "sentiment", "scope": "collective"},
        "signal": {"model": "fixed_threshold",
                    "params": {"positiveThreshold": 0.2,
                                "negativeThreshold": 0.5,
                                "neutralThreshold": 0.8}},
        "execution": {"leverage": 1.0}}}'

# 预设快捷（兼容旧式）：strategyType 展开为默认组件组合
curl -X POST https://api.eurybia.xyz/v1/quant/backtests \
  -H "X-API-Key: sk_..." \
  -d '{"strategy": {"strategyID": "...", "strategyType": "sentiment_long_short",
                   "targetAsset": "BTC"}}'

当前可用组件（以动态查询为准）​

数据源变体可用代币可用算法
sentimentcollective（生产）；per_kol（规划中）21 币：ACT/AXS/BOME/BONK/BTC/DOGE/DOGS/ETH/FLOKI/MEME/NEIRO/ORDI/PEOPLE/PEPE/PNUT/SATS/SHIB/SOL/TURBO/WIF/XRPfixed_threshold（21 币均可）；fixed_threshold_tpsl（仅 BTC/ETH，引擎限制）
volumecollective（生产）BTC, ETHwindow_hold
memecollective / per_kol（均生产）MEME（推文级 1h 持有策略）meme_kol_hold

预设策略（GET /v1/quant/strategies 动态查询）：sentiment_long_short / sentiment_curated / mention_momentum / sentiment_risk_managed / hype_window。

资产白名单：fixed_threshold_tpsl（sentiment_risk_managed）引擎只支持 BTC/ETH，其他币返回 400 asset ... not allowed for sentiment_risk_managed；hype_window 的 targetAsset 必须为 MEME。

成果产品（每日更新，订阅制）​

端点内容
POST /v1/quant/artifacts/sentiment-collective-fixed-threshold-grid-scorescollective sentiment × fixed_threshold 参数寻优（各时间窗口最优阈值；body {"target_asset": "BTC"}；可选 as_of 查历史批次）
POST /v1/quant/artifacts/kol-leaderboardKOL 回测收益排行

产物命名约定：{data}-{scope}-{signal}-{类型}。订阅按具体产物单独开通。

过渡期别名：/v1/quant/grid-scores、/v1/quant/artifacts/grid-scores、/v1/quant/leaderboard 仍可用。

情绪因子（/v1/quant/factors/sentiment/compute）​

curl -X POST https://api.eurybia.xyz/v1/quant/factors/sentiment/compute \
  -H "X-API-Key: sk_..." \
  -d '{"cryptocurrency": "bitcoin", "time_window": "7d"}'
  • time_window 为 1h / 1d / 7d；返回 positive/negative/neutral 占比。
  • 旧 Kolect 直连的 Bearer 鉴权已取消——统一走网关 X-API-Key。

错误码​

状态码含义
403 strategy ... not in tenant capability策略未开通（用 /v1/quant/strategies 查可用）
403 ... requires subscription成果产品未订阅
400 unknown data source ...数据源不存在（用 /v1/quant/factors 查目录）
400 asset ... not available for ...该数据源没有这个代币
400 signal model ... not available for ...该数据源不支持这个算法
400 scope ... not open yet数据变体未开放（如 per_kol）