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 Studio or Telegram, stored hashed server-side, and can be revoked from Studio or with /api revoke <key_id>.

Authorization: Bearer md_live_your_key_here

Studio hides newly generated API keys by default. Copy the key immediately, or reveal it only when it is safe. 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.
  • Infrastructure usage estimates follow Helius credit weights with a 10% Mint Degen margin on top.

Current Helius basis used by Mint Degen estimates: Developer plan $49 per 10,000,000 credits, standard RPC 1 credit, DAS 10 credits, Enhanced Transactions 100 credits, address transaction history 10 credits minimum, LaserStream 2 credits per 0.1 MB.

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.

Sniper

Sniper API endpoints require a Pro account and accept the same bearer API key. They mirror the Studio sniper controls for tracker management, live feed reads, Telegram session state, coin blacklist, and wallet-cluster scans.

GET /api/v1/sniper/trackers

Returns sniper connection state and all wallet/Telegram trackers.

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

POST /api/v1/sniper/trackers

Create or upsert a wallet or Telegram tracker. Common fields include target/address, label, trigger mode, buy limits, sell rules, execution speed, selected snipe wallets, protocol blocks, and instant-ban filters.

curl -X POST "$MINT_DEGEN_API/api/v1/sniper/trackers" \
  -H "Authorization: Bearer $MINT_DEGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d ''''{
    "kind": "wallet",
    "target": "SOLANA_WALLET_ADDRESS",
    "label": "Whale tracker",
    "label_color": "#70E688",
    "trigger_mode": "bought",
    "max_buy_sol": 0.5,
    "copy_buy_pct": 100,
    "min_buy_sol": 0.1,
    "min_token_amount": 0,
    "slippage_pct": 10,
    "sell_mode": "tp_sl",
    "take_profit_pct": 50,
    "stop_loss_pct": 25,
    "time_exit_minutes": 0,
    "time_exit_sell_pct": 0,
    "execution_speed": "normal",
    "snipe_wallet_mode": "selected",
    "snipe_wallet_ids": ["launch"],
    "blocked_protocols": ["raydium"],
    "insta_ban_filters": {
      "market_cap_usd": { "min": 10000, "max": 500000 },
      "top10_holders_pct": { "max": 35 },
      "dev_holding_pct": { "max": 10 }
    },
    "auto_snipe": false,
    "enabled": true
  }''''

POST /api/v1/sniper/trackers/{tracker_id}

Update a tracker. Send the full tracker body, or a small toggle body.

curl -X POST "$MINT_DEGEN_API/api/v1/sniper/trackers/$TRACKER_ID" \
  -H "Authorization: Bearer $MINT_DEGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"auto_snipe": true}'

DELETE /api/v1/sniper/trackers/{tracker_id}

curl -X DELETE "$MINT_DEGEN_API/api/v1/sniper/trackers/$TRACKER_ID" \
  -H "Authorization: Bearer $MINT_DEGEN_API_KEY"

GET /api/v1/sniper/live

Returns recent live feed events, executions, blacklist, and SOL/USD rate. Use ?limit=40 to control feed size.

curl "$MINT_DEGEN_API/api/v1/sniper/live?limit=40" \
  -H "Authorization: Bearer $MINT_DEGEN_API_KEY"

POST /api/v1/sniper/coin-blacklist

Add a mint to the account blacklist so sniper execution avoids it.

curl -X POST "$MINT_DEGEN_API/api/v1/sniper/coin-blacklist" \
  -H "Authorization: Bearer $MINT_DEGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"mint":"TOKEN_MINT","reason":"manual"}'

DELETE /api/v1/sniper/coin-blacklist

curl -X DELETE "$MINT_DEGEN_API/api/v1/sniper/coin-blacklist" \
  -H "Authorization: Bearer $MINT_DEGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"mint":"TOKEN_MINT"}'

POST /api/v1/sniper/cluster

Scans a seed wallet's latest buy and ranks likely linked wallets for the same mint.

curl -X POST "$MINT_DEGEN_API/api/v1/sniper/cluster" \
  -H "Authorization: Bearer $MINT_DEGEN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"wallet":"SOLANA_WALLET_ADDRESS"}'

GET /api/v1/sniper/connection

Returns Telegram sniper bot connection state.

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

POST /api/v1/sniper/connection

Creates a Telegram bot connection token/link for the account.

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

DELETE /api/v1/sniper/connection

curl -X DELETE "$MINT_DEGEN_API/api/v1/sniper/connection" \
  -H "Authorization: Bearer $MINT_DEGEN_API_KEY"

GET /api/v1/sniper/telegram/session

Returns Telegram QR/session connection state.

curl "$MINT_DEGEN_API/api/v1/sniper/telegram/session" \
  -H "Authorization: Bearer $MINT_DEGEN_API_KEY"

POST /api/v1/sniper/telegram/session

Starts or resumes a Telegram QR login. Response can include qr_url, qr_image, and expires_in_seconds.

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

DELETE /api/v1/sniper/telegram/session

curl -X DELETE "$MINT_DEGEN_API/api/v1/sniper/telegram/session" \
  -H "Authorization: Bearer $MINT_DEGEN_API_KEY"

GET /api/v1/sniper/telegram/channels

Lists Telegram channels/groups visible to the connected Telegram QR session and indicates whether each is tracked.

curl "$MINT_DEGEN_API/api/v1/sniper/telegram/channels" \
  -H "Authorization: Bearer $MINT_DEGEN_API_KEY"

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