Sign in

v56

latestOpenAPI 3.0.0raw.githubusercontent.com2026-08-03113163377.5 KB
Account

Get account information

Respond with requester's account information

get/account

Query parameters

subaccount_addressstring

Subaccount address

Response

OK

accountstring

User's starknet account

account_valuestring

Current account value [with unrealized P&Ls]

free_collateralstring

Free collateral available (Account value in excess of Initial Margin required)

initial_margin_requirementstring

Amount required to open trade for the existing positions

last_seen_notificationinteger

Latest notification event timestamp (ms) the user has seen — used for cross-device dedup

maintenance_margin_requirementstring

Amount required to maintain exisiting positions

margin_cushionstring

Acc value in excess of maintenance margin required

seq_nointeger

Unique increasing number (non-sequential) that is assigned to this account update. Can be used to deduplicate multiple feeds

settlement_assetstring

Settlement asset for the account

statusstring

Status of the acc - like ACTIVE, LIQUIDATION

total_collateralstring

User's total collateral

updated_atinteger

Account last updated time

Example response

{
  "account": "0x495d2eb5236a12b8b4ad7d3849ce6a203ce21c43f473c248dfd5ce70d9454fa",
  "account_value": "136285.06918911",
  "free_collateral": "73276.47229774",
  "initial_margin_requirement": "63008.59689218",
  "last_seen_notification": 1713400000000,
  "maintenance_margin_requirement": "31597.25239676",
  "margin_cushion": "104687.8167956",
  "seq_no": 1681471234972000000,
  "settlement_asset": "USDC",
  "status": "ACTIVE",
  "total_collateral": "123003.62047353",
  "updated_at": 1681471234972
}
All 113 operations