API reference
Every route: inputs, outputs, status codes.
Every route answers JSON. Errors are { "error": "…" } with a 4xx/5xx status. Sessions are a cookie set by /api/session.
Session#
POST/api/sessionnone
Body { wallet, issuedAt, signature }: the wallet's EIP-191 signature over the sign-in message. Sets the session cookie. 401 on a bad or stale signature.
DELETE/api/sessioncookie
Signs out.
Launches#
POST/api/launchescookie
Store a coin's details (HIRE's Upload step). Multipart form: name, ticker, description, style, x, telegram, website, devBuy, slippage, image (see Launching). 400 on a rule. Returns { id, slug, status: "created" }.
GET/api/launchescookie
The caller's coins.
POST/api/launches/:id/launchcookie
Body { hash }: the launch transaction. 402 while unconfirmed or when the receipt is not a 1%-fee launch of this coin by this wallet; 409 if already launched. Returns { ok, token, status: "launched" }.
GET/api/launches/:id/metadatanone
Name, symbol, description, image, attributes.
GET/api/launches/:id/logonone
The launcher's image, or an SVG mark.
POST/api/launches/:id/deskcookie, launcher
Runs the team again. 409 before the team has started.
Studio#
POST/api/agents/sessionscookie, HIREHOOD gate
Body { agent, message }. Opens a session and takes its first turn. 402 without the gate, 429 over the daily quota.
POST/api/agents/sessions/:idcookie
Body { message }. One more turn. 409 when the session is full.
Operator#
GET/api/cron/feesbearer CRON_SECRET or ?key=
Runs a fee round over every launched coin. Returns the rounds.