POST
/
v2
/
route
/
transactions
curl --request POST \
  --url https://backend.swap.coffee/v2/route/transactions \
  --header 'Content-Type: application/json' \
  --data '{
  "sender_address": "UQCNTO0Nh0Z7QNyRW1BLWfk08f2dAOw4izrx9sO6OUPg4DoV",
  "slippage": 0.05,
  "referral_name": "tonkeeper",
  "custom_fee": {
    "fixed_fee": "<string>",
    "percentage_fee": 123,
    "min_percentage_fee_fixed": "<string>",
    "max_percentage_fee_fixed": "<string>"
  },
  "paths": [
    {
      "blockchain": "ton",
      "dex": "stonfi",
      "pool_address": "<string>",
      "input_token": {
        "address": {
          "blockchain": "ton",
          "address": "native"
        },
        "metadata": {
          "name": "ARBUZ",
          "symbol": "ARBUZ",
          "decimals": 123,
          "image_url": "<string>",
          "listed": true
        }
      },
      "output_token": {
        "address": {
          "blockchain": "ton",
          "address": "native"
        },
        "metadata": {
          "name": "ARBUZ",
          "symbol": "ARBUZ",
          "decimals": 123,
          "image_url": "<string>",
          "listed": true
        }
      },
      "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": [
        {}
      ]
    }
  ]
}'
{
  "route_id": 123,
  "transactions": [
    {
      "address": "EQCM3B12QK1e4yZSf8GtBRT0aLMNyEsBc_DhVfRRtOEffLez",
      "value": "<string>",
      "send_mode": 123,
      "query_id": 123
    }
  ]
}

Authorizations

​
X-Api-Key
string
header
required

Body

application/json
​
sender_address
string
required
​
slippage
number
required

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
​
paths
object[]
required

Value of this field is a response from route building endpoint

​
referral_name
string

May be set whilst building transactions from B2B partnership products

​
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

Response

200
application/json
transactions for the route
​
route_id
integer
required

Unique identifier of the route used for tracking.

​
transactions
object[]
required
Returns the best route for the given trade pairReturns pre-built transaction for the given unstake request. It is assumed that transaction will be signed and sent by the sender via wallet