Xp | Ethos Developers

Get detailed weekly XP statistics for specified users (Admin only)

get

Authorizations

Query parameters

userIdsinteger[] · min: 1 · max: 100Required

weekStartstringRequired

weekEndstringRequired

Responses

200

Successful response

application/json

400

Invalid input data

application/json

401

Authorization not provided

application/json

403

Insufficient access

application/json

404

Not found

application/json

500

Internal server error

application/json

get

GET /api/v2/admin/xp/weekly/stats HTTP/1.1
Host: api.ethos.network
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  {
    "ANY_ADDITIONAL_PROPERTY": "text"
  }
]

Get user IDs that were active in the specified date range (Admin only)

get

Authorizations

Query parameters

weekStartstringRequired

weekEndstringRequired

Responses

200

Successful response

application/json

Responseinteger[]

400

Invalid input data

application/json

401

Authorization not provided

application/json

403

Insufficient access

application/json

404

Not found

application/json

500

Internal server error

application/json

get

GET /api/v2/admin/xp/weekly/active-users HTTP/1.1
Host: api.ethos.network
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

[
  1
]

Get total XP for a user across all seasons

get

Path parameters

userkeystringRequired

Responses

200

Successful response

application/json

Responsenumber

400

Invalid input data

application/json

404

Not found

application/json

500

Internal server error

application/json

get

GET /api/v2/xp/user/{userkey} HTTP/1.1
Host: api.ethos.network
Accept: */*

Get XP for a user in a specific season

get

Path parameters

userkeystringRequired

seasonIdnumberRequired

Responses

200

Successful response

application/json

Responsenumber

400

Invalid input data

application/json

404

Not found

application/json

500

Internal server error

application/json

get

GET /api/v2/xp/user/{userkey}/season/{seasonId} HTTP/1.1
Host: api.ethos.network
Accept: */*

Get weekly XP data for a user in a specific season

get

Path parameters

userkeystringRequired

seasonIdnumberRequired

Responses

200

Successful response

application/json

400

Invalid input data

application/json

404

Not found

application/json

500

Internal server error

application/json

get

GET /api/v2/xp/user/{userkey}/season/{seasonId}/weekly HTTP/1.1
Host: api.ethos.network
Accept: */*

[
  {
    "week": 1,
    "weeklyXp": 1,
    "cumulativeXp": 1
  }
]

Get all XP seasons plus current season information

get

Responses

200

Successful response

application/json

500

Internal server error

application/json

get

GET /api/v2/xp/seasons HTTP/1.1
Host: api.ethos.network
Accept: */*

{
  "seasons": [
    {
      "id": 1,
      "name": "text",
      "startDate": "text"
    }
  ],
  "currentSeason": {
    "id": 1,
    "name": "text",
    "startDate": "text",
    "week": 1
  }
}

Get all weeks in a season with their date ranges

get

Path parameters

seasonIdnumberRequired

Responses

200

Successful response

application/json

400

Invalid input data

application/json

404

Not found

application/json

500

Internal server error

application/json

get

GET /api/v2/xp/season/{seasonId}/weeks HTTP/1.1
Host: api.ethos.network
Accept: */*

[
  {
    "week": 1,
    "startDate": "text",
    "endDate": "text"
  }
]

Get leaderboard rank for a user

get

Path parameters

userkeystringRequired

Responses

200

Successful response

application/json

Responsenumber

400

Invalid input data

application/json

404

Not found

application/json

500

Internal server error

application/json

get

GET /api/v2/xp/user/{userkey}/leaderboard-rank HTTP/1.1
Host: api.ethos.network
Accept: */*