Spawn.meme Docs

v1.0.0 · api.spawn.meme

SPAWN is a decentralized token launchpad built on Ethereum. Anyone can create a token with a bonding curve in seconds — no coding, no presale, no team allocation. When a token's bonding curve reaches its target, it automatically graduates to Uniswap with locked liquidity (1% Fee).

The Spawn.meme API provides programmatic access to the entire platform: token discovery, trading data, user profiles, real-time WebSocket events, and more.

Base URL: https://api.spawn.meme

WebSocket: wss://api.spawn.meme/ws

How It Works

Create a Token

Pick a name, symbol, and description. Upload an image and set optional social links. Every token launches with a standardized 1 billion total supply and an automated bonding curve. No coding required — takes only seconds.

Trade on Bonding Curve

Tokens are immediately tradeable via an automated bonding curve. Price increases as supply is bought. A 1% fee applies to each transaction. The curve fills as more ETH is deposited — everyone can see the progress in real-time.

Graduate to Uniswap

When the bonding curve reaches its target, the token enters a duel phase and then automatically migrates to Uniswap. A 1% Fee is deducted, and remaining liquidity is paired with the collected ETH and locked permanently.

Fair & Transparent

No presale, no team tokens, no insider allocation. All trades happen on-chain with transparent pricing. Holders, swaps, and charts are public and real-time. The system ensures a level playing field for all participants.

Create Token via API

This guide shows how to programmatically create a token on Spawn using direct smart contract interaction. Useful for bots, custom UIs, or integrating Spawn into your own platform.

Flow Overview

Upload Image

to IPFS

Upload Metadata

JSON to IPFS

Get Vanity Salt

from API

Call Contract

newTokenV2()

Parse Event

TokenCreated

Contract Info

Portal Contract (Proxy)0x295F1C1f486e74F98E3bE18f02a530135CC2C8EC

NetworkEthereum Mainnet (chainId: 1)

FunctionnewTokenV2(params)

Tax Token FunctionnewTaxToken(params)

1Upload Token Image to IPFS

Upload your token logo (PNG/JPG, max 5MB) to IPFS via any pinning service (Pinata, Infura, nft.storage, etc). You need the resulting ipfs://<CID> URI.

2Upload Token Metadata to IPFS

Build a JSON metadata object and upload it to IPFS. The contract stores this URI on-chain as the token's meta field.

3Generate Vanity Salt

The Portal contract uses CREATE2, so each token needs a unique salt. The vanity API generates a salt that produces a token address with a recognizable suffix (0x...8888 for standard tokens, 0x...7777 for tax tokens).

4Call the Smart Contract

Send a transaction to the Portal contract. If you include ETH as msg.value, it acts as an initial buy (you'll receive tokens in the same tx). Set to 0 for no initial buy.

Standard Token — newTokenV2()

Tax Token — newTaxToken()

Tax tokens charge a fee on Uniswap trades after graduation. The tax is split between a marketing wallet, burn, and LP.10% of collected taxes go to the platform, and 90% are distributed according to the creator's allocation. Allocation percentages are in basis points and must sum to 10000.

5Parse the Token Address from Event

After the transaction is confirmed, parse the TokenCreated (or TaxTokenCreated) event from the receipt logs to get the deployed token address. Alternatively, use the predicted address returned by the vanity salt API (Step 3) — it's deterministic via CREATE2.

Parameter Reference

Param	Type	Description
`name`	`string`	Token name (e.g. "Doge Coin")
`symbol`	`string`	Token ticker, uppercased (e.g. "DOGE")
`meta`	`string`	IPFS URI to metadata JSON (ipfs://...)
`dexThresh`	`uint8`	Default: 1. Only accepted value — other values will be rejected.
`salt`	`bytes32`	Vanity salt from /vanity/api/generate
`taxRate`	`uint16`	Standard: bonding curve tax (bps). Tax token: DEX tax (bps)
`migratorType`	`uint8`	Default: 1. Only accepted value — other values will be rejected.
`quoteToken`	`address`	0x0...0 for ETH pair
`quoteAmt`	`uint256`	0 for ETH pair
`beneficiary`	`address`	Address that receives fees/tax revenue
`permitData`	`bytes`	0x (unused, pass empty bytes)
`msg.value`	`ETH`	Initial buy amount. 0 = launch without buying

Important Notes

Total supply is always 1 billion tokens (18 decimals).
Token creation fee: Free — no cost to launch a token.
Trading fee: 1% on buys and sells on the bonding curve.
Liquidity fee: 1% on DEX migration.
If you send ETH as msg.value, it counts as the creator's initial buy (you get tokens).
The vanity salt endpoint is rate-limited. Cache the salt if you retry the transaction.
Gas recommendation: 2M for standard tokens, 3M for tax tokens.
Token address is deterministic via CREATE2 — the predicted address from the vanity API will match the deployed address.
For tax tokens, marketBps + deflationBps + lpBps must equal 10000.
For tax tokens, 10% of collected taxes go to the platform and 90% are distributed according to the creator's configuration (Marketing / Burn / LP).

Authentication

Spawn uses wallet-based authentication via EIP-191 message signing. No passwords or emails — just your Ethereum wallet.

Request a nonce

POST /auth/nonce with your wallet address. Creates your account if needed.

Sign the message

Sign: "Sign this message to authenticate with SPAWN.\n\nNonce: {nonce}"

Verify & get JWT

POST /auth/verify with your address + signature. Receive a JWT token.

Use the JWT

Include Authorization: Bearer <token> on all authenticated endpoints.

Rate Limits & Caching

Rate Limits

Global300 req/min per IP

Auth endpoints20 req/min per IP

Write endpoints30 req/min per IP

Messages5 per hour per user

Rate limit headers (RateLimit-*) are included in all responses.

Caching

All public GET endpoints are cached for 10 seconds. Responses include cache status headers:

X-Cache: HITResponse served from cache

X-Cache: MISSFresh response from server

Authenticated GET requests bypass the cache entirely.

WebSocket

Connect to wss://api.spawn.meme/ws for real-time events. All messages are JSON-encoded.

Event	Description	Payload
`swap`	New swap executed on any token	Swap object with token metadata
`token:new`	New token launched on the platform	Full Token object
`token:status`	Token status change (e.g. graduated to DEX)	{ address, status }
`message:new`	New chat message posted on a token	Message object
`price:update`	Real-time price update for a token	{ address, priceUSD, priceNative }

Connection Limits

Max connections per IP5

Max message rate30 per 10s

Max subscriptions20 channels

Max payload size4 KB

API Reference

All endpoints use https://api.spawn.meme as the base URL. Responses are JSON.

Error Response Format

All error responses follow a consistent structure:

Spawn.meme API v1.0.0support@spawn.meme