Skip to main content

Commission Swap Webhook Payload - Swap API

Specification of webhook for commission swaps.

Updated on
Aug 09, 2026
Please note that this method is only available for paid subscribers on the Navigator plan of Swap API.

Parameters

event_type
string
REQUIRED

The type of event we have detected. Must be swap_tokens for this webhook.

body
object
REQUIRED

The details for this event

tx
string
REQUIRED

The transaction as an unsigned encoded string.

tx_type
string
REQUIRED

The type of transaction we are sending you. Must be one of versioned_transaction or transaction.

amount_in
integer
REQUIRED

The amount of the token you were paid in commission we are going to swap.

quote
object
REQUIRED

The quote we used to generate this swap.

inputMint
string
REQUIRED

The source token's mint address

inAmount
string
REQUIRED

The amount of the source token being swapped

outputMint
string
REQUIRED

The destination token's mint address

outAmount
string
REQUIRED

The amount of the destination token received after the swap

otherAmountThreshold
string
REQUIRED

A threshold amount for the destination token

swapMode
string
REQUIRED

Indicates the swap mode

slippageBps
integer
REQUIRED

Slippage tolerance in basis points

platformFee
object
REQUIRED

The platform Fee object which contains the following fields:

amount
string
REQUIRED

The amount of the platform fee

feeBps
integer
REQUIRED

The fee percentage in basis points

priceImpactPct
string
REQUIRED

The percentage of price impact due to the swap

routePlan
array
REQUIRED

An array containing detailed information about each step of the swap process

swapInfo
object
REQUIRED

Detailed information about a specific swap step

ammKey
string
REQUIRED

The key identifying the Automated Market Maker (AMM) responsible for the swap

label
string
REQUIRED

A label or identifier for the AMM

inputMint
string
REQUIRED

The mint address of the token being swapped from in this step

outputMint
string
REQUIRED

The mint address of the token being received in this step

inAmount
string
REQUIRED

The amount of the token being swapped from in this step

outAmount
string
REQUIRED

The amount of the token being received after the swap in this step

feeAmount
string
REQUIRED

The amount of fee charged for this step of the swap

feeMint
string
REQUIRED

The mint address of the token used for paying fees in this step

percent
integer
REQUIRED

The percentage allocation of the swap for this step

contextSlot
integer
REQUIRED

A contextual identifier

wallet_pubkey
string
REQUIRED

The wallet pubkey we used to generate the unsigned transaction here.

Returns

This method returns nothing
Request
Don't have an account yet?
Create your Quicknode endpoint in seconds and start building
Get started for free