Developers

Launch tokens on Immortalpad.fun via the API

Launch a token on Immortalpad.fun straight from your scripts or bots: send the token metadata plus your wallet's secret key — IMMORTAL builds, signs, simulates, broadcasts and verifies the launch, then opens the Call War round on the pad automatically.

No API key needed

The deploy endpoint is public — no X-Launch-Key header required. Your wallet's secret key rides each request and authorizes spending that wallet only, so treat the secret itself like a withdrawal password and never share it.

Send the launch request

curl -X POST https://api.immortalpad.fun/api/launches/deploy \
  -H "Content-Type: application/json" \
  -d '{
    "symbol": "MYCOIN",
    "name": "My Coin",
    "description": "What the coin is about",
    "twitter": "mycoin",
    "website": "https://mycoin.xyz",
    "image_base64": "<base64 png/jpg/webp/gif ≤3MB>",
    "slots": 5,
    "dev_buy_sol": 0.05,
    "wallet_secret": "<base58 secret key of your wallet>",
    "dry_run": false
  }'

The response is immediate — the transaction is assembled and signed in the background:

{
  "ok": true,
  "mint_preview": "pending-…",
  "payer": "<your wallet>",
  "status": "processing",
  "stage": "queued",
  "status_url": "/api/launches/deploy/pending-…"
}

Poll the deploy status

curl https://api.immortalpad.fun/api/launches/deploy/<mint_preview>

Stages: queued → waiting_tx → signing → simulating → broadcasting → confirming → verifying → done. When done: mint is your live token address and tx_signature the on-chain create transaction. On failure the error field explains exactly what went wrong.

Rehearse with dry_run first

Set "dry_run": true to build + sign + simulate the transaction without broadcasting. You get the signed transaction and the simulation verdict back, and nothing touches the chain — the safest way to validate your integration.

Security rules

• Your wallet secret never touches disk or logs — it lives in memory for the duration of the deploy job only.
• Your wallet is the fee payer and creator: the dev buy is paid by you; creator fees route to the token's reward fund.
• Every launch is verified on-chain before it goes live (mint, payer, creator fee wallet and symbol must match).
• Keys of platform custody wallets are refused — the API only spends your key.

After the launch

The token appears on the board with its own Call War round. Every trade pays creator fees into the round fund — 90% to the latest qualified callers on X.com or Pump.fun (native $IMMORTAL rounds: 50%), 10% to the buy & burn vault. Each valid call resets the 5:00 clock; when it burns out the callers get paid and a fresh round starts.

Launch a coin View the board