Skip to main content
GET
One page of the named wallets' spot positions.

Authorizations

Authorization
string
header
required

Send the API key as Authorization: Bearer <key>.

Query Parameters

wallets
string
required

Wallet addresses, CSV; one to 100.

chains
string

Chains to scope to, CSV of the chain slugs. Absent means every spot chain.

lifecycle
enum<string>

Lifecycle to list; open when absent. A position's current-cycle lifecycle.

Available options:
open,
closed
hideLowLiquidity
boolean
default:true

Drop open positions whose token liquidity is below the low-liquidity floor.

hideDust
boolean

Drop open positions whose remaining value is below the dust floor.

hideTransfers
boolean

Drop positions never acquired through a buy.

chain
string

Exact-token drill-down chain; requires token.

token
string

Exact-token drill-down address; requires chain.

q
string

Case-insensitive substring of the token symbol or name.

sort
string

Sort field and direction, field:asc|desc. value:desc when absent, closedAt:desc for closed.

limit
integer<int32>

Rows per page, clamped to 1-100; 50 when absent.

Required range: 1 <= x <= 100
cursor
string

Opaque cursor from the previous page.

Response

One page of the named wallets' positions. The price-derived fields are null for a token without a price.

One page of the named wallets' positions.

asOf
integer<int64>
required

Serve-time snapshot timestamp.

counts
object
required

Per-product counts, taken before the lifecycle, display, search and drill-down filters.

hasMore
boolean
required

Whether a next page exists.

positions
object[]
required

Positions on this page.

nextCursor
string | null

Cursor for the next page; null on the last page.