client.trades is your authenticated trade history and private fill stream. For the public tape,
see Public trades (client.market_data).
Methods
| Method | Summary |
|---|---|
list | Private user trades (subaccount_id, limit). |
subscribe | Stream private fills (recv_result()). |
List
Rust’s typed helper currently takes optional subaccount and limit only, there is no symbol filter on this convenience method (unlike Python/Go).
let page = client.trades.list(None, Some(50)).await?;
for t in &page.trades {
println!(
"{} {} {:?} {:?} {} {} {}",
t.match_id, t.order_id, t.price, t.qty, t.fee_amount_e18, t.fee_asset, t.fee_is_rebate
);
}Each UserTrade includes fee_amount_e18, fee_asset, referral_share_amount_e18, and fee_is_rebate. Fee magnitudes are fixed 18-decimal (U128) strings in units of fee_asset. fee_asset is "quote" or "base" (with unknown future enum values preserved as "UNKNOWN(<number>)"). fee_is_rebate is sparse: true means fee_amount_e18 is a rebate
credit rather than a fee debit (proto3 omits false).
When fee_asset is "base" on a BUY, convert fee_amount_e18 to the symbol's base quantity
scale before adjusting fill quantity: subtract for a fee, add for a rebate. Do not assume a BUY's
gross fill quantity is fully available to sell.
Subscribe
Private channel private:spot:trades:{account_id}:proto. Needs API key + Account ID. Realtime is
always compiled; the realtime Cargo feature is an empty compatibility flag.
let account = client.default_account_id.as_deref();
let mut sub = client.trades.subscribe(account).await?;
while let Some(trade) = sub.recv_result().await? {
println!("{} {} {:?}", trade.match_id, trade.order_id, trade.price);
break;
}