curl --request POST \
--url https://payments.magicblock.app/v1/swap/swap \
--header 'Content-Type: application/json' \
--data '
{
"userPublicKey": "3rXKwQ1kpjBd5tdcco32qsvqUh1BnZjcYnS5kYrP7AYE",
"quoteResponse": {
"inputMint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"inAmount": "1000000",
"outputMint": "Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB",
"outAmount": "999519",
"otherAmountThreshold": "994522",
"swapMode": "ExactIn",
"slippageBps": 50,
"priceImpactPct": "0",
"routePlan": []
}
}
'{
"swapTransaction": "AQABA...base64...",
"lastValidBlockHeight": 318120000
}Swap
curl --request POST \
--url https://payments.magicblock.app/v1/swap/swap \
--header 'Content-Type: application/json' \
--data '
{
"userPublicKey": "3rXKwQ1kpjBd5tdcco32qsvqUh1BnZjcYnS5kYrP7AYE",
"quoteResponse": {
"inputMint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
"inAmount": "1000000",
"outputMint": "Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB",
"outAmount": "999519",
"otherAmountThreshold": "994522",
"swapMode": "ExactIn",
"slippageBps": 50,
"priceImpactPct": "0",
"routePlan": []
}
}
'{
"swapTransaction": "AQABA...base64...",
"lastValidBlockHeight": 318120000
}ボディ
Public key of the wallet that will sign the swap transaction.
"3rXKwQ1kpjBd5tdcco32qsvqUh1BnZjcYnS5kYrP7AYE"
Quote response from GET /v1/swap/quote.
Optional fee payer for transaction fees and rent.
"3rXKwQ1kpjBd5tdcco32qsvqUh1BnZjcYnS5kYrP7AYE"
Automatically wrap and unwrap native SOL when needed.
true
Allow shared accounts for intermediate routing state.
true
Optional initialized token account used to collect platform fees.
Optional public key used for downstream transaction tracking.
Optional priority fee configuration or fixed lamport amount.
x >= 0Build a legacy transaction instead of a versioned one. Not allowed when visibility = "private".
Optional destination token account for the output mint. When visibility = "private", this is server-controlled and must match the derived stash ATA.
Optional destination account for native SOL output. Not supported when visibility = "private".
Estimate compute usage and set the compute unit limit automatically.
Skip extra RPC checks for required user accounts.
Let the upstream swap builder overwrite slippage on the transaction.
Optional exact compute unit price in micro-lamports.
x >= 0Optional transaction expiry window in slots.
x >= 0Optional positive slippage collection settings.
public (default) proxies Jupiter/Metis as-is. private routes the output through a scheduled private transfer.
public, private "public"
Final private-transfer recipient (wallet pubkey). Required when visibility = "private".
Earliest (ms) the queued transfer may settle. Required when visibility = "private".
^\d+$"0"
Latest (ms) the queued transfer may settle. Required when visibility = "private". Must be >= minDelayMs and <= 600000 (10 minutes).
^\d+$"60000"
Number of queue entries to split the transfer across. Required when visibility = "private". Must be between 1 and 14.
1 <= x <= 14Optional u64 client correlation id attached to each queued split.
^\d+$Optional validator pubkey for the transfer-queue PDA. Defaults to the well-known MagicBlock validator (MAS1Dt9qreoRMQ14YQuhg8UTZMMzDdKhmkZMECCzk57).
レスポンス
Swap transaction
Base64-encoded unsigned transaction.
x >= 0x >= 0Present only when visibility = "private". Diagnostic metadata about the appended schedule_private_transfer instruction.
Show child attributes
Show child attributes