Sign in

v1

latestOpenAPI 3.0.02026-07-2471143147.5 KB
Stats

Get user trading stats

Get per-wallet trading stats (volume + fees + trade count + last trade timestamp + win rate) within a time range.

get/v1/stats/user-trading

Query parameters

addressstring required

Wallet address (0x prefixed hex)

Response

A successful response.

addressstring

Wallet address (echoed back).

traded_volumestring

Regular trading volume: non-liquidation matches (limit/market + TPSL).

liquidation_volumestring

Liquidation volume: forcibly-closed positions.

total_volumestring

traded_volume + liquidation_volume.

maker_feestring

Fees paid on maker-side fills.

taker_feestring

Fees paid on taker-side fills.

liquidation_feestring

Penalty fees paid on liquidation.

total_feestring

maker_fee + taker_fee + liquidation_fee.

trade_countinteger

Lifetime match count: maker + taker participations.

last_trade_atstring int64

Unix nanos of the wallet's most recent match across maker + taker sides. 0 when the wallet has never traded — FE renders as "—" or "Never".

win_ratestring

Closed-position win rate, as a decimal string in [0, 1] (e.g. "0.5720" = 57.2%). A "closed position" = a position_records row where pnl_after != pnl_before; a "win" = pnl_after > pnl_before. "0" when the wallet has no closed positions — numeric default, not a sentinel, so FE can always parseFloat without special-casing.