Skip to main content
POST
POST /api/v2/swap/transaction — Build unsigned transaction (raw mode)

Authorizations

Authorization
string
header
required

Use Authorization: Bearer <jwt> for user auth or Authorization: Bearer sk_{keyId}_{secret} for API key auth.

Body

application/json

POST /api/v2/swap/transaction request body

Build an unsigned transaction from trade parameters. The caller signs locally and submits via /submit or directly to chain.

amount
string
required

Amount in base units (e.g., lamports for SOL, wei for EVM)

chain
string
required

Chain identifier: "solana", "base", "bsc"

inputMint
string
required

Token address to sell

outputMint
string
required

Token address to buy

walletAddress
string
required

User's own wallet address (not a Shuriken wallet ID)

slippageBps
integer<int32>

Slippage tolerance in basis points (default: 100 = 1%)

Response

Unsigned transaction

V2 success response envelope

data
object
required

Wrapper enum for /transaction response (SVM or EVM). Uses #[serde(untagged)] so the JSON shape varies by chain.

requestId
string
required
pagination
object | null

Page-based pagination info (per RFC)