Api set sub account collateral preference request

ApiSetSubAccountCollateralPreferenceRequest

Enable or disable one or more currencies as collateral for a Multi-Asset Mode sub account.

USDT (the quote currency) cannot be disabled. Disabling collateral currencies reduces MarginBalance, and the batch is rejected when Initial Margin would no longer be covered.

Name
Lite
Type Required
Default
Description
sub_account_id
sa
string True The sub account ID to set collateral preferences for
preferences
p
[ApiCollateralPreferenceItem] True Per-currency preferences applied atomically. Duplicate currencies and empty lists are rejected.
signature
s
Signature True The signature of this operation
ApiCollateralPreferenceItem

A single (currency, enable) pair to toggle as collateral.

Name
Lite
Type Required
Default
Description
currency
c
string True The currency whose collateral preference is being changed
enable
e
boolean True True to include the currency as collateral, false to exclude it
Signature
Name
Lite
Type Required
Default
Description
signer
s
string True The address (public key) of the wallet signing the payload
r
r
string True Signature R
s
s1
string True Signature S
v
v
integer True Signature V
expiration
e
string True Timestamp after which this signature expires, expressed in unix nanoseconds. Must be capped at 30 days
nonce
n
integer True Users can randomly generate this value, used as a signature deconflicting key.
ie. You can send the same exact instruction twice with different nonces.
When the same nonce is used, the same payload will generate the same signature.
Our system will consider the payload a duplicate, and ignore it.
Range: 0 to 4,294,967,295 (uint32)
chain_id
ci
string True Chain ID used in EIP-712 domain. Zero value fallbacks to GRVT Chain ID.