---
title: "Weekly or season leaderboard"
method: GET
path: "/points/leaderboard"
tags: ["Points"]
---

# Weekly or season leaderboard

`GET /points/leaderboard`

## Request

- Base URL: `https://api.getchord.xyz/v1`
- URL: `https://api.getchord.xyz/v1/points/leaderboard`
- Auth: none declared

Wallets ranked by points for one week or the whole season, with base points, referral and streak bonuses, volume, trades, days active and tier. `503 NOT_ENABLED` while the program is off on the deployment.

## Query parameters

- `scope` 'week' | 'season'
- `week` string
- `limit` integer

## Response `200`

- object
  - `chain` integer
  - `season` integer
  - `scope` string
  - `week` integer, nullable
  - `weekBounds` object, nullable
    - `from` integer: Unix time, seconds, UTC.
    - `to` integer: Unix time, seconds, UTC.
  - `seasonStart` integer: Unix time, seconds, UTC.
  - `currentWeek` integer
  - `weekPool` number
  - `rows` object[]
    - `rank` integer
    - `wallet` string: EVM address, hex, case-insensitive.
    - `points` number
    - `basePoints` number
    - `referralBonus` number
    - `streakBonus` number
    - `volumeUsd` number
    - `trades` integer
    - `daysActive` integer
    - `tier` string, nullable
    - `lastTradeTs` integer: Unix time, seconds, UTC.
  - `totalWallets` integer
  - `totalPoints` number
  - `totalVolumeUsd` number
  - `indexedToBlock` integer, nullable
  - `updatedAt` integer: Unix time, milliseconds — when the server built this answer.

## Other responses

- `400`: Invalid parameters — `error` names the check that failed (`INVALID_PARAMS`, `BAD_ADDRESS`, `BAD_LIMIT`, `BAD_HOURS`, …).
- `503`: The lane behind this endpoint is not ready or not enabled here (`NOT_READY`, `CHAIN_NOT_ENABLED`, `NOT_ENABLED`, `*_UNAVAILABLE`). Retry later; do not treat it as an empty answer.

---

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