Skip to main content
GET
https://api.0xarchive.io
/
v1
/
hyperliquid
/
wallets
/
classify
Classify Hyperliquid wallets
curl --request GET \
  --url https://api.0xarchive.io/v1/hyperliquid/wallets/classify \
  --header 'X-API-Key: <api-key>'
{
  "success": true,
  "data": {
    "wallets": [
      {
        "address": "0x010461c14e146ac35fe42271bdc1134ee31c703a",
        "metrics": {
          "total_orders": 123,
          "cancel_rate": 123,
          "fill_rate": 123,
          "order_to_trade_ratio": 123,
          "ioc_ratio": 123,
          "post_only_ratio": 123,
          "tpsl_ratio": 123,
          "trigger_order_ratio": 123,
          "unique_coins_traded": 123,
          "uses_tpsl": true,
          "uses_builder": true,
          "top_builder": "<string>",
          "avg_order_size_usd": 123,
          "max_order_size_usd": 123,
          "median_cancel_speed_ms": 123,
          "active_hours": 123,
          "total_fills": 123,
          "total_volume_usd": 123,
          "maker_ratio": 123,
          "long_short_ratio": 123,
          "buy_volume_usd": 123,
          "sell_volume_usd": 123,
          "total_fees_usd": 123,
          "realized_pnl_usd": 123,
          "liquidation_count": 123,
          "max_single_fill_usd": 123,
          "unique_fill_coins": 123,
          "uses_twap": true,
          "twap_fill_ratio": 123,
          "uses_cloid": true,
          "cloid_ratio": 123,
          "uses_priority_gas": true,
          "total_priority_gas_paid": 123,
          "total_builder_fees_paid": 123
        },
        "period": "24h"
      }
    ],
    "total": 4444,
    "date": "2026-06-16"
  },
  "meta": {
    "count": 123,
    "next_cursor": "<string>",
    "request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
  }
}

Authorizations

X-API-Key
string
header
required

API key for authentication. Get yours at https://www.0xarchive.io/dashboard/

Query Parameters

min_orders
integer<int64>
default:100

Minimum order count. Default 100.

min_volume_usd
number
default:0

Minimum fill volume in USD.

sort
enum<string>
default:total_orders

Metric to sort by.

Available options:
total_orders,
total_fills,
total_volume,
total_volume_usd,
cancel_rate,
fill_rate,
maker_ratio,
avg_order_size_usd,
avg_order_notional,
max_order_size_usd,
max_order_notional,
active_hours,
unique_coins,
total_fees,
total_fees_usd,
realized_pnl,
realized_pnl_usd,
median_cancel_speed_ms,
twap_fills,
total_priority_gas,
total_priority_gas_paid,
total_builder_fees,
total_builder_fees_paid
order
enum<string>
default:desc

Sort order.

Available options:
asc,
desc
limit
integer
default:100

Maximum wallets to return (default: 100, max: 1000).

Required range: 1 <= x <= 1000
offset
integer
default:0

Pagination offset. Capped at 100000.

Required range: x <= 100000
uses_twap
boolean

Filter wallets by TWAP usage.

uses_priority_gas
boolean

Filter wallets by priority-gas usage.

min_cancel_rate
number

Minimum cancel rate, from 0.0 to 1.0.

Required range: 0 <= x <= 1
max_cancel_rate
number

Maximum cancel rate, from 0.0 to 1.0.

Required range: 0 <= x <= 1
date
string<date>

Daily snapshot date (YYYY-MM-DD). Defaults to yesterday.

Example:

"2026-06-16"

Response

Wallet classification results

API response containing bulk wallet classification results.

success
boolean
Example:

true

data
object

Bulk wallet classification response body.

meta
object

Response metadata

Last modified on June 19, 2026