Returns closed token positions for a profile, grouped as feed cards containing full trade history.
Closed positions are tokens where the profile has fully exited (holding_amount < 0.0001).
Each position includes:
Sorting options:
value (default): Sorted by realized gains descending (with zero-sell positions pushed to bottom)latest: Sorted by position close date (most recently closed first)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 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: likes, reposts, bookmarks, 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
Present only in For You feed. Highlights the specific trade with alpha tags that triggered recommendation.