Ctrlk
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Xp

Get total XP for a user across all seasons

get
Path parameters
userkeystringRequired
Responses
200

Successful response

application/json
numberOptional
get/xp/user/{userkey}
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
numberOptional
get/xp/user/{userkey}/season/{seasonId}
GET /api/v2/xp/user/{userkey}/season/{seasonId} HTTP/1.1
Host: api.ethos.network
Accept: */*

1
Deprecated

[Deprecated] Get weekly XP data for a user in a specific season. Use /timeline instead.

get
Path parameters
userkeystringRequired
seasonIdnumberRequired
Responses
200

Successful response

application/json
weeknumberRequired
weeklyXpnumberRequired
cumulativeXpnumberRequired
get/xp/user/{userkey}/season/{seasonId}/weekly
GET /api/v2/xp/user/{userkey}/season/{seasonId}/weekly HTTP/1.1
Host: api.ethos.network
Accept: */*

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

Get time-bucketed XP timeline for a user with configurable granularity

get
Path parameters
userkeystringRequired
seasonIdnumberRequired
Query parameters
granularitystring · enumRequiredPossible values:
sincestringOptional
Responses
200

Successful response

application/json
timestringRequired
xpnumberRequired
cumulativeXpnumberRequired
get/xp/user/{userkey}/season/{seasonId}/timeline
GET /api/v2/xp/user/{userkey}/season/{seasonId}/timeline?granularity=hour HTTP/1.1
Host: api.ethos.network
Accept: */*

[
  {
    "time": "text",
    "xp": 1,
    "cumulativeXp": 1
  }
]

Get all XP seasons plus current season information

get
Responses
200

Successful response

application/json
get/xp/seasons
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
weeknumberRequired
startDatestringRequired
endDatestringRequired
get/xp/season/{seasonId}/weeks
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
numberOptional
get/xp/user/{userkey}/leaderboard-rank
GET /api/v2/xp/user/{userkey}/leaderboard-rank HTTP/1.1
Host: api.ethos.network
Accept: */*

1

Send XP to another user

post
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Body
receiverUserkeystringRequired
amountinteger · max: 9007199254740991Required
messagestring · max: 280Optional
shouldBundlebooleanOptional
Responses
200

Successful response

application/json
tipIdnumberRequired
senderNewBalancenumberRequired
receiverNewBalancenumberRequired
post/xp/tip
POST /api/v2/xp/tip HTTP/1.1
Host: api.ethos.network
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 108

{
  "receiverUserkey": "text",
  "amount": 1,
  "message": "text",
  "source": {
    "type": "broker",
    "id": 1
  },
  "shouldBundle": true
}
{
  "tipId": 1,
  "senderNewBalance": 1,
  "receiverNewBalance": 1
}

Get XP sent by the authenticated user

get
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
limitinteger · max: 100OptionalDefault: 50
offsetinteger · max: 2147483647OptionalDefault: 0
Responses
200

Successful response

application/json
totalnumberRequired
get/xp/tips/sent
GET /api/v2/xp/tips/sent HTTP/1.1
Host: api.ethos.network
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "values": [
    {
      "amount": 1,
      "createdAt": "text",
      "id": 1,
      "message": "text",
      "receiverUserId": 1,
      "senderProfileId": 1,
      "source": {
        "type": "broker",
        "id": 1
      }
    }
  ],
  "total": 1
}

Get XP received by the authenticated user

get
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Query parameters
limitinteger · max: 100OptionalDefault: 50
offsetinteger · max: 2147483647OptionalDefault: 0
Responses
200

Successful response

application/json
totalnumberRequired
get/xp/tips/received
GET /api/v2/xp/tips/received HTTP/1.1
Host: api.ethos.network
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "values": [
    {
      "amount": 1,
      "createdAt": "text",
      "id": 1,
      "message": "text",
      "receiverUserId": 1,
      "senderProfileId": 1,
      "source": {
        "type": "broker",
        "id": 1
      }
    }
  ],
  "total": 1
}

Get XP send statistics for the authenticated user

get
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Responses
200

Successful response

application/json
totalSentnumberRequired
totalReceivednumberRequired
get/xp/tips/stats
GET /api/v2/xp/tips/stats HTTP/1.1
Host: api.ethos.network
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "totalSent": 1,
  "totalReceived": 1
}

Get XP history for a user

get
Query parameters
userkeystringRequired
seasonIdnumberOptional
limitinteger · max: 100OptionalDefault: 50
offsetinteger · max: 2147483647OptionalDefault: 0
Responses
200

Successful response

application/json
totalnumberRequired
get/xp/history
GET /api/v2/xp/history?userkey=text HTTP/1.1
Host: api.ethos.network
Accept: */*

{
  "values": [
    {
      "id": 1,
      "type": "REVIEW",
      "points": 1,
      "metadata": null,
      "createdAt": "text",
      "week": 1,
      "xpSeasonId": 1
    }
  ],
  "total": 1
}

Get XP send details by history entry IDs

get
Query parameters
xpHistoryIdsnumber[] · max: 100Required
Responses
200

Successful response

application/json
idnumberRequired
amountnumberRequired
createdAtstringRequired
messagestring · nullableRequired
senderXpHistoryIdnumberRequired
receiverXpHistoryIdnumberRequired
get/xp/send-details
GET /api/v2/xp/send-details?xpHistoryIds=1 HTTP/1.1
Host: api.ethos.network
Accept: */*

[
  {
    "id": 1,
    "sender": {
      "id": 1,
      "profileId": 1,
      "displayName": "text",
      "username": "text",
      "avatarUrl": "https://example.com",
      "description": "text",
      "score": 1,
      "status": "ACTIVE",
      "userkeys": [
        "text"
      ],
      "xpTotal": 1,
      "xpStreakDays": 1,
      "xpRemovedDueToAbuse": true,
      "influenceFactor": 1,
      "influenceFactorPercentile": 1,
      "humanVerificationStatus": "REQUESTED",
      "validatorNftCount": 1,
      "links": {
        "profile": "https://example.com",
        "scoreBreakdown": "https://example.com"
      },
      "stats": {
        "review": {
          "received": {
            "negative": 1,
            "neutral": 1,
            "positive": 1
          }
        },
        "vouch": {
          "given": {
            "amountWeiTotal": 1,
            "count": 1
          },
          "received": {
            "amountWeiTotal": 1,
            "count": 1
          }
        },
        "vouchTotals": [
          {
            "balance": {
              "given": 1,
              "received": 1
            },
            "count": {
              "given": 1,
              "received": 1
            },
            "token": {
              "address": "text",
              "decimals": 1,
              "id": "text"
            }
          }
        ]
      }
    },
    "receiver": {
      "id": 1,
      "profileId": 1,
      "displayName": "text",
      "username": "text",
      "avatarUrl": "https://example.com",
      "description": "text",
      "score": 1,
      "status": "ACTIVE",
      "userkeys": [
        "text"
      ],
      "xpTotal": 1,
      "xpStreakDays": 1,
      "xpRemovedDueToAbuse": true,
      "influenceFactor": 1,
      "influenceFactorPercentile": 1,
      "humanVerificationStatus": "REQUESTED",
      "validatorNftCount": 1,
      "links": {
        "profile": "https://example.com",
        "scoreBreakdown": "https://example.com"
      },
      "stats": {
        "review": {
          "received": {
            "negative": 1,
            "neutral": 1,
            "positive": 1
          }
        },
        "vouch": {
          "given": {
            "amountWeiTotal": 1,
            "count": 1
          },
          "received": {
            "amountWeiTotal": 1,
            "count": 1
          }
        },
        "vouchTotals": [
          {
            "balance": {
              "given": 1,
              "received": 1
            },
            "count": {
              "given": 1,
              "received": 1
            },
            "token": {
              "address": "text",
              "decimals": 1,
              "id": "text"
            }
          }
        ]
      }
    },
    "amount": 1,
    "createdAt": "text",
    "message": "text",
    "senderXpHistoryId": 1,
    "receiverXpHistoryId": 1
  }
]

Look up XP sent by sender and/or receiver

get
Query parameters
senderUserkeystringOptional
receiverUserkeystringOptional
limitinteger · max: 1000OptionalDefault: 50
offsetinteger · max: 2147483647OptionalDefault: 0
Responses
200

Successful response

application/json
totalnumberRequired
limitnumberRequired
offsetnumberRequired
get/xp/tips
GET /api/v2/xp/tips HTTP/1.1
Host: api.ethos.network
Accept: */*

{
  "values": [
    {
      "id": 1,
      "sender": {
        "id": 1,
        "profileId": 1,
        "displayName": "text",
        "username": "text",
        "avatarUrl": "https://example.com",
        "description": "text",
        "score": 1,
        "status": "ACTIVE",
        "userkeys": [
          "text"
        ],
        "xpTotal": 1,
        "xpStreakDays": 1,
        "xpRemovedDueToAbuse": true,
        "influenceFactor": 1,
        "influenceFactorPercentile": 1,
        "humanVerificationStatus": "REQUESTED",
        "validatorNftCount": 1,
        "links": {
          "profile": "https://example.com",
          "scoreBreakdown": "https://example.com"
        },
        "stats": {
          "review": {
            "received": {
              "negative": 1,
              "neutral": 1,
              "positive": 1
            }
          },
          "vouch": {
            "given": {
              "amountWeiTotal": 1,
              "count": 1
            },
            "received": {
              "amountWeiTotal": 1,
              "count": 1
            }
          },
          "vouchTotals": [
            {
              "balance": {
                "given": 1,
                "received": 1
              },
              "count": {
                "given": 1,
                "received": 1
              },
              "token": {
                "address": "text",
                "decimals": 1,
                "id": "text"
              }
            }
          ]
        }
      },
      "receiver": {
        "id": 1,
        "profileId": 1,
        "displayName": "text",
        "username": "text",
        "avatarUrl": "https://example.com",
        "description": "text",
        "score": 1,
        "status": "ACTIVE",
        "userkeys": [
          "text"
        ],
        "xpTotal": 1,
        "xpStreakDays": 1,
        "xpRemovedDueToAbuse": true,
        "influenceFactor": 1,
        "influenceFactorPercentile": 1,
        "humanVerificationStatus": "REQUESTED",
        "validatorNftCount": 1,
        "links": {
          "profile": "https://example.com",
          "scoreBreakdown": "https://example.com"
        },
        "stats": {
          "review": {
            "received": {
              "negative": 1,
              "neutral": 1,
              "positive": 1
            }
          },
          "vouch": {
            "given": {
              "amountWeiTotal": 1,
              "count": 1
            },
            "received": {
              "amountWeiTotal": 1,
              "count": 1
            }
          },
          "vouchTotals": [
            {
              "balance": {
                "given": 1,
                "received": 1
              },
              "count": {
                "given": 1,
                "received": 1
              },
              "token": {
                "address": "text",
                "decimals": 1,
                "id": "text"
              }
            }
          ]
        }
      },
      "amount": 1,
      "createdAt": "text"
    }
  ],
  "total": 1,
  "limit": 1,
  "offset": 1
}

Get current profile's XP Season 2 decision

get
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Responses
200

Successful response

application/json
profileIdinteger · max: 2147483647Required
seasonIdnumberRequired
decisionTypestring · enumRequiredPossible values:
createdAtstringRequired
updatedAtstringRequired
get/xp/decision
GET /api/v2/xp/decision HTTP/1.1
Host: api.ethos.network
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

{
  "profileId": 1,
  "seasonId": 1,
  "decisionType": "SPEND",
  "delegations": [
    {
      "validatorTokenId": "text",
      "xpAmount": 1
    }
  ],
  "createdAt": "text",
  "updatedAt": "text"
}

Submit or update XP Season 2 decision

post
Authorizations
AuthorizationstringRequired
Bearer authentication header of the form Bearer <token>.
Body
decisionTypestring · enumRequiredPossible values:
Responses
200

Successful response

application/json
profileIdinteger · max: 2147483647Required
seasonIdnumberRequired
decisionTypestring · enumRequiredPossible values:
createdAtstringRequired
updatedAtstringRequired
post/xp/decision
POST /api/v2/xp/decision HTTP/1.1
Host: api.ethos.network
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 81

{
  "decisionType": "SPEND",
  "delegations": [
    {
      "validatorTokenId": "text",
      "xpAmount": 1
    }
  ]
}
{
  "profileId": 1,
  "seasonId": 1,
  "decisionType": "SPEND",
  "delegations": [
    {
      "validatorTokenId": "text",
      "xpAmount": 1
    }
  ],
  "createdAt": "text",
  "updatedAt": "text"
}

Get XP Season 2 decision metadata (deadlines, dates)

get
Responses
200

Successful response

application/json
deadlinestringRequired
delegatePercentagenumberRequired
isBeforeDeadlinebooleanRequired
maxValidatorsnumberRequired
minValidatorsnumberRequired
nothingPenaltynumberRequired
spendPercentagenumberRequired
validatorXpCapnumberRequired
get/xp/decision/metadata
GET /api/v2/xp/decision/metadata HTTP/1.1
Host: api.ethos.network
Accept: */*

{
  "deadline": "text",
  "delegatePercentage": 1,
  "isBeforeDeadline": true,
  "maxValidators": 1,
  "minValidators": 1,
  "nothingPenalty": 1,
  "spendPercentage": 1,
  "validatorXpCap": 1
}

Get list of validator profiles for delegation

get
Responses
200

Successful response

application/json
tokenIdstringRequired
namestringRequired
imageUrlstring · nullableRequired
ownerAddressstringRequired

Ethereum address (0x-prefixed, 20 bytes)

ownerProfileIdinteger · max: 2147483647 · nullableRequired
ownerDisplayNamestring · nullableRequired
ownerUsernamestring · nullableRequired
ownerAvatarUrlstring · nullableRequired
currentXpnumberRequired
remainingCapacitynumberRequired
xpCapnumberRequired
isFullbooleanRequired
get/xp/validators
GET /api/v2/xp/validators HTTP/1.1
Host: api.ethos.network
Accept: */*

[
  {
    "tokenId": "text",
    "name": "text",
    "imageUrl": "text",
    "ownerAddress": "text",
    "ownerProfileId": 1,
    "ownerDisplayName": "text",
    "ownerUsername": "text",
    "ownerAvatarUrl": "text",
    "currentXp": 1,
    "remainingCapacity": 1,
    "xpCap": 1,
    "isFull": true
  }
]

Get validators owned by a profile with their delegators and XP info

get
Path parameters
userkeystringRequired
Responses
200

Successful response

application/json
tokenIdstringRequired
namestringRequired
imageUrlstring · nullableRequired
currentXpnumberRequired
xpCapnumberRequired
get/xp/validators/profile/{userkey}
GET /api/v2/xp/validators/profile/{userkey} HTTP/1.1
Host: api.ethos.network
Accept: */*

[
  {
    "tokenId": "text",
    "name": "text",
    "imageUrl": "text",
    "currentXp": 1,
    "xpCap": 1,
    "delegators": [
      {
        "user": {
          "id": 1,
          "profileId": 1,
          "displayName": "text",
          "username": "text",
          "avatarUrl": "https://example.com",
          "description": "text",
          "score": 1,
          "status": "ACTIVE",
          "userkeys": [
            "text"
          ],
          "xpTotal": 1,
          "xpStreakDays": 1,
          "xpRemovedDueToAbuse": true,
          "influenceFactor": 1,
          "influenceFactorPercentile": 1,
          "humanVerificationStatus": "REQUESTED",
          "validatorNftCount": 1,
          "links": {
            "profile": "https://example.com",
            "scoreBreakdown": "https://example.com"
          },
          "stats": {
            "review": {
              "received": {
                "negative": 1,
                "neutral": 1,
                "positive": 1
              }
            },
            "vouch": {
              "given": {
                "amountWeiTotal": 1,
                "count": 1
              },
              "received": {
                "amountWeiTotal": 1,
                "count": 1
              }
            },
            "vouchTotals": [
              {
                "balance": {
                  "given": 1,
                  "received": 1
                },
                "count": {
                  "given": 1,
                  "received": 1
                },
                "token": {
                  "address": "text",
                  "decimals": 1,
                  "id": "text"
                }
              }
            ]
          }
        },
        "xpAmount": 1
      }
    ]
  }
]

Get yield stats for dashboard (vouch + market hold pools)

get
Path parameters
profileIdinteger · max: 2147483647Required
Responses
200

Successful response

application/json
userDailyYieldnumberRequired
yesterdayDailyYieldnumberRequired
platformAvgYieldnumberRequired
totalDailyEmissionsnumberRequired
userPercentOfEmissionsnumberRequired
get/xp/dashboard/yield/{profileId}
GET /api/v2/xp/dashboard/yield/{profileId} HTTP/1.1
Host: api.ethos.network
Accept: */*

{
  "userDailyYield": 1,
  "yesterdayDailyYield": 1,
  "yieldBreakdown": {
    "vouchYield": 1,
    "marketHoldYield": 1,
    "marketTradeYield": 1
  },
  "platformAvgYield": 1,
  "totalDailyEmissions": 1,
  "userPercentOfEmissions": 1,
  "emissionsGauge": {
    "current": 1,
    "seasonMin": 1,
    "seasonMax": 1,
    "level": "normal"
  }
}

Get periodic reward stats for dashboard (daily tasks, votes, comments)

get
Path parameters
profileIdinteger · max: 2147483647Required
Responses
200

Successful response

application/json
userPercentOfRewardsnumberRequired
nextDistributionDatestringRequired
get/xp/dashboard/periodic-rewards/{profileId}
GET /api/v2/xp/dashboard/periodic-rewards/{profileId} HTTP/1.1
Host: api.ethos.network
Accept: */*

{
  "today": {
    "totalPool": 1,
    "userEarnings": 1,
    "topEarners": [
      {
        "id": 1,
        "profileId": 1,
        "displayName": "text",
        "username": "text",
        "avatarUrl": "https://example.com",
        "description": "text",
        "score": 1,
        "status": "ACTIVE",
        "userkeys": [
          "text"
        ],
        "xpTotal": 1,
        "xpStreakDays": 1,
        "xpRemovedDueToAbuse": true,
        "influenceFactor": 1,
        "influenceFactorPercentile": 1,
        "humanVerificationStatus": "REQUESTED",
        "validatorNftCount": 1,
        "links": {
          "profile": "https://example.com",
          "scoreBreakdown": "https://example.com"
        },
        "stats": {
          "review": {
            "received": {
              "negative": 1,
              "neutral": 1,
              "positive": 1
            }
          },
          "vouch": {
            "given": {
              "amountWeiTotal": 1,
              "count": 1
            },
            "received": {
              "amountWeiTotal": 1,
              "count": 1
            }
          },
          "vouchTotals": [
            {
              "balance": {
                "given": 1,
                "received": 1
              },
              "count": {
                "given": 1,
                "received": 1
              },
              "token": {
                "address": "text",
                "decimals": 1,
                "id": "text"
              }
            }
          ]
        },
        "points": 1
      }
    ]
  },
  "yesterday": {
    "totalPool": 1,
    "userEarnings": 1,
    "topEarners": [
      {
        "id": 1,
        "profileId": 1,
        "displayName": "text",
        "username": "text",
        "avatarUrl": "https://example.com",
        "description": "text",
        "score": 1,
        "status": "ACTIVE",
        "userkeys": [
          "text"
        ],
        "xpTotal": 1,
        "xpStreakDays": 1,
        "xpRemovedDueToAbuse": true,
        "influenceFactor": 1,
        "influenceFactorPercentile": 1,
        "humanVerificationStatus": "REQUESTED",
        "validatorNftCount": 1,
        "links": {
          "profile": "https://example.com",
          "scoreBreakdown": "https://example.com"
        },
        "stats": {
          "review": {
            "received": {
              "negative": 1,
              "neutral": 1,
              "positive": 1
            }
          },
          "vouch": {
            "given": {
              "amountWeiTotal": 1,
              "count": 1
            },
            "received": {
              "amountWeiTotal": 1,
              "count": 1
            }
          },
          "vouchTotals": [
            {
              "balance": {
                "given": 1,
                "received": 1
              },
              "count": {
                "given": 1,
                "received": 1
              },
              "token": {
                "address": "text",
                "decimals": 1,
                "id": "text"
              }
            }
          ]
        },
        "points": 1
      }
    ]
  },
  "userPercentOfRewards": 1,
  "validatorStaking": {
    "totalDelegated": 1,
    "validators": [
      {
        "tokenId": "text",
        "name": "text",
        "imageUrl": "text",
        "xpAmount": 1
      }
    ]
  },
  "nextDistributionDate": "text",
  "weeklyTotals": {
    "votePoolReward": 1,
    "commentPoolReward": 1,
    "vouchPoolReward": 1,
    "marketHoldPoolReward": 1,
    "marketTradePoolReward": 1,
    "delegationReward": 1,
    "slashStakeReturned": 1,
    "slashStakeWon": 1,
    "slashVoterReward": 1,
    "slashVoteReward": 1,
    "slashVoteRefund": 1,
    "total": 1
  },
  "validatorRewards": {
    "today": 1,
    "yesterday": 1,
    "weekly": 1
  }
}

Get multiplier stats for dashboard (score, streak, validators, market holdings)

get
Path parameters
profileIdinteger · max: 2147483647Required
Responses
200

Successful response

application/json
validatorCountnumberRequired
marketHoldingsEthnumberRequired
combinedMultipliernumberRequired
get/xp/dashboard/multipliers/{profileId}
GET /api/v2/xp/dashboard/multipliers/{profileId} HTTP/1.1
Host: api.ethos.network
Accept: */*

{
  "scoreMultiplier": {
    "value": 1,
    "score": 1,
    "tier": "text",
    "nextTier": {
      "threshold": 1,
      "multiplier": 1
    }
  },
  "streakMultiplier": {
    "value": 1,
    "streakDays": 1,
    "tier": "text",
    "nextTier": {
      "threshold": 1,
      "multiplier": 1
    }
  },
  "validatorCount": 1,
  "marketHoldingsEth": 1,
  "combinedMultiplier": 1
}

Get user daily earnings breakdown

get
Path parameters
profileIdinteger · max: 2147483647Required
datestring · enumRequiredPossible values:
Responses
200

Successful response

application/json
get/xp/dashboard/daily-earnings/{profileId}/{date}
GET /api/v2/xp/dashboard/daily-earnings/{profileId}/{date} HTTP/1.1
Host: api.ethos.network
Accept: */*

{
  "items": [
    {
      "id": 1,
      "type": "REVIEW",
      "points": 1,
      "metadata": {
        "distributionDate": "text",
        "reviewId": 1,
        "slashId": 1,
        "role": "text",
        "stakeAmount": 1,
        "feeAmount": 1,
        "reason": "text",
        "stakeReturned": 1,
        "resolution": "text",
        "wonAmount": 1,
        "voteWeight": 1,
        "totalWeight": 1,
        "validatorTokenId": "text",
        "inviterProfileId": 1,
        "inviteeProfileId": 1
      },
      "createdAt": "text"
    }
  ]
}

Get daily awards (top activities and resolved slashes)

get
Path parameters
datestring · enumRequiredPossible values:
Responses
200

Successful response

application/json
get/xp/dashboard/daily-awards/{date}
GET /api/v2/xp/dashboard/daily-awards/{date} HTTP/1.1
Host: api.ethos.network
Accept: */*

{
  "topEarners": [
    {
      "id": 1,
      "profileId": 1,
      "displayName": "text",
      "username": "text",
      "avatarUrl": "https://example.com",
      "description": "text",
      "score": 1,
      "status": "ACTIVE",
      "userkeys": [
        "text"
      ],
      "xpTotal": 1,
      "xpStreakDays": 1,
      "xpRemovedDueToAbuse": true,
      "influenceFactor": 1,
      "influenceFactorPercentile": 1,
      "humanVerificationStatus": "REQUESTED",
      "validatorNftCount": 1,
      "links": {
        "profile": "https://example.com",
        "scoreBreakdown": "https://example.com"
      },
      "stats": {
        "review": {
          "received": {
            "negative": 1,
            "neutral": 1,
            "positive": 1
          }
        },
        "vouch": {
          "given": {
            "amountWeiTotal": 1,
            "count": 1
          },
          "received": {
            "amountWeiTotal": 1,
            "count": 1
          }
        },
        "vouchTotals": [
          {
            "balance": {
              "given": 1,
              "received": 1
            },
            "count": {
              "given": 1,
              "received": 1
            },
            "token": {
              "address": "text",
              "decimals": 1,
              "id": "text"
            }
          }
        ]
      },
      "points": 1
    }
  ],
  "topActivities": [
    {
      "activity": {},
      "dayOfVotes": 1
    }
  ],
  "resolvedSlashes": [
    {
      "slashId": 1,
      "outcome": "text",
      "slashVotes": 1,
      "defendVotes": 1,
      "subject": {
        "id": 1,
        "profileId": 1,
        "displayName": "text",
        "username": "text",
        "avatarUrl": "https://example.com",
        "description": "text",
        "score": 1,
        "status": "ACTIVE",
        "userkeys": [
          "text"
        ],
        "xpTotal": 1,
        "xpStreakDays": 1,
        "xpRemovedDueToAbuse": true,
        "influenceFactor": 1,
        "influenceFactorPercentile": 1,
        "humanVerificationStatus": "REQUESTED",
        "validatorNftCount": 1,
        "links": {
          "profile": "https://example.com",
          "scoreBreakdown": "https://example.com"
        },
        "stats": {
          "review": {
            "received": {
              "negative": 1,
              "neutral": 1,
              "positive": 1
            }
          },
          "vouch": {
            "given": {
              "amountWeiTotal": 1,
              "count": 1
            },
            "received": {
              "amountWeiTotal": 1,
              "count": 1
            }
          },
          "vouchTotals": [
            {
              "balance": {
                "given": 1,
                "received": 1
              },
              "count": {
                "given": 1,
                "received": 1
              },
              "token": {
                "address": "text",
                "decimals": 1,
                "id": "text"
              }
            }
          ]
        }
      }
    }
  ]
}

Get weekly delegator award stats for dashboard

get
Path parameters
profileIdinteger · max: 2147483647Required
Query parameters
weekinteger · max: 9007199254740991Optional
Responses
200

Successful response

application/json
nextAwardDatestringRequired
get/xp/dashboard/weekly-delegator-award/{profileId}
GET /api/v2/xp/dashboard/weekly-delegator-award/{profileId} HTTP/1.1
Host: api.ethos.network
Accept: */*

{
  "lastAward": {
    "delegatorCount": 1,
    "delegatorsXpAward": 1,
    "distributedAt": "text",
    "topDelegators": [
      {
        "user": {
          "id": 1,
          "profileId": 1,
          "displayName": "text",
          "username": "text",
          "avatarUrl": "https://example.com",
          "description": "text",
          "score": 1,
          "status": "ACTIVE",
          "userkeys": [
            "text"
          ],
          "xpTotal": 1,
          "xpStreakDays": 1,
          "xpRemovedDueToAbuse": true,
          "influenceFactor": 1,
          "influenceFactorPercentile": 1,
          "humanVerificationStatus": "REQUESTED",
          "validatorNftCount": 1,
          "links": {
            "profile": "https://example.com",
            "scoreBreakdown": "https://example.com"
          },
          "stats": {
            "review": {
              "received": {
                "negative": 1,
                "neutral": 1,
                "positive": 1
              }
            },
            "vouch": {
              "given": {
                "amountWeiTotal": 1,
                "count": 1
              },
              "received": {
                "amountWeiTotal": 1,
                "count": 1
              }
            },
            "vouchTotals": [
              {
                "balance": {
                  "given": 1,
                  "received": 1
                },
                "count": {
                  "given": 1,
                  "received": 1
                },
                "token": {
                  "address": "text",
                  "decimals": 1,
                  "id": "text"
                }
              }
            ]
          }
        },
        "xpEarned": 1
      }
    ],
    "ownerXpAward": 1,
    "week": 1,
    "winner": {
      "owner": {
        "id": 1,
        "profileId": 1,
        "displayName": "text",
        "username": "text",
        "avatarUrl": "https://example.com",
        "description": "text",
        "score": 1,
        "status": "ACTIVE",
        "userkeys": [
          "text"
        ],
        "xpTotal": 1,
        "xpStreakDays": 1,
        "xpRemovedDueToAbuse": true,
        "influenceFactor": 1,
        "influenceFactorPercentile": 1,
        "humanVerificationStatus": "REQUESTED",
        "validatorNftCount": 1,
        "links": {
          "profile": "https://example.com",
          "scoreBreakdown": "https://example.com"
        },
        "stats": {
          "review": {
            "received": {
              "negative": 1,
              "neutral": 1,
              "positive": 1
            }
          },
          "vouch": {
            "given": {
              "amountWeiTotal": 1,
              "count": 1
            },
            "received": {
              "amountWeiTotal": 1,
              "count": 1
            }
          },
          "vouchTotals": [
            {
              "balance": {
                "given": 1,
                "received": 1
              },
              "count": {
                "given": 1,
                "received": 1
              },
              "token": {
                "address": "text",
                "decimals": 1,
                "id": "text"
              }
            }
          ]
        }
      },
      "validator": {
        "imageUrl": "text",
        "name": "text",
        "tokenId": "text"
      }
    }
  },
  "lifetime": {
    "totalEarned": 1,
    "timesSelected": 1
  },
  "nextAwardDate": "text",
  "userParticipation": {
    "delegatedToWinner": true,
    "xpEarned": 1
  }
}
PreviousWalletsNextAPI v1 (deprecated)

Last updated