Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.forevex.trade/llms.txt

Use this file to discover all available pages before exploring further.

Polymarket Account Analyzer 是一款 只读 的 Rust 工具:输入任意 Polymarket 钱包地址,从公开 Data API(及可选 Gamma、Goldsky 子图)拉取数据,生成结构化 AnalyzeReport JSON,并支持 命令行GET /analyze/:wallet。不涉及下单、签名或私钥。

快速开始

克隆仓库、编译、运行一次分析与本地 API。

产品能力

全市场类型

不限于 5 分钟市场:BTC/ETH 短线、1h、daily、事件、政治、体育等均可纳入统计。

多维报告

Lifetime、市场分布、价格分桶、UTC 活跃时段、交易模式、胜率与策略反推(rule_json + 伪代码)。

CLI + HTTP

analyze 输出 stdout 或 --outserve 提供 REST,便于前端或脚本集成。

可选 Postgres

报告缓存、raw / canonical 落库、对账摘要、榜单 GET /leaderboard(需数据库)。

你能得到什么

能力说明
分析引擎基于 Data API trades 主路径;可选子图赎回 / fills / PnL 与用户仓位
对账与血缘v0/v1 对账、quality_alert、报告内 provenance / data_lineage
报告模式默认内存 Data API;analytics.source = canonicalreport-from-canonical-run(PG 重放)
输出形态schema_version 2.x JSON;含 frontend 块(大单、持仓、最近成交等)供 UI 使用
非交易产品:不提供 CLOB 下单、Builder 归因或 Gasless Relayer。EOA / Safe 用户若要在链上交易,请使用 Polymarket Builder 文档 中的官方客户端与 Relayer 方案。

工作流程

1

提供钱包地址

CLI:analyze 0x…;HTTP:GET /analyze/0x…(路径参数勿对 0x 做多余编码)。
2

拉取公开数据

分页请求 Data API;按需叠加 Gamma 元数据、子图与可选 PG 持久化。
3

构建报告

聚合指标、模式检测、策略推断;写入缓存(若启用 Postgres)。
4

消费结果

CLI 打印或写文件;HTTP 返回 JSON;下游前端(如独立 Next 应用)可直接绑定字段。

上手步骤

1

获取源码

在 monorepo 中进入 polymarket-account-analyzer/(或克隆 Polymarket-Analyzer 仓库根目录)。
2

编译

cargo build --release,二进制名为 polymarket-account-analyzer
3

跑一次分析

cargo run --release -- analyze <wallet> --out report.json(可选 --config--with-subgraph 等)。
4

(可选)启动 API

cargo run --release -- serve --bind 127.0.0.1:3000,详见 API 参考

技术栈与仓库

Rust + Axum

tokio、reqwest(rustls)、serde、chrono、anyhow、clap 4;HTTP 服务 Axum 0.7。

配置与环境变量

config.toml + PAA_* 前缀环境变量;Docker Compose 与 DATABASE_URL 说明。

HTTP API

GET /analyze/:walletGET /leaderboard;查询参数与 CLI 标志对齐。

官方 Polymarket 文档

市场数据、子图与 Builder 程序(与本工具「只读分析」互补)。

下一步

快速开始

架构与数据流

配置参考

OpenAPI