Developers

REST APIAccount

Get weekly points breakdown

GET
/account/points/weekly

Returns the authenticated user's per-week points history for one season, season or the current season by default, alongside each week's points budget. Entries are ordered chronologically from week 1 of the season.

The current in-progress round is included with calculated: false until it closes.

Requires JWT authentication.

Authorization

ApiKeyAuthBearerAuth
headerx-api-key<token>

API key authentication via the x-api-key header.

headerAuthorizationBearer <JWT>

Bearer authentication via the Authorization: Bearer <token> header.

Query Parameters

season?integer

The id of the points season to list the weeks of, which must exist. Defaults to the current season, the latest one to have started.

Formatint32

Response Body

application/json; charset=utf-8
  1. response

Response for GET /v1/account/points/weekly

success*boolean
data*array<>
Example Request
curl -X GET 'https://api.predict.fun/v1/account/points/weekly'
Example Response
{  "success": true,  "data": [    {      "week": 0,      "startTime": "string",      "endTime": "string",      "userPoints": 0.1,      "userReferralPoints": 0.1,      "allocationAmount": 0,      "calculated": true    }  ]}

Get account activity GET

Get a paginated list of trading activity including orders, matches, conversions, merges, and splits for the authenticated user. The occurredAfter and occurredBefore filters are unix timestamps in milliseconds and both bounds are exclusive: only events that occurred strictly after occurredAfter and strictly before occurredBefore are returned. Requires JWT authentication.

Get account by address GET

Get the public profile of any wallet address: its display name, its profile image once it has passed moderation, and its leaderboard points and rank. A wallet that never set up a profile has a null name. An address with no wallet returns 404.