# Earn Protocol API

## What is this?
Earn Protocol lets you launch tokens on Pump.fun (Solana) with automatic:
- Fee distribution to creators
- Token buybacks (price floor protection)
- Staking rewards for holders

## Quick Start
Launch a token with one API call:

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

## Endpoints

### POST /launch
Create a new token. Required: name, ticker, image, tokenomics.
Tokenomics options: degen (40/30/30), creator (50/25/25), community (25/25/50)

### GET /explore
List all tokens. Optional params: page, limit, tokenomics, search, includePrice

### GET /stats
Protocol statistics: total tokens, volume, fees distributed

### GET /token/:mint
Get details for a specific token by mint address

### GET /health
Check API status

## Response Format
All endpoints return JSON with { success: boolean, ...data }

## Rate Limits
10 requests per minute per IP

## No Authentication Required
All endpoints are public.

## Data Sources
- Price data: DexScreener (free, no key)
- Token metadata: Helius DAS API (optional, for enhanced data)

## Get Your Own Helius Key (Optional)
AI agents can self-provision Helius keys for enhanced metadata:
  npm install -g helius-cli && helius login
Or visit: https://dev.helius.xyz

## More Info
- Website: https://earn.supply
- GitHub: https://github.com/earn-ai/earn-protocol
- OpenAPI Spec: https://api.earn.supply/openapi.json
- Full Skill: https://api.earn.supply/skill.md