fetch_account_summary

Documentation for eth_defi.derive.account.fetch_account_summary function.

fetch_account_summary(client, subaccount_id=None)

Fetch comprehensive account summary including collaterals and margin info.

Combines multiple API calls to build a complete account picture.

Example:

from eth_defi.derive.authentication import DeriveApiClient
from eth_defi.derive.account import fetch_account_summary

client = DeriveApiClient(...)
client.session_key_private = "0x..."

summary = fetch_account_summary(client)
print(f"Total value: ${summary.total_value_usd}")
print(f"Margin status: {summary.margin_status}")
for col in summary.collaterals:
    print(f"  {col.token}: {col.total}")
Parameters
  • client (DeriveApiClient) – Authenticated Derive API client with session key

  • subaccount_id (int | None) – Subaccount ID (defaults to client.subaccount_id)

Returns

Complete account summary

Raises

ValueError – If authentication fails or account not found

Return type

eth_defi.derive.account.AccountSummary