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":"Hood Cat","symbol":"HCAT","metadataUri":"METADATA_URI","feeRecipient":"0x...","sender":"0x...","initialBuyHood":"1"}'

initialBuyHood is an optional 18-decimal HOOD amount. If it is non-zero, submit the returned approval transaction first, then submit launch. Native ETH is used only for gas and an optional factory launch fee.

The API always returns chain ID 4663 and the fixed HOOD pair token. Sign both transactions 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 HOOD 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.
• Only Robinhood Chain and the fixed HOOD quote token are accepted.
• Read responses use short caching and stale-while-revalidate.
• All endpoints support browser CORS.
• Errors use stable codes and human-readable messages.