Skip to main content
Add one or more Polymarket proxy wallet addresses to your BYOL set. Newly added wallets are indexed 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"
  ]
}
​
wallets
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
}
FieldTypeDescription
addednumberNumber of new wallets added
already_trackednumberWallets that were already in your set (not counted toward the limit)
totalnumberTotal wallets now in your set
limitnumberMaximum 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"
    ]
  }'
Newly added wallets are fetched immediately in the background. They typically appear in leaderboard queries within a few seconds.