/builders/{builder}/users

GET https://data.vike.io/v1/hyperliquid/builders/{builder}/users

The wallets routing through one builder, ranked.

cURL

# the heaviest wallets routing through one builder, by volume
curl -s "https://data.vike.io/v1/hyperliquid/builders/0xb84168cf3be63c6b8dad05ff5d755e97432ff80b/users?limit=3" \
  -H "X-API-KEY: $VIKE_API_KEY"

# who pays the builder most: rank by fees instead of volume
curl -s "https://data.vike.io/v1/hyperliquid/builders/0xb84168cf3be63c6b8dad05ff5d755e97432ff80b/users?sort=fees&limit=50" \
  -H "X-API-KEY: $VIKE_API_KEY"

# whose users lose money: the traders' own signed realized PnL, worst first
curl -s "https://data.vike.io/v1/hyperliquid/builders/0xb84168cf3be63c6b8dad05ff5d755e97432ff80b/users?sort=pnl&order=asc&limit=20" \
  -H "X-API-KEY: $VIKE_API_KEY"

# a shorter window for a recent read of the same ranking
curl -s "https://data.vike.io/v1/hyperliquid/builders/0xb84168cf3be63c6b8dad05ff5d755e97432ff80b/users?window=7d&limit=100" \
  -H "X-API-KEY: $VIKE_API_KEY"

# next page: NEXT is the previous response's nextCursor; the cursor pins the window, so the walk is one snapshot
curl -s "https://data.vike.io/v1/hyperliquid/builders/0xb84168cf3be63c6b8dad05ff5d755e97432ff80b/users?window=7d&limit=100&cursor=$NEXT" \
  -H "X-API-KEY: $VIKE_API_KEY"

builderpathrequired

Builder address

windowqueryoptional

1d | 7d | 30d | all. Default 30d

sortqueryoptional

volume | fees | pnl. Default volume

orderqueryoptional

asc | desc. Default desc

limitqueryoptional

Default 100, max 1000

cursorqueryoptional

Keyset cursor

Example response

{
  "builder": "0xb84168cf3be63c6b8dad05ff5d755e97432ff80b",
  "window": {
    "window": "30d",
    "start": "2026-08-04T08:06:57.246000+00:00",
    "end": "2026-09-03T08:06:57.246000+00:00"
  },
  "sort": "volume",
  "order": "desc",
  "users": [
    {
      "wallet": "0xe1b02144c101e4f6c41bc746f854214404efa23d",
      "rank": 1,
      "assets": 1,
      "fee_usd": 58025.66724299987,
      "volume_usd": 116051339.95361994,
      "share_volume_usd": 116051339.95361994,
      "fills": 6401,
      "fee_rate_bps": 4.999999764430975,
      "fee_usd_node": 58025.66724299987,
      "trader_fee_usd": 96609.87647999988,
      "builder_routed_deployer_fee_usd": 0.0,
      "closed_pnl_usd": -16109.553342999967,
      "active_days": 30,
      "crossed_fills": 6238,
      "taker_pct": 97.45352288704889,
      "first_seen": "2026-08-04T10:39:34.604000+00:00",
      "last_seen": "2026-09-02T19:18:12.778000+00:00"
    },
    {
      "wallet": "0xff573cc8d53d6ca48134c23da75df1984ff28c24",
      "rank": 2,
      "assets": 11,
      "fee_usd": 32611.176251000008,
      "volume_usd": 65043708.12699884,
      "share_volume_usd": 65043708.12699884,
      "fills": 13193,
      "fee_rate_bps": 5.013732640723094,
      "fee_usd_node": 32611.176251000008,
      "trader_fee_usd": 56593.81896899996,
      "builder_routed_deployer_fee_usd": 29.69778300000001,
      "closed_pnl_usd": 1960.3512290000253,
      "active_days": 17,
      "crossed_fills": 13193,
      "taker_pct": 100.0,
      "first_seen": "2026-08-04T08:10:00.798000+00:00",
      "last_seen": "2026-08-20T09:47:11.594000+00:00"
    },
    {
      "wallet": "0x30381168675a9c97dbeb108b8cde33aba434be4f",
      "rank": 3,
      "assets": 20,
      "fee_usd": 30719.542745999996,
      "volume_usd": 61419224.695899084,
      "share_volume_usd": 61419224.695899084,
      "fills": 5981,
      "fee_rate_bps": 5.001616822436236,
      "fee_usd_node": 30719.542745999996,
      "trader_fee_usd": 54596.672999999966,
      "builder_routed_deployer_fee_usd": 547.0871540000002,
      "closed_pnl_usd": 57038.65442500002,
      "active_days": 19,
      "crossed_fills": 5981,
      "taker_pct": 100.0,
      "first_seen": "2026-08-04T09:14:37.068000+00:00",
      "last_seen": "2026-08-23T03:42:46.452000+00:00"
    }
  ],
  "nextCursor": "eyJoaSI6IjIwMjYtMDktMDNUMDg6MDY6NTcuMjQ2MDAwKzAwOjAwIiwibG8iOiIyMDI2LTA4LTA0VDA4OjA2OjU3LjI0NjAwMCswMDowMCIsInIiOjMsInYiOjYxNDE5MjI0LjY5NTg5OTA4NCwidyI6IjB4MzAzODExNjg2NzVhOWM5N2RiZWIxMDhiOGNkZTMzYWJhNDM0YmU0ZiJ9"
}

sort=pnl ranks the traders' result, not the builder's

sort=pnl ranks sum(closed_pnl) — the traders' realized result, not the builder's. It is signed, and a builder whose users lose money is a different business from one whose users win.