Luxor Documentation Hub Logo
Derivatives/API Documentation

Balances

Retrieve balance information for a specific currency type

GET
/api/v1/derivatives/balances/{currency_type}

Authorization

authorization<token>

Use your API key here.

In: header

Path Parameters

currency_typeRequiredstring

Currency type (e.g., BTC, USD)

curl -X GET "https://app.luxor.tech/api/v1/derivatives/balances/<string>" \
  -H "authorization: <token>"

Balance information

{
  "currency_type": "BTC",
  "current_margin_balance": {
    "realized_margin_balance": 110.887551818,
    "unrealized_margin_balance": 110.887551818,
    "effective_margin_balance": 110.887551818
  },
  "current_repayment_balance": {
    "upfront_payment_credits": 1310.613298448,
    "upfront_repayment_made": 1232.437007498,
    "upfront_repayment_balance": 78.1425895
  },
  "current_margin_requirement": {
    "maintenance_requirement": 6.9700358,
    "initial_buffer_pct": 0,
    "initial_buffer_requirement": 6.9700358
  },
  "current_available": {
    "maintenance_available": 103.91748238,
    "initial_buffer_available": 103.91748238
  }
}