polyscopebeta

api

Public REST endpoints. JSON only. No auth required for read access. Base URL https://polyscope.gudman.xyz.

signals
GET/api/divergences

Currently active counter-consensus signals. Each signal includes market price, top-trader weighted consensus, and a predictive_contributor when one clears the quality gate; full contributors are on the evidence endpoint.

try it →
GET/api/divergences/history

Resolved signals with outcome scoring. Used by the on-chain track-record tile.

params
  • limitint= 50— max rows, ≤ 200
try it →
GET/api/signals/evidence/{market_id}

Full evidence trail for the latest signal on a market — per-trader contributions with their accuracy, skew-band hit rate, category hit rate.

try it →replace {...} with a real id
traders
GET/api/traders/leaderboard

Per-trader accuracy ranking. The flagship endpoint — what /traders renders.

params
  • orderstring= predictive— predictive | anti-predictive
  • min_signalsint= 10— minimum resolved-signal count for inclusion
  • limitint= 100— max rows, ≤ 500
try it →
GET/api/traders/{address}

Trader profile — overall accuracy + breakdowns by skew band and category, plus Wilson 95% CI.

try it →replace {...} with a real id
GET/api/smart-money/leaderboard

Polymarket's native P&L leaderboard, surfaced for comparison. Not what we rank by.

try it →
markets · activity
GET/api/markets

Active markets with prices, volume, open interest. Optional category filter.

params
  • limitint= 50— max rows, ≤ 200
  • offsetint= 0— pagination offset
  • categorystring— filter by category substring
try it →
GET/api/market/{condition_id}

Single market detail + active divergence (if any) + price history + signal history.

try it →replace {...} with a real id
GET/api/whale-flow

Recent large-size top-trader entries. Empty until tracked leaderboard addresses transact.

try it →
validation
GET/api/calibration

Brier scores and calibration breakdown by category. Used by /calibration.

try it →
GET/api/methodology/stats

Live dataset stats: signal counts, skew breakdown, predictive-filter performance vs unfiltered baseline. Cached 10 min.

try it →
builder · attribution
GET/api/builder/identity

Public Builder Code (bytes32) used for Polymarket order attribution.

try it →
GET/api/orders/config

Whether the deployment has trading wired (builder code + max order cap).

try it →
GET/api/builder/trades/public

On-chain settled trades attributed to PolyScope's Builder Code. Empty until users route orders through the trade UI.

try it →
notes
  • All amounts in USD. Prices are 0-1 (probability). Percent fields named _pct are already × 100.
  • Wilson 95% CI bounds (when present) are returned as percentages, not 0-1 fractions.
  • Lists are stable-ordered by the metric the endpoint advertises (rank, accuracy, divergence). Pagination via limit / offset where applicable.
  • Rate limits are not enforced today; soft limit on caching is 60s for divergences, 300s for stats. Clients should respect that.

Need an endpoint that isn't listed? methodology →