Top LPers (Premium API)

Endpoint ini disediakan untuk use case API/B2B dan menggunakan autentikasi x-api-key.

Endpoint

• Method: GET
• Path: /api/radar/{poolAddress}/top-lpers
• Auth: x-api-key header
• Plan requirement: premium / enterprise tier

Request

curl -X GET "https://app.gorover.xyz/api/radar/<POOL_ADDRESS>/top-lpers" \
  -H "x-api-key: YOUR_API_KEY"

Success Response

{
  "ok": true,
  "poolAddress": "9xQeWvG816bUx9EPfDU9J4AqQfQf...",
  "topLpers": [
    {
      "walletAddress": "7L5Y...abc",
      "tier": "managed",
      "trades": 18,
      "wins": 13,
      "winRatePct": 72.22,
      "avgPnlPct": 4.91,
      "score": 45.3
    }
  ],
  "sampleSize": 132,
  "lookbackDays": 30,
  "requestedByTier": "managed"
}

Error Cases

• 401 UNAUTHORIZED
  • x-api-key hilang atau tidak valid.
• 402 PAYMENT_REQUIRED
  • API key valid tapi tier masih basic/free.
• 400 POOL_REQUIRED
  • poolAddress kosong/tidak valid.

Notes

• Ranking dihitung dari beacon verified dalam lookback 30 hari.
• Skor komposit saat ini: winRatePct * 0.6 + avgPnlPct * 0.4.
• Endpoint ini dimaksudkan untuk analytics dan strategy discovery; bukan jaminan performa masa depan.