Forgepad API Documentation

{
  "tokenLogo": "data:image/png;base64,iVBORw0KGgoAAAANSUhE...",
  "mint": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
  "tokenName": "My Token",
  "tokenSymbol": "MTK",
  "userWallet": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
  "tokenSupply": 1000000000,
  "bondingStartMarketcap": 5000,
  "bondingMarketcap": 100000,
  "bondingFee": 1,
  "migrationFee": 100,
  "devBuy": 0.5,
  "quoteMint": "SOL",
  "tokenDescription": "A revolutionary token",
  "website": "https://mytoken.com",
  "twitter": "@mytoken"
}

{
  "success": true,
  "poolTx": "<base64-encoded-transaction>",
  "curveConfig": "44VcSFBvrj9pUhXCEzv8436wxYTbiXxGvW79MUWuM2W2"
}

{
  "walletSignedTransaction": "<base64-transaction>",
  "mintSecretKey": [1, 2, 3, ...],
  "mintSource": "bot",
  "mintFilename": "mint-abc123.json"
}

{
  "success": true,
  "signature": "5wHu1qwD7q4XqY4WZ..."
}

{
  "prefix": "ABC"
}

{
  "publicKey": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
  "secretKey": [1, 2, 3, ...],
  "filename": "mint-abc123.json"
}

{
  "prefix": "FORGE",
  "caseSensitive": false
}

{
  "publicKey": "FORGEabc123...",
  "secretKey": [1, 2, 3, ...],
  "attempts": 15423
}

{
  "holders": [
    {
      "address": "9WzDXwBbmkg8...",
      "balance": "1000000",
      "percentage": 10.5
    }
  ],
  "totalHolders": 150,
  "totalSupply": "1000000000"
}

{
  "new": {
    "timeframe": "24h",
    "sortBy": "launchTimestamp",
    "sortDir": "desc"
  },
  "graduating": {
    "timeframe": "7d",
    "sortBy": "bondingCurveProgress",
    "sortDir": "desc"
  },
  "graduated": {
    "timeframe": "all",
    "sortBy": "mcap",
    "sortDir": "desc"
  }
}

{
  "new": {
    "pools": [
      {
        "tokenMint": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
        "name": "My Token",
        "symbol": "MTK",
        "logoUrl": "https://...",
        "mcap": 50000,
        "volume24h": 12500,
        "bondingCurveProgress": 0.45,
        "launchTimestamp": "2024-01-15T10:30:00Z",
        "migrated": false
      }
    ]
  },
  "graduating": {
    "pools": []
  },
  "graduated": {
    "pools": []
  }
}

{
  "totalTokens": 1500,
  "totalVolume24h": "5000000",
  "totalGraduated": 250,
  "averageBondingProgress": 0.35
}

event: token_created
data: {"tokenMint": "...", "name": "...", "symbol": "..."}

event: token_graduated
data: {"tokenMint": "...", "graduatedAt": "..."}

event: price_update
data: {"tokenMint": "...", "price": 0.00001, "mcap": 50000}

{
  "generatedAt": "2024-01-15T10:30:00.000Z",
  "dataFreshnessSeconds": 15,
  "dbcConfigId": "44VcSFBvrj9pUhXCEzv8436wxYTbiXxGvW79MUWuM2W2",
  "tokens": [
    {
      "tokenMint": "7xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
      "name": "Forge Token",
      "symbol": "FORGE",
      "logoUrl": "https://...",
      "twitter": "@forgetoken",
      "telegram": "https://t.me/forgetoken",
      "website": "https://forgepad.fun",
      "mcap": 500000,
      "mcapAth": 750000,
      "volume24h": 125000,
      "usdPrice": 0.0005,
      "liquidity": 50000,
      "fdv": 500000,
      "priceChange24h": 15.5,
      "badge100k": true,
      "badge500k": false,
      "badge1m": false,
      "leaderboardUpdatedAt": "2024-01-15T10:29:45.000Z",
      "marketCapSource": "dbc_sqrt_price",
      "priceSource": "dbc_sqrt_price",
      "debug": null
    }
  ]
}

{
  "walletAddress": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
  "referralCode": "FORGE123"
}

{
  "success": true,
  "user": {
    "walletAddress": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
    "username": null,
    "points": 0,
    "lifetimePoints": 0,
    "referralCode": "USER_ABC123",
    "referredBy": "FORGE123",
    "tier": "bronze",
    "isRegistered": true
  },
  "isNew": true,
  "registered": true,
  "referralSet": true
}

{
  "username": "CryptoKing"
}

{
  "available": true,
  "username": "CryptoKing"
}

{
  "available": false,
  "error": "Username already taken"
}

{
  "walletAddress": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
  "username": "CryptoKing"
}

{
  "success": true,
  "username": "CryptoKing"
}

{
  "walletAddress": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
  "username": "CryptoKing",
  "isRegistered": true,
  "currentEpoch": "2024-01",
  "currentOre": 15000,
  "oreExpiringSoon": 5000,
  "oreLifetime": 150000,
  "oreTotalSmelted": 100000,
  "volumeCurrentEpoch": "50000000000",
  "volumeLifetime": "500000000000",
  "referral": {
    "referrerWallet": "4xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
    "referrerUsername": "Referrer123",
    "totalReferees": 10,
    "totalRefereePoints": 5000,
    "selfBonusEarned": 2500
  },
  "rewards": [
    {
      "epochId": "2024-01",
      "cycleId": "cycle_001",
      "points": 10000,
      "claimableSol": "0.5",
      "claimed": false,
      "expiresAt": "2024-02-15T00:00:00.000Z",
      "startedAt": "2024-01-01T00:00:00.000Z",
      "smelterOpenUntil": "2024-01-03T00:00:00.000Z"
    }
  ]
}

{
  "events": [
    {
      "eventType": "trade",
      "basePoints": 1000,
      "selfBonusPoints": 50,
      "referrerBonusPoints": 0,
      "totalPoints": 1050,
      "epochId": "2024-01",
      "createdAt": "2024-01-15T10:30:00.000Z",
      "expiresAt": "2024-02-14T10:30:00.000Z"
    }
  ],
  "pagination": {
    "limit": 20,
    "offset": 0,
    "hasMore": true
  }
}

{
  "epochId": "2024-01",
  "type": "ore",
  "entries": [
    {
      "rank": 1,
      "walletAddress": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM",
      "username": "TopMiner",
      "currentOre": 500000,
      "tier": "platinum"
    },
    {
      "rank": 2,
      "walletAddress": "4xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
      "username": null,
      "currentOre": 350000,
      "tier": "gold"
    }
  ],
  "userRank": {
    "oreRank": 15,
    "volumeRank": 23
  },
  "pagination": {
    "limit": 50,
    "offset": 0,
    "hasMore": true
  }
}

{
  "smelter": {
    "is_open": true,
    "manual_override": false,
    "current_window": {
      "opens": "2024-01-15T00:00:00.000Z",
      "closes": "2024-01-17T00:00:00.000Z"
    },
    "next_window_opens": "2024-01-29T00:00:00.000Z",
    "next_window_closes": "2024-01-31T00:00:00.000Z",
    "hours_until_open": 0
  },
  "user": {
    "available_ore": 15000,
    "ore_expiring_soon": 5000,
    "expired_ore": 0,
    "already_smelted_ore": 10000,
    "pool_balance_sol": "10.5",
    "total_unsmelted_ore": 500000,
    "estimated_sol": "0.315",
    "can_smelt": true,
    "message": "Smelter is open! You can smelt your ORE now."
  }
}

{
  "walletAddress": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM"
}

{
  "success": true,
  "cycleId": "cycle_001",
  "oreSubmitted": 15000,
  "estimatedSol": "0.315",
  "message": "Successfully submitted 15,000 ORE to smelting cycle"
}

{
  "error": "Smelter is not currently open"
}

{
  "cycleId": "679a1b2c3d4e5f6789012345",
  "walletAddress": "9WzDXwBbmkg8ZTbNMqUxvQRAyrZzDsGYdLVL9zYtAWWM"
}

{
  "success": true,
  "txSignature": "5wHu1qwD7q4XqY4WZ...",
  "claimedSol": "0.499000000",
  "grossSol": "0.5",
  "gasReserve": "0.001"
}

{
  "totalTrades": 150,
  "totalVolume": "500000000000",
  "averageOrePerMiner": 12500,
  "topMiner": {
    "walletAddress": "4xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
    "username": "TopReferee",
    "totalOre": 50000
  },
  "miners": [
    {
      "walletAddress": "4xKXtg2CW87d97TXJSDpbD5jBkheTqA83TZRuJosgAsU",
      "username": "TopReferee",
      "totalOre": 50000,
      "volumeLifetime": "100000000000",
      "joinedAt": "2024-01-10T10:30:00.000Z"
    }
  ]
}

{
  "totalEarnings": 25000,
  "earningsThisEpoch": 5000,
  "refereeCount": 10,
  "bonusRate": 10
}

{
  "balance": "5.25",
  "isActive": true,
  "recentDrops": [
    {
      "amount": "0.05",
      "timestamp": "2024-01-15T10:30:00.000Z",
      "walletAddress": "9WzDXw..."
    }
  ]
}

{
  "totalMiners": 1500,
  "totalOreEarned": 50000000,
  "totalSolDistributed": "1250.5",
  "activeCycle": {
    "cycleId": "cycle_002",
    "status": "active",
    "solPool": "15.5",
    "totalOre": 750000
  },
  "currentEpoch": "2024-01"
}

{
  "organizations": [
    {
      "id": "org_123abc",
      "name": "Save the Children",
      "logo": "https://...",
      "description": "Global children's charity",
      "category": "Children & Youth"
    },
    {
      "id": "org_456def",
      "name": "Red Cross",
      "logo": "https://...",
      "description": "Humanitarian aid organization",
      "category": "Disaster Relief"
    }
  ]
}

{
  "transactions": [
    {
      "txSignature": "5wHu1qwD7q4...",
      "tokenMint": "7xKXtg2CW87d...",
      "organizationId": "org_123abc",
      "organizationName": "Save the Children",
      "amount": "1.5",
      "timestamp": "2024-01-15T10:30:00.000Z"
    }
  ]
}

{
  "error": "Human-readable error message"
}

{
  "error": "Too many requests"
}

type UserTier = 'bronze' | 'silver' | 'gold' | 'platinum';

type PointEventType = 'trade' | 'referral' | 'bonus' | 'smelter' | 'adjustment' | 'ember_drop';

type CycleStatus = 'pending' | 'active' | 'smelting' | 'completed' | 'cancelled';

type TradeDirection = 'buy' | 'sell';

type QuoteMint = 'SOL' | 'USDC' | 'USD1' | 'MET';

type DistributionType = 'Rewards' | 'Dividends' | 'Burn' | 'Charity';

const eventSource = new EventSource('/api/explore/stream');

eventSource.addEventListener('token_created', (event) => {
  const data = JSON.parse(event.data);
  console.log('New token:', data);
});

eventSource.addEventListener('token_graduated', (event) => {
  const data = JSON.parse(event.data);
  console.log('Token graduated:', data);
});

eventSource.addEventListener('price_update', (event) => {
  const data = JSON.parse(event.data);
  console.log('Price update:', data);
});

// 1. Get mint keypair
const mintRes = await fetch('/api/get-mint-keypair', { method: 'POST' });
const { publicKey, secretKey, filename } = await mintRes.json();

// 2. Create pool transaction
const poolRes = await fetch('/api/upload', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    tokenLogo: logoBase64,
    mint: publicKey,
    tokenName: 'My Token',
    tokenSymbol: 'MTK',
    userWallet: walletAddress,
    tokenSupply: 1000000000,
    bondingStartMarketcap: 5000,
    bondingMarketcap: 100000,
    bondingFee: 1,
    migrationFee: 100,
    devBuy: 0.5,
    quoteMint: 'SOL'
  })
});
const { poolTx } = await poolRes.json();

// 3. Sign with wallet
const tx = Transaction.from(Buffer.from(poolTx, 'base64'));
const signedTx = await wallet.signTransaction(tx);

// 4. Send transaction
const sendRes = await fetch('/api/send-transaction', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify({
    walletSignedTransaction: signedTx.serialize().toString('base64'),
    mintSecretKey: Array.from(secretKey),
    mintFilename: filename,
    mintSource: 'bot'
  })
});
const { signature } = await sendRes.json();

// 1. Check smelt status
const statusRes = await fetch(`/api/rewards/smelt/status?wallet=${walletAddress}`);
const { smelter, user } = await statusRes.json();

// 2. Get user dashboard for available rewards
const dashRes = await fetch(`/api/rewards/user/${walletAddress}`);
const { rewards } = await dashRes.json();

// 3. Claim unclaimed reward
const unclaimedReward = rewards.find(r => !r.claimed && !r.forfeited);
if (unclaimedReward) {
  const claimRes = await fetch('/api/rewards/claim', {
    method: 'POST',
    headers: { 'Content-Type': 'application/json' },
    body: JSON.stringify({
      cycleId: unclaimedReward.cycleId,
      walletAddress
    })
  });
  const { txSignature, claimedSol } = await claimRes.json();
}