OpenQFR

OpenQFR

OpenQFR 是一个机器可读的量化策略失败证据库。它帮助研究 Agent 在花费算力进行另一次回测之前，检查是否已有类似想法失败。

QFR 记录是负面证据，不构成投资建议。OpenQFR 不提供交易信号、不下单，也不接受可执行文件上传。

在线端点

• REST API：https://openqfr.dev/api/v1
• QFR 记录：https://openqfr.dev/api/v1/failures
• Schema：https://openqfr.dev/schema/qfr/0.1.0
• 下一版本的 Schema 草案：https://openqfr.dev/schema/qfr/0.2.0-draft
• A2A Agent Card：https://openqfr.dev/.well-known/agent-card.json
• A2A 端点：https://openqfr.dev/a2a/v1/message:send

五分钟 REST 示例

curl -s 'https://openqfr.dev/api/v1/failures?symbol=BTCUSDT&limit=3'

from urllib.parse import urlencode
from urllib.request import urlopen
import json

query = urlencode({"symbol": "BTCUSDT", "limit": 3})
with urlopen(f"https://openqfr.dev/api/v1/failures?{query}") as response:
    failures = json.load(response)
print(failures["total"])

A2A 示例

curl -s https://openqfr.dev/a2a/v1/message:send \
  -H 'Content-Type: application/a2a+json' \
  -H 'A2A-Version: 1.0' \
  --data '{"message":{"messageId":"demo-1","role":"ROLE_USER","parts":[{"data":{"operation":"search","symbol":"BTCUSDT"}}]}}'

支持的操作包括 search、get 和 stats。

MCP

公开的无状态 Streamable HTTP 端点为：

https://openqfr.dev/mcp

它提供只读的 qfr_search、qfr_get 和 qfr_stats 工具。仓库还包含一个无需依赖项的 stdio 适配器，供不支持远程 MCP 的客户端使用。

python3 mcp_server.py

客户端配置示例：

{
  "mcpServers": {
    "openqfr": {
      "command": "python3",
      "args": ["/absolute/path/to/openqfr/mcp_server.py"]
    }
  }
}

提交安全

提交请求头和审核规则见 SUBMISSIONS.md。

签名提交内容会被隔离以供审核。内容必须符合 QFR 0.1.0-pilot，使用 Ed25519 签名，且只能包含失败证据；不得包含机密信息、凭据、个人数据、源代码或可执行内容。公开记录为只读。

项目状态

这是一个早期试点项目，已收录 100 条 BTCUSDT 量化失败记录。Schema 在 1.0 之前可能会发生变化。下一个里程碑是与独立 Agent 开发者开展小规模封闭 Alpha 测试。