latestOpenAPI 3.0.32026-08-10336178.7 KB

6b7d8bd51050

Positions

Get open positions

Returns active positions for the resolved account, including derived PnL, maintenance margin, bankruptcy price, and liquidation price. Public account selectors do not require authentication; sub_account_id and the no-selector caller context do. Selector precedence is account_id, vault_id, blockchain address, then authenticated caller/subaccount.

get/v2/positions

Query parameters

symbolstring

Filter by trading pair symbol

position_idinteger

Filter by position ID (requires symbol)

account_idstring uuid

Public account lookup by UUID. Takes precedence over every other account selector.

sub_account_idstring uuid

Select an active subaccount owned by the authenticated master account. Requires JWT or API-wallet authentication and is used only when account_id, vault_id, and blockchain_address are absent.

vault_idstring

Public vault lookup. Resolves the vault's trading account; ignored when account_id is present.

blockchain'cardano' | 'ethereum' | 'solana'

Blockchain used with blockchain_address for a direct lookup. If omitted, the server infers or searches supported chains.

blockchain_addressstring

Public wallet-address lookup (maximum 512 bytes).

Response

Open positions

countinteger required

Number of positions returned