Developer API

Mint Degen API

Programmatic access to the same paid memecoin creation engine as the Telegram bot. API launches charge the same account balance, credits, or subscription quota.

Quickstart

  1. Create or log into a Mint Degen account in Telegram.
  2. Top up the imported launch wallet with SOL, or activate the monthly subscription.
  3. Run /api new in the bot and copy the key once.
  4. Call the API from your backend with Authorization: Bearer <key>.
curl -X GET "$MINT_DEGEN_API/api/v1/account" \
  -H "Authorization: Bearer $MINT_DEGEN_API_KEY"

Authentication

Every private endpoint accepts a bearer API key. Keys are generated in Telegram with /api new, stored hashed server-side, and can be revoked with /api revoke <key_id>.

Authorization: Bearer md_live_your_key_here

Keep keys on your backend. Do not put launch-wallet private keys or API keys in public browser code.

Account

GET /api/v1/account

Returns the linked account, launch wallet, live SOL balance when RPC is reachable, pricing, credits, and subscription status.

curl "$MINT_DEGEN_API/api/v1/account" \
  -H "Authorization: Bearer $MINT_DEGEN_API_KEY"

Billing

API billing is not free and does not bypass the bot. The same account ledger is used everywhere.

  • Pay-per-launch: charged at the configured launch price.
  • Subscription: charged at the configured monthly price and grants the configured quota.
  • Priority order: subscription quota, free credits, then SOL fee sweep from the launch wallet.

POST /api/v1/subscriptions

curl -X POST "$MINT_DEGEN_API/api/v1/subscriptions" \
  -H "Authorization: Bearer $MINT_DEGEN_API_KEY"

Launches

POST /api/v1/launches

Creates a paid async launch job. The request returns immediately with a job id. Poll the status URL until it succeeds or fails.

curl -X POST "$MINT_DEGEN_API/api/v1/launches" \
  -H "Authorization: Bearer $MINT_DEGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d ''{
    "theme": "a sleep deprived frog with a golden laptop",
    "vibe": "degen",
    "dev_buy_sol": 0.5,
    "launch_wallet_private_key": "BASE58_PRIVATE_KEY"
  }''

GET /api/v1/launches/{id}

curl "$MINT_DEGEN_API/api/v1/launches/$JOB_ID" \
  -H "Authorization: Bearer $MINT_DEGEN_API_KEY"

The final result includes name, ticker, mint address, metadata URI, generated website URL, market cap, token price, and total launch SOL spent.

Webhooks

Webhook delivery is not enabled yet. Use polling for launch job status. The status response includes an ordered event list so agents and dashboards can show progress cleanly.

Errors

  • 401 unauthorized: missing, invalid, or revoked API key.
  • 400 launch_wallet_required: launch requests need a wallet key unless the server has a fallback wallet.
  • 402 payment_failed: not enough balance, no quota, or payment sweep failed.
  • 404 not_found: job id does not exist for the authenticated account context.
Copied