Appearance
Get Account Margin Status
GET
/v1/margin/account/status
Returns whether the account has margin trading enabled or not; and if it's currently in Liquidation state.
Liquidation
When an account falls below its maintenance margin, the value of its equity has dropped far enough that the risk that assets in the account won't cover all of the debt is beyond acceptable limits.
VALR aims to liquidate accounts well before there is a risk of permanent loss. We achieve this by gradually selling off assets when the account falls below maintenance margin.
The Liquidation process is set up in distinct stages that aim to keep an account above maintenance margin for as long as possible, reducing the impact of liquidation orders on order books and allowing customers the opportunity to take action to repay debt.
All liquidation orders placed during the first stage (i.e. below maintenance but above auto-close, and whether matcher or not) will be visible as orders of the type "liquidation limit order" on the particular account in question.
Similarly, for auto-close, the transfer of debt and assets out of the account will be visible on transaction history records as "liquidation takeover debt transfer" and "liquidation takeover asset transfer" respectively.
Authorizations
apiKey
Your API key
Type
API Key (header: X-VALR-API-KEY)
apiSignature
HMAC SHA512 signature of the request (see Authentication section)
Type
API Key (header: X-VALR-SIGNATURE)
apiTimestamp
Request timestamp in milliseconds
Type
API Key (header: X-VALR-TIMESTAMP)
Responses
Account margin status retrieved successfully
application/json
JSON
{
"marginEnabled": true,
"inLiquidation": false,
"futuresEnabled": true
}