# Get the points leaderboard

> List the points leaderboard

`GET /v2/points/leaderboard`

List the points leaderboard.

**Authentication:** None. This route is public.

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `limit` | query | integer (1–200) | No (default `25`) | Number of ranked rows to return. |

## Response

`200` returns an object with:

- `data` · array of object · **required**
  - `address` · string · **required**
  - `volumeUsd` · number · **required**
  - `eligibleOrderVolumeUsd` · number · **required**
  - `bonusVolumeUsd` · number · **required**
  - `wagyu` · number · **required**
  - `tradeCount` · number · **required**
  - `lastOrderAt` · string or null · **required**
  - `rank` · number · **required**
  - `totalVolume` · number · **required**

Errors use the [standard error envelope](https://docs.wagyu.xyz/actions-and-retries.md#the-error-envelope): branch on `code`, never on the message.

## Example

<!-- curl -->
```bash
curl 'https://api-beta.wagyu.xyz/v2/points/leaderboard?limit=2'
```

<!-- JavaScript -->
```javascript
const res = await fetch('https://api-beta.wagyu.xyz/v2/points/leaderboard?limit=2'
);
const data = await res.json();
```

<!-- Python -->
```python
import requests

res = requests.get('https://api-beta.wagyu.xyz/v2/points/leaderboard?limit=2', timeout=30)
data = res.json()
```

<!-- Response · 200 · captured 4 Nov 2026, 08:24 UTC -->
```json
{
  "data": [
    {
      "address": "0x8e3d5e109837c11ddd373d97c9b3e4d716f1423a",
      "volumeUsd": 75855101.036915,
      "eligibleOrderVolumeUsd": 75855101.036915,
      "bonusVolumeUsd": 0,
      "wagyu": 758551.01036915,
      "tradeCount": 511,
      "lastOrderAt": "2026-11-04T08:00:00.000Z",
      "rank": 1,
      "totalVolume": 75855101.036915
    },
    {
      "address": "0x92fca16b23ec24dd7206552be0286eb06ca83cd2",
      "volumeUsd": 68668745.88814,
      "eligibleOrderVolumeUsd": 68668745.88814,
      "bonusVolumeUsd": 0,
      "wagyu": 686687.4588814,
      "tradeCount": 392,
      "lastOrderAt": "2026-11-04T07:00:00.000Z",
      "rank": 2,
      "totalVolume": 68668745.88814
    }
  ]
}
```

---
Source: https://docs.wagyu.xyz/api-reference/get-points-leaderboard · Built from the live Wagyu API on 2026-11-04.