Skip to main content
GET
/
api
/
v1
/
user
/
leaderboard
/
placement
Get Leaderboard Placement
curl --request GET \
  --url https://api.ekiden.fi/api/v1/user/leaderboard/placement \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "account_value": "<string>",
      "place": "<string>",
      "pnl": "<string>",
      "ranked": true,
      "referral_xp": 123,
      "roi": "<string>",
      "sub_account_address": "<string>",
      "total_xp": 123,
      "trading_xp": 123,
      "volume": "<string>"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.ekiden.fi/llms.txt

Use this file to discover all available pages before exploring further.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

​
sub_account
string | null

When set, return placement for this subaccount only; otherwise one entry per subaccount.

​
timeframe
enum<string>
required

Ranking window. Leaderboard ranking window: today, last 7 days, last 30 days, or all time.

Available options:
today,
7d,
30d,
all

Response

Placements (ranked false when not on board)

Response for the current user's placement(s) on the leaderboard.

​
data
object[]
required

One row per subaccount (or single row when sub_account query is set).