Polyrankdocs

FAQ

Data freshness, P&L differences, licensing, and the usual questions.

How fresh is the data?

Trades land from the chain within seconds (the live pulse and WSS feeds are real-time). Heavy metric recomputes (windowed metrics, percentiles, rankings) run nightly. Each cached public response carries a snapshot-age header.

Why does a trader's P&L differ from another tracker?

Polyrank reproduces Polymarket's own methodology — average-cost basis, sell-clamping, peer transfers ignored, LP rewards excluded — and validates it at scale against on-chain events. Trackers using FIFO, including transfers, or counting rewards will differ. When our reconciliation flags a wallet, we show pnl_under_review rather than a number we can't stand behind.

Where does the data come from?

Public Polygon on-chain events (CTF Exchange fills, splits/merges, redemptions, resolutions) indexed end-to-end — including maker-side fills, which most trackers miss. Every number traces to a transaction.

Can I use the API in a browser app?

Yes — /v1/public/* sends permissive CORS and needs no credentials. The authed API is CORS-restricted to polyrank.app; call it from your backend with an API key instead.

What can I do with the data? (licensing)

Free public API: personal and evaluation use with attribution ("data: polyrank.app"). Paid plans license internal/commercial use scaled by tier; redistribution of bulk data requires Desk or Enterprise. Details: polyrank.app/tos.

Is this investment advice?

No. Polyrank is read-only analytics over public data. Most prediction-market traders lose money; past calibration does not guarantee future calibration.

Is Polyrank affiliated with Polymarket?

No. Independent, read-only, non-custodial.

On this page