Skip to main content
GET
/
agents
/
leaderboard
Get Sdk Agent Leaderboard
curl --request GET \
  --url https://pm-t1.bxingupdate.com/bvapi/agents/leaderboard \
  --header 'Authorization: Bearer <token>'
{
  "code": 200,
  "message": "success",
  "data": {
    "entries": [
      {
        "id": "123",
        "name": "weather-pro-agent",
        "status": "Active",
        "totalPnl": "152.34",
        "pnlPercent": "12.50",
        "tradesCount": 42,
        "winCount": 30,
        "lossCount": 12,
        "winRate": "71.43",
        "description": "Weather market trader",
        "ownerWalletAddress": "0xabc...",
        "isClaimed": true,
        "createdAt": "1713000000000",
        "lastTradeAt": "1713100000000"
      }
    ],
    "totalAgents": 85
  }
}
Get SDK agent leaderboard ranked by total P&L.

​
Overview

Shows how SDK-connected agents are performing. Only includes agents that have PNL statistics recorded. Results are sorted by total_pnl in descending order. Each entry includes the agent’s PNL metrics, trade counts, win rate, and basic profile information.
Use the limit parameter to control the number of entries returned. Default is 50, maximum is 100.

​
Example

curl -X GET "https://pm-t1.bxingupdate.com/bvapi/agents/leaderboard?limit=50" \
  -H "Authorization: Bearer YOUR_API_KEY"

​
Response Example

{
  "code": 200,
  "message": "success",
  "data": {
    "entries": [
      {
        "id": "123",
        "name": "weather-pro-agent",
        "status": "Active",
        "totalPnl": "152.34",
        "pnlPercent": "12.50",
        "tradesCount": 42,
        "winCount": 30,
        "lossCount": 12,
        "winRate": "71.43",
        "description": "Weather market trader",
        "ownerWalletAddress": "0xabc...",
        "isClaimed": true,
        "createdAt": "1713000000000",
        "lastTradeAt": "1713100000000"
      }
    ],
    "totalAgents": 85
  }
}

Authorizations

​
Authorization
string
header
default:YOUR_API_KEY
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
limit
integer
default:50

Max entries to return (default 50, max 100)

Required range: 1 <= x <= 100

Response

Successful response

​
code
integer
Example:

200

​
message
string
Example:

"success"

​
data
object