/ API · v1
Build on Voltpad.
Use the API to generate images from a coin's budget and read coin data. Keys are issued to connected wallets; never share yours.
Access
Keys and credits
Your key lets scripts do what you could do in the studio, nothing more. Generations and Blender jobs draw on the balance you topped up or on a coin budget you choose. A key can never move funds or sign a transaction.
AuthorizationSend your key as a bearer token on every request that spends credits or reads your account.
Wallet signingLaunches and trades are always signed in your own wallet, never through a key.
Paying for workEach image or render is charged when it finishes, from your credits or the coin budget you name.
Public readsCoin lists and the leaderboard are readable without a key.
Request shape
Quickstart
Every response is JSON. Replace the key with your own.
# Newest coins curl https://voltpaddot.fun/api/v1/coins?limit=20 # Make a square image paid from a coin's GPU budget curl -X POST https://voltpaddot.fun/api/v1/images \ -H "Authorization: Bearer $VOLTPAD_API_KEY" \ -H "Content-Type: application/json" \ -d '{"prompt": "neon koi pond seen from above", "format": "square", "coin": "<coin id>"}'
Reference
Endpoints
- GET
/v1/coinsEvery Voltpad coin, sorted by launch date with the latest on top. Paged with limit and cursor. - GET
/v1/coins/leaderboardCoins ordered by how much work their budgets have paid for. Market price plays no part in the order. - GET
/v1/coins/{id}One coin: name, ticker, links and its fee split. - GET
/v1/coins/{id}/budgetHow much GPU money a coin holds, with each deposit that went in. - GET
/v1/creditsWhat is left on your topped-up balance. - POST
/v1/imagesMake an image, paid from a coin's budget or your credits. - GET
/v1/images/{id}Whether an image job is queued, running or finished, plus the file when ready. - POST
/v1/rendersQueue a Blender job for a scene you uploaded; each finished frame is billed to your balance. - GET
/v1/renders/{id}Status of a render and its frames once done.