---
title: "POST /v2/route/start"
method: POST
path: "/v2/route/start"
tags: ["Routes"]
---

# POST /v2/route/start

`POST /v2/route/start`

Function that takes in a route and starts the selected route.
  Function is responsible for
  - Saving the selected route to bridge tokens from one chain to another.
  - Saving the fromChain, toChain, and fromAsssetAddress and toAssetAddress
  - Returns the Active Route Id, Current Tx, Total number of txs, txType

## Headers

- `API-KEY` string

## Request body

- StartActiveRouteInputDTO
  - `fromChainId` 'ETHEREUM' | 'OPTIMISM' | 'BSC' | 'XDAI' | 'POLYGON' | 'FANTOM' | 'ARBITRUM' | 'AVALANCHE', required — Chain id of source chain.
  - `toChainId` 'ETHEREUM' | 'OPTIMISM' | 'BSC' | 'XDAI' | 'POLYGON' | 'FANTOM' | 'ARBITRUM' | 'AVALANCHE', required — Chain id of destination chain.
  - `fromAssetAddress` string, required — Token address on source chain.
  - `toAssetAddress` string, required — Token address on destination chain.
  - `includeFirstTxDetails` boolean — Include the tx details for the first user transaction. If true it will return the txData txType etc. If false, it will only return the active route Id of the selected route.
  - `route` Route, required
    - `routeId` string, required — Unique id for each route.
    - `fromAmount` string, required — Sending token amount.
    - `chainGasBalances` ChainGasBalances, required
    - `toAmount` string, required — Approximate receiving token amount.
    - `usedBridgeNames` string[], required — Array of bridges used in the route
    - `totalUserTx` number, required — Total number of transactions for the route.
    - `totalGasFeesInUsd` number, required — Combined USD gas fees for all transactions in the route.
    - `sender` string, required — Address of user making the transactions.
    - `userTxs` object[], required — Array of user transactions.
    - `serviceTime` number, required — Estimate of total time in seconds, excluding the transaction time.

## Response `200`

Starts the Active Route and gives back the data to start the route

- StartActiveRouteResponseDTO
  - `userTxType` 'approve' | 'fund-movr' | 'claim' | 'dex-swap' | 'sign'
  - `txTarget` string
  - `chainId` 'ETHEREUM' | 'OPTIMISM' | 'BSC' | 'XDAI' | 'POLYGON' | 'FANTOM' | 'ARBITRUM' | 'AVALANCHE'
  - `activeRouteId` number, required
  - `txData` string
  - `txType` 'eth_sendTransaction' | 'eth_signMessage'
  - `value` string
  - `userTxIndex` number
  - `totalUserTx` number, required
  - `approvalData` ApprovalData
    - `minimumApprovalAmount` string, required — Minimum amount of approval needed.
    - `approvalTokenAddress` string, required — Address of token for which approval is required.
    - `allowanceTarget` string, required — Contract address that needs approval.
    - `owner` string, required — Address of owner.

## Other responses

- `201`

---

[API](https://skmtc.net/swaprhq/apis/movr-aggregator-api.md) · [All operations](https://skmtc.net/swaprhq/apis/movr-aggregator-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/swaprhq/movr-aggregator-api/revisions/8b1957cc0e8f/schema)