# 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="https://1860373586-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Ml6s5BMmWoDc9jHH2VT%2Fuploads%2FMIquWbRK8EtQYqE9PyFF%2Fimage.png?alt=media&#x26;token=a17c6e89-266e-4fdc-be1d-979af55420fa" alt=""><figcaption></figcaption></figure>

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