Skip to main content

​
walletSummary

Lifetime aggregate stats for up to 50 wallets in one request — trade counts, volume, realized PnL, win rate, etc.

​
Arguments

NameTypeRequiredDescription
addresses[String!]!yes1-50 wallet addresses. Each must be ≥ 32 chars.

​
Return type

type WalletSummary {
  address: String!
  totalTrades: Int!
  totalBuys: Int!
  totalSells: Int!
  buyRatio: Float!
  sellRatio: Float!
  totalVolumeSol: Float!
  totalVolumeUsd: Float!
  avgTradeSizeSol: Float!
  avgTradeSizeUsd: Float!
  largestTradeSol: Float!
  largestTradeUsd: Float!
  totalFees: Float!
  realizedPnlSol: Float!
  realizedPnlUsd: Float!
  uniqueTokensTraded: Int!
  winningTokens: Int!
  winRate: Float!
  firstTradeAt: String!
  lastTradeAt: String!
  proTradeCount: Int!
  sniperCount: Int!
  bundleCount: Int!
  solPriceUsd: Float!
}
Returns one entry per input address. Addresses with no recorded activity are still returned with zero counts.

​
Example

query {
  walletSummary(addresses: [
    "3ixtZXbbJjNEq89GbeFu8vJMGDMNSePofNEf5kecVhsA",
    "4wuudpdbJzUFpsu1MgwbGEWg93NQcb9Wxyoaya9i7FMF"
  ]) {
    address totalTrades totalVolumeSol realizedPnlSol winRate
  }
}

​
walletTokens

Per-token aggregate stats for one wallet — one row per (wallet, mint) pair.

​
Arguments

NameTypeRequiredDescription
addressStringyesWallet address (≥ 32 chars).
limitIntnoDefault 100, max 200.
offsetIntnoDefault 0.
sortStringno"volume" (default), "trades", "pnl", "last_trade".

​
Return type

type WalletToken {
  mint: String!
  totalTrades: Int!
  buys: Int!
  sells: Int!
  totalVolumeSol: Float!
  buyVolumeSol: Float!
  sellVolumeSol: Float!
  realizedPnlSol: Float!
  firstTrade: String!
  lastTrade: String!
  totalFees: Float!
}

​
Example

query {
  walletTokens(
    address: "3ixtZXbbJjNEq89GbeFu8vJMGDMNSePofNEf5kecVhsA"
    limit: 50
    sort: "pnl"
  ) {
    mint totalTrades totalVolumeSol realizedPnlSol firstTrade lastTrade
  }
}

​
walletPerformance

Time-series stats for one wallet across a date range — useful for charts.

​
Arguments

NameTypeRequiredDescription
addressStringyesWallet address (≥ 32 chars).
fromStringyesStart time in seconds since epoch, as a string.
toStringyesEnd time in seconds since epoch, as a string. Must be greater than from.
resolutionStringnoBucket size. Default "1h". Supports "1m", "5m", "15m", "1h", "4h", "1d".

​
Return type

type WalletPerformancePoint {
  timestamp: String!
  trades: Int!
  buys: Int!
  sells: Int!
  volumeSol: Float!
  realizedPnlSol: Float!
  uniqueTokens: Int!
}
Returned oldest-first.

​
Example

query {
  walletPerformance(
    address: "3ixtZXbbJjNEq89GbeFu8vJMGDMNSePofNEf5kecVhsA"
    from: "1740000000"
    to:   "1740086400"
    resolution: "1h"
  ) {
    timestamp trades volumeSol realizedPnlSol uniqueTokens
  }
}