> For the complete documentation index, see [llms.txt](https://docs.fuul.xyz/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.fuul.xyz/developer-guide/getting-leaderboard-data/volume.md).

# Volume

Retrieve the volume leaderboard using the `getVolumeLeaderboard` method. This shows transaction volume generated by users.

```typescript
import { Fuul } from '@fuul/sdk';

await Fuul.getVolumeLeaderboard({
  user_type: 'affiliate',
});
```

{% hint style="info" %}
`user_type` is optional. Use `'affiliate'` for referred volume or `'end_user'` for direct user volume.
{% endhint %}

Example response:

```json
{
  "total_results": 89,
  "page": 1,
  "page_size": 10,
  "results": [
    {
      "address": "0x1234...",
      "total_amount": "1250000.00",
      "rank": 1
    }
  ]
}
```

{% hint style="info" %}
Volume values are returned in USD.
{% endhint %}

{% hint style="info" %}
Leaderboard responses are paginated. Use `page` and `page_size` (max 100 per page) to retrieve the full leaderboard.
{% endhint %}

For full endpoint details, see the [API reference](https://fuul.readme.io/reference/getrevenueleaderboard).