Filters
Filters define which trades you care about. They combine trader performance criteria, asset attributes, trade parameters, and manual whitelists/blacklists into a reusable configuration. Filter-based Pods react when a trade matches the filter — but not every pod is filter-powered (discretionary pods are deliberately filter-less for manual trading).
Looking for starting shapes? Most users build one of four canonical filter setups (Whitelist, Cohort, Hybrid, or Asset Specialist). See Filter Setups for step-by-step recipes. This page is the component-level field reference.
Creating a Filter
- Go to the Filters tab
- Click the + button to open the Filter Builder
- Enter a Filter Name (required)
- Configure one or more components (see below)
- Click Create Filter (the button reads Update Filter when you’re editing an existing filter)
You can remove any component you don’t need, and add more with a row of + <Section Name> buttons — one per available section (e.g. + Trader Criteria, + Trader Whitelist, + Trader Blacklist, + Asset Criteria, + Coin Blacklist, + Trade Criteria). There is no “Add Component” dropdown. As you set criteria, a live estimate banner at the bottom refreshes automatically (~half a second after each change) to show how many active traders and assets match.
Filter Components
A filter is a stack of components, each answering a different “should this trade match?” question. There are two kinds:
- Criteria describe a quality bar: the trader has to be good enough, the asset has to be liquid enough, the trade has to be big enough. Set thresholds, then any trader/asset/trade above the bar passes.
- Whitelists and blacklists are manual overrides: a curated list of specific traders (and a blocked list of coins) you want to include or exclude regardless of the criteria.
A filter combines up to six components: Trader Criteria, Trader Whitelist, Trader Blacklist, Asset Criteria, Coin Blacklist, and Trade Criteria. The combination logic is OR within each side, AND across sides — see How Components Combine below.
Trader Criteria
Use this when you want to follow a class of traders rather than specific addresses: “smart, well-managed perpetuals traders” rather than “this list of 20 wallets”. Set thresholds on the metrics that capture what “smart” means to you. Any trader whose stats clear all the bars matches.
Set min and/or max for any combination:
| Field | What it means | Example use |
|---|---|---|
| Trader Score | Composite 0 to 100 score across performance, risk, consistency, edge, experience | Min 70, strong overall traders |
| $-Weighted Win Rate | Dollar-weighted percentage of winning closed positions | Min 55, traders who win more than they lose |
| Sharpe Ratio | Risk-adjusted return. Above 1 is good, above 2 is excellent | Min 1.5, strong risk-adjusted performers |
| PnL | Net realized profit/loss across all closed positions in USD | Min 5000, meaningfully profitable traders |
| Max Drawdown | Largest peak-to-trough decline | Max 30, exclude traders with large drawdowns |
| Kelly Fraction | Position-sizing reference from the trader’s historical edge and payoff ratio | Min 0.1, traders with meaningful edge |
| Profit Factor | Gross profits / gross losses. Above 1 = profitable overall | Min 1.5, consistently profitable |
| Total Volume | Total dollar volume traded | Min 100000, traders with real skin in the game |
| Avg Leverage | Average leverage the trader uses | Max 5, conservative-leverage traders |
| Total Trades | Total individual trades executed | Min 50, experienced traders |
| Closed Positions | Total closed positions — track-record depth | Min 100, traders with a long history |
Closed Positions is a first-class Filter Builder criterion (above), and the public API accepts a
closedPositionCountcriterion too.
Trader Criteria are evaluated against the same trailing-180-day stats the Traders tab shows. There is no category or time-window slicing on Hyperliquid filters.
Asset Criteria
Use this to restrict where a trade can happen — which perp coins. Two common reasons: liquidity hygiene (“only coins deep enough that I won’t take bad fill on”) and funding/leverage focus (“only high-cap coins I can reason about”). This is Hyperliquid’s equivalent of a “market” constraint.
Constrains which coins the trade must occur on:
| Field | What it means | Example use |
|---|---|---|
| Coins (include) | A handpicked list of coin names (e.g. BTC, ETH). The trade must be on one of these. | BTC + ETH, high-cap majors only |
| Day Volume | 24-hour trading volume in USD | Min 10000000, liquid perps |
| Open Interest | The raw coin-denominated open interest (the stored base-coin count, NOT USD). The display surfaces convert to USD, but the builder compares against the stored coin figure directly. | Min a coin-count figure you’ve looked up for that coin |
| Funding Rate | Hourly funding, expressed as annualized APR in this builder. Positive = longs pay shorts; negative = shorts pay longs. | Max 30% APR, avoid coins with expensive positive funding for long strategies |
| Max Leverage | Maximum leverage allowed on the coin | Min 10, coins that let you size up |
Funding Rate is entered in APR terms here (the same number you’d get annualizing the hourly figure the Assets tab shows), and the system converts it to Hyperliquid’s hourly decimal behind the scenes. Don’t confuse it with the Explore tab’s funding criterion, which matches the raw hourly decimal. The same caution applies to Open Interest: the criterion matches the raw coin-denominated stored figure, so convert from USD before you type.
Trade Criteria
Use this to gate on the individual trade rather than the trader or coin. The main use case is filtering out small noise trades by setting a minimum dollar size (whale-only filters).
Applied to each individual trade as it happens:
| Field | What it means | Range | Example use |
|---|---|---|---|
| Trade Size ($) | Dollar value of the trade (size × price), in USD notional | 0+ | Min 1000, whale-sized trades only |
The filters trigger on trades in both directions — there is no locked “BUY only” side. Hyperliquid filters match both parties to a trade (the maker and the taker) and both long and short activity, since a provided close is itself a trade that a copy pod may want to react to. There is no separate notion of “entry vs exit”; exits are handled by the pod’s own settings.
Note: The
leveragefield that once existed under Trade Criteria was removed — Hyperliquid trade events don’t carry the trader’s leverage. If you want to filter by leverage, use Trader Criteria → Avg Leverage instead.
Trader Whitelist
Use this when you’ve already validated a specific list of traders and want to follow them directly without relying on metric thresholds. Search by name or wallet address to add them. When a whitelist is active and there are no Trader Criteria, only trades from these addresses can match. When both are active, a trader passes the trader side if they’re on the whitelist or meet the criteria.
Trader Blacklist
Use this to exclude specific traders from a filter that has a positive side. Blacklists are purely exclusionary: they can only remove traders from what would otherwise match — a blacklist on its own is never a valid filter. A blacklisted trader never matches, regardless of any criteria they’d otherwise clear or any whitelist they’re on.
Coin Blacklist
Use this to exclude specific coins (e.g., a low-cap alt that’s consistently noisy, or coins you don’t want copied into). Blacklisted coins never match. There is no “asset whitelist” — but remember a blacklist can only exclude from a filter that already has a positive (criteria or whitelist) side. To restrict to a handful of coins, use Asset Criteria → Coins (include) instead.
How Components Combine
The match logic is OR within each side, AND across sides:
- Trader side: the trader passes if
trader is on Trader Whitelist OR meets Trader Criteria - Asset side: the coin passes if it
meets Asset Criteria(with no Asset Criteria, any coin passes) - Trade side: the trade meets Trade Criteria (with no Trade Criteria, any size passes)
- Blacklists always win, applied first: a blacklisted trader or coin is excluded before any of the above is evaluated
A trade matches when trader side AND asset side AND trade side AND not blacklisted.
This shape is the reason the whitelist is useful even when criteria exist: it widens, not narrows. A trader who’s on the whitelist passes the trader side regardless of whether they meet the metric thresholds.
Because a blacklist is only an exclusion, it has no positive side of its own — a filter that contains only a blacklist (and no criteria or whitelist) matches nothing and can’t be saved.
Validation Rules
A filter saves when it satisfies these rules and every criteria range is valid (min strictly less than max):
- Rule 1 — at least one inclusion component. A filter must have at least one of: Trader Criteria, Trader Whitelist, or Asset Criteria. A blacklist never counts as an inclusion component, so a blacklist-only filter is rejected on both create and edit. Trade criteria alone is also not enough — you still need one of the three above.
- Rule 2 — asset-only filters need trade criteria. If a filter has no Trader Criteria and no Trader Whitelist (so its only positive side is asset criteria), it must also include Trade Criteria. A blacklist doesn’t substitute.
In short: a blacklist alone is never enough, and trade criteria alone is never enough.
Filter Detail Page
Click any filter row to open the detail page. It has three tabs:
- Overview: the filter’s criteria summarized in plain English, an Edit button, and a Live Match Estimate card that shows how many active traders (traded in the last 24 hours) and assets currently match.
- Matched Traders: a paginated, sortable list of the traders currently matching the filter (loaded via REST; 20 per page).
- Live Trades: a WebSocket stream of trades matching the filter in real time.
There is no asset-universe panel on the detail page; the estimate card is the only place you see the asset count.
The Filters list
The Filters list has Name | Summary | actions only. There is no Counts column and no “as of” timestamp — the live match estimate lives on each filter’s detail page. Click a row to open the detail page; the list rows show a trash (delete) icon and a chevron only — there is no pencil on the list, so to edit a filter you open it first and use Edit on the detail page.
Managing Filters
- Edit: open the filter, then click Edit on the detail page to reopen the Filter Builder with all fields pre-populated (the button reads Update Filter).
- Delete: click the trash icon. Deleting a filter with attached pods is refused — you get a message that the filter can’t be deleted until its pods are deleted first. There is no cascade: delete the pods, then the filter.
- There is no enable/disable toggle on filter rows — filters are always active. To stop a filter from triggering pods, disable the pods attached to it (each pod row has its own Active toggle).
To change which trades a filter matches, edit it — pods on that filter pick up the new criteria on the next matching trade.