Skip to main content
GET
cURL

Authorizations

X-Monaco-Signature
string
header
required

Ed25519 session-key request signing. Every authenticated request carries three headers: X-Monaco-PublicKey (64-char lowercase-hex session public key), X-Monaco-Timestamp (Unix milliseconds, within 30s of server time), and X-Monaco-Signature (hex ed25519 signature). The signature is over METHOD\npath?query\ntimestamp_ms\nSHA256_hex(body), where the body hash is the SHA-256 of the empty byte string when there is no body. Obtain the session keypair from POST /api/v1/auth/challenge followed by POST /api/v1/auth/verify.

Query Parameters

asset
string

Response

OK

asset
string | null
walletAvailable
string | null
walletLocked
string | null
marginTransferable
string | null
marginAvailableCollateral
string | null

The largest amount that can currently leave the user's parent margin account for this asset — the same bound as MarginAccountSummary.withdrawable_collateral, and served from the same value, so the two surfaces cannot disagree. Absent when the user has no margin account yet.

This is NOT trading headroom for existing cross exposure. It is bounded by allocation (principal not earmarked by risk buckets) as well as by margin requirements, and an unrealized gain does not raise it: a mark-to-market gain is initial margin against existing cross exposure but may not fund an exit. MarginAccountSummary.free_collateral credits that gain in full and remains the trading-margin headroom for existing cross exposure — but a NEW isolated or first-use position allocates principal through the same gate this field measures, so size those from this field.

Note the two margin_* fields answer opposite questions: margin_transferable is wallet-to-margin capacity, this is the amount that can come back out.