Developer API

Quick start

1. Upload an image in any aspect ratio.
2. Create the metadata document.
3. Prepare an unsigned launch transaction.
4. Sign and broadcast on chain ID 4663.
5. Read the indexed token and live graduation progress.

1. Upload image

curl -X POST $BASE_URL/api/v1/images \
  -F "image=@token.png"

2. Create metadata

curl -X POST $BASE_URL/api/v1/metadata \
  -H "content-type: application/json" \
  -d '{"name":"Degen Cat","symbol":"DEGEN","image":"/api/image/IMAGE_ID"}'

3. Prepare launch

curl -X POST $BASE_URL/api/v1/launch/prepare \
  -H "content-type: application/json" \
  -d '{"name":"Degen Cat","symbol":"DEGEN","metadataUri":"METADATA_URI","feeRecipient":"0x...","initialBuyEth":"0.1"}'

The response contains chainId, to, data, and value. Sign it with your own wallet. The API never receives a private key.

4. Read launches

curl "$BASE_URL/api/v1/tokens?limit=50"
curl "$BASE_URL/api/v1/tokens/0xTOKEN"
curl "$BASE_URL/api/v1/tokens/0xTOKEN/trades?limit=50"

Progress is returned as basis points: 0 to 10000. It follows the V3 pool's WETH balance, and graduation becomes permanent as soon as the indexed all-time-high pool balance reaches the configured target. No keeper transaction is required.

Reliability

• Cursor pagination is stable by launch block.
• Indexer resumes from disk and rewinds 20 blocks after restart.
• Read responses use short CDN caching and stale-while-revalidate.
• All v1 endpoints support browser CORS.
• Errors use an object with stable code and human-readable message.