Improved

2026.08.18 - Add Filters For Top Traders API

Add min/max filters to the Token Top Traders API for Solana and EVM chains

Features

Token - Top Traders

GET /defi/v2/tokens/top_traders

  • Support filtering top traders by trade count, token volume, USD volume, realized PnL, and unrealized PnL
  • Apply filters to both Solana and EVM-supported Top Traders requests
  • Keep existing sorting, pagination, and response fields unchanged
  • min/max filters are not supported when use with sort_by=hold_volume

New Parameters

ParameterTypeRequiredDefaultDescription
min_tradeintegerNo-Minimum trade count. Not supported when sort_by=hold_volume.
max_tradeintegerNo-Maximum trade count. Not supported when sort_by=hold_volume.
min_volumenumberNo-Minimum token volume. Not supported when sort_by=hold_volume.
max_volumenumberNo-Maximum token volume. Not supported when sort_by=hold_volume.
min_volume_usdnumberNo-Minimum USD volume. Not supported when sort_by=hold_volume.
max_volume_usdnumberNo-Maximum USD volume. Not supported when sort_by=hold_volume.
min_realized_pnlnumberNo-Minimum realized PnL. Not supported when sort_by=hold_volume.
max_realized_pnlnumberNo-Maximum realized PnL. Not supported when sort_by=hold_volume.
min_unrealized_pnlnumberNo-Minimum unrealized PnL. Not supported when sort_by=hold_volume.
max_unrealized_pnlnumberNo-Maximum unrealized PnL. Not supported when sort_by=hold_volume.

Usage Note: min_trade and max_trade must be non-negative integers. Volume filters must be non-negative. PnL filters support both positive and negative values.

Compatibility Note: This release does not change existing response fields or existing sort behavior. Filters are additive and optional.