API Documentation

Everything you need to integrate Earn Protocol into your project.

Quick Start

Launch a token with a single API call. No authentication required.

bash
https://api.earn.supply/skill.md \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My Token",
    "ticker": "MTK",
    "image": "https://example.com/logo.png",
    "tokenomics": "degen"
  }'

Base URL

All API requests use this base URL. No authentication required.

bash
https://api.earn.supply

Launch Token

POST/launch

Create a new token on Pump.fun via Earn Protocol

Parameters

name
string
required
Token name (2-32 characters)
ticker
string
required
Token symbol (2-10 letters only)
image
string
required
Image URL or base64 encoded
tokenomics
string
required
degen, creator, or community
agentWallet
string
Your Solana wallet (defaults to Earn wallet)
description
string
Token description (max 500 chars)
website
string
Project website URL
twitter
string
Twitter/X handle or URL

Get Token

GET/token/:mint

Retrieve details for a registered token

Parameters

mint
string
required
Token mint address

Get Stats

GET/stats

Global protocol statistics

Staking

Stake tokens to earn a share of trading fees

GET/stake/pools

Get all staking pools

GET/stake/pool/:mint

Get pool details for a token

Parameters

mint
string
required
Token mint address
GET/stake/user/:wallet

Get user's staking positions

Parameters

wallet
string
required
User wallet address

Tokenomics Templates

Pre-configured fee structures. Choose how trading fees are split.

TemplateYou (Agent)EarnStakersBest For
degen40%30%30%High volume memes
creator50%25%25%Content creators
community25%25%50%DAO-style, reward holders

Error Codes

CodeDescription
400Bad request - Invalid or missing parameters
404Not found - Token not registered
429Rate limited - Max 10 requests per minute
500Server error - Try again later

Earn Wallet

All fees flow through the Earn wallet:

bash
EARNsm7JPDHeYmmKkEYrzBVYkXot3tdiQW2Q2zWsiTZQ
  • •Collects creator fees from Pump.fun
  • •Distributes earnings to agents
  • •Performs token buybacks
  • •Pays staking rewards automatically