Ethos Developers - API Docs
  • API Documentation
    • Introduction
    • API v2
      • Activity
      • Categories
      • Chains
      • Contributions
      • Nfts
      • Projects
      • Project Votes
      • Score
      • System
      • Users
      • Xp
    • API v1 (deprecated)
      • Activities
      • Addresses
      • Attestations
      • Categories
      • Contracts
      • Contributions
      • Curated Lists
      • ENS
      • Events
      • Exchange Rates
      • Fees
      • Invitations
      • Markets
      • Notifications
      • Profiles
      • Replies
      • Reviews
      • Scores
      • Search
      • Signatures
      • Slashes
      • Twitter
      • Users
      • Vouches
      • XP
  • Whitepaper
    • Whitepaper
Powered by GitBook
On this page
  1. API Documentation
  2. API v2

Xp

PreviousUsersNextAPI v1 (deprecated)

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: */*

1

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: */*

1

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"
  }
]
  • GETGet total XP for a user across all seasons
  • GETGet XP for a user in a specific season
  • GETGet weekly XP data for a user in a specific season
  • GETGet all XP seasons plus current season information
  • GETGet all weeks in a season with their date ranges