Skip to content

v2.1.1 — Polymarket CLOB V2 subgraphs + builder attribution

Choose a tag to compare

View all tags
@PaulieB14 PaulieB14 released this 08 Aug 21:04
· 1 commit to main since this release
v2.1.1
af89c4d

Adds Paul's four Polymarket CLOB V2 subgraphs alongside the existing V1 registry. 35 tools total — the v2.0.0 REST surface (Gamma + CLOB) is unchanged.

V1 and V2 are different eras, not old and new: the V2 subgraphs index from block 84902353 (the 2026-04-28 migration) and hold no earlier history, so all-time questions still belong on V1.

New — builder attribution

Every V2 fill carries the builder code of the frontend, bot or integrator that routed it. The V1 exchange contracts never emitted it, so this is new capability rather than a migration.

  • get_builder_leaderboard — rank builders by routed volume, orders or fees, with each one's share of V2 volume
  • get_builder_activity — recent fills for one builder code
  • get_v2_top_traders — top real V2 traders, exchange contracts excluded
  • check_subgraph_freshness — how far behind chainhead any subgraph is, read live from _meta

3,325 builders across $24B of V2 volume as of 2026-08-08.

Three traps handled for you

The exchange contracts look like traders. The V2 exchange is the taker when an order matches the book, so it accumulates an Account row. Ranking accounts naively returns 0xe111…996b (176M fills) and 0xe222…0f59 (41M) above every human by an order of magnitude. get_v2_top_traders filters them.

v2_main is ~86 days behind chainhead and catching up slowly. It answers queries — with mid-May data. Stale-not-broken is the dangerous case, so it carries a sync warning and check_subgraph_freshness measures it live rather than trusting a hardcoded date.

Three V1 deployments are no longer served on the network — beefy_pnl, resolution, traders. beefy_pnl is unreachable by deployment and subgraph id, and it backs get_account_pnl, get_top_traders, get_daily_stats and get_market_positions. This predates 2.1.x. The client now distinguishes "no indexer serves this" from "your query is wrong", so a model stops retrying a rewritten query into a wall.

beefy_pnl keeps metrics V2 P&L has no equivalent for — winRate, profitFactor, maxDrawdown, daily series — so trader-quality scoring stays pointed at V1 by design.

npm i graph-polymarket-mcp@2.1.1 · also on ClawHub

Assets 2
Loading