Skip to main content
POST
Quote a swap

Authorizations

x-api-key
string
header
required

Production API key beginning with o1_launch_.

Body

application/json
chain_id
enum<integer>
required

Production chain ID: 8453 for Base, 4663 for Robinhood Chain, 143 for Monad, 5042 for Arc, 56 for BSC, or 196 for X Layer.

Available options:
8453,
4663,
143,
5042,
56,
196
Example:

8453

wallet
string
required

Wallet that will execute the prepared swap.

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

"0x1111111111111111111111111111111111111111"

token_address
string
required

Tracked launch token to buy or sell, returned as token.address by GET /tokens.

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

"0x1111111111111111111111111111111111111111"

side
enum<string>
required

buy spends the selected settlement asset for launch tokens; sell spends launch tokens for that asset. Settlement defaults to the pool quote.

Available options:
buy,
sell
amount_in_raw
string
required

Exact input in base units: settlement-token units (paired quote when omitted) for buy, launch-token units for sell. Range: 1 through uint128 max.

Pattern: ^(0|[1-9][0-9]*)$
Example:

"1000000000000000000"

slippage_bps
integer
required

Slippage tolerance in basis points. 1 bps = 0.01%; 50 means 0.5%, 100 means 1%, and 300 means 3%. The swap reverts below the calculated minimum output.

Required range: 0 <= x <= 4999
Example:

50

settlement_token
string

Optional admitted buy payment/sell receipt asset; omission retains the pool quote. GET /config quote swap_settlement_tokens lists reviewed candidates. Native uses zero address; Arc SwapX supports ERC20 USDC, not native-USDC swaps. Routes, actual units, approvals and final amount-specific execution are verified before signing. Arbitrary assets or routes are rejected.

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

"0x1111111111111111111111111111111111111111"

referrer
string

Optional eligible referral wallet. It cannot be the trader, creator, platform treasury, or router. Unsupported for wstO burn pools.

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

"0x1111111111111111111111111111111111111111"

comment
string

Optional hook comment limited to 32 UTF-8 bytes.

Maximum string length: 32

Response

A signed short-lived quote and prerequisite steps.

data
object
required
meta
object
required