API reference

Get 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: branch on code, never on the message.

#Example

curl

curl 'https://api-beta.wagyu.xyz/v2/points/leaderboard?limit=2'

JavaScript

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

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

{
  "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
    }
  ]
}