---
title: "Get Leaderboard Winners History"
method: GET
path: "/leaderboard/winners"
tags: ["tokens"]
---

# Get Leaderboard Winners History

`GET /leaderboard/winners`

Returns paginated history of top 3 winning tokens for each epoch, sorted by epoch_id desc starting from current epoch.

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

OK

- InternalHandlersLeaderboardWinnersResponse
  - `epochs` InternalHandlersEpochWinnersItem[]
    - `epoch_id` integer
    - `winners` InternalHandlersLeaderboardWinnerRow[]
      - `address` string
      - `epoch_id` integer
      - `image_url` string
      - `mcap` integer
      - `mcap_score` number
      - `name` string
      - `nft_votes` integer
      - `rank` integer
      - `symbol` string
      - `total_score` number
      - `vol_7d` number
      - `vol_score` number
      - `vote_score` number
  - `total` integer

---

[API](https://skmtc.dev/grambo/apis/grambo-api.md) · [All operations](https://skmtc.dev/grambo/apis/grambo-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/grambo/grambo-api/revisions/5d88d65e212e/schema)