Competition

Register

Changed on Nov 3, 2026

Register a wallet for a competition, optionally claiming a username. Competitions configured with an entry code require a matching code and reject others with PERMISSION_DENIED. Registering for a cohort competition also adds the wallet to the cohort, which is what puts it on the leaderboard.

post/v1/competitions/{slug}/register

Request

Base URL
https://api.testnet.rise.trade
Auth
none required
TypeScript
https://skmtc.dev/rise/apis/risex-rest-api/docs/v1/competitions/:slug/register/post.ts
A function with typed inputs. Its response is checked against the schema.

Path parameters

slugstring required

Request body

walletstring

usernamestring

Optional. Claimed on the wallet's first registration only, and ignored when the wallet already has a profile. Leaving it empty registers the wallet with no username: the leaderboard shows its address, and it can claim a name later by registering again with this field set.

codestring

Entry code, required when the competition's scoring_config sets registration_code (see GetRegistrationStatusResponse.requires_code). Compared case-insensitively after trimming surrounding whitespace, since it is shared with a community and retyped by hand. Ignored by competitions with no code.

Response

A successful response.

registeredboolean