---
title: "Create Auto Watchlist"
method: POST
path: "/api/v1/hyperliquid/watchlist/auto"
tags: ["Hyperliquid Traders"]
---

# Create Auto Watchlist

`POST /api/v1/hyperliquid/watchlist/auto`

## Request

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

Auto-populate watchlist from top traders based on configurable criteria.

## Request body

- AutoWatchlistRequest
  - `mode` string: Source mode (currently only 'top_traders')
  - `max_wallets` integer: Max wallets in auto-managed set
  - `min_score` integer: Minimum top-trader score
  - `filters` AutoWatchlistFilters
    - `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 when filters are provided, to prevent tiny-sample wallets (e.g. '100% WR over 2 trades') from passing. Pass 0 explicitly to disable.
    - `min_avg_duration_hours` number, nullable: Min avg trade duration (hours)
    - `exclude_types` string[], nullable: Trader types to exclude, e.g. ['hft','scalper']
  - `auto_refresh` boolean: Re-evaluate daily and update automatically

## Response `201`

Successful Response

- HLAutoWatchlistResponse: Auto-managed watchlist result.
  - `managed` boolean, required
  - `wallet_count` integer, required
  - `wallets` object[], required
  - `config` object, required
  - `next_refresh` string, nullable
  - `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)