Cascade
Account

Get Positions

Retrieve positions for an account

GET
/account/positions

Query Parameters

accountstring

Identifies the user whose positions are to be retrieved. Caller must be be authenticated as this account or a delegate.

subaccountIndexstring

Identifies the subaccount to retrieve positions for.

symbol?string

Filter positions by market symbol.

Response Body

application/json

text/plain

text/plain

curl -X GET "https://matcher.cascade.xyz/account/positions?account=0xe1c03ec3bcf509b3e8e63abcd03edc661ffe6a78&subaccountIndex=0&symbol=ETHUSD"
{
  "positions": [
    {
      "account": "0xe1c03ec3bcf509b3e8e63abcd03edc661ffe6a78",
      "basis": "3720.226",
      "fees": "1.323667",
      "funding": "87.382478",
      "margin": "558.621108",
      "quantity": "1.5",
      "subaccountIndex": 0,
      "symbol": "ETHUSD",
      "updatedAt": 1752846925500
    }
  ]
}
"Delegation not allowed for request"
"Symbol not found"