Skip to main content
POST
Prepare a launch

Authorizations

x-api-key
string
header
required

Production API key beginning with o1_launch_.

Headers

Unique retry ID
Idempotency-Key
string
required

Generate a random UUID for each new request and reuse it only when retrying that exact request. A different payload is rejected.

Required string length: 1 - 255

Body

application/json
chain_id
enum<integer>
required

Production chain ID: 8453 for Base or 4663 for Robinhood Chain.

Available options:
8453,
4663
Example:

8453

creator
string
required

Wallet that will sign and send the prepared launch transaction.

Pattern: ^0x[0-9a-fA-F]{40}$
Example:

"0x1111111111111111111111111111111111111111"

market
enum<string>
required

Launch route to use. The selected quote must be active for this market.

Available options:
standard,
rwa
quote_address
string
required

Active quote address returned by GET /config for the selected chain and market. The zero address represents an active native-currency quote.

Pattern: ^0x[0-9a-fA-F]{40}$
Example:

"0x1111111111111111111111111111111111111111"

token
object
required

Token identity, public profile, image, and optional metadata settings.

allocations
object[]

Optional immediate token allocations, subject to the live launch caps.

Maximum array length: 128
vesting
object[]

Optional vested token allocations, subject to the live launch caps.

Maximum array length: 64

Response

An unsigned launch transaction plan.

data
object
required
meta
object
required