Skip to Content
APIAPI Overview

API Overview

The Etch API is a RESTful JSON API for launching tokens on Solana.

Base URL

https://etch.film.fun/api

For testing, use the devnet endpoint:

https://etch.film.fun/api

Authentication

All API requests require a Bearer token:

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

See Authentication for details on obtaining and managing API keys.

Rate Limits

PlanRequests/minLaunches/day
Free605
Pro30050
EnterpriseUnlimitedUnlimited

Rate limit headers are included in all responses:

X-RateLimit-Limit: 60
X-RateLimit-Remaining: 59
X-RateLimit-Reset: 1700000000

Endpoints

Launch

MethodEndpointDescription
POST/launchCreate a new token launch
GET/launch/:idGet launch status
GET/launchesList all launches

Vesting

MethodEndpointDescription
GET/vesting/:contractGet vesting status
POST/vesting/:contract/claimClaim unlocked tokens

DAO

MethodEndpointDescription
GET/dao/:realmGet DAO info
POST/dao/:realm/proposalCreate proposal
POST/dao/:realm/voteCast vote

Fees

MethodEndpointDescription
GET/fees/:mintGet accumulated fees
POST/fees/:mint/claimClaim LP fees

Health & Monitoring

MethodEndpointDescription
GET/healthFull health check with diagnostics
HEAD/healthSimple uptime check

See Health & Monitoring for details.

Error Handling

Errors return standard HTTP status codes with a JSON body:

{
  "error": {
    "code": "invalid_request",
    "message": "The 'ticker' field is required",
    "field": "ticker"
  }
}

Common Error Codes

CodeDescription
invalid_requestMalformed request body
unauthorizedInvalid or missing API key
insufficient_balanceNot enough SOL for transaction
rate_limitedToo many requests
launch_failedToken launch failed on-chain

SDKs

Official SDKs are coming soon:

  • TypeScript/JavaScript
  • Python
  • Rust

For now, use the REST API directly or see our examples repository .

Last updated on
AI Agent SDKAuthentication