Swing Points Program is Live 🚀 Learn More →

Send (Transfer)

post
/v0/transfer/send

Get a transfer transaction for the route selected from the getQuote endpoint.

tokenSymbol
string
required
toTokenSymbol
string
required
tokenAmount
string
required

Amount in minimal divisible unit (wei)

fromChain
string
required
Example:
ethereum
fromTokenAddress
string
required

Token address on source chain

fromUserAddress
string
required

User's wallet on source chain.

toChain
string
required
Example:
ethereum
toTokenAmount
string

Destination token amount for contract call

route
array[Route]
required

Best route returned by Swing /quote endpoint

bridge
required
bridgeTokenAddress
string
required
Example:
0x1111111254fb6c44bac0bed2854e76f90643097d
steps
array[string]
required

The status of the current transfer step. It should be in one of these values: allowance' | 'approve' | 'send' | 'nativeStaking' | 'bridge' | 'sign' | 'claim';

Allowed values:
allowanceapprovesendnativeStakingsignclaimbridge
name
string
required
part
number
required
Example:
100
encryptionKeyRequired
boolean
Example:
false
toTokenAddress
string
required

Token address on the destination chain.

toUserAddress
string
required

User's wallet address on the destination chain.

fromTokenAccountAddress
string

Solana specific token account address (required if transfer is from Solana to EVM chains)

toTokenAccountAddress
string

Solana specific token account address (required if transfer is from EVM chains to Solana)

maxSlippage
number

An optional percentage value passed as a decimal between 0 and 1. (i.e 0.02 = 2%). Defaults between 0.5% and 1% based on chain and token. Your transaction will revert if the price changes unfavorably by more than this percentage.

Example:
0.01
encryptionPublicKey
string

Nxtp requires encryptionPublicKey to encrypt callData.

partner
string

partner company contract address

projectId
string

Project Identifier. Optional. Will return project-specific configuration

Example:
41122b12-7aad-4c54-9e2f-a67627ac0787
includeDEXS
string

Advanced option to specify exact DEXes to utilize in the quote. This will impact prices and quote availability. If the DEX key is invalid, it will revert to default behaviour. Each dex-aggregator is '|' seperated and then followed by a comma separated list of DEX names for each aggregator. See example: paraswap:Aerodrome|openocean:12

Example:
paraswap:Aerodrome|openocean:12
contractCallInfo
ContractCallInfo

Parameters for contract call

toContractAddress
string
required

The address of the contract to interact with.

toContractCallData
string
required

The callData to be sent to the contract for the interaction on the destination chain.

toContractGasLimit
string

The estimated gas used by the destination call. If this value is incorrect, the interaction may fail -- choose this carefully!

outputTokenAddress
string

Some contract interactions will output a token (e.g. staking), specify the token address to forward the token to the user. Omit this parameter if no token should be returned to the user.

toApprovalAddress
string

If the approval address is different thant the contract to call, specify that address here.

fee
number

Optionally set the percentage of fee charged by partners per each transaction in Basis Points (BPS) units. This will override the default fee rate configured via platform. 1 BPS = 0.01%. The maximum value is 1000 (which equals 10%). The minimum value is 1 (which equals 0.01%).

affiliateId
string

Affiliate ID for tracking purposes. Optional.

skipValidation
string

Setting to any truthy-value will skip transaction validations on-chain. By default, we check for transactions that will fail on-chain execution (ex. not enough allowance or in-sufficent funds) and return an error.

nativeStaking
boolean
Body
preparing...