Users

Get all current positions for a wallet

Changed on

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

Request

  • Base URL: https://api.gauntlet.xyz
  • URL: https://api.gauntlet.xyz/v1/users/{wallet_address}/positions
  • Auth: none declared

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

  • 34bf11a7d24eRevision changes
    • info

      added the optional property / to the response with the status

  • 4452dcc4d7b3Revision changes
    • info

      added the new optional query request parameter include_hidden

    • info

      added the optional property // to the response with the status

    • info

      added the optional property / to the response with the status