---
title: "Get wallet trading analysis"
method: GET
path: "/api/2/wallet/analysis"
tags: ["V2 - Wallet"]
---

# Get wallet trading analysis

`GET /api/2/wallet/analysis`

Performs a comprehensive trading performance analysis for a wallet. Returns win rate, total realized PnL, average trade size, best/worst trades, total volume, number of tokens traded, most-traded tokens, and performance breakdown over time periods (24h, 7d, 30d, all-time). Use for evaluating a trader skill, due diligence on copy-trade candidates, or building trader leaderboards.

## Query parameters

- `wallet` string, required — Wallet address to analyze
- `chainId` string
- `chainIds` string — Comma-separated list of chain IDs (e.g., "evm:1,evm:8453,solana:solana"). If omitted, all chains.
- `period` string — Analysis period: 1d, 7d, 30d, or 90d (default: 7d)
- `from` number, nullable — Start timestamp in milliseconds (alternative to period)
- `to` number, nullable — End timestamp in milliseconds (alternative to period)

## Response `200`

Wallet analysis response

- object
  - `data` object, required
    - `winRateDistribution` object, required
      - `>500%` number, required
      - `200%-500%` number, required
      - `50%-200%` number, required
      - `0%-50%` number, required
      - `-50%-0%` number, required
      - `<-50%` number, required
    - `marketCapDistribution` object, required
      - `>1000M` number, required
      - `>100M` number, required
      - `10M-100M` number, required
      - `1M-10M` number, required
      - `100k-1M` number, required
      - `<100k` number, required
    - `periodTimeframes` object[], required
      - `date` string, required
      - `realized` number, required
    - `calendarBreakdown` object[], required
      - `date` string, required
      - `volumeBuy` number, required
      - `volumeSell` number, required
      - `totalVolume` number, required
      - `buys` number, required
      - `sells` number, required
      - `realizedPnlUSD` number, required
    - `stat` object, required
      - `totalValue` number, required
      - `periodTotalPnlUSD` number, required
      - `periodRealizedPnlUSD` number, required
      - `periodRealizedRate` number, required
      - `periodActiveTokensCount` number, required
      - `periodWinCount` number, required
      - `fundingInfo` object, required
        - `from` string, nullable, required
        - `date` string, nullable, required
        - `chainId` string, nullable, required
        - `txHash` string, nullable, required
        - `amount` string, nullable, required
        - `formattedAmount` number, nullable, required
        - `currency` object, nullable, required
          - `name` string, required
          - `symbol` string, required
          - `logo` string, nullable, required
          - `decimals` number, required
          - `address` string, required
        - `fromWalletLogo` string, nullable, required
        - `fromWalletTag` string, nullable, required
        - `fromWalletMetadata` object, nullable
          - `entityName` string, nullable, required
          - `entityLogo` string, nullable, required
          - `entityLabels` string[], required
          - `entityType` string, nullable, required
          - `entityDescription` string, nullable, required
          - `entityTwitter` string, nullable, required
          - `entityWebsite` string, nullable, required
          - `entityGithub` string, nullable, required
          - `entityDiscord` string, nullable, required
          - `entityTelegram` string, nullable, required
          - `extra` object
      - `periodVolumeBuy` number, required
      - `periodVolumeSell` number, required
      - `periodBuys` number, required
      - `periodSells` number, required
      - `nativeBalance` object, nullable, required
        - `rawBalance` string, required
        - `formattedBalance` number, required
        - `assetId` number, nullable, required
        - `chainId` string, required
        - `address` string, required
        - `decimals` number, required
        - `name` string, required
        - `symbol` string, required
        - `logo` string, nullable, required
        - `price` number, required
        - `balanceUSD` number, required
      - `periodBuyTokens` number, required
      - `periodSellTokens` number, required
      - `periodTradingTokens` number, required
      - `holdingTokensCount` number, required
      - `holdingDuration` number, required
      - `tradingTimeFrames` number, required
      - `winRealizedPnl` number, required
      - `winRealizedPnlRate` number, required
      - `winToken` object, nullable, required
        - `address` string, required
        - `chainId` string, required
        - `name` string, required
        - `symbol` string, required
        - `logo` string, nullable, required
        - `decimals` number, required
    - `labels` string[], required
    - `walletMetadata` object, nullable, required
      - `entityName` string, nullable, required
      - `entityLogo` string, nullable, required
      - `entityLabels` string[], required
      - `entityType` string, nullable, required
      - `entityDescription` string, nullable, required
      - `entityTwitter` string, nullable, required
      - `entityWebsite` string, nullable, required
      - `entityGithub` string, nullable, required
      - `entityDiscord` string, nullable, required
      - `entityTelegram` string, nullable, required
      - `extra` object
    - `platform` object, nullable, required
      - `id` string, required
      - `name` string, required
      - `logo` string, nullable, required

## Other responses

- `402` — Payment Required

---

[API](https://skmtc.net/mobula/apis/mobula-api.md) · [All operations](https://skmtc.net/mobula/apis/mobula-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mobula/mobula-api/versions/32f95d9e8ff2/schema)