---
title: "Top traders' Hyperliquid positions"
method: GET
path: "/api/top-traders"
tags: ["AlphaYou"]
---

# Top traders' Hyperliquid positions

`GET /api/top-traders`

## Request

- Base URL: `https://api.alphayou.net`
- URL: `https://api.alphayou.net/api/top-traders`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

Positions the top tracked traders currently hold in Hyperliquid perpetual contracts linked to US stocks, not shares: side, size, entry price and unrealized profit. Only stocks confirmed against the US ticker registry are returned. An annualised ROI at the 10000% ceiling is returned as null with roiCapped true.

Plans: Pro.

## Response `200`

The requested records.

## Other responses

- `401`: Missing, unrecognised or revoked API key (error key_revoked).
- `403`: This key's plan does not include this endpoint, or the key has been suspended (error key_suspended).
- `404`: Not an endpoint an API key may call.
- `429`: Rate limited. The scope field says which budget ran out: minute, day, account (shared by all of an account's keys), or concurrency (too many calls running at once). Retry-After says when to come back, and X-RateLimit-Remaining reports what is left of today's budget. A call refused for going too fast (the per-minute limit) does not use up the day, so wait for Retry-After and try again.
- `503`: The request budget could not be checked right now. Retry after the number of seconds in Retry-After.

---

[API](https://skmtc.dev/alphayou/apis/alphayou-api.md) · [All operations](https://skmtc.dev/alphayou/apis/alphayou-api/llms.txt) · [OpenAPI document](https://skmtc.dev/alphayou/apis/alphayou-api/revisions/cde9e990c368?raw)