# Polyrank

> Polyrank is the skill-analytics layer for Polymarket prediction markets. It ranks ~2.8M wallets by genuine forecasting SKILL — calibration (Brier), alpha-vs-mid, information coefficient, risk-adjusted return — not vanity P&L or win rate. The thesis: "copy the skilled, not the lucky." Win rate and P&L lie; calibration doesn't.

Polyrank computes 57 skill metrics across 3+ years of on-chain Polymarket (Polygon) data. Humans use it to find traders worth copying and to read smart-money consensus on any market. AI agents use it as a trusted, queryable measure of which wallets and signals have edge.

## Free public API (no auth, JSON, cached)
- Leaderboard (top traders by composite skill): https://api.polyrank.app/v1/public/leaderboard?preset=polyrank-default&limit=25
- Trader skill profile: https://api.polyrank.app/v1/public/trader/{address}
- Trader calibration (reliability bins): https://api.polyrank.app/v1/public/trader/{address}/calibration
- Market consensus vs market mid + top holders: https://api.polyrank.app/v1/public/market/{conditionId-or-slug}
- Live pulse (big wins, sharp-money moves, biggest recent trades, trending markets, consensus divergence): https://api.polyrank.app/v1/public/pulse
- Platform totals: https://api.polyrank.app/v1/stats/overview

## For AI agents — paid per-request via x402
Polyrank offers a pay-per-request "Agent" tier priced in USDC on Base using the x402 protocol (HTTP 402 + EIP-3009 transferWithAuthorization, Coinbase's agent-payment standard). No subscription: an agent calls an endpoint, receives a 402 with payment requirements, signs the USDC authorization, and retries. This unlocks deep skill signals (full Brier decomposition, alpha, smart-money positioning) for autonomous trading/research agents.
- Agent base URL: https://api.polyrank.app
- Payment: USDC on Base (x402 "exact" scheme).
- Pricing: https://polyrank.app/pricing

## MCP server (Model Context Protocol)
Polyrank ships an MCP server so any LLM agent (Claude, etc.) can call Polyrank tools directly — get_leaderboard, get_trader_skill, get_trader_calibration, get_market_consensus, get_pulse. It wraps the free public API; premium signals are billed via x402. See the @polyrank/mcp package / https://polyrank.app/pricing.

## Key pages
- Leaderboard: https://polyrank.app/leaderboard
- Pricing (Trader + Builder tiers + x402 Agent): https://polyrank.app/pricing

## What the metrics mean
- Calibration / Brier score: how well a wallet's predicted probabilities match reality — the core skill signal Polyrank ranks on.
- Alpha-vs-mid: a wallet's edge over the market price at entry.
- Information coefficient, Sharpe/Sortino/Calmar, Kelly adherence, contrarian alpha: risk- and edge-adjusted skill measures.
- Win rate, P&L, volume: commodity numbers — shown, but explicitly NOT how Polyrank ranks skill.

## Disclaimers
Polyrank is not affiliated with Polymarket, is not investment advice, and is not custodial. Every number traces to a public Polygon transaction.