---
title: "Get Pure Return Leaderboard"
method: GET
path: "/api/leaderboard/pure-return"
tags: ["Leaderboard"]
---

# Get Pure Return Leaderboard

`GET /api/leaderboard/pure-return`

## Request

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

Get leaderboard based on Pure Return (allocation * % return) over specified timeframe

Pure Return = Sum of (allocation_percent * signal_return_percent) for all closed signals in timeframe
This measures actual portfolio impact rather than average per signal

Args:
    timeframe: 1W, 1M, 3M, 6M, 1Y, or ALL
    portfolio_type: all, paper, or verified - filters signals by portfolio type

## Query parameters

- `timeframe` string: Time period: 1W, 1M, 3M, 6M, 1Y, or ALL
- `portfolio_type` string: Portfolio type filter (paper/verified)
- `min_signals` integer: Minimum total signals required
- `limit` integer: Maximum number of results to return
- `offset` integer: Number of results to skip for pagination

## Response `200`

Successful Response

- LeaderboardResponse: GET /api/leaderboard/*
  - `status` string, required
  - `timeframe` string, nullable
  - `period` string, nullable
  - `leaderboard` LeaderboardEntry[], required
    - `rank` integer, required
    - `username` string, required
    - `publisher_type` string, nullable
    - `is_house_bot` boolean, nullable
    - `total_signals` integer
    - `closed_signals` integer, nullable
    - `pure_return` number, nullable
    - `avg_return` number, nullable
    - `win_rate` number, nullable
    - `total_allocation` number, nullable
    - `avg_allocation_per_signal` number, nullable
    - `bio` string, nullable
    - `is_monetized` boolean, nullable
    - `has_profile_image` boolean, nullable
    - `display_name` string, nullable
  - `total_publishers` integer
  - `source` string, nullable

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-19** `d52b2182fb25`: 1 info
  - added the optional property `leaderboard/items/is_house_bot` to the response with the `200` status

[Operation history](https://skmtc.dev/alphabazaar/apis/alpha-bazaar-signal-server/changes/api/leaderboard/pure-return/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)