List the caller's launch countdowns
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.
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.
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
Response Body
application/json
application/json
application/json
curl -X GET "https://example.com/community/countdowns"{ "countdowns": [ { "id": "string", "botId": "string", "launchId": "string", "tokenAddress": "string", "launchesAt": "string", "offsetsSeconds": [ 0 ], "postedAt": "string", "createdAt": "string" } ]}The holder count for a token GET
How many distinct wallets hold a non-zero balance of the token, on one chain. The number comes from the same `ChainReader` the holder gate uses, so a community that shows 1,284 holders here and refuses 0 wallets there is reading one source. A `409` means the reader in use cannot answer a census at all — an indexer is a different job from an `eth_call`, and putty does not guess a number it cannot back up. Supply a `ChainReader` whose `holderCount` is indexer-backed and the same route answers 200.
Schedule a launch countdown POST
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.