Creates a new token on-chain. This endpoint prepares and optionally executes the blockchain transaction to deploy a new token contract with specified parameters.
Supports:
Returns transaction data for client-side execution or confirmation of server-side execution.
Anti-Sniping & Initial Buy Fees:
USD Rewards Attribution:
JWT token or API key
Token name
1"My Cool Token"
Token symbol (ticker)
1 - 10"MCT"
Token description
1"A revolutionary new token"
Token logo image - can be either a URL or base64-encoded image data (data:image/...)
1"https://example.com/logo.png or data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg=="
Blockchain identifier. Supported chains: solana, solana-devnet, arbitrum, base, base-sepolia, avalanche, op-bnb, bnb, bnb-testnet, ethereum, monad, unichain, unichain-testnet, abstract, polygon, zksync, zksync-testnet
solana, solana-devnet, arbitrum, base, base-sepolia, avalanche, op-bnb, bnb, bnb-testnet, ethereum, monad, unichain, unichain-testnet, abstract, polygon, zksync, zksync-testnet "base-sepolia"
Banner image - can be either a URL or base64-encoded image data (data:image/...)
1"https://example.com/banner.png or data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAAEAAAABCAYAAAAfFcSJAAAADUlEQVR42mNk+M9QDwADhgGAWjR9awAAAABJRU5ErkJggg=="
Promotional video - can be either a URL or base64-encoded video data (data:video/...)
1"https://example.com/promo.mp4 or data:video/mp4;base64,AAAAIGZ0eXBpc29tAAACAGlzb21pc28yYXZjMW1wNDEAAAAIZnJlZQAACKBtZGF0AAAC"
Optional social media and website links
Optional array of destination chain slugs for cross-chain token deployment and migration endpoints. Defaults to [base-sepolia, bnb-testnet, solana-devnet]. The initial chain will be automatically excluded from migration endpoints.
Blockchain identifier. Supported chains: solana, solana-devnet, arbitrum, base, base-sepolia, avalanche, op-bnb, bnb, bnb-testnet, ethereum, monad, unichain, unichain-testnet, abstract, polygon, zksync, zksync-testnet
solana, solana-devnet, arbitrum, base, base-sepolia, avalanche, op-bnb, bnb, bnb-testnet, ethereum, monad, unichain, unichain-testnet, abstract, polygon, zksync, zksync-testnet [
"base-sepolia",
"bnb-testnet",
"solana-devnet"
]Type of token pool. Defaults to "meme". Maps to: meme=7, startup-preseed=8
meme, startup-preseed, test "meme"
User wallet address (optional - if not provided, will use user's Privy wallet from user_wallets table)
^0x[a-fA-F0-9]{40}$"0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb"
Builder attribution information (optional). Includes address and fee in bps.
Token referral address for attribution (optional - defaults to zero address). Used to attribute referral fees to a specific address.
^0x[a-fA-F0-9]{40}$"0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb"
Optional hashtags/tags for the token
["defi", "meme"]Transaction type (currently only "coin" is supported - placeholder for future integration)
coin "coin"
Optional USD amount to spend on initial token purchase (in USD). Use 0 or omit to skip initial purchase.
x >= 010
Optional number of tokens to purchase initially. Use 0 or omit to skip initial purchase. If both amountIn and tokensOut are provided, tokensOut takes priority.
x >= 01000
Maximum USD amount willing to spend when tokensOut is specified. This value comes from the Quoter contract quote and includes slippage protection. Required when tokensOut is provided.
x >= 015.5
Successful response
true Numeric chain ID for the transaction
84532
Deprecated: Use transactions array instead. Single transaction object for backwards compatibility.
Array of transactions to execute. May include USDC approval transaction if initial purchase is requested.