JestSprout · public API
A tiny API for big internet energy.
Send a theme and get back a playful meme coin concept with a guaranteed hosted logo. The endpoint is free for five successful generations per IP per UTC day, then costs $0.01 USDC per call through x402 or uses the existing $5 API-key pack. It stays firmly concept-only.
Prefer a machine-readable contract? Open the OpenAPI 3.1 document.
01 · Quick start
POST /api/generate
The JSON body must contain a theme string between 3 and 240 characters. Without a key, each IP can make 5 successful requests per UTC day. Failed generation attempts do not consume a successful-generation slot.
curl -X POST https://jestsprout.polsia.io/api/generate \
-H "content-type: application/json" \
-d '{"theme":"a pigeon that knows everyone’s secrets"}'02 · Access
Free and public
No account, wallet, payment, or caller API key is required for the free tier. Each client IP gets 5 successful generations per UTC day. After the free allowance, send an X-PAYMENT header for $0.01 USDC on Base via Coinbase x402, or buy one $5 pack for 500 generations at /api-keys.
03 · Paid access
Buy a $5 pack for 500 generations
Buy a pack at /api-keys. After payment is confirmed, your API key is revealed once. Send it with either supported header format:
curl -X POST https://jestsprout.polsia.io/api/generate \
-H "Authorization: Bearer js_live_your_key" \
-H "content-type: application/json" \
-d '{"theme":"a pigeon that knows everyone’s secrets"}'curl -X POST https://jestsprout.polsia.io/api/generate \
-H "X-API-Key: js_live_your_key" \
-H "content-type: application/json" \
-d '{"theme":"a pigeon that knows everyone’s secrets"}'03 · x402 pay-per-call
Pay $0.01 USDC after the free allowance
After five successful generations for an IP on the current UTC day, send a valid X-PAYMENT header. Coinbase CDP verifies and settles the exact payment on Base before the concept is served. The fixed payment is 10000 atomic USDC units to 0x0E2C79D680016D1b13be69780e45Bb2bE175F16e using asset 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913.
curl -X POST https://jestsprout.polsia.io/api/generate \
-H "X-PAYMENT: <base64-encoded-x402-payment>" \
-H "content-type: application/json" \
-d '{"theme":"a pigeon that knows everyone’s secrets"}'04 · Response
A complete concept result
A successful response contains the AI-generated coin name, uppercase ticker, human-readable description, and a hosted logo image URL. The example below shows the response shape; the values are generated for each request.
{
"coinName": "string",
"ticker": "string",
"description": "human-readable concept description",
"logoUrl": "<hosted logo image URL>",
"logo_error_detail": "<bounded, redacted provider detail when fallback is used>",
"logo_error": "unavailable",
"conceptOnly": true
}logoUrl always points to a hosted image. If the logo provider is unavailable after the built-in retry, the concept still succeeds with a deterministic SVG fallback and the safe, bounded logo_error_detail alongside logo_error: "unavailable".
05 · Remote MCP
Connect an agent at POST /mcp
JestSprout exposes a stateless Streamable HTTP JSON-RPC surface with one tool: generate_coin_concept. Its input is { theme: string }, and a successful tool result contains the same concept JSON as /api/generate, including logoUrl, optional logo_error and logo_error_detail, and conceptOnly: true.
curl -X POST https://jestsprout.polsia.io/mcp -H "content-type: application/json" -H "Authorization: Bearer js_live_your_key" -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"generate_coin_concept","arguments":{"theme":"a pigeon that knows everyone’s secrets"}}}'Authentication is optional. Omit credentials for 5 successful generations per IP per UTC day, send X-PAYMENT after the allowance for $0.01 USDC on Base, or send either X-API-Key or Authorization: Bearer <key> to use the existing paid key credits. The same access decision applies to REST and MCP.
06 · Errors
Clear failure responses
400— invalid or unusable theme, with a field error.401— a paid key was missing, invalid, or revoked.402— free_limit_reached without a valid X-PAYMENT or API key, with fixed x402acceptsdetails and the buy URL; a valid paid key can also return 402 when it has no credits. Buy another pack at https://jestsprout.polsia.io/api-keys.503— concept generation failed after its retry; logo unavailability does not invalidate an otherwise complete concept.
06 · Scope
Concept first
Results are ideas only. This API does not deploy tokens, connect wallets, process payments, call a blockchain, or claim that a coin exists or has value.
Want to try it interactively? Open the concept generator →