Positions

Read positions: account positions by wallet, and live SDK position holdings by product.

cesto.positions has two reads: getPositions for a user’s Cesto-account positions, and getPosition for the live, on-chain position in one basket — the position view for SDK-opened positions.

Get all positions

cesto.positions.getPositions returns a user’s open and closing positions, resolved from their external Solana wallet address, with no end-user login required.

const { positions, pendingClosePositions } = await cesto.positions.getPositions({
  user: 'EXTERNAL_SOLANA_ADDRESS',
});

user · string · required

External Solana wallet address to look up.

positions · Position[]

Live open / partially-open positions.

pendingClosePositions · Position[]

Positions with a close currently in progress.

A wallet with no Cesto account returns an empty result ({ positions: [], pendingClosePositions: [] }) and is not an error. The user 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 getPosition below.

Position by product (SDK positions)

cesto.positions.getPosition 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.

const position = await cesto.positions.getPosition({
  user: 'SOLANA_ADDRESS',
  slug: 'defi-blue-chip',
});

position.hasPosition;   // true when the wallet holds any of the basket's tokens
position.totalValueUsd; // 101.2
position.holdings;      // [{ mint, symbol, name, amount /* base units */, decimals, priceUsd, valueUsd }]
position.lastExecution; // { executionId, type, status, startedAt, completedAt } | null

user · string · required

Solana address to read.

slug · string · required

Basket to read, by slug (a product id also works).

holdings · Holding[]

The wallet’s live balances of the basket’s constituent tokens, with USD prices and values.

totalValueUsd · number

Total USD value of the holdings.

hasPosition · boolean

True when the wallet holds any of the basket’s tokens (i.e. a close would sell something).

lastExecution · object | null

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.

Opening and closing

To open or close a position (client-signed, write-scoped key), see Open a Position and Close a Position.