Live — keys for Pro

CopyGrade Scores. Farming flags. Verdicts. Over HTTPS.

A small, well-shaped API for builders shipping copy-trading bots, analyst dashboards, or research notebooks who want CopyGrade's verdicts programmatically — not via a screen. Pro subscribers mint keys in Account → API access; each key carries its own quota of 1,000 calls a day.

Live today, no key needed: GET /api/v1/wallets/{address} returns a wallet's score, verdict, sub-scores, farming level and post-fee edges from a per-IP budget, /api/v1/wallets/copyable and /api/v1/wallets/screen answer list questions, and the MCP server at /api/mcp gives AI agents the same reads as tools. A Pro key, sent as a Bearer header, moves any of them onto the key's own quota.

Get a key Connect an agent

Live today

GET/api/v1/wallets/{address}

CopyGrade Score by wallet

The full 0–100 score, verdict band, sub-scores, farming level and post-fee edges for one Polymarket wallet — the same numbers the verdict page renders. 404 means the index has not reached the address yet.

GET/api/v1/wallets/copyable

The copyable shortlist

Every graded wallet clearing the shortlist bar — farming-clean, Candidate band or better, active in the last 30 days — with the graded total as the denominator.

GET/api/v1/wallets/screen

Screen the index

Ranked graded wallets under verdict, farming, minimum-score, category and active-30d filters — the Scout table as JSON.

POST/api/mcp

MCP server

The same reads, plus a fee-and-latency-adjusted copy replay, as Model Context Protocol tools for Claude, ChatGPT, Cursor or your own agent.

Planned — what the waitlist is for

POST/v1/wallets/score:batch

Batch scoring

Submit up to a few hundred wallet addresses in one call. Returns the score-and-verdict shape per address. Built for nightly leaderboard rebuilds.

POST/v1/webhooks/farming

Webhook on farming flag

Subscribe a URL; we deliver a signed POST when a covered wallet trips a watch or severe finding. The same trigger that fires the in-app alert.

GET/v1/watchlist

Watchlist sync

Read and mutate the signed-in user's CopyGrade watchlist from your own surface. Keeps an external dashboard or terminal in lockstep with the app.

Planned routes are indicative. Final shapes are locked when each one ships.

Status

Three read endpoints, the MCP server and Pro keys are live. Batch scoring, webhooks and watchlist sync are not.

Every read answers with no key from a per-IP budget of 200 calls a day. A Pro key, minted in Account → API access and sent as a Bearer header, moves the caller onto the key's own quota of 1,000 calls a day, spent atomically. The planned endpoints below are what the waitlist is now for.

Wiring the MCP server into Claude, ChatGPT, Cursor or your own agent takes one line — the connect instructions, the tool schema and an example response are on the MCP page.

Get on the list

Tell us what you'd build next.

Leave your email and we’ll notify you when batch scoring, webhooks or watchlist sync ship — that’s the only thing it’s used for. A line on what you’d build is optional but decides which of the three comes first.

Already a subscriber?

Pro accounts can mint a key now — Account → API access. You only need this form for the planned endpoints.

Pricing

Flat monthly fee, not per-call: a key comes with Pro at $29 a month and answers 1,000 calls a day. The keyless tier stays free at 200 calls a day per IP.

Common questions

Is the API open?

For reads, yes. GET /api/v1/wallets/{address}, /copyable and /screen and the MCP server answer today without a key from a per-IP budget of 200 calls a day, and a Pro key lifts a caller onto its own quota of 1,000 calls a day. Batch scoring, webhooks and watchlist sync are planned and not built; the waitlist is for those.

Do I need Pro to read a score?

Not on the site — every CopyGrade Score, verdict, sub-score and farming forensic is free and public, signed in or not. What Pro buys on the API is programmatic access itself: a key, a quota, and automated lookups at volume. There is no API-only data tier, and nothing the API returns is hidden from a visitor who simply opens the wallet's page.

Is there a free tier?

The keyless tier is the free tier: 200 calls a day per IP against every read endpoint and the MCP server, with no account. It is sized for an answer engine assembling one response or a script proving an integration; production use belongs on a Pro key.