microchipx402 Facilitators API

The Claude_launch x402 Facilitators API enables AI agents to autonomously launch tokens on Solana. A facilitator is an AI-powered service that handles the entire token launch process - from creation to deployment.

API usage doesn't require users to hold $CLAI at this time. But if your users hold $CLAI they are also eligible for discounts, see more here.

triangle-exclamation

How it works

Base API URL

https://api.claudelaunch.ai/v1

Payment Request Flow

- Service returns HTTP 402 when payment is required.

- Client pays (e.g., USDC transfer on Solana).

- Client resubmits request with proof headers.

Required Headers for x402

X-Payment-Signature: <transaction_signature>
X-Payment-Payer: <your_wallet_address>
X-Payment-Service-Id: <unique_service_id>

Verification (handled server-side)

- Tx confirmed on Solana mainnet

- Amount ≥ required fee

- Recipient = service wallet

- Service ID unique & not expired/reused

Endpoints

POST /facilitator/prepare-launch

Prepares a launch and returns the required fee information. Call this first to get payment details.

Request Body

Response

POST /facilitator/launch

Initiates a token launch. Requires payment proof headers.

Required Headers

Request Body

Parameters

Parameter
Type
Required
Description

token.name

string

Yes

Token name (max 32 characters)

token.symbol

string

Yes

Token ticker symbol (max 10 characters)

token.description

string

Yes

Token description (max 500 characters)

token.image

string

Yes

URL to token image (PNG/JPG, min 400x400)

token.twitter

string

No

Twitter/X profile URL

token.telegram

string

No

Telegram group URL

token.website

string

No

Project website URL

launch.platform

string

Yes

Target platform: pumpfun or letsbonk

launch.devBuyAmount

number

No

SOL amount for dev wallet buy (default: 0)

launch.bundleWallets

array

No

Array of bundle wallet configurations

Response


GET /facilitator/launch/{launchId}

Get the status of a token launch.

Response

Status Values

Status
Description

pending

Launch queued, awaiting processing

processing

Facilitator is executing the launch

completed

Token successfully deployed

failed

Launch failed (see error details)


GET /facilitator/status

Check facilitator availability and current queue.

Response


Complete Integration Example

Full Launch Flow with USDC Payment


Error Handling

Error Response Format

Common Error Codes

Code
Description

INVALID_PAYMENT

Payment proof is invalid, expired, or already used

PAYMENT_NOT_FOUND

USDC transfer not found on-chain

INSUFFICIENT_AMOUNT

Payment amount is less than required fee

WRONG_RECIPIENT

Payment sent to wrong wallet

SERVICE_ID_USED

Service ID has already been used

PAYMENT_EXPIRED

Payment proof has expired

INVALID_TOKEN_CONFIG

Token configuration is missing required fields

PLATFORM_UNAVAILABLE

Selected platform is currently unavailable

RATE_LIMITED

Too many requests, please wait

FACILITATOR_BUSY

Facilitator queue is full, try again later


Rate Limits

Endpoint
Limit

POST /facilitator/prepare-launch

20 requests/minute

POST /facilitator/launch

10 requests/minute

GET /facilitator/launch/{id}

60 requests/minute

GET /facilitator/status

30 requests/minute


Last updated