LogoTopwallets.ai
API Documentation

Getting Started

The TopWallets API provides programmatic access to Solana wallet analytics and trading data. All API endpoints are accessible via HTTPS and return data in JSON format.

Authentication

All API requests require authentication using a Bearer token in the Authorization header:

Authorization: Bearer YOUR_API_KEY

Base URL

https://www.topwallets.ai/api/bot/solana

Endpoints

GET /top-wallets

Description

Returns a list of top-performing wallets based on their trading performance over a 7-day period.

Query Parameters

ParameterTypeDescription
limitnumberMaximum number of wallets to return (default: 100, max: 100)

Example Requests

curl -X GET \
  "https://www.topwallets.ai/api/bot/solana/top-wallets?limit=50" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response Format

{
    "success": true,
    "message": "Successfully fetched top wallets",
    "data": [
        {
            "all": {
                "score": number,
                "winrateScore": number,
                "pnlScore": number,
                "roiScore": number,
                "consistencyScore": number,
                "address": string,
                "formattedAddress": string,
                "winrate": number,
                "tokenTraded": number,
                "averageHoldingTime": string,
                "realizedPnl": string,
                "unrealizedPnl": string,
                "realizedRoi": string,
                "unrealizedRoi": string,
                "combinedRoi": string,
                "realizedPnlRaw": number,
                "unrealizedPnlRaw": number,
                "realizedRoiRaw": number,
                "unrealizedRoiRaw": number,
                "combinedRoiRaw": number,
                "combinedPnlRaw": number,
                "totalInvested": number | string | null,
                "totalInvestedFormatted": string | null,
                "averageBuyAmount": number | string | null,
                "averageBuyAmountFormatted": string | null,
                "totalWins": number | null,
                "totalLosses": number | null,
                "lossPercentage": number | null,
                "name": string | null,
                "twitter_url": string | null,
                "picture_url": string | null,
                "type": "normal" | "kols",
                "isFavorite": boolean,
                "updatedAt": string
            },
            "30d": { /* Same structure as 'all' */ },
            "7d": { /* Same structure as 'all' */ },
            "1d": { /* Same structure as 'all' */ }
        }
        // ... more wallet trading data
    ]
}

Rate Limits

10 requests per minute

Error Codes

StatusDescription
401
Unauthorized - Invalid API key
404
No top wallets found
500
Internal server error