Skip to Content
Quickstart

Quickstart

Get your first token launched in under 5 minutes.

Prerequisites

  • A Solana wallet with some SOL (devnet for testing)
  • An API key from the Etch Dashboard 

Step 1: Get an API Key

Sign up at etch.dev  and create a new project. You’ll receive an API key that looks like:

etch_sk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Step 2: Create a Launch

Make a POST request to create your token launch:

curl -X POST https://etch.film.fun/api/launch \
  -H "Authorization: Bearer etch_sk_live_xxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Demo Token",
    "ticker": "DEMO",
    "description": "My first token on Etch",
    "image": "https://arweave.net/your-image-hash",
    "totalSupply": 1000000000,
    "decimals": 9,
    "reservePercent": 20,
    "beneficiary": "YOUR_WALLET_ADDRESS",
    "vestingConfig": {
      "mode": "time",
      "cliffMonths": 3,
      "durationMonths": 12
    }
  }'

Response

{
  "launchId": "launch_abc123",
  "status": "queued",
  "estimatedTime": "30s"
}

Step 3: Wait for Completion

Etch processes your launch asynchronously. You can either:

Option A: Poll for status

curl https://etch.film.fun/api/launch/launch_abc123 \
  -H "Authorization: Bearer etch_sk_live_xxxxx"

Option B: Use webhooks

Configure a webhook URL in your dashboard to receive real-time updates:

{
  "event": "launch.complete",
  "launchId": "launch_abc123",
  "data": {
    "mint": "ABC123...",
    "metadata": "DEF456...",
    "vesting": "GHI789...",
    "dao": "JKL012...",
    "pool": "MNO345..."
  }
}

Step 4: Verify Your Token

Once complete, your token is fully live:

Debugging

Every response includes a request ID for tracing:

X-Request-ID: 550e8400-e29b-41d4-a716-446655440000

Include this ID when reporting issues.

Common Issues

ErrorSolution
rate_limitedWait and retry (see Retry-After header)
insufficient_balanceAdd more SOL to your wallet
invalid_tickerUse 2-10 uppercase characters

What’s Next?

Last updated on
Streamflow Integration