Skip to content

HTTPClient

HTTPClient

Synchronous HTTP client

Attributes

account property 

account: LightAccount

Get the LightAccount instance (this is not a web3 contract instance).

active_subaccount property 

active_subaccount: Subaccount

Get the currently active subaccount.

bridge property 

bridge: BridgeClient

Get the bridge client for cross-chain transfers.

cached_subaccounts property 

cached_subaccounts: list[Subaccount]

Get all cached subaccounts.

collateral property 

collateral: CollateralOperations

Manage collateral and margin.

logger property 

logger: LoggerType

markets property 

markets: MarketOperations

Access market data and instruments.

mmp property 

mmp: MMPOperations

Market maker protection settings.

orders property 

orders: OrderOperations

Place and manage orders.

positions property 

positions: PositionOperations

View and manage positions.

rfq property 

rfq: RFQOperations

Request for quote operations.

trades property 

trades: TradeOperations

View trade history.

transactions property 

transactions: TransactionOperations

Query transaction status and details.

Functions

connect 

connect() -> None

Connect to Derive and validate credentials, fetch and cache market instruments.

disconnect 

disconnect() -> None

Close the underlying session and clear cached state. Idempotent.

fetch_subaccount 

fetch_subaccount(subaccount_id: int) -> Subaccount

Fetch a subaccount from API and cache it.

fetch_subaccounts 

fetch_subaccounts() -> list[Subaccount]

Fetch subaccounts from API and cache them.

from_env classmethod 

from_env(
    session_key_path: Path | None = None,
    env_file: Path | None = None,
) -> HTTPClient

Create the HTTPClient instance.

timeout 

timeout(seconds: float) -> Generator[None, None, None]

Temporarily overwrite client's HTTPSession's request_timeout.