Execute Swap
This endpoint performs an atomic exchange of one asset for another through a specified liquidity pool. The swap is executed immediately and settlement is handled by the TEE system.
Swap Process
- User deposits input asset to the pool’s address
- Submit swap request with transfer proof
- Pool calculates output amount based on current reserves
- Slippage protection is applied
- Output asset is sent to the user
- Fees are distributed to LPs and hosts
Price Calculation
- For constant product pools: Uses x*y=k formula
- For single-sided pools: Uses bonding curve
- Price impact increases with swap size
Slippage Protection
Two methods to protect against price movement:
- min_amount_out: Absolute minimum output required
- max_slippage_bps: Maximum acceptable price deviation
Fees
Each swap incurs fees that are split between:
- Liquidity providers (LP fee)
- Host platform (if applicable)
- Flashnet protocol
Authentication
Requires a valid JWT bearer token. The token’s public key must match the user_public_key in the request.
Arguments
user_public_key- Public key of the swapperpool_id- LP public key of the poolasset_in_address- Asset being providedasset_out_address- Asset being receivedamount_in- Amount to swapmin_amount_out- Minimum acceptable outputmax_slippage_bps- Optional slippage toleranceasset_in_spark_transfer_id- Transfer proofnonce- Unique value for replay protectionsignature- Request signature
Returns
200 OKwith swap details if successful400 Bad Requestif validation fails or insufficient liquidity401 Unauthorizedif authentication fails500 Internal Server Errorif swap execution fails
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
Swap execution details including assets, amounts, and authentication
Request body for executing a swap on an AMM pool.
Swaps allow users to exchange one asset for another through a liquidity pool. The swap is executed atomically and the result is returned immediately.
Response
Swap executed successfully
Clean response for a successfully executed swap operation