---
title: "Retrieves swap transaction plan"
method: POST
path: "/public/{address}/swap"
tags: ["Swap endpoints"]
---

# Retrieves swap transaction plan

`POST /public/{address}/swap`

Retrieves a swap transaction plan containing the required transactions that must be signed by the wallet to complete the swap. The wallet must sign each transaction in the order it is returned in the response. For example, the list of transactions may include a first a token approval transaction, and then a swap transaction.

## Path parameters

- `address` string, required

## Query parameters

- `fromChain` string
- `fromToken` string
- `fromTokenAmount` string
- `fromTokenAmountUsd` string
- `toChain` string
- `toToken` string
- `toWalletAddress` string

## Request body

- SwapRouteQuote
  - `duration` number
  - `gas` string
  - `quote` SwapQuote
    - `integration` string
    - `type` string
    - `bridgeFee` string
    - `bridgeFeeInNativeToken` string
    - `amount` string
    - `decimals` number
    - `amountUSD` string
    - `bridgeFeeUSD` string
    - `bridgeFeeInNativeTokenUSD` string
    - `priceImpact` string
  - `route` SwapRoute[]
    - `bridge` string
  - `gasUsd` string

## Response `200`

A list of transactions that must be signed to complete the swap.

- SwapPlannedTx[]
  - `id` string
  - `type` string
  - `transaction` object
    - `chainId` number
    - `to` string
    - `data` string
    - `value` string
    - `gasLimit` string

## Other responses

- `400` — Bad swap request

---

[API](https://skmtc.net/unstoppabledomains/apis/profile-api.md) · [All operations](https://skmtc.net/unstoppabledomains/apis/profile-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/unstoppabledomains/profile-api/revisions/10f8400cb1c1/schema)