Withdraw Integrator Fees

curl --request POST \
  --url https://api.amm.flashnet.xyz/v1/integrators/withdraw-fees \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "assetBAmount": 500000,
  "lpIdentityPublicKey": "03abcdef0123456789abcdef0123456789abcdef0123456789abcdef01234567",
  "nonce": "550e8400-e29b-41d4-a716-446655440000",
  "signature": "3045022100a7e5d4f8b2c9a1e6f0d5b8c4a9e7f2d1c8b5a4e9f0d6c5b3a2e1d0c9b8a7f02201f2e3d4c5b6a7980e9f0a1b2c3d4e5f67889a0b1c2d3e4f5a6b7c8d9e0f1a2b3"
}
'

{
  "accepted": true,
  "assetBWithdrawn": 500000,
  "requestId": "550e8400-e29b-41d4-a716-446655441111",
  "transferId": "spark-transfer-asset-b-uuid"
}

Integrators

Withdraw Integrator Fees

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

The integrator specifies the target pool and (optionally) explicit withdrawal amounts.
The AMM Gateway validates the request, JWT, signature and nonce.
The request is forwarded to the settlement service, which executes the payment on Spark and returns a status object.
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_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.

POST

integrators

withdraw-fees

Withdraw Integrator Fees

curl --request POST \
  --url https://api.amm.flashnet.xyz/v1/integrators/withdraw-fees \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "assetBAmount": 500000,
  "lpIdentityPublicKey": "03abcdef0123456789abcdef0123456789abcdef0123456789abcdef01234567",
  "nonce": "550e8400-e29b-41d4-a716-446655440000",
  "signature": "3045022100a7e5d4f8b2c9a1e6f0d5b8c4a9e7f2d1c8b5a4e9f0d6c5b3a2e1d0c9b8a7f02201f2e3d4c5b6a7980e9f0a1b2c3d4e5f67889a0b1c2d3e4f5a6b7c8d9e0f1a2b3"
}
'

{
  "accepted": true,
  "assetBWithdrawn": 500000,
  "requestId": "550e8400-e29b-41d4-a716-446655441111",
  "transferId": "spark-transfer-asset-b-uuid"
}

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Integrator fee withdrawal request details including pool ID, optional amounts, and authentication.

Request payload for withdrawing integrator fees from an AMM pool.

lpIdentityPublicKey

string

required

Identity public key of the LP wallet (pool ID).

Example:

"03abcdef0123456789abcdef0123456789abcdef0123456789abcdef01234567"

nonce

string

required

Nonce used for signature replay-protection.

Example:

"550e8400-e29b-41d4-a716-446655440000"

signature

string

required

ECDSA signature of the vectorized JSON payload including all the other fields in this request.

Example:

"3045022100..."

assetBAmount

integer | null

Amount of asset B fees to withdraw in the smallest unit. Set to 0 to withdraw all available fees.

Required range: x >= 0

Example:

500000

Response

Integrator fee withdrawal initiated successfully

Response for host fee withdrawal

requestId

string

required

Request ID for tracking

Example:

"01HJZKFABCDEFGHJKLMNPQRSTVW"

accepted

boolean

required

Whether withdrawal was initiated

Example:

true

flashnetRequestId

string | null

Settlement service request ID for correlation

Example:

"018D5E56-9D80-7890-A1B2-C3D4E5F6G7H8"

assetBWithdrawn

integer | null

Asset B amount withdrawn

Required range: x >= 0

Example:

"500000"

transferId

string | null

Spark transfer ID for withdrawal

error

string | null

Error message if rejected

Get Integrator Fee Withdrawal History

Add liquidity

⌘I

Auth

Clawback

Hosts

Integrators

Liquidity

Status

Pools

Swaps

Withdraw Integrator Fees

Fee Accumulation

Withdrawal Process

Partial Withdrawals

Authentication

Request Body

Response

Arguments

Returns

Authorizations

Body

Response