---
title: "Get Whale Leaderboard"
method: GET
path: "/api/leaderboard/whales"
tags: ["Leaderboard"]
---

# Get Whale Leaderboard

`GET /api/leaderboard/whales`

## Request

- Base URL: `https://alpha-bazaar-signal-server.onrender.com`
- URL: `https://alpha-bazaar-signal-server.onrender.com/api/leaderboard/whales`
- Auth: none required

Get leaderboard of whale trackers (13F hedge fund managers)

Returns trading signals from hedge fund managers and institutions tracked via 13F filings
Filtered by publisher_type = 'whale-tracker'

Args:
    timeframe: 1W, 1M, 3M, 6M, 1Y, or ALL
    limit: Number of results to return (1-100, default 5)

## Query parameters

- `timeframe` string
- `limit` integer
- `min_signals` integer: Minimum total signals required
- `sort` string: Rank by avg_return (default), pure_return, win_rate or sharpe_ratio. Win rate and Sharpe ratio rank publishers with 5+ closed signals in the period, as their boards do

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-20** `01654ec03d07`: 1 info
  - added the new optional `query` request parameter `sort`

[Operation history](https://skmtc.dev/alphabazaar/apis/alpha-bazaar-signal-server/changes/api/leaderboard/whales/get.md)

---

[API](https://skmtc.dev/alphabazaar/apis/alpha-bazaar-signal-server.md) · [All operations](https://skmtc.dev/alphabazaar/apis/alpha-bazaar-signal-server/llms.txt) · [OpenAPI document](https://skmtc.dev/alphabazaar/apis/alpha-bazaar-signal-server/revisions/01654ec03d07?raw)
