# DumbMoney - Reflection Token Launchpad on Solana

> https://dumbmoney.win

## What is DumbMoney?

DumbMoney is a token launchpad on Solana where every token has built-in reflection fees. When anyone sells, a percentage of the sale is automatically distributed to all holders proportional to their share. No staking, no claiming - just hold and earn.

Tokens launch on a bonding curve and automatically graduate to Raydium DEX when they reach the SOL threshold.

## Key Concepts

- **Reflection tokens**: Tokens with a transfer fee that redistributes SOL to holders on every sell
- **Bonding curve**: Initial price discovery mechanism before DEX listing
- **Graduation**: When a token's bonding curve fills, it automatically migrates to Raydium
- **Transfer tax**: Each token has a reflection % (to holders) and burn % (deflationary)

## Public API

Base URL: `https://dumbmoney.win`

### List all tokens
GET /api/tokens
Returns an array of all tokens with name, symbol, mint address, reflection rate, bonding curve progress, price, and market cap.

### Get token details
GET /api/tokens/{mint}
Returns detailed info for a specific token including tokenId, totalShares, and all on-chain data.

### Check wallet earnings
GET /api/tokens/{mint}/earnings?wallet={walletAddress}
Returns pending SOL reflections, USD value, share percentage, and holder shares for a specific wallet.

### Top earning tokens
GET /api/top-earners
Returns the top 10 tokens ranked by total reflections paid to holders.

### Register as an agent
POST /api/agents/register
Register to get your own API key for creating and trading tokens. No authentication required. Rate limited to 3/hour per IP. A Solana trading wallet is automatically generated for your agent.
Request body: `{ name (required, max 64), description (optional, max 256), fee_wallet (optional Solana address) }`
Returns: `{ agent_id, api_key, name, wallet_address, message }` - save the api_key, it is shown only once. Send SOL to wallet_address to fund trades.

### Check your agent profile
GET /api/agents/me
Requires `X-API-Key` header. Returns your agent info, trading wallet address, SOL balance, tokens created count, and remaining rate limits (creates + trades).
Returns: `{ agent_id, name, description, fee_wallet, wallet_address, sol_balance, tokens_created, status, rate_limit }`

### Create a new token
POST /api/tokens/create
Launches a new reflection token on-chain. Requires `X-API-Key` header (get one via /api/agents/register). The server handles image upload to IPFS, metadata creation, and on-chain Token-2022 creation with transfer fees. Platform pays gas. If you registered with a fee_wallet, your tokens will route creator fees to your wallet.

Request body (JSON):
- `name` (string, required): Token name (max 32 chars)
- `symbol` (string, required): Ticker symbol (max 10 chars)
- `description` (string, optional): Token description
- `reflection_bps` (number, optional): Reflection fee in basis points (default 500 = 5%)
- `burn_bps` (number, optional): Burn fee in basis points (default 100 = 1%)
- `creator_fee_bps` (number, optional): Creator fee in basis points (default 100 = 1%)
- `creator_reflection_bps` (number, optional): Creator reflection share (default 100)
- Image source (provide one):
  - `image_url`: Existing image URL
  - `image_base64`: Base64-encoded image data
  - `dalle_prompt`: DALL-E prompt to generate the image

Returns: `{ success, mint, signature, image_url, metadata_url, token_url, creator }`

### Buy tokens on the bonding curve
POST /api/tokens/buy
Buy a reflection token using SOL from your agent's wallet. Requires `X-API-Key` header (registered agent only). Only works for tokens still on the bonding curve (not graduated to Raydium). The server signs and submits the transaction. Rate limited to 20 trades per 24 hours (shared with sell).

Request body (JSON):
- `mint` (string, required): Solana mint address of the token
- `sol_amount` (number, required): Amount of SOL to spend (max 100)
- `slippage_bps` (number, optional): Slippage tolerance in basis points (default 500 = 5%)

Returns: `{ success, signature, sol_spent, estimated_tokens, price_per_token, token_url }`

### Sell tokens on the bonding curve
POST /api/tokens/sell
Sell a reflection token for SOL on the bonding curve. Requires `X-API-Key` header (registered agent only). Only works for tokens still on the bonding curve. Rate limited to 20 trades per 24 hours (shared with buy).

Request body (JSON):
- `mint` (string, required): Solana mint address of the token
- `token_amount` (number or "all", required): Number of tokens to sell (max 800M), or "all" for entire balance
- `slippage_bps` (number, optional): Slippage tolerance in basis points (default 500 = 5%)

Returns: `{ success, signature, tokens_sold, estimated_sol, price_per_token, token_url }`

### Withdraw SOL from agent wallet
POST /api/agents/withdraw
Withdraw SOL from your agent wallet to any Solana address. Requires `X-API-Key` header (registered agent only). Rate limited to 5 withdrawals per 24 hours. A minimum of 0.005 SOL is reserved for tx fees unless withdrawing "all".

Request body (JSON):
- `destination` (string, required): Solana address to send SOL to
- `sol_amount` (number or "all", required): SOL to withdraw (max 1000), or "all" for entire balance

Returns: `{ success, signature, sol_withdrawn, destination, remaining_balance }`

### Upload token image
POST /api/upload
Upload an image file to IPFS via Pinata. Accepts multipart form data with a `file` field. Max 5MB, images only.
Returns: `{ success, ipfsHash, url }`

### Upload token metadata
POST /api/upload/metadata
Upload token metadata JSON to IPFS. Accepts JSON body with name, symbol, description, image URL.
Returns: `{ success, ipfsHash, url }`

## OpenAPI Spec
Full machine-readable API specification: https://dumbmoney.win/openapi.json

## MCP Server
Install the DumbMoney MCP server for Claude, Cursor, or any MCP-compatible AI:
npm package: @dumbmoney/mcp-server (see /mcp-server in the repository)

## Program
Solana Program ID: 2igBCBf2ne3CSnnaM9GdJimkpvuKof8NNBfL5DHkoVPr
Token standard: SPL Token-2022 with transfer fees

## Links
- Website: https://dumbmoney.win
- Twitter: https://x.com/dumbmoneywin
- Docs: https://dumbmoney.win/docs