Skip to content
●Polyrank

Developers · API & MCP

Polyrank in your agent.

REST API, webhooks, pay-per-call x402, and an MCP server with 26 tools, Lab included.

Install in one line

claude mcp add polyrank -- npx -y @polyrank/mcp

With a key for the Builder and the Lab: claude mcp add polyrank -e POLYRANK_API_KEY=pk_live_… -- npx -y @polyrank/mcp

The MCP server’s Strategy Lab tools need an API key and a paid plan. The read and rank tools work without one. Create a key on the API keys page.

  • MCP server

    26 tools for Claude, Cursor and any MCP client: rankings, traders, markets, the Builder and the Strategy Lab.

  • REST API

    Boards, traders, markets and metrics. Public routes need no key; the full metric grid takes one.

  • Webhooks

    Signed deliveries to your endpoint when a market resolves or smart money moves.

  • x402 pay-per-call

    Agents pay per request instead of holding a key.

A live response

GET https://api.polyrank.app/v1/public/leaderboard?preset=polyrank-default&limit=1

{
  "preset": "polyrank-default",
  "served_preset": "polyrank-default",
  "rows": [
    {
      "rank": 1,
      "tid": "CHa3HWEoiMcJGA7NMppPOZfulsORmvpZonDr8fLiUSM",
      "wallet_label": "0x0b…dd",
      "wallet_count": 1,
      "display": {
        "username": "Fe…er",
        "pseudonym": "Ki…ox",
        "profile_image": "https://polymarket-upload.s3.us-east-2.amazonaws.com/profile-image-4677806-b0ec7b8c-a8ab-4ccb-91c1-5be8d04fd1de.png",
        "verified": false
      },
      "composite_score": 99.0279,
      "total_pnl": 113364.5777161549,
      "win_rate_pct": 80.82295205738015,
      "lifetime_volume_usdc": 2789084.452868,
      "trade_count": 21250,
      "calibration_excess_z": -1.7247939764519467,
      "calibration_excess_z_pctile": 96.62760925292969,
      "profit_per_dollar_risked": 2.678900607908843,
      "return_on_avg_capital": 10.129688514181696,
      "pnl_net_usdc": 98752.9662771549,
      "roi_net": 0.07234666969553977,
      "prediction_accuracy_pct": 56.73624288425047,
      "prediction_n": 2635,
      "prediction_avg_price": 0.5478495115612637
    }
  ],
  "total_cohort": 1009,
  "eligible_universe": 3253633,
  "snapshot_age_seconds": 57867,
  "definition": {
    "weights": [
      {
        "id": "hit_rate_vs_implied",
        "name": "Hit rate vs implied",
        "window": "lifetime",
        "weight_pct": 53
      },
      {
        "id": "profit_concentration_top1",
        "name": "Top-1 profit share",
        "window": "lifetime",
        "weight_pct": 27
      },
      {
        "id": "profit_factor",
        "name": "Daily profit factor",
        "window": "lifetime",
        "weight_pct": 20
      }
    ],
    "filters": [
      {
        "label": "Min resolved markets",
        "value": "50"
      },
      {
        "label": "Min lifetime volume",
        "value": "$10,000"
      },
      {
        "label": "Min realized P&L",
        "value": "$500"
      },
      {
        "label": "Min profit factor",
        "value": "1.05"
      },
      {
        "label": "Active within",
        "value": "30d"
      },
      {
        "label": "Top 20% by",
        "value": "Brier skill score"
      },
      {
        "label": "Top 35% by",
        "value": "Hit rate vs implied"
      },
      {
        "label": "Median entry price",
        "value": "≥ 0.03"
      }
    ]
  }
}

A real response, read 5 Nov 2026, 18:18 UTC. Wallets are masked on public routes.

The 26 MCP tools

@polyrank/mcp is a stdio Model Context Protocol server. The Lab tools that create something (a strategy, a backtest, a paper run) are the only ones that write; every other tool only reads. Nothing places orders or moves money, and every Lab result is simulated.

No key · 17

Rankings, traders by masked id, markets, the pulse, weekly reports, the metric catalog.

  • polyrank_get_leaderboard
  • polyrank_get_trader_skill
  • polyrank_get_trader_calibration
  • polyrank_get_market_consensus
  • polyrank_get_pulse
  • polyrank_get_platform_stats
  • polyrank_get_top_roi_trades
  • polyrank_get_movers
  • polyrank_get_smart_money_reports
  • polyrank_get_smart_money_report
  • polyrank_get_trader_by_tid
  • polyrank_get_trader_calibration_by_tid
  • polyrank_get_custom_ranking
  • polyrank_get_traders_batch
  • polyrank_get_metrics_catalog
  • polyrank_get_metric_windows
  • polyrank_list_ranking_templates

With an API key · 3

The Ranking Builder on any of the 84 metrics, per-window trader metrics, a masked id resolved.

  • polyrank_resolve_tid
  • polyrank_rank_wallets
  • polyrank_get_trader_metrics

Strategy Lab · key + paid plan · 6

Templates, strategies, backtests and paper runs. Simulated results, not advice.

  • polyrank_list_lab_templates
  • polyrank_create_strategy
  • polyrank_run_backtest
  • polyrank_get_backtest
  • polyrank_start_paper
  • polyrank_get_paper_run

Every tool’s inputs and outputs in the docs →