Returns token positions for a profile, grouped as feed cards containing full trade history.
Position status:
open: Tokens currently held (remaining position value >= $1)closed: Tokens fully exited or dust remaining (remaining position value < $1)Each position includes:
Sorting options:
value (default): For closed positions, sorted by realized gains descending (with zero-sell positions pushed to bottom). For open positions, sorted by 30-day sell cost basis.latest: For closed positions, sorted by close date. For open positions, sorted by open date.Aggregation:
By default, returns aggregated positions across all addresses in the profile. Set providedAddressesOnly=true to scope to just the provided wallet address.
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Profile UUID or wallet address to look up
Position status filter. Use "closed" to get fully exited positions.
open, closed "closed"
When true, returns positions for only the provided wallet address. When false (default), aggregates positions across all addresses in the profile.
Sorting method. "value" (default): sorts by realized gains for closed positions, 30-day sell cost basis for open. "latest": sorts by close date for closed positions, open date for open.
value, latest If included, only include transactions with actions on the provided chains. Defaults to base, ethereum, solana. Pass all to see transactions on all supported chains.
ethereum, optimism, polygon, arbitrum, zora, base, zero, solana, hyperliquid, all Page number for pagination (1-based)
x >= 1Number of positions per page (max 100)
1 <= x <= 100200
Number of unique addresses that purchased this token in the last 24 hours
Display title for the feed card (typically profile name)
Action buttons/links for this card
Token details and position statistics including all trades
AI-generated insights and metrics about this position
Engagement metrics: copytrade count and volume, reply count, comment count
Unique identifier for this feed card (position)
Transaction hash of the first trade in this position
Unix timestamp of the first trade in this position
Unix timestamp of the most recent trade in this position. Used for "latest" sort ordering.
Profile information of the trader who holds/held this position
Profile avatar image URL of the actor