Xp

Get total XP for a user across all seasons

get

Path parameters

userkeystringRequired

Responses

200

Successful response

application/json

numberOptional

400

Invalid input data

application/json

404

Not found

application/json

500

Internal server error

application/json

get

/xp/user/{userkey}

HTTPcURLJavaScriptPython

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

400

Invalid input data

application/json

404

Not found

application/json

500

Internal server error

application/json

get

/xp/user/{userkey}/season/{seasonId}

HTTPcURLJavaScriptPython

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

400

Invalid input data

application/json

404

Not found

application/json

500

Internal server error

application/json

get

/xp/user/{userkey}/season/{seasonId}/weekly

HTTPcURLJavaScriptPython

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

400

Invalid input data

application/json

404

Not found

application/json

500

Internal server error

application/json

get

/xp/user/{userkey}/season/{seasonId}/timeline

HTTPcURLJavaScriptPython

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

500

Internal server error

application/json

get

/xp/seasons

HTTPcURLJavaScriptPython

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

400

Invalid input data

application/json

404

Not found

application/json

500

Internal server error

application/json

get

/xp/season/{seasonId}/weeks

HTTPcURLJavaScriptPython

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

400

Invalid input data

application/json

404

Not found

application/json

500

Internal server error

application/json

get

/xp/user/{userkey}/leaderboard-rank

HTTPcURLJavaScriptPython

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

1

Send XP to another user

post

Authorizations

Authorization

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

receiverUserkeystringRequired

amountinteger · max: 9007199254740991Required

messagestring · max: 280Optional

shouldBundlebooleanOptional

Responses

200

Successful response

application/json

tipIdnumberRequired

senderNewBalancenumberRequired

receiverNewBalancenumberRequired

400

Invalid input data

application/json

401

Authorization not provided

application/json

403

Insufficient access

application/json

500

Internal server error

application/json

post

/xp/tip

HTTPcURLJavaScriptPython

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

Authorization

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

limitinteger · min: -9007199254740991 · max: 100OptionalDefault: 50

offsetnumberOptionalDefault: 0

Responses

200

Successful response

application/json

totalnumberRequired

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

/xp/tips/sent

HTTPcURLJavaScriptPython

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

Authorization

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Query parameters

limitinteger · min: -9007199254740991 · max: 100OptionalDefault: 50

offsetnumberOptionalDefault: 0

Responses

200

Successful response

application/json

totalnumberRequired

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

/xp/tips/received

HTTPcURLJavaScriptPython

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

Authorization

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

Successful response

application/json

totalSentnumberRequired

totalReceivednumberRequired

401

Authorization not provided

application/json

403

Insufficient access

application/json

500

Internal server error

application/json

get

/xp/tips/stats

HTTPcURLJavaScriptPython

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 · min: -9007199254740991 · max: 100OptionalDefault: 50

offsetnumberOptionalDefault: 0

Responses

200

Successful response

application/json

totalnumberRequired

400

Invalid input data

application/json

404

Not found

application/json

500

Internal server error

application/json

get

/xp/history

HTTPcURLJavaScriptPython

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

messageany ofRequired

stringOptional

or

nullOptional

senderXpHistoryIdnumberRequired

receiverXpHistoryIdnumberRequired

400

Invalid input data

application/json

404

Not found

application/json

500

Internal server error

application/json

get

/xp/send-details

HTTPcURLJavaScriptPython

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
          }
        }
      }
    },
    "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
          }
        }
      }
    },
    "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 · min: -9007199254740991 · max: 1000OptionalDefault: 50

offsetnumberOptionalDefault: 0

Responses

200

Successful response

application/json

totalnumberRequired

limitnumberRequired

offsetnumberRequired

400

Invalid input data

application/json

404

Not found

application/json

500

Internal server error

application/json

get

/xp/tips

HTTPcURLJavaScriptPython

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
            }
          }
        }
      },
      "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
            }
          }
        }
      },
      "amount": 1,
      "createdAt": "text"
    }
  ],
  "total": 1,
  "limit": 1,
  "offset": 1
}

Get current profile's XP Season 2 decision

get

Authorizations

Authorization

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Responses

200

Successful response

application/json

or

nullOptional

401

Authorization not provided

application/json

403

Insufficient access

application/json

500

Internal server error

application/json

get

/xp/decision

HTTPcURLJavaScriptPython

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

Authorization

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

decisionTypestring · enumRequiredPossible values:

Responses

200

Successful response

application/json

profileIdinteger · max: 2147483647Required

seasonIdnumberRequired

decisionTypestring · enumRequiredPossible values:

createdAtstringRequired

updatedAtstringRequired

400

Invalid input data

application/json

401

Authorization not provided

application/json

403

Insufficient access

application/json

500

Internal server error

application/json

post

/xp/decision

HTTPcURLJavaScriptPython

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

500

Internal server error

application/json

get

/xp/decision/metadata

HTTPcURLJavaScriptPython

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

imageUrlany ofRequired

stringOptional

or

nullOptional

ownerAddressstringRequired

Ethereum address (0x-prefixed, 20 bytes)

ownerProfileIdany ofRequired

integer · max: 2147483647Optional

or

nullOptional

ownerDisplayNameany ofRequired

stringOptional

or

nullOptional

ownerUsernameany ofRequired

stringOptional

or

nullOptional

ownerAvatarUrlany ofRequired

stringOptional

or

nullOptional

currentXpnumberRequired

remainingCapacitynumberRequired

xpCapnumberRequired

isFullbooleanRequired

500

Internal server error

application/json

get

/xp/validators

HTTPcURLJavaScriptPython

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

imageUrlany ofRequired

stringOptional

or

nullOptional

currentXpnumberRequired

xpCapnumberRequired

400

Invalid input data

application/json

404

Not found

application/json

500

Internal server error

application/json

get

/xp/validators/profile/{userkey}

HTTPcURLJavaScriptPython

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
              }
            }
          }
        },
        "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

400

Invalid input data

application/json

404

Not found

application/json

500

Internal server error

application/json

get

/xp/dashboard/yield/{profileId}

HTTPcURLJavaScriptPython

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

400

Invalid input data

application/json

404

Not found

application/json

500

Internal server error

application/json

get

/xp/dashboard/periodic-rewards/{profileId}

HTTPcURLJavaScriptPython

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
            }
          }
        },
        "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
            }
          }
        },
        "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

400

Invalid input data

application/json

404

Not found

application/json

500

Internal server error

application/json

get

/xp/dashboard/multipliers/{profileId}

HTTPcURLJavaScriptPython

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

400

Invalid input data

application/json

404

Not found

application/json

500

Internal server error

application/json

get

/xp/dashboard/daily-earnings/{profileId}/{date}

HTTPcURLJavaScriptPython

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

400

Invalid input data

application/json

404

Not found

application/json

500

Internal server error

application/json

get

/xp/dashboard/daily-awards/{date}

HTTPcURLJavaScriptPython

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
          }
        }
      },
      "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
            }
          }
        }
      }
    }
  ]
}

Get weekly delegator award stats for dashboard

get

Path parameters

profileIdinteger · max: 2147483647Required

Query parameters

weekinteger · max: 9007199254740991Optional

Responses

200

Successful response

application/json

lastAwardany ofRequired

or

nullOptional

nextAwardDatestringRequired

400

Invalid input data

application/json

404

Not found

application/json

500

Internal server error

application/json

get

/xp/dashboard/weekly-delegator-award/{profileId}

HTTPcURLJavaScriptPython

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
              }
            }
          }
        },
        "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
            }
          }
        }
      },
      "validator": {
        "imageUrl": "text",
        "name": "text",
        "tokenId": "text"
      }
    }
  },
  "lifetime": {
    "totalEarned": 1,
    "timesSelected": 1
  },
  "nextAwardDate": "text",
  "userParticipation": {
    "delegatedToWinner": true,
    "xpEarned": 1
  }
}