Appearance
Get Account Margin Information
GET
/v2/margin/status
Returns margining information for an account including margin fraction, collateralised margin fraction, initial margin fraction, total leveraged exposure in reference, 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, total unrealised futures PnL in reference, total borrowed in reference, and trade reserved in reference.
Note: This endpoint includes additional fields (totalLeveragedExposureInReference, totalBorrowedInReference, tradeReservedInReference) compared to /v1/margin/status.
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": "60.20150659",
"collateralizedMarginFraction": "0.3958049",
"initialMarginFraction": "0.2",
"totalLeveragedExposureInReference": "40.87818421",
"collateralizedBalancesInReference": "0",
"referenceCurrency": "USDC",
"initialRequiredInReference": "8.175636842",
"availableInReference": "2444.74849043828165",
"maintenanceMarginFraction": "0.1",
"autoCloseMarginFraction": "0.033333333",
"leverageMultiple": 0.02,
"totalPositionsAtEntryInReference": "40.87818421",
"totalUnrealisedFuturesPnlInReference": "0",
"totalBorrowedInReference": "0",
"tradeReservedInReference": "16.1797854537"
}