Get all margin accounts with positions for an address

Retrieve all margin accounts with their positions for a specific address. This endpoint returns complete margin account data including deposits, withdrawals, P&L tracking, and all open positions.

No signature required - Only API key authentication is needed.

Margin Account Information Returned

For each margin account, you'll receive:

  • id: Unique margin account identifier
  • pair_id: Reference to the trading pair
  • deposits: Total deposits made to this account
  • withdrawals: Total withdrawals from this account
  • realised_pnl: Cumulative realized profit/loss
  • accrued_funding: Accumulated funding payments
  • liquidation: Whether the account has been liquidated
  • smart_account_address: Associated smart contract address
  • positions: Array of open positions with:
    • id: Position identifier
    • instrument: The specific option or perpetual contract
    • instrument_type: Type of instrument (option/perp)
    • size: Position size (negative for short, positive for long)
    • average_price: Volume-weighted average entry price
    • entry_fees: Total fees paid when opening the position

Key Features

  • Complete Account Data: Full margin account information including financial metrics
  • Consolidated View: See all accounts and positions across different trading pairs
  • Real-time Data: Data reflects the latest trades, deposits, and settlements
  • Comprehensive Tracking: Deposits, withdrawals, P&L, and fees all tracked separately

Example Use Cases

  1. Position Monitoring: Quick overview of all open trades
  2. Risk Assessment: Identify concentrated positions or exposures
  3. Trade Planning: Check existing positions before placing new orders
  4. Fee Analysis: Calculate total fees paid across all positions

Understanding Position Sizes

  • Positive size: Long position (bought the instrument)
  • Negative size: Short position (sold the instrument)
  • Options: Size represents number of contracts
  • Perpetuals: Size represents notional amount in base currency
Language
Credentials
Header
URL
Click Try It! to start a request and see the response here!