Trader Stats

GET/gateway/v1/hyperliquid/trader/stats

Deprecated — use `/hyperliquid/performance`. This proxies Hydromancer's own trade-summary, which measures a DIFFERENT trade universe than our warehouse: its `total_pnl` is realized plus funding (after fees + funding) over Hydromancer's all-markets trade model, while `/hyperliquid/performance` is funding-excluded realized P&L over our `episodes` (closed round-trips). Because the trade definition, market scope, and funding treatment all differ, the two diverge on trade count, volume, fees, AND PnL — they do NOT reconcile and must never be shown together (the gap is structural, not merely the wallet's net funding). Retained only for backward compatibility.

Returns one wallet's aggregate trading performance: PnL, win/loss rate, volume, fees, funding, active days, and a human-likeness score. The `from`/`to` window is unreliable on this endpoint — the upstream summary does not consistently scope volume / trades / fees / traded_pairs to the window (a narrow window can report lifetime-scale volume and pair counts alongside zero trades); for windowed figures use `/hyperliquid/trades` or `/hyperliquid/fills`. `dex` limits to one market.

Query Parameters

addressstringrequired

Wallet address: a 0x EVM address or an ENS name (e.g. vitalik.eth). Solana addresses are not supported.

fromstring

Window start (Unix seconds or a date). Omit for lifetime.

Example: 2026-03-01

tostring

Window end (Unix seconds or a date). Defaults to now.

Example: 2026-03-01

dexenum<string>

Market scope: main_dex for the native market only, or omit to aggregate across all markets; or a builder market — one of: xyz, flx, vntl, hyna, km, abcd, cash, para, mkts.

Available options:main_dexxyzflxvntlhynakmabcdcashparamkts

Trader Stats

const options = {method: 'GET'};

fetch('https://api.asksurf.ai/gateway/v1/hyperliquid/trader/stats?from=2026-03-01&to=2026-03-01', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "$schema": "https://example.com/schemas/DataObjectResponseHyperliquidTraderStats.json",
  "data": {
    "account_age_days": 123,
    "address": "<string>",
    "days_active": 123,
    "human_score": 123,
    "loss_rate": 123,
    "total_fees": 123,
    "total_funding": 123,
    "total_pnl": 123,
    "total_trades": 123,
    "traded_pairs": [],
    "volume_traded": 123,
    "win_rate": 123
  },
  "meta": {
    "cached": true,
    "credits_used": 123,
    "empty_reason": "<string>"
  }
}