Skip to main content
GET
Get identity

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.

Response

The account's ID, status, username and wallet.

account_id
string<uuid>
required

Totalis account ID.

Pattern: ^[0-9a-f]{8}-[0-9a-f]{4}-7[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$
status
enum<string>
required

Account status: ACTIVE, RESTRICTED (some actions are refused by policy) or CLOSED.

Available options:
ACTIVE,
RESTRICTED,
CLOSED
wallet
string
required

The account's wallet: its Privy embedded wallet, or the one wallet of an account that signs in with an external wallet. It is the account's owner, which signs API-key issuance, and its signer, which signs its financial actions.

Pattern: ^0x[0-9a-f]{40}$
username
string | null

The account's public username, or null until it picks one with PUT /v1/me/username. Servers before contract 129 omit it.

Pattern: ^[a-z0-9_]{3,20}$