Skip to main content
POST
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.

Path Parameters

marginAccountId
string
default:2b1a5f9c-0000-4000-8000-000000000001
required

Parent margin account UUID that releases collateral.

Body

application/json
marginAccountId
string | null

Parent margin account UUID that releases collateral.

asset
string | null
amount
string | null
tradingPairId
string<uuid> | null

Optional trading pair UUID used to release collateral from an isolated risk bucket under the parent margin account. If omitted, the transfer applies to the parent margin account only.

strategyKey
string | null

Optional strategy key echoed in responses when callers scope a risk bucket.

marginMode
string | null

Risk bucket mode. Defaults to ISOLATED, which is selected by tradingPairId. Pass CROSS to release from the account's cross risk bucket, which has no trading pair and so cannot be named any other way. Values: ISOLATED, CROSS.

Response

OK

movementId
string | null
marginAccountId
string | null
asset
string | null
amount
string | null
status
string | null
newEquity
string | null
newTotalCollateralValue
string | null
newWithdrawableCollateral
string | null

The largest amount a further transfer-out will accept after this one. See MarginAccountSummary.withdrawable_collateral: this is an allocation-bounded figure, not clamped equity headroom.

strategyKey
string | null