Struct Trade 

pub struct Trade {
    pub perpetual_id: PerpetualId,
    pub taker_account_id: AccountId,
    pub taker_request_id: RequestId,
    pub taker_side: OrderSide,
    pub taker_fee: UD64,
    pub taker_builder: Option<BuilderAttribution>,
    pub taker_builder_fee: UD64,
    pub maker_fills: Vec<MakerFill>,
}

A complete trade event: one taker matched against one or more makers.

Each TakerTrade represents a single taker order execution that may have matched against multiple maker orders. The maker_fills vector contains all individual maker fills that occurred as part of this trade.

Fields

perpetual_id: PerpetualId

Perpetual contract ID.

taker_account_id: AccountId

Taker account ID.

taker_request_id: RequestId

Taker request ID.

taker_side: OrderSide

Taker side (Bid = buying, Ask = selling).

taker_fee: UD64

Taker fee paid (normalized decimal, in collateral token).

taker_builder: Option<BuilderAttribution>

Builder the taker order is attributed to, with the fee rate it charges, if any.

taker_builder_fee: UD64

Builder fee earned on the taker side (normalized decimal, in collateral token).

Included in Self::taker_fee, so consumers must not add it on top.

maker_fills: Vec<MakerFill>

All maker fills matched by this taker order.

Implementations

impl Trade

pub fn total_size(&self) -> UD64

Total size filled across all makers.

pub fn avg_price(&self) -> Option<UD64>

Volume-weighted average price across all maker fills.

Returns None if there are no fills.

pub fn total_maker_fees(&self) -> UD64

Total maker fees paid across all fills.

pub fn total_builder_fees(&self) -> UD64

Total builder fees earned on this trade, taker and maker sides combined.

Part of Self::taker_fee and the maker fees, not additional to them.

pub fn builder_total(&self, builder_id: BuilderId) -> UD64

Total builder fees earned by a specific builder on this trade.

pub fn maker_total(&self, account_id: AccountId) -> Option<(UD64, UD64, UD64)>

Volume-weighted average price, total size and total fees for a specific maker.

Returns None if the maker has no fills in this trade.

Trait Implementations

impl Clone for Trade

fn clone(&self) -> Trade

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for Trade

fn fmt(&self, __derive_more_f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.