Schedule a launch countdown
Schedules the countdown posts for one launch on one of the caller's bots. `offsetsSeconds` is seconds before the launch. Omitting it posts at an hour out, ten minutes out, and the moment itself — the three beats that make a launch feel like it is happening, without a bot that has to be running the whole time. Scheduling does not post anything. A bot with `postCountdowns` off holds the schedule and never sends it, which is why the switch is the user's to set separately.
Schedules the countdown posts for one launch on one of the caller's bots. offsetsSeconds is seconds before the launch. Omitting it posts at an hour out, ten minutes out, and the moment itself — the three beats that make a launch feel like it is happening, without a bot that has to be running the whole time. Scheduling does not post anything. A bot with postCountdowns off holds the schedule and never sends it, which is why the switch is the user's to set separately.
Authorization
bearerAuth A bearer token. The Account routes accept a Privy access token; the MCP transport accepts an sk- API key issued by POST /account/api-keys.
In: header
Request Body
application/json
The launch, the moment it goes live, and when to post.
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://example.com/community/countdowns" \ -H "Content-Type: application/json" \ -d '{ "launchId": "string", "tokenAddress": "string", "launchesAt": "string" }'{ "id": "string", "botId": "string", "launchId": "string", "tokenAddress": "string", "launchesAt": "string", "offsetsSeconds": [ 0 ], "postedAt": "string", "createdAt": "string"}List the caller's launch countdowns GET
Every countdown schedule on the caller's bots, newest first. A schedule is a set of offsets, not a running timer: the bot holds the timestamps and posts when it passes them, so a restart does not lose a pending post. `postedAt` is the idempotency key that stops a restart from announcing the same launch twice.
Get the open spotlight vote GET
The open spotlight vote and the ballots on it, or `null` when no vote is open. One vote at a time. A second open vote would mean two spotlight slots, which is not a thing the Kit offers — so casting a vote while one is open adds a ballot to it rather than starting another.