Skip to content

Get XP history for a user

GET
/xp/history
curl --request GET \
--url 'https://api.ethos.network/api/v2/xp/history?userkey=example&limit=50&offset=0'
userkey
required
string
seasonId
number
limit
integer
default: 50 <= 100
offset
integer
0 <= 2147483647

Successful response

Media typeapplication/json
object
values
required
Array<object>
object
id
required
number
type
required
string
Allowed values: REVIEW CONTRIBUTION INVITE_ACCEPTED VOUCH_DAY CLAIM EXTENSION_CHECK_IN CLAIM_REFERRAL MARKET_HOLDINGS ADMIN_XP_RESET XP_TIP_SENT XP_TIP_RECEIVED VOTE_COST COMMENT_COST REVIEW_COST STREAK_FORGIVENESS_COST INVITE_SENT_COST SLASH_VOTE_COST VOTE_POOL_REWARD COMMENT_POOL_REWARD VOUCH_POOL_REWARD MARKET_HOLD_POOL_REWARD MARKET_TRADE_POOL_REWARD DAILY_TASK_POOL_REWARD XP_SLASH_ESCROW_AUTHOR XP_SLASH_ESCROW_SUBJECT XP_SLASH_FEE XP_SLASH_STAKE_RETURNED XP_SLASH_STAKE_WON XP_SLASH_VOTER_REWARD SLASH_VOTE_REWARD SLASH_VOTE_REFUND DELEGATION_REWARD WEEKLY_DELEGATOR_AWARD_VALIDATOR WEEKLY_DELEGATOR_AWARD_DELEGATOR DECISION_SPEND_DEDUCTION DECISION_NOTHING_DEDUCTION DECISION_DELEGATED DECISION_DELEGATION_RETURNED HV_ESCROW_DEDUCTION HV_BURN HV_VERIFIER_PAYOUT HV_COMPLETION_BONUS HV_CLAWBACK BOUNTY_REWARD BOND_SLASH_VERIFIER_ESCROW BOND_SLASH_VERIFIER_RETURNED
points
required
number
metadata
required
createdAt
required
string
week
required
number
xpSeasonId
required
number
total
required
number

Example

{
"values": [
{
"type": "REVIEW"
}
]
}

Invalid input data

Media typeapplication/json
Invalid input data error (400)

The error information

object
message
required

The error message

string
code
required

The error code

string
issues

An array of issues that were responsible for the error

Array<object>
object
message
required
string

Example

{
"code": "BAD_REQUEST",
"message": "Invalid input data",
"issues": []
}

Not found

Media typeapplication/json
Not found error (404)

The error information

object
message
required

The error message

string
code
required

The error code

string
issues

An array of issues that were responsible for the error

Array<object>
object
message
required
string

Example

{
"code": "NOT_FOUND",
"message": "Not found",
"issues": []
}

Internal server error

Media typeapplication/json
Internal server error error (500)

The error information

object
message
required

The error message

string
code
required

The error code

string
issues

An array of issues that were responsible for the error

Array<object>
object
message
required
string

Example

{
"code": "INTERNAL_SERVER_ERROR",
"message": "Internal server error",
"issues": []
}