> For the complete documentation index, see [llms.txt](https://docs.relysia.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.relysia.com/token/leaderboard.md).

# Leaderboard

To display the distribution of a particular token, we implemented the /leaderboard endpoint. A leaderboard is typically an information page on a platform page that shows how you rank among others. Distributing tokens in a competition and then displaying ownership is thus an interesting way to enrich the user experience. 

Since tokens are on a public blockchain, we can aggregate all transactions and balances from the public blockchain to display the leaderboard. Thanks to p2p paymail integration, updating the leaderboard happens in real time. 

<figure><img src="/files/mywBr8RznZMerJEKiuvA" alt=""><figcaption></figcaption></figure>

{% openapi src="<https://api.relysia.com/docs/json>" path="/v1/leaderboard" method="get" %}
<https://api.relysia.com/docs/json>
{% endopenapi %}