Skip to main content
POST
/
v2
/
route
/
transactions
Returns pre-built transactions for the given route. It is assumed that transactions will be signed and sent by the sender via wallet
curl --request POST \
  --url https://backend.swap.coffee/v2/route/transactions \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <api-key>' \
  --data '
{
  "sender_address": "UQCNTO0Nh0Z7QNyRW1BLWfk08f2dAOw4izrx9sO6OUPg4DoV",
  "paths": [
    {
      "blockchain": "ton",
      "dex": "stonfi",
      "pool_address": "<string>",
      "input_token": {
        "address": {
          "blockchain": "ton",
          "address": "native"
        },
        "metadata": {
          "name": "ARBUZ",
          "symbol": "ARBUZ",
          "decimals": 123,
          "listed": true,
          "verification": "whitelisted",
          "image_url": "<string>"
        }
      },
      "output_token": {
        "address": {
          "blockchain": "ton",
          "address": "native"
        },
        "metadata": {
          "name": "ARBUZ",
          "symbol": "ARBUZ",
          "decimals": 123,
          "listed": true,
          "verification": "whitelisted",
          "image_url": "<string>"
        }
      },
      "swap": {
        "result": "fully_fulfilled",
        "input_amount": 123,
        "output_amount": 123,
        "before_reserves": [
          123
        ],
        "after_reserves": [
          123
        ],
        "reason": "<string>",
        "left_amount": 123
      },
      "recommended_gas": 123,
      "average_gas": 123,
      "next": "<array>"
    }
  ],
  "slippage": 0.05,
  "dynamic_slippage": true,
  "referral_name": "tonkeeper",
  "custom_fee": {
    "fixed_fee": "<string>",
    "percentage_fee": 123,
    "min_percentage_fee_fixed": "<string>",
    "max_percentage_fee_fixed": "<string>"
  },
  "mev_protection": true
}
'
{
  "route_id": 123,
  "transactions": [
    {
      "address": "EQCM3B12QK1e4yZSf8GtBRT0aLMNyEsBc_DhVfRRtOEffLez",
      "value": "<string>",
      "cell": "aSDinaTvuI8gbWludGxpZnk=",
      "send_mode": 123,
      "query_id": 123,
      "stateInit": "aSDinaTvuI8gbWludGxpZnk="
    }
  ]
}

Authorizations

​
X-Api-Key
string
header
required

Body

application/json
​
sender_address
string
required
Example:

"UQCNTO0Nh0Z7QNyRW1BLWfk08f2dAOw4izrx9sO6OUPg4DoV"

​
paths
object[]
required

Value of this field is a response from route building endpoint

​
slippage
number<double>

If the slippage is exceeded, the transaction will not be executed and intermediate tokens will be returned to the sender.

Required range: 0 <= x <= 1
Example:

0.05

​
dynamic_slippage
boolean
default:false

If set to true, slippage will be calculated dynamically.

Example:

true

​
referral_name
string

May be set whilst building transactions from B2B partnership products

Example:

"tonkeeper"

​
custom_fee
object

If present, additional transaction for fees collection will be generated. Because of that, be careful with max_splits to not exceed wallet contract limits

​
mev_protection
boolean

Whether a MEV protection should be enabled

Example:

true

Response

transactions for the route

​
route_id
integer
required

Unique identifier of the route used for tracking.

​
transactions
object[]
required