GET /leaderboard: PnL Leaderboard

curl --request GET \
  --url https://bravado-api-k7kaq.ondigitalocean.app/leaderboard

const options = {method: 'GET'};

fetch('https://bravado-api-k7kaq.ondigitalocean.app/leaderboard', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://bravado-api-k7kaq.ondigitalocean.app/leaderboard",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://bravado-api-k7kaq.ondigitalocean.app/leaderboard"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://bravado-api-k7kaq.ondigitalocean.app/leaderboard")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "results": [
    {
      "rank": 123,
      "trader": "<string>",
      "username": {},
      "avatar": {},
      "bravado_user_id": {},
      "pnl_usdc": "<string>",
      "volume_usdc": "<string>",
      "trades": 123,
      "win_rate": "<string>"
    }
  ],
  "window": "<string>",
  "total": 123,
  "has_more": true
}

GET

leaderboard

GET /leaderboard: PnL Leaderboard

curl --request GET \
  --url https://bravado-api-k7kaq.ondigitalocean.app/leaderboard

const options = {method: 'GET'};

fetch('https://bravado-api-k7kaq.ondigitalocean.app/leaderboard', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://bravado-api-k7kaq.ondigitalocean.app/leaderboard",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://bravado-api-k7kaq.ondigitalocean.app/leaderboard"

	req, _ := http.NewRequest("GET", url, nil)

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://bravado-api-k7kaq.ondigitalocean.app/leaderboard")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)

response = http.request(request)
puts response.read_body

{
  "results": [
    {
      "rank": 123,
      "trader": "<string>",
      "username": {},
      "avatar": {},
      "bravado_user_id": {},
      "pnl_usdc": "<string>",
      "volume_usdc": "<string>",
      "trades": 123,
      "win_rate": "<string>"
    }
  ],
  "window": "<string>",
  "total": 123,
  "has_more": true
}

Returns traders on Polymarket ranked by realized PnL for the requested window. All PnL values are computed under PMWAS. For volume-ranked results, use GET /leaderboard/volume.

GET https://bravado-api-k7kaq.ondigitalocean.app/leaderboard

Query Parameters

string

default:"30d"

Rolling time window over which to compute PnL. One of 24h, 7d, 30d, all.

integer

default:"100"

Number of traders to return. Maximum 500.

integer

default:"0"

Offset for pagination. See Pagination.

Response

array

Show LeaderboardRow fields

integer

1-based rank in the window.

string

Polygon wallet address.

string | null

Polymarket display name if the wallet has one.

string | null

Avatar image URL.

string | null

Internal Bravado user identifier if this wallet is provisioned through Bravado.

string

Realized PnL in USDC over the window, net of fees. String for precision.

string

Total USDC notional traded in the window.

integer

Trade events in the window.

string

Fraction of closed positions with positive realized PnL. String between “0” and “1”.

string

Echo of the window parameter used for the response.

integer

Total number of traders matching the window.

boolean

True if additional pages exist.

Errors

Status	When
`400 Bad Request`	Invalid `window`, `limit`, or `offset` value
`401 Unauthorized`	Missing or invalid Bearer token
`429 Too Many Requests`	Rate limit exceeded, see `Retry-After` header

See the Error reference.

Example

curl -G https://bravado-api-k7kaq.ondigitalocean.app/leaderboard \
  -H "Authorization: Bearer <token>" \
  -d window=30d \
  -d limit=20

{
  "window": "30d",
  "results": [
    {
      "rank": 1,
      "trader": "0xabc123...def456",
      "username": "topPlayer",
      "avatar": "https://polymarket.com/avatars/topPlayer.png",
      "bravado_user_id": null,
      "pnl_usdc": "42580.120000",
      "volume_usdc": "1250000.000000",
      "trades": 218,
      "win_rate": "0.61"
    }
  ],
  "total": 100,
  "has_more": true
}

GET /leaderboard/volume for volume-ranked results.
GET /traders/{address} for per-trader detail.
Guide: Build a PnL leaderboard.

⌘I

Get Started

Supported Prediction Markets

Products Overview

Use Cases

SDKs

GET /leaderboard: PnL Leaderboard

Query Parameters

Response

Errors

Example

​Query Parameters

​Response

​Errors

​Example

​Related

Query Parameters

Response

Errors

Example

Related