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

# Leaderboard

> Read the top canonical or legacy-compatible points projection for one chain.

## Query parameters

<ParamField query="chainId" type="number" default="57073">
  `57073` for Ink or `4663` for Robinhood.
</ParamField>

The endpoint does not accept page or search parameters. It returns up to 100 entries.

## Response

<ResponseField name="chainId" type="number">
  Chain used for the projection.
</ResponseField>

<ResponseField name="leaderboard" type="array">
  Ranked entries.

  <Expandable title="Leaderboard entry">
    <ResponseField name="address" type="string">
      Lowercase wallet address.
    </ResponseField>

    <ResponseField name="points" type="number">
      Pump points.
    </ResponseField>

    <ResponseField name="inkyswap_points" type="number">
      InkySwap points.
    </ResponseField>

    <ResponseField name="lp_points" type="number">
      Liquidity-provider points.
    </ResponseField>

    <ResponseField name="rank" type="number">
      One-based rank.
    </ResponseField>

    <ResponseField name="projection_status" type="&#x22;SAFE&#x22; | &#x22;LEGACY_UNPROVEN&#x22;">
      Evidence status. `LEGACY_UNPROVEN` is allowed only for Ink compatibility rows.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="totalCount" type="number">
  Number of returned entries, at most 100.
</ResponseField>

## Rate limit

The computational limit is 10 requests per minute per rate-limit key.

<ResponseExample>
  ```json theme={null}
  {
    "chainId": 57073,
    "leaderboard": [
      {
        "address": "0x1234567890abcdef1234567890abcdef12345678",
        "points": 15420,
        "inkyswap_points": 800,
        "lp_points": 250,
        "rank": 1,
        "projection_status": "SAFE"
      }
    ],
    "totalCount": 1
  }
  ```
</ResponseExample>

<RequestExample>
  ```bash theme={null}
  curl "https://inkypump.com/api/leaderboard?chainId=57073"
  ```
</RequestExample>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.