The Pump.fun Trading API
That Actually Works

// Option A: Auto-upload (recommended — single request)
{
  "publicKey": "YourWalletBase58Address",
  "name": "My Token",
  "symbol": "MTK",
  "imageUrl": "https://i.imgur.com/abc.png",
  "description": "My awesome token",
  "twitter": "https://x.com/mytoken",
  "telegram": "https://t.me/mytoken",
  "website": "https://mytoken.com",
  "devBuyAmount": 0.1    // SOL, optional (0 = no dev buy)
}

// Option B: Provide your own metadata URI
{
  "publicKey": "YourWalletBase58Address",
  "name": "My Token",
  "symbol": "MTK",
  "metadataUri": "https://ipfs.io/ipfs/Qm...",
  "devBuyAmount": 0.1
}

// Also supports PumpPortal-style params:
// "amount" + "denominatedInSol": "true" instead of "devBuyAmount"
// "imageURL" (capital) also works

{
  "transaction": "base64_serialized_transaction...",
  "mint": "NewTokenMintBase58Address",
  "metadataUri": "https://ipfs.io/ipfs/Qm..."
}

{
  "publicKey": "BuyerWalletBase58",
  "mint": "TokenMintBase58",
  "solAmount": 0.5,        // SOL to spend
  "slippageBps": 1000,     // optional, default 10% (1000 bps = 10%)
  "pool": "auto",          // "pump", "jupiter", or "auto" (default)
  "priorityFee": 0.00005   // optional, SOL for tx priority
}

// PumpPortal-compatible format also works:
// "amount": 0.5, "denominatedInSol": "true", "slippage": 10

{
  "transaction": "base64_serialized_transaction...",
  "pool": "pump"           // "pump" (bonding curve) or "jupiter" (graduated)
}

{
  "publicKey": "SellerWalletBase58",
  "mint": "TokenMintBase58",
  "tokenAmount": "1000000000",   // string! (bigint, 6 decimals)
  "slippageBps": 1000,            // optional, default 10%
  "pool": "auto",                 // "pump", "jupiter", or "auto"
  "priorityFee": 0.00005          // optional
}

// PumpPortal-compatible:
// "amount": 1000, "denominatedInSol": "false", "slippage": 10

{
  "transaction": "base64_serialized_transaction...",
  "pool": "pump"                  // "pump" or "jupiter"
}

{
  "mint": "TokenMintBase58",
  "bondingCurve": {
    "address": "BondingCurveBase58",
    "complete": false,
    "progress": 45.2,
    "virtualTokenReserves": "...",
    "virtualSolReserves": "...",
    "realTokenReserves": "...",
    "realSolReserves": "...",
    "tokenTotalSupply": "...",
    "price": 0.000042,
    "marketCapSol": 42.5
  },
  "graduated": false,
  "dexPool": null
}

// Query parameters:
//   filter   — "newest" (default) | "graduating" | "migrated"
//   limit    — Max tokens (default 50, max 100)
//   sort     — "newest" or "marketcap" (only for filter=newest)

// Examples:
//   GET /api/v1/tokens?filter=newest&limit=50
//   GET /api/v1/tokens?filter=graduating&limit=20
//   GET /api/v1/tokens?filter=migrated&limit=20

// filter=newest
{
  "filter": "newest",
  "tokens": [
    {
      "mint": "...", "name": "...", "symbol": "...",
      "uri": "...", "creator": "...",
      "price": 0.000042, "marketCapSol": 42.5, "progress": 45.2
    }
  ],
  "total": 50
}

// filter=graduating (tokens at 80%+ progress)
{
  "filter": "graduating",
  "tokens": [
    {
      "mint": "...", "name": "...", "symbol": "...",
      "marketCapSol": 280.5, "bondingCurveProgress": 92.3,
      "holders": 145, "totalBuys": 320, "totalSells": 47
    }
  ],
  "total": 12
}

// filter=migrated (recently graduated)
{
  "filter": "migrated",
  "tokens": [
    {
      "mint": "...", "name": "...", "symbol": "...",
      "marketCapSol": 450, "graduatedAt": 1712345678,
      "totalBuys": 580, "finalHolders": 234
    }
  ],
  "total": 8
}

// URL: /api/v1/trades/TokenMintBase58?limit=500&from=&to=
//
// Query parameters:
//   limit  — Max trades (default 500, max 500)
//   from   — UNIX timestamp (seconds), only trades after
//   to     — UNIX timestamp (seconds), only trades before

{
  "mint": "TokenMintBase58",
  "trades": [
    {
      "signature": "tx_signature",
      "txType": "buy",                  // or "sell"
      "traderPublicKey": "...",
      "solAmount": 0.5,
      "tokenAmount": 1000000,
      "marketCapSol": 45.2,
      "priceSol": 0.0000005,
      "newSolReserves": 32.5,
      "newTokenReserves": 760000000,
      "timestamp": 1712345700
    }
  ],
  "count": 423,
  "hasMore": false                       // true if buffer might have evicted older trades
}

// Use this to build candlestick charts:
// 1. Fetch /trades/:mint (historical)
// 2. Aggregate to OHLC by timeframe (1m/5m/1h)
// 3. Subscribe to subscribeTokenTrade WS for live updates

// URL: /api/v1/dev-trades/TokenMintBase58?limit=100
//
// Query parameters:
//   limit  — Max trades (default 100, max 1000)
//
// Note: returns empty array if we don't have a creator on record (token born
// before our indexer). Sorted ascending by timestamp.

{
  "mint": "TokenMintBase58",
  "creator": "CreatorWalletBase58",
  "trades": [
    {
      "signature": "tx_signature...",
      "type": "buy",                    // or "sell"
      "solAmount": 5.0,
      "tokenAmount": 50000000,
      "priceSol": 0.0000001,
      "marketCapSol": 35.0,
      "isInitialBuy": true,             // launch bundle (★ marker)
      "timestamp": 1712345678
    },
    {
      "signature": "tx_signature...",
      "type": "buy",
      "solAmount": 1.2,
      "tokenAmount": 8500000,
      "priceSol": 0.00000014,
      "marketCapSol": 92.0,
      "isInitialBuy": false,            // post-launch market buy (DB marker)
      "timestamp": 1712348900
    }
  ],
  "count": 2
}

// URL: /api/v1/ohlcv/TokenMintBase58?resolution=1m&from=...&to=...
//
// Query parameters:
//   resolution — required: 1s | 15s | 30s | 1m | 5m | 15m | 1h | 4h | 1d
//   from       — UNIX timestamp (seconds), default: now - 24h
//   to         — UNIX timestamp (seconds), default: now

{
  "mint": "TokenMintBase58",
  "resolution": "1m",
  "from": 1712345000,
  "to": 1712348600,
  "candles": [
    {
      "timestamp": 1712345040,         // bucket start, UNIX seconds
      "open": 0.0000005,
      "high": 0.0000007,
      "low": 0.00000048,
      "close": 0.00000065,
      "volume": 12.5,                  // SOL volume in bucket
      "trades": 23                     // number of trades aggregated
    }
  ],
  "count": 60,
  "truncated": false,                  // hit the 5000-candle cap
  "reachedBufferStart": true,          // requested range extends past our oldest data
  "earliestAvailable": 1712340000,
  "source": "postgres"                 // postgres | buffer
}

// Sparse output — only buckets containing at least one trade are returned.
// Consumers handle their own forward-fill / gap rendering.
// Prices are SOL per token; volume is SOL. Convert to USD client-side.

{
  "publicKey": "CreatorWalletBase58",
  "mint": "TokenMintBase58"
}

{
  "transaction": "base64_serialized_transaction...",
  "creatorVault": "VaultAddressThatHoldsFees"
}

{
  "publicKey": "CreatorWalletBase58"
}

{
  "transactions": ["base64_tx_1...", "base64_tx_2..."],
  "tokens": [
    { "mint": "Token1Mint", "sharingConfig": "...", "creatorVault": "..." },
    { "mint": "Token2Mint", "sharingConfig": "...", "creatorVault": "..." }
  ],
  "totalTokens": 2,
  "message": "Found 2 token(s) with claimable fees. 1 transaction(s) to sign."
}

{
  "actions": [
    {
      "action": "buy",
      "publicKey": "Wallet1Base58",
      "mint": "TokenMintBase58",
      "solAmount": 0.5,
      "slippageBps": 1000,
      "pool": "auto"
    },
    {
      "action": "buy",
      "publicKey": "Wallet2Base58",
      "mint": "TokenMintBase58",
      "solAmount": 1.0
    },
    {
      "action": "sell",
      "publicKey": "Wallet3Base58",
      "mint": "TokenMintBase58",
      "tokenAmount": "1000000000"
    }
  ]
}

{
  "results": [
    { "index": 0, "action": "buy", "transaction": "base64...", "pool": "pump" },
    { "index": 1, "action": "buy", "transaction": "base64...", "pool": "pump" },
    { "index": 2, "action": "sell", "transaction": "base64...", "pool": "pump" }
  ],
  "total": 3,
  "success": 3,
  "failed": 0
}

{
  "publicKey": "YourWalletBase58",
  "signature": "base58_ed25519_signature",
  "message": "Link wallet to Pump4Dev API — 2025-04-11T..."
}

// The message must contain "Pump4Dev" (anti-phishing).
// Sign the message with your wallet (Phantom: signMessage).
// Signature must be base58-encoded.

// ── Tier System ──
// Free (no key):    1% fee, 60 req/min
// Holder (500K+):   0.5% fee, 180 req/min, whale alerts
// VIP (3M+):        0% fee, 600 req/min, all intelligence

// After linking, use your key in all requests:
// Header: X-API-Key: p4d_a1b2c3d4e5...

{
  "apiKey": "p4d_a1b2c3d4e5f6...",
  "wallet": "YourWalletBase58",
  "message": "Wallet linked successfully."
}

// GET /api/v1/auth/key — check your tier & balance
// POST /api/v1/auth/key — regenerate key
// DELETE /api/v1/auth/key — revoke key
// All require X-API-Key header.

// Content-Type: multipart/form-data
//
// Fields:
//   file         — Image (PNG, JPEG, GIF, WEBP, max 5MB)
//   name         — Token name
//   symbol       — Token symbol
//   description  — Token description (optional)
//   twitter      — Twitter URL (optional)
//   telegram     — Telegram URL (optional)
//   website      — Website URL (optional)

{
  "metadataUri": "https://ipfs.io/ipfs/QmHash..."
}