Top PNL Addresses

GET /toppnl/addresses

Description: Retrieve the top profitable and top losing trader addresses within the last 24 hours, including their trade stories and overall market insight.

Request

HTTP Method: GET Endpoint:

/toppnl/addresses

Query Parameters

None.

Response

Content Type: application/json

Field	Type	Description
topProfitable	TopPnlAddressItem[]	Top 10 most profitable addresses in 24h
topLoss	TopPnlAddressItem[]	Top 10 most losing addresses in 24h

Type: TopPnlAddressItem

Field	Type	Description
address	string	Trader wallet address
nickname	string	Nickname of the trader
avatar	string	URL of the avatar image
totalPnl	number	Total PnL in the past 24 hours
tradeStory	string	Generated trade story summarizing behavior

Functionality

This endpoint aggregates and analyzes trading data across all tracked addresses in the past 24 hours. It identifies the most profitable and most unprofitable traders, calculates their total PnL, and generates a short “trade story” narrative for each—providing a high-level market overview and behavioral insight.

---

Example Request

GET https://openapi.wildmeta.ai/dataprovider/v1/toppnl/addresses

Example Response

{
  "topProfitable": [
    {
      "address": "0x1234...abcd",
      "nickname": "SmartWhale",
      "avatar": "https://example.com/avatar1.png",
      "totalPnl": 15432.55,
      "tradeStory": "This trader capitalized on rapid volatility by rotating early into Token A before its breakout, then exiting near the local peak for substantial gains."
    }
  ],
  "topLoss": [
    {
      "address": "0x9876...ffff",
      "nickname": "RiskyTrader",
      "avatar": "https://example.com/avatar2.png",
      "totalPnl": -8421.77,
      "tradeStory": "Aggressive leverage on Token B during a downturn led to steep losses, compounded by late stop-loss triggers."
    }
  ]
}