Polymarket traders ranked by real track record: win rate, return and consistency. Agents pay a few cents in USDC per call through x402. No API key, no account, no subscription.
Not a developer? Try it in your browser. The first few are free.
Every price is per successful request. Calls that fail or return an error are never charged.
| Endpoint | Parameters | Returns | Price |
|---|---|---|---|
GET /v1/whales | minMinimum trade size in USD (default 1000) limitNumber of trades, 1 to 50 (default 20) | Recent large Polymarket trades, with 5- and 15-minute markets filtered out. | $0.02 |
GET /v1/wallet | addressPolymarket wallet address (0x…) | A wallet's track record: skill score, edge over the odds paid, win rate, return, specialty and largest open positions. | $0.05 |
GET /v1/top-traders | periodday, week, month or all (default month) categoryOptional: sports, politics, crypto, economy or other limitNumber of traders, 1 to 25 (default 10) | Top Polymarket traders re-ranked by skill (edge over the odds paid, return, consistency), not just total profit. Optionally within one category. | $0.05 |
GET /v1/smart-money | marketMarket link, market slug or condition ID | Which way skilled traders lean in a Polymarket market compared with its odds: the biggest holders, each scored for skill. | $0.20 |
GET /v1/skilled-whales | minMinimum trade size in USD (default 1000) limitNumber of trades, 1 to 50 (default 20) | Recent large Polymarket trades by Solid or Sharp traders only, each tagged with the trader's skill score. | $0.05 |
GET /v1/disagreements | categoryOptional: sports, politics, crypto, economy or other limitNumber of markets, 1 to 20 (default 5) | Busy open Polymarket markets where skilled traders' money disagrees most with the market's odds, with a confidence rating. | $0.35 |
Total profit rewards whoever bets the most. The skill score asks how well someone bets.
Did they win more often than the odds they paid implied, and did it make money? Measured over their latest 200 finished bets, losses included.
If most of the winnings came from one lucky bet, the score drops. Thin histories under 10 bets aren't rated.
Wallets that mostly trade 5- and 15-minute crypto markets are discounted, since those are close to chance.
x402 builds payment into ordinary web requests, so any agent with a funded wallet can use x402Pulse.
Your agent calls an endpoint. x402Pulse replies 402 Payment Required with the price and where to pay.
The agent signs a USDC payment for that exact amount. Signing is free, and no gas is needed.
The agent repeats the call with the signature. The payment settles on-chain and the data comes back.
Use any x402 client. With the official TypeScript packages, one wrapped fetch handles the whole exchange. Full reference on the Developers page.
import { x402Client, wrapFetchWithPayment } from "@x402/fetch";
import { registerExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";
const client = new x402Client();
registerExactEvmScheme(client, {
signer: privateKeyToAccount(process.env.KEY),
});
const pay = wrapFetchWithPayment(fetch, client);
const res = await pay(
"https://www.x402pulse.dev/v1/smart-money?market=" +
encodeURIComponent("https://polymarket.com/event/…")
);
console.log(await res.json());{
"data": {
"question": "Will the Fed cut rates in December?",
"outcomes": [{ "name": "Yes", "price": 0.41 },
{ "name": "No", "price": 0.59 }],
"lean": { "outcome": "Yes", "share": 0.72 },
"summary": "Skilled holders lean Yes: 72% of
skill-weighted money.",
"sides": [ … top holders, each with skill,
win rate and return … ]
},
"cached": false
}400 means a missing or invalid parameter (an ambiguous market link also lists the markets to choose from), 404 means the wallet or market wasn't found, 429 means too many requests, and 503 means the service is at capacity. None of these are charged.