> ## Documentation Index
> Fetch the complete documentation index at: https://docs.openformat.tech/llms.txt
> Use this file to discover all available pages before exploring further.

# Leaderboards

> Leaderboard generation from on-chain data for specific apps and time ranges

You can get a leaderboard for a specific application in a time range. You will receive a paginated list
of users ordered by how much XP they earned.

<CodeGroup>
  ```curl cURL theme={null}
  curl --request GET \
    --url https://api.openformat.tech/v1/leaderboard \
    --header 'X-API-KEY: <api-key>'
  ```

  ```curl Time range & paginated theme={null}
  curl --request GET \
    --url https://api.openformat.tech/v1/leaderboard&start=0&page=1&page_size=20 \
    --header 'X-API-KEY: <api-key>'
  ```

  ```json JSON Response theme={null}
  {
    "status": "success",
    "total": 6,
    "data": [
      {
        "user": "0x208c5b9c4fe63ca96736e722525c32be411ce3ce",
        "xp_rewarded": "680"
      },
      {
        "user": "0x03755352654d73da06756077dd7f040adce3fd58",
        "xp_rewarded": "220"
      },
      {
        "user": "0x752d3046faeb80c80f3f2a79059e7189607faf41",
        "xp_rewarded": "140"
      },
      {
        "user": "0x6cd61d5f43bd77e666be14ab8d7c2e06cf7ef164",
        "xp_rewarded": "110"
      },
      {
        "user": "0x77edf40f3b8792da7e081bb677bbfc04bd8d349d",
        "xp_rewarded": "100"
      },
      {
        "user": "0xf2caa9ab4cf8d4027a9ca508f80d9314e4e6e1f3",
        "xp_rewarded": "100"
      }
    ]
  }
  ```
</CodeGroup>