> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bravadotrade.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Polymarket Analytics

> Wallet leaderboard, wallet profiles, smart-activity markets and positions for Polymarket, on one partner credential. Stable plain-USD numbers, 0–1 ratios, unix-second timestamps.

> [!NOTE]
>
> Sign each request with a fresh HMAC signature. The cURL and HTTP header values in these pages are placeholders, not reusable credentials. For runnable signing code, use [request signing examples](https://docs.bravadotrade.com/authentication-examples.md).

The `/v2/polymarket` surface serves Polymarket wallet and market analytics under a single Data API credential (`analytics.read`). Every route is **fixed to the Polymarket venue** — there is no `venue` parameter to pass.

### Response conventions

These hold across every endpoint on this surface:

* **Numbers are exact decimal strings**, never floating-point — USD amounts, prices and PnL as decimal strings, ratios (ROI, win rate) as `0`–`1` decimals — so precision survives transit.
* **Timestamps are unix seconds** (`computed_at`, `first_trade_at`, `last_trade_at`, …).
* **Unknown is `null`, never a fake `0`.** A metric the source cannot compute is `null`. In particular `fees_paid` is `null` on the day windows and `fees_refunded` is `null` on every window — this surface has no per-window fee split — so a `null` fee means *unknown*, not *zero*.
* **Cursor pagination.** List endpoints return `pagination.pagination_key`; pass it back as the `pagination_key` query parameter to get the next page. `pagination.has_more` tells you when to stop.

### Endpoints

* [`GET /v2/polymarket/leaderboard`](https://docs.bravadotrade.com/api/polymarket/leaderboard) — wallets ranked for a window.
* [`GET /v2/polymarket/wallet/{wallet}`](https://docs.bravadotrade.com/api/polymarket/wallet) — one wallet's four-window profile.
* [`GET /v2/polymarket/wallets/profiles`](https://docs.bravadotrade.com/api/polymarket/wallets-profiles) — a batch of wallet profiles.
* [`GET /v2/polymarket/markets/smart-activity`](https://docs.bravadotrade.com/api/polymarket/smart-activity) — per-market smart-cohort aggregates.
* [`GET /v2/polymarket/positions`](https://docs.bravadotrade.com/api/analytics/positions) — positions across every indexed wallet (documented alongside the canonical positions endpoint).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.