Skip to main content
This endpoint requires a Growth or Enterprise plan. Learn more.

​
Returns

WalletChartResponse
WalletChartResponse

​
Arguments

input
WalletChartInput!
required

​
Usage Guidelines

  • Requires walletAddress, a range with start/end unix timestamps, and a resolution (60, 240, 1D, or 7D)
  • Optionally pass networkId to scope the chart to a single network — omit it for cross-chain aggregated data
  • Each data point includes volumeUsd, realizedProfitUsd, and swaps for that time bucket
  • volumeUsdAll includes volume from tokens sold where we may not have a price — use volumeUsd for more conservative figures
  • Check backfillState to determine if historical data is fully available — BackfillComplete means all historical stats have been processed

​
Troubleshooting Tips

60 = 1-hour candles, 240 = 4-hour candles, 1D = daily candles, 7D = weekly candles. Choose a resolution appropriate for your time range — e.g., daily for a multi-week range, hourly for a few days.
Wallet historical data needs to be computed before it’s available. BackfillComplete means data is ready. BackfillInProgress or BackfillRequestReceived means it’s still processing — retry after a short wait. BackfillCanceled or BackfillBlocked typically means the wallet was flagged as a bot.
A negative realizedProfitUsd means the wallet realized a loss during that time bucket — tokens were sold for less than their acquisition cost. This only reflects closed positions; unrealized gains/losses on held tokens are not included.
volumeUsd only counts volume from tokens where we have a reliable USD price. volumeUsdAll additionally includes volume from tokens that were sold but for which we couldn’t determine a USD price. For most use cases, volumeUsd is the safer metric.