leaderboard

GET /api/Token/KOL_Leaderboard Description: Retrieves a ranked list of KOLs (wallets) by ROI for a specific mint address, including buy, sell, and wallet metadata.Query Parameters

Parameter	Type	Required	Description
api_key	String	Yes	API key for authentication.
mint	String	Yes	Mint address to filter transactions.

Response

• Status Code: 200 OK

• Content-Type: application/json

• Body:

[
  {
    "wallet": "string",
    "buy": number,
    "sell": number,
    "roi": number,
    "rank": integer,
    "wallet_data": {
      "name": "string",
      "wallet_address": "string",
      "telegram": "string",
      "twitter": "string",
      "image_url": "string"
    }
  },
  ...
]

Error Responses

• 400 Bad Request:

{
  "error": "Mint address is required"
}

• 403 Forbidden:

{
  "error": "Invalid or exhausted API key"
}

Example Request

curl "http://82.29.177.109:8080/api/Token/KOL_Leaderboard?mint=4yQSp8nFxXHNHzsUDnbQPMVuMaN2YqqUDvjUxictbonk&api_key=bqAaObeTIEDNy6KF1z88H6uOhVTI2GyhMAUzvn"

Example Response

[
  {
    "wallet": "86AEJExyjeNNgcp7GrAvCXTDicf5aGWgoERbXFiG1EdD",
    "buy": 10.0821,
    "sell": 12.8898,
    "roi": 27.85,
    "rank": 1,
    "wallet_data": {
      "name": "Publix",
      "wallet_address": "86AEJExyjeNNgcp7GrAvCXTDicf5aGWgoERbXFiG1EdD",
      "telegram": "",
      "twitter": "https://x.com/publixplays",
      "image_url": "/images/rnOev9pm_400x400.jpg"
    }
  },
  {
    "wallet": "G3g1CKqKWSVEVURZDNMazDBv7YAhMNTjhJBVRTiKZygk",
    "buy": 2.0220,
    "sell": 1.4071,
    "roi": -30.41,
    "rank": 2,
    "wallet_data": {
      "name": "Insyder",
      "wallet_address": "G3g1CKqKWSVEVURZDNMazDBv7YAhMNTjhJBVRTiKZygk",
      "telegram": "",
      "twitter": "https://x.com/insydercrypto",
      "image_url": "/images/cGGAw6Pg_400x400.jpg"
    }
  },
  ...
]

Notes

• Responses are cached for 5 seconds.

• Sorted by ROI descending, with ranks assigned.