Skip to main content
GET
/
leaderboard
cURL
curl --request GET \
  --url https://api.openformat.tech/v1/leaderboard \
  --header 'X-API-KEY: <api-key>'
[
  {
    "user": "0x03755352654d73da06756077dd7f040adce3fd58",
    "xp_rewarded": "310"
  },
  {
    "user": "0x16bb52a951e3dd1d2cdb95b1a70c2b05ce1e4cee",
    "xp_rewarded": "110"
  },
  {
    "user": "0xb98492ec79fcc78cb584eafacee18d9a4cdc3424",
    "xp_rewarded": "60"
  },
  {
    "user": "0x7d92949b4dace9aee85ecd7d362b3a8ffc40e00a",
    "xp_rewarded": "30"
  }
]

[
  {
    "user": "0x03755352654d73da06756077dd7f040adce3fd58",
    "xp_rewarded": "310"
  },
  {
    "user": "0x16bb52a951e3dd1d2cdb95b1a70c2b05ce1e4cee",
    "xp_rewarded": "110"
  },
  {
    "user": "0xb98492ec79fcc78cb584eafacee18d9a4cdc3424",
    "xp_rewarded": "60"
  },
  {
    "user": "0x7d92949b4dace9aee85ecd7d362b3a8ffc40e00a",
    "xp_rewarded": "30"
  }
]

Authorizations

​
X-API-KEY
string
header
required

Query Parameters

​
chain
string
required

Blockchain network to use

Required string length: 1 - 255
Example:

"arbitrum-sepolia"

​
app_id
string
required

Ethereum address of the application we are insterested

Pattern: ^(0x)?[0-9a-fA-F]{40}$
Example:

"0x9716fb655f2a72b1fc1b4db02b8ad20b6747442a"

​
token_id
string

Ethereum address of the token to use

Pattern: ^(0x)?[0-9a-fA-F]{40}$
Example:

"0xd1f09c70f6f2838a3ab6209c1465af68594667ec"

​
start
string

Timestamp for start date

Pattern: ^\d+$
Example:

"0"

​
end
string

Timestamp for end date

Pattern: ^\d+$
Example:

"9999999999999999"

​
page
string

Results page

Pattern: ^\d+$
Example:

"1"

​
page_size
string

Page size

Pattern: ^\d+$
Example:

"20"

Response

Displays the leaderboard

​
status
enum<string>
required

Response status: 'sucess' or 'failed'

Available options:
failed,
success
Example:

"success"

​
total
number
required
​
data
object[]
required