This endpoint allows registered integrators (e.g. trading front-ends, wallets, or analytics platforms) to withdraw the share of swap fees they have accrued from trades routed through their integration. The withdrawal itself is processed asynchronously by the TEE-secured settlement service.

Fee Accumulation

Integrators earn a portion of the integrator fee configured on each swap:

• Fees accrue per pool and per asset.
• The percentage share for an integrator is defined when the swap is submitted (via integratorFeeRateBps and the associated fee-split vector).
• Accumulated fees can be withdrawn at any time; there is no minimum interval.

Withdrawal Process

1. The integrator specifies the target pool and (optionally) explicit withdrawal amounts.
2. The AMM Gateway validates the request, JWT, signature and nonce.
3. The request is forwarded to the settlement service, which executes the payment on Spark and returns a status object.
4. Funds are transferred to the integrator’s fee-recipient wallet.

Partial Withdrawals

• If assetAAmount / assetBAmount are provided, only those amounts will be withdrawn.
• If they are omitted, all available fees for each asset will be withdrawn.
• This lets integrators drip-feed or batch their withdrawals as they see fit.

Authentication

Requires a valid JWT bearer token. The token’s public key must be the same key that signs the request payload.

Request Body

• lpIdentityPublicKey – LP public key of the pool to withdraw from.
• assetAAmount – Optional amount of asset A fees to withdraw.
• assetBAmount – Optional amount of asset B fees to withdraw.
• nonce – Unique value for replay protection.
• signature – Signature over the canonical JSON payload.

Response

Returns a request ID for tracking the asynchronous withdrawal. Transfer IDs for each asset are included once the settlement service accepts the request.

Arguments

• lp_identity_public_key – Pool identifier (LP public key).
• asset_a_amount – Optional amount of asset A fees to withdraw.
• asset_b_amount – Optional amount of asset B fees to withdraw.
• nonce – Unique nonce for replay protection.
• signature – Request signature.

Returns

• 200 OK when the withdrawal request is accepted.
• 400 Bad Request if validation fails.
• 401 Unauthorized if authentication fails.
• 404 Not Found if the pool is unknown.
• 500 Internal Server Error if the settlement service errors.