Sign in
Users

Get all current positions for a wallet

Returns every vault position the wallet currently holds or has pending exposure in (pending deposit or redeem). Fully-exited positions (zero shares, no pending escrow) are excluded. Scoped to the Gauntlet-curated vault set: only positions in publicly listed vaults are returned by default, include_hidden=true widens to hidden (enabled but unlisted) vaults, and positions in disabled vaults are never returned.

All monetary metrics include a usd field (null when pricing is unavailable). value.usd and pending_deposit_assets.usd use the current spot price. cost_basis.usd and pnl.realized.usd are computed by replaying on-chain events against the token's historical price series — the same method used by GET /v1/users/{wallet}/positions/{vault_id}. pnl.unrealized.usd, pnl.total.usd, and roi_pct.usd are derived from those.

Cursor-paginated on internal position ID. Default page size 100, max 500.

get/v1/users/{wallet_address}/positions

Path parameters

wallet_addressstring required

Ethereum wallet address

Query parameters

nextstring

Opaque cursor from previous meta.next_cursor.

limitinteger

Page size (1–500, default 100).

include_hiddenboolean

Include positions in hidden (enabled but unlisted) vaults alongside visible ones. Positions in disabled vaults are never returned.

Response

All wallet positions

Changes

Changed in 2 of the 3 revisions of this API.4

  • 4452dcc4d7b33See the full diff
    • ○

      added the new optional query request parameter include_hidden

      new-optional-request-parameter

    • ○

      added the optional property data/items/numeraire_token to the response with the 200 status

      response-optional-property-added

    • ○

      added the optional property meta/partial_errors to the response with the 200 status

      response-optional-property-added

  • bd6a0a40d4fc1See the full diff
    • ○

      endpoint added

      endpoint-added