REST APIAccount
Get account by address
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.
ApiKeyAuthx-api-key<token>API key authentication via the x-api-key header.
address*stringThe wallet's address. For a Predict account, use the account's address.
application/json; charset=utf-8- response
Response for GET /v1/account/{address}
success*booleandata*The public profile of a wallet
curl -X GET 'https://api.predict.fun/v1/account/string'{ "success": true, "data": { "name": "string", "address": "string", "imageUrl": "string", "points": { "total": 0.1, "rank": 0, "season": 0 } }}Get weekly points breakdown GET
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.
Get account activity by address GET
Get a paginated list of the conversions, merges, splits, redemptions and refunds of any wallet address. Order events are not included. The fills of an address are available from GET /v1/orders/matches with signerAddress. An address with no account returns an empty list. 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.