---
title: "Search Wallets"
method: GET
path: "/api/v1/hyperliquid/wallets/search"
tags: ["Hyperliquid Traders"]
---

# Search Wallets

`GET /api/v1/hyperliquid/wallets/search`

## Request

- Base URL: `https://cryptodataapi.com`
- URL: `https://cryptodataapi.com/api/v1/hyperliquid/wallets/search`
- Auth: API key in header `X-API-Key`

Search the cached top-leaderboard pool for wallets matching arbitrary gates.

Read-only — does not modify the watchlist. Pool is the same ~50-wallet set
that auto-watchlist evaluation considers. Refreshed daily at 19:00 UTC.

## Query parameters

- `min_score` number: Minimum top-trader score
- `min_win_rate` number, nullable: Minimum 30d win rate (0-1)
- `min_profit_factor` number, nullable: Minimum profit factor
- `min_trades_30d` integer, nullable: Minimum trades in 30d. Defaults to 30 to filter tiny-sample wallets. Pass 0 explicitly to disable.
- `min_avg_duration_hours` number, nullable: Min avg trade duration (hours)
- `exclude_types` string, nullable: Comma-separated trader types to exclude, e.g. 'hft,scalper'
- `limit` integer: Max wallets to return

## Response `200`

Successful Response

- HLWalletSearchResponse: Wallets from the cached top-leaderboard pool that satisfy the given gates.
  - `wallets` object[], required
  - `count` integer, required
  - `filters` object, required
  - `pool_size` integer, required
  - `updated_at` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/cryptodataapi/apis/crypto-data-api.md) · [All operations](https://skmtc.dev/cryptodataapi/apis/crypto-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/cryptodataapi/apis/crypto-data-api/revisions/8628b754ca81?raw)