> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hyperdash.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Find traders worth copying

> Shortlist traders to copy by risk-adjusted performance as well as PnL.

> AI agents: read [https://docs.hyperdash.com/skills/data](https://docs.hyperdash.com/skills/data) before using this API. Endpoint index: [https://data.hyperdash.com/llms.txt](https://data.hyperdash.com/llms.txt). Never ask the user to paste an API key into the chat.

**What you get:** a ranked list of the top traders by 30-day PnL with their copy score, Sharpe ratio and max drawdown, with PnL plotted against drawdown.

![Scatter chart of 30 traders: 30-day PnL against max drawdown, each dot sized by copy score.](https://mintcdn.com/hd-ebefeca3/pd0wguZzpnZWXwwa/images/data-api/recipes/copy-traders.png?fit=max\&auto=format\&n=pd0wguZzpnZWXwwa\&q=85\&s=5ad0906b212d6d3f61bd293cba552663)

> [!TIP]
>
> **Ask your agent:** paste this prompt into an AI chat connected to the [MCP server](https://docs.hyperdash.com/data-api/mcp.md), or into a command-line coding agent such as Claude Code or Codex, with your [API key](https://docs.hyperdash.com/data-api/authentication.md) exported.
>
> ```text theme={null}
> Find 20 Hyperliquid traders worth copying. Start from the top traders by 30-day PnL, rank them by copy score, and show each one's Sharpe ratio and max drawdown. Leave out anyone with a drawdown over 30%.
> ```
>
> **Optional:** add this line to get the results as an interactive dashboard.
>
> ```text theme={null}
> Build it as an interactive dashboard in a local HTML file and open it in my browser.
> ```

## API calls

Set your key and the values the calls use first:

```bash theme={null}
export HYPERDASH_API_KEY="hdk_sk_..."
export ADDRESS="0x..."   # the wallet to read
```

**1. List the top traders**

Sorted by 30-day PnL. Each row carries copy score, 30-day Sharpe and max drawdown.

```bash theme={null}
curl "https://data.hyperdash.com/v1/traders/screener?sort=pnlPerpMonth&limit=30" \
  -H "Authorization: Bearer $HYPERDASH_API_KEY"
```

**2. Break down a copy score**

The factors behind one trader's score.

```bash theme={null}
curl "https://data.hyperdash.com/v1/accounts/$ADDRESS/copy-score" \
  -H "Authorization: Bearer $HYPERDASH_API_KEY"
```

**3. Check longer-term risk**

Sharpe and Sortino over 30 to 365 days, max drawdown over 7 to 365 days.

```bash theme={null}
curl "https://data.hyperdash.com/v1/accounts/$ADDRESS/risk-metrics" \
  -H "Authorization: Bearer $HYPERDASH_API_KEY"
```

> [card] [View more recipes](https://docs.hyperdash.com/data-api/recipes.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.