Add Wallets

Add one or more Polymarket proxy wallet addresses to your BYOL set. Newly added wallets are tracked immediately in the background and will appear in your leaderboard queries within seconds.

POST /v2/leaderboard/wallets

Authentication

Pass your API key via query parameter ?key=, header x-api-key, or Authorization: Bearer.

Request body

{
  "wallets": [
    "0x94f199fb7789f1aef7fff6b758d6b375100f4c7a",
    "0xe9ad918c7678cd38b12603a762e638a5d1ee7091"
  ]
}

string[]

required

Array of Polymarket proxy wallet addresses. Each must be a valid Ethereum address (0x + 40 hex characters). Maximum 500 wallets per request.

Response

{
  "added": 2,
  "already_tracked": 0,
  "total": 106,
  "limit": 5000
}

Field	Type	Description
`added`	number	Number of new wallets added
`already_tracked`	number	Wallets that were already in your set (not counted toward the limit)
`total`	number	Total wallets now in your set
`limit`	number	Maximum wallets allowed (5,000)

Deduplication

If you add wallets that are already in your set, they are silently ignored. This means you can safely re-send your full wallet list without worrying about duplicates.

// Request: adding 2 wallets that are already tracked
{
  "wallets": [
    "0x94f199fb7789f1aef7fff6b758d6b375100f4c7a",
    "0xe9ad918c7678cd38b12603a762e638a5d1ee7091"
  ]
}

// Response: nothing was added, total unchanged
{
  "added": 0,
  "already_tracked": 2,
  "total": 106,
  "limit": 5000
}

Examples

curl -X POST "https://api.polynode.dev/v2/leaderboard/wallets?key=YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "wallets": [
      "0x94f199fb7789f1aef7fff6b758d6b375100f4c7a",
      "0xe9ad918c7678cd38b12603a762e638a5d1ee7091"
    ]
  }'

const response = await fetch(
  "https://api.polynode.dev/v2/leaderboard/wallets?key=YOUR_API_KEY",
  {
    method: "POST",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({
      wallets: [
        "0x94f199fb7789f1aef7fff6b758d6b375100f4c7a",
        "0xe9ad918c7678cd38b12603a762e638a5d1ee7091"
      ]
    })
  }
);
const data = await response.json();
console.log(`Added: ${data.added}, Total: ${data.total}`);

import requests

response = requests.post(
    "https://api.polynode.dev/v2/leaderboard/wallets",
    params={"key": "YOUR_API_KEY"},
    json={
        "wallets": [
            "0x94f199fb7789f1aef7fff6b758d6b375100f4c7a",
            "0xe9ad918c7678cd38b12603a762e638a5d1ee7091"
        ]
    }
)
data = response.json()
print(f"Added: {data['added']}, Total: {data['total']}")

Newly added wallets are fetched immediately in the background. They typically appear in leaderboard queries within a few seconds.

Overview

V3 Data API

Wallet P&L

Wallet Activity

Credits

Identity

Fees

Combos

Rewards

Markets & Search

Orderbook

Leaderboard & Tags

Builders

Polymarket Profiles

Global

Tokens

Perps

Perps Market Data

Perps Wallets

Perps Analytics

Perps On-Chain

Perps Streaming

Crypto

Sports

BYOL

Backtesting

Market Card

System

Search & Context

Onchain V2 (legacy)

Authentication

Request body

Response

Deduplication

Examples

​Authentication

​Request body

​Response

​Deduplication

​Examples

Authentication

Request body

Response

Deduplication

Examples