# Weekly or season leaderboard

`GET https://api.getchord.xyz/v1/points/leaderboard`

Source: https://getchord.xyz/docs/api-reference/operations/pointsleaderboard/

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.

## Parameters

| Name | In | Required | Type | Description |
| --- | --- | --- | --- | --- |
| `scope` | query | no | `week` · `season` (default `week`) |  |
| `week` | query | no | string | Week number or `current`. |
| `limit` | query | no | integer (default `100`) |  |

## Response 200

- **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.
