Appearance
Get Account Margin Information
GET
/v1/margin/status
Returns margining information for an account including margin fraction, collateralised margin fraction, initial margin fraction, collateralised balances in reference, reference currency, initial required in reference, available in reference, maintenance margin fraction, auto close margin fraction, leverage multiple, total positions at entry in reference, and total unrealised futures PnL in reference.
Note: This endpoint uses marginFraction (camelCase) field naming. The /v2/margin/status endpoint includes additional fields.
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 information retrieved successfully
application/json
JSON
{
"marginFraction": "0.10710575",
"collateralisedMarginFraction": "0.10398192",
"initialMarginFraction": "0.10032321",
"totalBorrowedInReference": "20065.42292",
"collateralisedBalancesInReference": "2013.1832234925416",
"referenceCurrency": "USDC",
"initialRequiredInReference": "2013.027732",
"availableInReference": "62.6810773874584",
"maintenanceMarginFraction": "0.050161607",
"autoCloseMarginFraction": "0.010075417",
"leverageMultiple": 9.34,
"totalPositionsAtEntryInReference": "20065.42292",
"totalUnrealisedFuturesPnlInReference": "73.2578",
"defaultInitialMarginFraction": "0.2",
"defaultMaintenanceMarginFraction": "0.1",
"defaultAutoCloseMarginFraction": "0.033333333"
}