One Hyperliquid builder: profile, users, fills, daily revenue series, retention

/v1/hyperliquid/builders/{builder} returns one builder's window totals, per-coin and per-dex breakdowns, user-volume deciles and lifetime block; /users, /fills and /series go one level down.

GET /v1/hyperliquid/builders/{builder} answers it in one call, as the profile: totals for the window (revenue, volume, fills, users, take rate, share of the venue), the best day, a breakdown per coin and per dex, the users split into ten volume deciles, and a lifetime block that ignores the window. Three sub-routes go deeper: /users ranks its wallets, /fills lists its routed fills, and /series gives revenue, volume and users per hour or day. The full parameter lists are on Builder profile, Builder users, Builder fills and Builder daily series.

Quick answer

Put the builder address in the path; breakdown_limit cuts the per-coin and per-dex lists.

cURL

# one builder's 30-day profile, with the top three coins and dexes
curl -H "X-API-Key: $VIKE_API_KEY" \
  "https://data.vike.io/v1/hyperliquid/builders/0xb84168cf3be63c6b8dad05ff5d755e97432ff80b?window=30d&breakdown_limit=3"

Example response

Captured from the live API on 2026-10-24 at 17:16 UTC, trimmed to 1 row of by_symbol and by_dex and 2 of the 10 deciles.

In 30 days the builder earned $1.40M from 34,517 users at a realized 5.32 bps, with a median of 5.00 bps on the fills that paid it (fee_rate_bps_p50). The deciles show the shape: the top tenth of users routed 94.6% of the volume, the bottom tenth 0.004%. lifetime covers 500 active days since 2025-06-12 and $27.5M of revenue.

Example response

{
  "builder": "0xb84168cf3be63c6b8dad05ff5d755e97432ff80b",
  "window": {
    "window": "30d",
    "start": "2026-09-24T17:16:01.603000+00:00",
    "end": "2026-10-24T17:16:01.603000+00:00"
  },
  "totals": {
    "fee_usd": 1403790.8224120003,
    "volume_usd": 2637780410.3248663,
    "share_volume_usd": 2637780410.3248663,
    "fills": 1671358,
    "users": 34517,
    "revenue_per_user": 40.66954898780312,
    "fee_rate_bps": 5.32186385537343,
    "fee_usd_node": 1403790.8224120003,
    "trader_fee_usd": 2395691.147484999,
    "builder_routed_deployer_fee_usd": 22344.546247999995,
    "active_days": 31,
    "crossed_fills": 1659212,
    "taker_pct": 99.27328555581748,
    "first_seen": "2026-09-24T17:16:02.752000+00:00",
    "last_seen": "2026-10-24T17:15:57.104000+00:00",
    "fee_rate_bps_p50": 4.9999919654188085,
    "trader_fee_rate_bps": 9.082223592637677,
    "routed_closed_pnl_usd": 551183.253068001,
    "symbols": 295,
    "dexes": 3,
    "buy_volume_usd": 1367510535.8893876,
    "sell_volume_usd": 1270269874.435478,
    "non_usd_fee_fills": 0,
    "non_usd_fee_volume_usd": 0.0,
    "profitable_users": 16235,
    "profitable_users_pct": 47.034794449112034,
    "market_share_pct": 0.5581706506638864,
    "venue_volume_usd": 472575977828.1963,
    "market_share_window_start": "2026-09-24T17:16:01.603000+00:00",
    "biggest_day": {
      "date": "2026-10-16",
      "fee_usd": 117324.18788900084,
      "volume_usd": 224309753.50541773,
      "fills": 54146,
      "users": 4621
    }
  },
  "by_symbol": [
    {
      "symbol": "BTC",
      "fee_usd": 541046.7265430006,
      "volume_usd": 1082337213.1417294,
      "share_volume_usd": 1082337213.1417294,
      "fills": 242921,
      "users": 15273,
      "revenue_per_user": 35.42504593354289,
      "fee_rate_bps": 4.998873918161694,
      "fee_usd_node": 541046.7265430006,
      "trader_fee_usd": 978681.6500969994,
      "builder_routed_deployer_fee_usd": 0.0,
      "closed_pnl_usd": 556740.6179370006,
      "active_days": 31,
      "crossed_fills": 240654,
      "taker_pct": 99.06677479509798,
      "first_seen": "2026-09-24T17:16:02.752000+00:00",
      "last_seen": "2026-10-24T17:15:19.465000+00:00",
      "fee_rate_bps_p50": 4.9999927455102835
    }
  ],
  "by_dex": [
    {
      "dex_name": "HL",
      "fee_usd": 1142689.489278008,
      "volume_usd": 2286730859.7571793,
      "share_volume_usd": 2286730859.7571793,
      "fills": 1393378,
      "users": 31049,
      "revenue_per_user": 36.80277913227505,
      "fee_rate_bps": 4.997044074523692,
      "fee_usd_node": 1142689.489278008,
      "trader_fee_usd": 2084936.6046770017,
      "builder_routed_deployer_fee_usd": 0.0,
      "closed_pnl_usd": 839563.3017279883,
      "active_days": 31,
      "crossed_fills": 1383324,
      "taker_pct": 99.27844418384673,
      "first_seen": "2026-09-24T17:16:02.752000+00:00",
      "last_seen": "2026-10-24T17:15:51.566000+00:00",
      "fee_rate_bps_p50": 4.999988507191725
    }
  ],
  "user_volume_distribution": [
    {
      "decile": 1,
      "users": 3452,
      "volume_usd": 94499.07235199981,
      "volume_share_pct": 0.003582522335146219,
      "fee_usd": 51.734770000000005,
      "min_volume_usd": 0.84374,
      "max_volume_usd": 46.644,
      "profitable_users": 952,
      "profitable_users_pct": 27.578215527230594,
      "closed_pnl_usd": 133.292607
    },
    {
      "decile": 2,
      "users": 3452,
      "volume_usd": 263553.0536650001,
      "volume_share_pct": 0.009991470580090532,
      "fee_usd": 144.3314620000004,
      "min_volume_usd": 46.64659999999999,
      "max_volume_usd": 111.39001400000001,
      "profitable_users": 1294,
      "profitable_users_pct": 37.485515643105444,
      "closed_pnl_usd": 696.9134480000008
    }
  ],
  "lifetime": {
    "first_seen": "2025-06-12T01:30:06+00:00",
    "last_seen": "2026-10-24T17:15:57.104000+00:00",
    "active_days": 500,
    "fills": 23404031,
    "users": 196592,
    "fee_usd": 27480998.260969616,
    "volume_usd": 53792649451.47612,
    "revenue_per_user": 139.78696112237333
  }
}

Variations

Its users. The builder's wallets ranked by volume.

cURL — users

# the builder's wallets ranked by volume over 30 days
curl -H "X-API-Key: $VIKE_API_KEY" \
  "https://data.vike.io/v1/hyperliquid/builders/0xb84168cf3be63c6b8dad05ff5d755e97432ff80b/users?window=30d&limit=20"

Its fills. The newest fills routed through the builder.

cURL — fills

# the newest fills routed through the builder
curl -H "X-API-Key: $VIKE_API_KEY" \
  "https://data.vike.io/v1/hyperliquid/builders/0xb84168cf3be63c6b8dad05ff5d755e97432ff80b/fills?limit=100"

Daily revenue series. One row per UTC day; limit must cover every day of the range.

cURL — series

# revenue, volume, users and fills per UTC day for September; limit must cover every day
curl -H "X-API-Key: $VIKE_API_KEY" \
  "https://data.vike.io/v1/hyperliquid/builders/0xb84168cf3be63c6b8dad05ff5d755e97432ff80b/series?bucket=1d&start=2026-09-01T00:00:00Z&end=2026-10-01T00:00:00Z&limit=31"

Whether users come back. The retention recipe reads each user's first and last day with the builder from /users?window=all.

cURL — all-time users

# every user of the builder with first_seen, last_seen and active_days over the whole history
curl -H "X-API-Key: $VIKE_API_KEY" \
  "https://data.vike.io/v1/hyperliquid/builders/0xb84168cf3be63c6b8dad05ff5d755e97432ff80b/users?window=all&limit=1000"

Before you rely on it

users does not add up across days

users in /series is the distinct wallets of each bucket, so summing the daily column counts a wallet once per day it traded. A period's user count comes from the profile over that period. profitable_users tests each wallet's total realized PnL, not single fills. fee_rate_bps is the realized rate, fee over volume; the rate the builder set on each order is not in the data, and fee_rate_bps_p50 is the closest thing to it.

Breakdowns are cut by breakdown_limit

by_symbol and by_dex keep the breakdown_limit biggest rows (default 100); totals.symbols and totals.dexes count the whole window, so compare them to see a cut. fee on /fills is raw, in its own fee_token; sum fee_usd instead. A checksummed builder address works: it is lower-cased before the lookup.

Ask your agent

Connected to the Vike MCP server (https://vike.io/mcp) in Claude, ChatGPT or Cursor, ask it in plain words. The hl_builders tool answers with view: profile, at 1 credit a call.

Ask your agent

Profile the Hyperliquid builder 0xb84168cf3be63c6b8dad05ff5d755e97432ff80b over 30 days: revenue, users, take rate, top coins

One Hyperliquid builder: profile, users, fills, daily revenue series, retention

Quick answer

Example response

Variations

Before you rely on it

Ask your agent

Related