cesto.positions has two reads: positions.list for a user’s Cesto-account positions,
and getHoldings for the live, on-chain position in one basket — the position view for
SDK-opened positions.
Get all positions
cesto.positions.list returns a user’s open and closing positions, resolved from
their external Solana wallet address, with no end-user login required.
A wallet with no Cesto account returns an empty result
(
{ positions: [], pendingClosePositions: [] }) and is not an error. The wallet
argument is required; an empty value throws before any request is made.This endpoint reads Cesto account positions (opened in the Cesto app). Positions
opened via the SDK are self-custody and do not appear here — use getHoldings below.Position by product (SDK positions)
cesto.positions.getHoldings returns the wallet’s live position in one basket, read
from on-chain balances of the basket’s constituent tokens — exactly what a
close would sell. Works with a read-only key.
The most recent SDK open/close execution for this wallet + product, scoped to your API
key — one partner never sees another partner’s activity for the same wallet.