Overview
The data behind Hexio, on a key of your own.
Polymarket gives away positions, trades and leaderboards for free, and we are not selling access to that. What this API serves is PnL reconstructed from our own Polygon node and verified against on-chain holdings at resolution — the subgraph everyone else resells breaks on wallets with 100k+ trades and only reports realized PnL.
Base URL
Every path below is relative to that origin. All responses are JSON; all timestamps are UTC ISO-8601 unless a field name says otherwise.
Your first request
Create a key on the Keys page, then:
curl -H "X-API-Key: hex_live_..." \
"https://api.hexio.trade/v1/wallets?limit=5"The fastest way to confirm a key works is to ask what it is entitled to. This endpoint costs nothing and is the one to reach for when something returns 401 or 429.
/v1/usageTier, rate limit, remaining quota and credit balance for the calling key.
Kept in this browser only, and reused on every page. Never sent anywhere but the API.
Paste a key once and every panel in these docs is runnable — it is kept in your browser and reused across pages.
{
"tier": "pro",
"scope": null,
"addons": [],
"parallel_streams": 1,
"rate_limit_per_min": 300,
"quota": 3000000,
"used": 279,
"remaining": 2999721,
"period_resets_at": "2026-09-01T00:00:00+00:00",
"credit_balance": 0,
"daily_limit": null,
"daily_used": 65
}What is here
| Area | What it answers |
|---|---|
| Wallets | Who is good, how good, and why — ranked list, full dossier, positions, trades, network |
| Markets | Where proven wallets agree, and where they disagree with the book |
| Signals | Radar events, curated baskets, and platform-wide stats |
| Streaming | Live trades over WebSocket, filtered to what you care about |
Before you build
- Authentication — how to send a key, and how not to leak one
- Rate limits & credits — what a request costs and what your plan allows
- Pagination — cursors, and why offset stops working at depth
- Errors — every status code this API returns, and what to do about each