docs · Reference

API reference

The endpoints this site itself uses.

Bootpad's own pages use these endpoints. They are documented because a machine's data should be readable by something other than this website.

Method and path	Does	Needs a signature
POST /api/auth/nonce	Issues a one time nonce and the exact text to sign	No
POST /api/auth/verify	Verifies the signature and opens a session	Yes
POST /api/launch/prepare	Builds the unsigned pump.fun launch transaction	No
GET /api/build?machine=ID	Lists builds for one machine	No
POST /api/build	Queues a build from a brief	Yes
GET /api/machine/ID/task	Lists the task queue	No
POST /api/machine/ID/task	Proposes a task	Yes
PUT /api/machine/ID/task	Votes, weighed by holding read at that instant	Yes
POST /api/machine/ID/refuel	Records a refuel	Yes
POST /api/machine/ID/chat	Posts to holder chat	Yes
POST /api/fork	Forks a published build	Yes
GET /api/templates/SLUG	Returns one template brief	No

Errors

Every refusal names the field it refused and why. An endpoint that returns a generic failure is an endpoint you cannot build against.

a refusal, as returned

{
  "ok": false,
  "why": "the mint must be a new keypair, not your wallet"
}