Builder & Agent Docs

Build on LumpFun

LumpFun is a Cardano-native fair-launch bonding curve. Tokens mint with a one-shot policy, trade against an on-chain constant-product curve, and graduate to Minswap V2 once they cross the configured ADA threshold. Everything below the UI is open: read state via REST, build transactions with any CIP-30 wallet + Lucid Evolution, sign, submit. No proprietary SDK required.

What you can build

Trading agents — read live curve state, compute slippage, submit signed buys/sells.
Portfolio dashboards — list tokens, fetch holdings, render OHLC charts.
Indexers / explorers — derive trade history straight from Cardano without re-implementing the curve math.
Launch automation — programmatic token launches with custom vesting / dev allocation parameters.
Sniper / MEV — go for it. The curve is exact constant-product; trades from the same block compete on tx-fee.

Sections

REST API Reference →Every public endpoint, request/response shape, code samples in curl + TypeScript.On-Chain Protocol →Aiken validators, parameterisation, datum/redeemer encoding, full launch / buy / sell tx walkthroughs.

Quick start

List every token currently launched on the protocol:

curl https://lumpfun.com/api/tokens

Fetch live curve reserves and a buy quote (no math required):

POLICY=ec11a20dc05761a24c415cfc85b42ef5b31caa52dd501082d6744b9c

# Curve state
curl "https://lumpfun.com/api/curve?address=$(curl -s https://lumpfun.com/api/token/$POLICY | jq -r .curveAddress)&asset=$POLICY$(curl -s https://lumpfun.com/api/token/$POLICY | jq -r .assetName)"

# Quote: 5 ADA buy
curl "https://lumpfun.com/api/quote?policyId=$POLICY&side=buy&amount=5000000"

Stability

REST endpoints documented in /docs/api are stable. Response shapes are additive — we may add fields, but won't break or remove existing ones without a deprecation window. Anything not documented in those pages should be treated as private (registry writes, treasury operations, etc.) and may change without notice.

Network & rate limits

Production API base URL: https://lumpfun.com
Cardano network: Mainnet. Tokens use real ADA.
No API key required for read endpoints.
Rate limits aren't enforced yet. Be polite — hammering the curve/quote routes in a tight loop hits Blockfrost on our side and may get your IP throttled if it impacts other users.

Disclaimer

LumpFun is experimental, unaudited software on Cardano mainnet. Tokens launched here are highly speculative experiments and most will lose all value. Building automation against the protocol means you're responsible for your own risk model, slippage, and key management. The protocol cannot reverse, refund, or recover transactions.