Rank wallets on one venue by native profit/volume or stored score.
const url = 'https://data.predictefy.com/v1/traders/polymarket/leaderboard?by=profit&window=day&limit=20';const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url 'https://data.predictefy.com/v1/traders/polymarket/leaderboard?by=profit&window=day&limit=20' \ --header 'Authorization: Bearer <token>'Native profit and volume rankings are served only where the venue exposes them. by=score reads current versioned Predictefy scores and supports window=all only; unsupported combinations return TRADERS_UNSUPPORTED or VALIDATION_ERROR rather than ignoring a filter.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”A venue with a capability-qualified Trader Intelligence adapter.
Query Parameters
Section titled “Query Parameters”Responses
Section titled “Responses”Native or stored-score leaderboard rows.
object
object
object
object
Present only when volumeCoverage is lifetime; otherwise null.
object
Predictefy-store — Trader Intelligence rows served from Predictefy’s own store. venue-rest — live Trader Intelligence rows fetched per request through the venue adapter.
object
Newest observation in the returned page, or null when the page is empty.
object
Predictefy-store — Trader Intelligence rows served from Predictefy’s own store. venue-rest — live Trader Intelligence rows fetched per request through the venue adapter.
Example
{ "success": true, "data": [ { "stats": { "volumeCoverage": "lifetime" }, "refreshState": "fresh", "provenance": { "source": "predictefy-store" }, "window": "all" } ], "meta": { "provenance": { "source": "predictefy-store" }, "window": "day" }}Enveloped error.
object
object
Always present on errors; quote this id when reporting a failed request.
Present only when a venue error is attributed to a specific exchange.
Example
{ "success": false, "error": { "code": "VALIDATION_ERROR" }}Enveloped error.
object
object
Always present on errors; quote this id when reporting a failed request.
Present only when a venue error is attributed to a specific exchange.
Example
{ "success": false, "error": { "code": "VALIDATION_ERROR" }}Enveloped error.
object
object
Always present on errors; quote this id when reporting a failed request.
Present only when a venue error is attributed to a specific exchange.
Example
{ "success": false, "error": { "code": "VALIDATION_ERROR" }}Enveloped error.
object
object
Always present on errors; quote this id when reporting a failed request.
Present only when a venue error is attributed to a specific exchange.
Example
{ "success": false, "error": { "code": "VALIDATION_ERROR" }}Enveloped error.
object
object
Always present on errors; quote this id when reporting a failed request.
Present only when a venue error is attributed to a specific exchange.
Example
{ "success": false, "error": { "code": "VALIDATION_ERROR" }}Enveloped error.
object
object
Always present on errors; quote this id when reporting a failed request.
Present only when a venue error is attributed to a specific exchange.
Example
{ "success": false, "error": { "code": "VALIDATION_ERROR" }}Enveloped error.
object
object
Always present on errors; quote this id when reporting a failed request.
Present only when a venue error is attributed to a specific exchange.
Example
{ "success": false, "error": { "code": "VALIDATION_ERROR" }}Enveloped error.
object
object
Always present on errors; quote this id when reporting a failed request.
Present only when a venue error is attributed to a specific exchange.
Example
{ "success": false, "error": { "code": "VALIDATION_ERROR" }}