Classify HIP-3 wallets

curl --request GET \
  --url https://api.0xarchive.io/v1/hyperliquid/hip3/wallets/classify \
  --header 'X-API-Key: <api-key>'

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://api.0xarchive.io/v1/hyperliquid/hip3/wallets/classify', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.0xarchive.io/v1/hyperliquid/hip3/wallets/classify"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "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": {
    "request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "count": 123,
    "has_more": true,
    "next_cursor": "<string>",
    "symbol": "BTC",
    "venue": "hyperliquid",
    "coverage_from": "2023-11-07T05:31:56Z",
    "notice": "<string>",
    "finalized_through": "2023-11-07T05:31:56Z",
    "requested_end": "2023-11-07T05:31:56Z",
    "clamped_to": "2023-11-07T05:31:56Z",
    "preliminary_row_count": 123
  }
}

GET

https://api.0xarchive.io

hyperliquid

hip3

wallets

classify

Classify HIP-3 wallets

curl --request GET \
  --url https://api.0xarchive.io/v1/hyperliquid/hip3/wallets/classify \
  --header 'X-API-Key: <api-key>'

const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};

fetch('https://api.0xarchive.io/v1/hyperliquid/hip3/wallets/classify', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.0xarchive.io/v1/hyperliquid/hip3/wallets/classify"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("X-API-Key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

{
  "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": {
    "request_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "count": 123,
    "has_more": true,
    "next_cursor": "<string>",
    "symbol": "BTC",
    "venue": "hyperliquid",
    "coverage_from": "2023-11-07T05:31:56Z",
    "notice": "<string>",
    "finalized_through": "2023-11-07T05:31:56Z",
    "requested_end": "2023-11-07T05:31:56Z",
    "clamped_to": "2023-11-07T05:31:56Z",
    "preliminary_row_count": 123
  }
}

API key required. Send X-API-Key with this request. See REST authentication.

Operation schema

Shared request rules

Machine schema

Open the generated operation schema for machine-readable request and response details.

Authorizations

X-API-Key

string

header

required

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

Headers

0xArchive-Version

enum<string>

Selects the 2026-10 response contract. Send 2026-10-01; any dated version on or after it selects the same shapes. Without the header every response keeps its existing shape. With it:

The data quality routes, /v1/status/coverage and /v1/symbols answer the standard {success, data, meta} envelope.
Record times that are integer milliseconds by default become RFC 3339 UTC strings with millisecond precision, and the integer moves to a *_ms field: L4 resting-order timestamp (timestamp_ms), CVD buckets, HIP-3 oracle reads, Lighter and Lighter on Robinhood Chain liquidations and liquidation volume. Levels and trigger-levels snapshot_ts become RFC 3339 with snapshot_ts_ms.
Error bodies carry the contract error_code names: invalid_parameter instead of invalid_query_params and invalid_path_params, historical_depth_exceeded instead of history_window_exceeded, and historical_range_exceeded instead of request_range_exceeded; a malformed cursor that fails to parse answers 400 invalid_cursor instead of invalid_query_params. With 0xArchive-Version: 2026-10-01, malformed cursors on trades, liquidations, L2 and L4 diffs, order history, TP/SL and order-flow routes answer 400 invalid_cursor. Without the header, the first six route families treat a malformed cursor as no cursor and return the first page; order flow answers 400 invalid_query_params. Malformed trade time inputs answer 400 invalid_time_range with the header and 400 invalid_query_params without it.

The response echoes the selected version in its own 0xArchive-Version header.

Available options:

2026-10-01

Example:

"2026-10-01"

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

HIP-3 wallet classification results

API response containing bulk wallet classification results.

success

boolean

Example:

true

data

object

Bulk wallet classification response body.

Hide child attributes

data.wallets

object[]

required

Hide child attributes

data.wallets.address

string

required

Wallet address.

Example:

"0x010461c14e146ac35fe42271bdc1134ee31c703a"

data.wallets.metrics

object

required

Precomputed wallet behavior metrics.

Hide child attributes

data.wallets.metrics.total_orders

integer<int64>

data.wallets.metrics.cancel_rate

number

data.wallets.metrics.fill_rate

number

data.wallets.metrics.order_to_trade_ratio

number

data.wallets.metrics.ioc_ratio

number

data.wallets.metrics.post_only_ratio

number

data.wallets.metrics.tpsl_ratio

number

data.wallets.metrics.trigger_order_ratio

number

data.wallets.metrics.unique_coins_traded

integer<int64>

data.wallets.metrics.uses_tpsl

boolean

data.wallets.metrics.uses_builder

boolean

data.wallets.metrics.top_builder

string

Builder address this wallet routed the most orders through. Omitted when the wallet used no builder.

data.wallets.metrics.avg_order_size_usd

number

data.wallets.metrics.max_order_size_usd

number

data.wallets.metrics.median_cancel_speed_ms

number

data.wallets.metrics.active_hours

integer<int64>

data.wallets.metrics.total_fills

integer<int64>

data.wallets.metrics.total_volume_usd

number

data.wallets.metrics.maker_ratio

number

data.wallets.metrics.long_short_ratio

number

data.wallets.metrics.buy_volume_usd

number

data.wallets.metrics.sell_volume_usd

number

data.wallets.metrics.total_fees_usd

number

data.wallets.metrics.realized_pnl_usd

number

data.wallets.metrics.liquidation_count

integer<int64>

data.wallets.metrics.max_single_fill_usd

number

data.wallets.metrics.unique_fill_coins

integer<int64>

data.wallets.metrics.uses_twap

boolean

data.wallets.metrics.twap_fill_ratio

number

data.wallets.metrics.uses_cloid

boolean

data.wallets.metrics.cloid_ratio

number

data.wallets.metrics.uses_priority_gas

boolean

data.wallets.metrics.total_priority_gas_paid

number

data.wallets.metrics.total_builder_fees_paid

number

data.wallets.period

string

required

Metric lookback period.

Example:

"24h"

data.total

integer<int64>

required

Total wallets matching the filters.

Example:

4444

data.date

string

required

Daily snapshot date.

Example:

"2026-06-16"

Endpoint reference

Requests and responses

Datasets

Venues

OpenAPI and schemas

Guides

Classify HIP-3 wallets

Authorizations

Headers

Query Parameters

Response