Get wallet trading analysis
Wallet APIs
Get Wallet Trading Analysis
GET
Get wallet trading analysis
Documentation Index
Fetch the complete documentation index at: https://docs.mobula.io/llms.txt
Use this file to discover all available pages before exploring further.
Query details
This endpoint provides comprehensive trading analytics for a wallet including PnL analysis, win rate distributions, market cap distributions, and detailed trading statistics over a specified period.| Parameter | Required | Description |
|---|---|---|
wallet | Yes | Wallet address to analyze. |
blockchains | No | Comma-separated list of blockchain IDs (e.g., "ethereum,base,solana:solana"). If not provided, analysis will be performed across all chains. |
period | No | Analysis period. Supported values: 1d, 7d, 30d, 90d. Default: 7d. |
from | No | Start timestamp in milliseconds (alternative to period). Must be used with to. |
to | No | End timestamp in milliseconds (alternative to period). Must be greater than from. |
Step-by-Step Tutorial and Video Walkthrough
- Check out the guide: Here
Response Structure
The endpoint returns comprehensive trading analytics including:Win Rate Distribution
Distribution of trades by profit/loss percentage:>500%: Number of trades with over 500% profit200%-500%: Number of trades with 200-500% profit50%-200%: Number of trades with 50-200% profit0%-50%: Number of trades with 0-50% profit-50%-0%: Number of trades with 0-50% loss<-50%: Number of trades with over 50% loss
Market Cap Distribution
Distribution of traded tokens by market capitalization:>1000M: Number of tokens with market cap over $1B>100M: Number of tokens with market cap 1B10M-100M: Number of tokens with market cap 100M1M-10M: Number of tokens with market cap 10M100k-1M: Number of tokens with market cap 1M<100k: Number of tokens with market cap under $100K
Trading Statistics (stat object)
totalValue: Current total portfolio value in USDperiodTotalPnlUSD: Total PnL (realized + unrealized) for the periodperiodRealizedPnlUSD: Realized PnL for the periodperiodRealizedRate: Realized PnL rate (%)periodActiveTokensCount: Number of tokens traded during the periodperiodWinCount: Number of winning tradesperiodVolumeBuy: Total buy volume in USDperiodVolumeSell: Total sell volume in USDperiodBuys: Number of buy transactionsperiodSells: Number of sell transactionsperiodBuyTokens: Number of unique tokens boughtperiodSellTokens: Number of unique tokens soldperiodTradingTokens: Number of unique tokens tradedholdingTokensCount: Current number of tokens heldholdingDuration: Average holding duration in daystradingTimeFrames: Number of trading sessionswinRealizedPnl: Total realized profit from winning tradeswinRealizedPnlRate: Win rate percentagenativeBalance: Native token balance informationwinToken: Details of the most profitable token (if any)fundingInfo: Information about initial wallet funding
Period Timeframes
Array of daily PnL data points with:date: Date of the data pointrealized: Realized PnL for that day
Calendar Breakdown
Array of day-by-day breakdown entries with:date: Date of the entryvolumeBuy: Buy volume for that day in USDvolumeSell: Sell volume for that day in USDtotalVolume: Total volume for that day in USDbuys: Number of buy transactionssells: Number of sell transactionsrealizedPnlUSD: Realized PnL for that day in USD
Labels
Array of labels associated with the wallet (e.g., “Smart Money”, “Early Adopter”, etc.)Wallet Metadata
Enriched wallet metadata (entity name, logo, labels) from known wallets database.null if not available.
Platform
Trading platform used by the wallet with full metadata (id, name, logo).null if not available.
Usage Examples
- Analyze wallet trading performance over the last 7 days on Ethereum
- Analyze wallet across all chains for 30 days
- Get comprehensive 90-day trading analysis on Base
Rate Limiting
This endpoint has a rate limit of 5 requests per minute per API key due to the computational intensity of the analysis.Use Cases
- Portfolio Performance Tracking: Monitor trading performance and PnL over time
- Wallet Scoring: Score wallets based on trading metrics for smart money identification
- Risk Analysis: Analyze trading patterns and risk distribution
- Trading Strategy Analysis: Understand trading behavior and token preferences
- Due Diligence: Research wallet trading history before following or copying trades
Query Parameters
Wallet address to analyze
Minimum string length:
1Comma-separated list of chain IDs (e.g., "evm:1,evm:8453,solana:solana"). If omitted, all chains.
Analysis period: 1d, 7d, 30d, or 90d (default: 7d)
Start timestamp in milliseconds (alternative to period)
End timestamp in milliseconds (alternative to period)
Response
200 - application/json
Wallet analysis response