Create a "swap" transaction

post https://api.valha.xyz/v0/{chain}/tokens/swap

BETA FEATURE - Please contact team to be whitelisted.

Create transaction objects to interact with an EVM blockchain for a specified user.

Path Params

chain

string

required

Defaults to optimism

The blockchain that will be used for this request.

Body Params

BETA FEATURE - Please contact team to be whitelisted.

This endpoint creates a swap on the protocol you selected to execute the exchange between the tokens you chose.

user

string

required

Defaults to 0x45E954acf1Efc374478dF69B45f12AEFD8AE51a3

from_token

string

required

Defaults to 0x7f5c764cbc14f9669b88837ca1490cca17c31607

to_token

string

required

Defaults to 0x94b008aa00579c1307b0ef2c499ad98a8ce58e58

amount

number

Defaults to 20

slippage

number

The maximum acceptable slippage that will be accepted to perform the swap (0.02 for 2%). If no value for this optional parameter is provided in the API request, the default slippage percentage is 2%.

protocol

string

required

Defaults to 1inch/v5

disable_check

boolean

Defaults to true

If selected to true, the API will not check if the provided user's address has enought token to perform the action.

maximum_approval

boolean

Defaults to false

If selected to true, the API will put the maximum amount for the approval action.

referrer

string

Referrer string that will be used on the DEX aggregators API.

Responses

`approveTx` might be `null` if there is no need for an approval.

Language

Credentials

Bearer

JWT


xxxxxxxxxx
15
1
curl --request POST \
2
     --url https://api.valha.xyz/v0/optimism/tokens/swap \
3
     --header 'accept: application/json' \
4
     --header 'content-type: application/json' \
5
     --data '
6
{
7
  "user": "0x45E954acf1Efc374478dF69B45f12AEFD8AE51a3",
8
  "from_token": "0x7f5c764cbc14f9669b88837ca1490cca17c31607",
9
  "to_token": "0x94b008aa00579c1307b0ef2c499ad98a8ce58e58",
10
  "amount": 20,
11
  "protocol": "1inch/v5",
12
  "disable_check": true,
13
  "maximum_approval": false
14
}
15
'

Click Try It! to start a request and see the response here! Or choose an example:

application/json

200approveTx might be null if there is no need for an approval.

400

`approveTx` might be `null` if there is no need for an approval.