Skip to main content
GET
Get position

Authorizations

Authorization
string
header
required

Scoped API key from the Totalis app settings. Each key acts for one account, yours or a maker's, and holds only scopes that account can use. Each operation lists the scopes it requires.

Headers

Origin
string<uri>

Required for browser sessions; API keys do not require an Origin.

Path Parameters

position_id
string
required

Position ID: the contract's ticketId (lowercase bytes32 hex).

Pattern: ^0x[0-9a-f]{64}$

Response

The position, reconciled against the vault contract. A key for your account reads the positions you hold; a key for a maker reads the positions the maker backs. The key's permissions are checked on every request. One freshness status covers the read; amounts are atomic USDC strings or null. No shared caching.

context
object
required

Freshness of this read: the oldest source observation and one status for every amount in the response.

position
object
required

The requested position.