dYdX Documentation

Get Fills

Retrieves fill records for a specific subaccount on the exchange. A fill represents a trade that has been executed.

Method Declaration

Python

async def get_subaccount_fills(
    self,
    address: str,
    subaccount_number: int,
    ticker: Optional[str] = None,
    ticker_type: TickerType = TickerType.PERPETUAL,
    limit: Optional[int] = None,
    created_before_or_at_height: Optional[int] = None,
    created_before_or_at: Optional[str] = None,
) -> Any

Unification Plan

Rename all methods to get_fills - shorter is better.
Add a Subaccount pair to Python and JavaScript, since it's always a pair
Rename created_before_or_at_time parameter to created_before_or_at
page optional parameter is missing in Python
page optional parameter is missing in Rust
In Rust market field of the options struct must be ticker
In Rust market_type field of the options struct must be ticker_type

Parameters

Parameter	Location	Type	Required	Description
`address`	query	Address	true	The wallet address that owns the account.
`subaccountNumber`	query	SubaccountNumber	true	The identifier for the specific subaccount within the wallet address.
`market`	query	Ticker	false	The market symbol to filter fills by (e.g., "BTC-USD"). If not provided, fills for all markets will be returned. (Python/TS SDK parameter: `ticker`)
`marketType`	query	MarketType	false	The type of market to filter by. (Python/TS SDK parameter: `ticker_type` / `tickerType`)
`limit`	query	u32	false	Maximum number of asset positions to return in the response.
`createdBeforeOrAtHeight`	query	Height	false	Filters results to positions created at or before a specific blockchain height.
`createdBeforeOrAt`	query	DateTime	false	Filters results to positions created at or before a specific timestamp (ISO 8601 format).
`page`	query	u32	false	The page number for paginated results.

Response

A promise that resolves to fill data containing details such as order ID, market, side (buy/sell), size, price, execution time, and other fill-specific information.

Status	Meaning	Schema	Description
`200`	OK	FillResponseObject ⛁	The fills data.

API Example

Examples: Guide - Get Fills