Skip to main content
GET
Wallet activity summary (single round-trip)

Authorizations

Authorization
string
header
required

Ironflow API key, format if_xxxx. Free keys at https://ironflow.sh/key. Optional on read endpoints.

Query Parameters

source
enum<string>
default:hyperliquid

Venue identifier. Defaults to hyperliquid.

Available options:
hyperliquid
address
string

Wallet address filter (hex string, e.g. 0xabc123).

Example:

"0xabc123def456"

from
integer<int64>

Start time as Unix milliseconds. Defaults to 24 hours ago. Clamped to tier history window. On /v1/trades and /v1/fills, the time range (to - from) is limited per tier (no key 1h, free key 6h, Explorer 24h, Builder 7d, Enterprise unlimited; without market filter 4h for all tiers). Returns QUERY_WINDOW_EXCEEDED (400) if exceeded — paginate with narrower from/to windows.

Example:

1718313600000

to
integer<int64>

End time as Unix milliseconds. Defaults to now.

Example:

1718400000000

Response

Wallet summary stats.

Aggregate stats for one address over a window. Single CH aggregation.

address
string
required
from
integer<int64>
required
to
integer<int64>
required
fills
integer<int64>
required
volume_usd
number<double>
required
realized_pnl
number<double>
required
wins
integer<int64>
losses
integer<int64>
win_rate
number<double>
maker_fills
integer<int64>
taker_fills
integer<int64>
pct_maker
number<double>
markets_count
integer<int64>
first_fill_ts
integer<int64> | null
last_fill_ts
integer<int64> | null