Skip to main content
GET
/
2
/
wallet
/
analysis
Get wallet trading analysis
curl --request GET \
  --url https://demo-api.mobula.io/api/2/wallet/analysis
{
  "data": {
    "winRateDistribution": {
      ">500%": 123,
      "200%-500%": 123,
      "50%-200%": 123,
      "0%-50%": 123,
      "-50%-0%": 123,
      "<-50%": 123
    },
    "marketCapDistribution": {
      ">1000M": 123,
      ">100M": 123,
      "10M-100M": 123,
      "1M-10M": 123,
      "100k-1M": 123,
      "<100k": 123
    },
    "periodTimeframes": [
      {
        "date": "<string>",
        "realized": 123
      }
    ],
    "calendarBreakdown": [
      {
        "date": "<string>",
        "volumeBuy": 123,
        "volumeSell": 123,
        "totalVolume": 123,
        "buys": 123,
        "sells": 123,
        "realizedPnlUSD": 123
      }
    ],
    "stat": {
      "totalValue": 123,
      "periodTotalPnlUSD": 123,
      "periodRealizedPnlUSD": 123,
      "periodRealizedRate": 123,
      "periodActiveTokensCount": 123,
      "periodWinCount": 123,
      "fundingInfo": {
        "from": "<string>",
        "date": "<string>",
        "chainId": "<string>",
        "txHash": "<string>",
        "amount": "<string>",
        "formattedAmount": 123,
        "currency": {
          "name": "<string>",
          "symbol": "<string>",
          "logo": "<string>",
          "decimals": 123,
          "address": "<string>"
        },
        "fromWalletLogo": "<string>",
        "fromWalletTag": "<string>"
      },
      "periodVolumeBuy": 123,
      "periodVolumeSell": 123,
      "periodBuys": 123,
      "periodSells": 123,
      "nativeBalance": {
        "rawBalance": "<string>",
        "formattedBalance": 123,
        "assetId": 123,
        "chainId": "<string>",
        "address": "<string>",
        "decimals": 123,
        "name": "<string>",
        "symbol": "<string>",
        "logo": "<string>",
        "price": 123,
        "balanceUSD": 123
      },
      "periodBuyTokens": 123,
      "periodSellTokens": 123,
      "periodTradingTokens": 123,
      "holdingTokensCount": 123,
      "holdingDuration": 123,
      "tradingTimeFrames": 123,
      "winRealizedPnl": 123,
      "winRealizedPnlRate": 123,
      "winToken": {
        "address": "<string>",
        "chainId": "<string>",
        "name": "<string>",
        "symbol": "<string>",
        "logo": "<string>",
        "decimals": 123
      }
    },
    "labels": [
      "<string>"
    ],
    "walletMetadata": {
      "entityName": "<string>",
      "entityLogo": "<string>",
      "entityLabels": [
        "<string>"
      ],
      "entityType": "<string>",
      "entityDescription": "<string>",
      "entityTwitter": "<string>",
      "entityWebsite": "<string>",
      "entityGithub": "<string>",
      "entityDiscord": "<string>",
      "entityTelegram": "<string>"
    },
    "platform": {
      "id": "<string>",
      "name": "<string>",
      "logo": "<string>"
    }
  }
}

Query Parameters

wallet
string
required

Wallet address to analyze

Minimum string length: 1
blockchains
string

Comma-separated list of blockchain IDs (e.g., "ethereum,base,solana:solana"). If omitted, all chains.

period
string

Analysis period: 1d, 7d, 30d, or 90d (default: 7d)

from
number | null

Start timestamp in milliseconds (alternative to period)

to
number | null

End timestamp in milliseconds (alternative to period)

Response

200 - application/json

Wallet analysis response

data
object
required