POST
/
v1
/
advanced
/
stepTransaction
Populate a step with transaction data
curl --request POST \
  --url https://li.quest/v1/advanced/stepTransaction \
  --header 'Content-Type: application/json' \
  --data '{
  "id": "a8dc011a-f52d-4492-9e99-21de64b5453a",
  "type": "lifi",
  "tool": "1inch",
  "toolDetails": {
    "key": "1inch",
    "logoURI": "https://raw.githubusercontent.com/lifinance/types/main/src/assets/icons/exchanges/oneinch.svg",
    "name": "1inch"
  },
  "action": {
    "fromChainId": 100,
    "toChainId": 100,
    "fromToken": {
      "address": "0x0000000000000000000000000000000000000000",
      "symbol": "xDai",
      "decimals": 18,
      "chainId": 100,
      "name": "xDai",
      "coinKey": "xDai",
      "priceUSD": "1",
      "logoURI": "https://static.debank.com/image/xdai_token/logo_url/xdai/1207e67652b691ef3bfe04f89f4b5362.png"
    },
    "toToken": {
      "name": "Minerva Wallet SuperToken",
      "symbol": "MIVA",
      "coinKey": "MIVA",
      "decimals": 18,
      "chainId": 100,
      "priceUSD": "1",
      "logoURI": "https://minerva.digital/i/MIVA-Token_200x200.png",
      "address": "0x63e62989d9eb2d37dfdb1f93a22f063635b07d51"
    },
    "fromAmount": "1000000000000000000",
    "slippage": 0.003,
    "fromAddress": "0x552008c0f6870c2f77e5cC1d2eb9bdff03e30Ea0",
    "toAddress": "0x552008c0f6870c2f77e5cC1d2eb9bdff03e30Ea0"
  },
  "estimate": {
    "fromAmount": "1000000000000000000",
    "toAmount": "21922914496086353975",
    "toAmountMin": "21265227061203763356",
    "tool": "1inch",
    "executionDuration": 30,
    "approvalAddress": "0x1111111254fb6c44bac0bed2854e76f90643097d",
    "feeCosts": [],
    "gasCosts": [
      {
        "type": "SEND",
        "price": "1",
        "estimate": "252364",
        "limit": "315455",
        "amount": "252364",
        "amountUSD": "0.00",
        "token": {
          "address": "0x0000000000000000000000000000000000000000",
          "symbol": "xDai",
          "decimals": 18,
          "chainId": 100,
          "name": "xDai",
          "coinKey": "xDai",
          "priceUSD": "1",
          "logoURI": "https://static.debank.com/image/xdai_token/logo_url/xdai/1207e67652b691ef3bfe04f89f4b5362.png"
        }
      }
    ]
  },
  "integrator": "fee-demo",
  "includedSteps": [
    {
      "id": "a8dc011a-f52d-4492-9e99-21de64b5453a",
      "type": "swap",
      "tool": "1inch",
      "toolDetails": {
        "key": "1inch",
        "logoURI": "https://raw.githubusercontent.com/lifinance/types/main/src/assets/icons/exchanges/oneinch.svg",
        "name": "1inch"
      },
      "action": {
        "fromChainId": 100,
        "toChainId": 100,
        "fromToken": {
          "address": "0x0000000000000000000000000000000000000000",
          "symbol": "xDai",
          "decimals": 18,
          "chainId": 100,
          "name": "xDai",
          "coinKey": "xDai",
          "priceUSD": "1",
          "logoURI": "https://static.debank.com/image/xdai_token/logo_url/xdai/1207e67652b691ef3bfe04f89f4b5362.png"
        },
        "toToken": {
          "name": "Minerva Wallet SuperToken",
          "symbol": "MIVA",
          "coinKey": "MIVA",
          "decimals": 18,
          "chainId": 100,
          "priceUSD": "1",
          "logoURI": "https://minerva.digital/i/MIVA-Token_200x200.png",
          "address": "0x63e62989d9eb2d37dfdb1f93a22f063635b07d51"
        },
        "fromAmount": "1000000000000000000",
        "slippage": 0.003,
        "fromAddress": "0x552008c0f6870c2f77e5cC1d2eb9bdff03e30Ea0",
        "toAddress": "0x552008c0f6870c2f77e5cC1d2eb9bdff03e30Ea0"
      },
      "estimate": {
        "fromAmount": "1000000000000000000",
        "toAmount": "21922914496086353975",
        "toAmountMin": "21265227061203763356",
        "tool": "1inch",
        "executionDuration": 30,
        "approvalAddress": "0x1111111254fb6c44bac0bed2854e76f90643097d",
        "feeCosts": [],
        "gasCosts": [
          {
            "type": "SEND",
            "price": "1",
            "estimate": "252364",
            "limit": "315455",
            "amount": "252364",
            "amountUSD": "0.00",
            "token": {
              "address": "0x0000000000000000000000000000000000000000",
              "symbol": "xDai",
              "decimals": 18,
              "chainId": 100,
              "name": "xDai",
              "coinKey": "xDai",
              "priceUSD": "1",
              "logoURI": "https://static.debank.com/image/xdai_token/logo_url/xdai/1207e67652b691ef3bfe04f89f4b5362.png"
            }
          }
        ]
      }
    }
  ]
}'
{
  "id": "a8dc011a-f52d-4492-9e99-21de64b5453a",
  "type": "lifi",
  "tool": "1inch",
  "toolDetails": {
    "key": "1inch",
    "logoURI": "https://raw.githubusercontent.com/lifinance/types/main/src/assets/icons/exchanges/oneinch.svg",
    "name": "1inch"
  },
  "action": {
    "fromChainId": 100,
    "toChainId": 100,
    "fromToken": {
      "address": "0x0000000000000000000000000000000000000000",
      "symbol": "xDai",
      "decimals": 18,
      "chainId": 100,
      "name": "xDai",
      "coinKey": "xDai",
      "priceUSD": "1",
      "logoURI": "https://static.debank.com/image/xdai_token/logo_url/xdai/1207e67652b691ef3bfe04f89f4b5362.png"
    },
    "toToken": {
      "name": "Minerva Wallet SuperToken",
      "symbol": "MIVA",
      "coinKey": "MIVA",
      "decimals": 18,
      "chainId": 100,
      "logoURI": "https://minerva.digital/i/MIVA-Token_200x200.png",
      "address": "0x63e62989d9eb2d37dfdb1f93a22f063635b07d51"
    },
    "fromAmount": "1000000000000000000",
    "slippage": 0.003,
    "fromAddress": "0x552008c0f6870c2f77e5cC1d2eb9bdff03e30Ea0",
    "toAddress": "0x552008c0f6870c2f77e5cC1d2eb9bdff03e30Ea0"
  },
  "estimate": {
    "fromAmount": "1000000000000000000",
    "toAmount": "21922914496086353975",
    "toAmountMin": "21265227061203763356",
    "approvalAddress": "0x1111111254fb6c44bac0bed2854e76f90643097d",
    "feeCosts": [],
    "gasCosts": [
      {
        "type": "SEND",
        "price": "1",
        "estimate": "252364",
        "limit": "315455",
        "amount": "252364",
        "amountUSD": "0.00",
        "token": {
          "address": "0x0000000000000000000000000000000000000000",
          "symbol": "xDai",
          "decimals": 18,
          "chainId": 100,
          "name": "xDai",
          "coinKey": "xDai",
          "priceUSD": "1",
          "logoURI": "https://static.debank.com/image/xdai_token/logo_url/xdai/1207e67652b691ef3bfe04f89f4b5362.png"
        }
      }
    ],
    "data": {
      "fromToken": {
        "name": "xDAI",
        "address": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
        "symbol": "xDAI",
        "decimals": 18,
        "logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0x6B175474E89094C44Da98b954EedeAC495271d0F/logo.png"
      },
      "toToken": {
        "name": "Minerva Wallet SuperToken",
        "address": "0x63e62989d9eb2d37dfdb1f93a22f063635b07d51",
        "symbol": "MIVA",
        "decimals": 18,
        "logoURI": "https://minerva.digital/i/MIVA-Token_200x200.png"
      },
      "toTokenAmount": "21922914496086353975",
      "fromTokenAmount": "1000000000000000000",
      "protocols": [
        [
          [
            {
              "name": "GNOSIS_HONEYSWAP",
              "part": 100,
              "fromTokenAddress": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
              "toTokenAddress": "0x63e62989d9eb2d37dfdb1f93a22f063635b07d51"
            }
          ]
        ]
      ],
      "estimatedGas": 252364
    }
  },
  "integrator": "fee-demo",
  "transactionRequest": {
    "from": "0x552008c0f6870c2f77e5cC1d2eb9bdff03e30Ea0",
    "to": "0x1111111254fb6c44bac0bed2854e76f90643097d",
    "chainId": 100,
    "data": "0x...",
    "value": "0x0de0b6b3a7640000",
    "gasPrice": "0xb2d05e00",
    "gasLimit": "0x0e9cb2"
  },
  "includedSteps": [
    {
      "id": "a8dc011a-f52d-4492-9e99-21de64b5453a",
      "type": "swap",
      "tool": "1inch",
      "toolDetails": {
        "key": "1inch",
        "logoURI": "https://raw.githubusercontent.com/lifinance/types/main/src/assets/icons/exchanges/oneinch.svg",
        "name": "1inch"
      },
      "action": {
        "fromChainId": 100,
        "toChainId": 100,
        "fromToken": {
          "address": "0x0000000000000000000000000000000000000000",
          "symbol": "xDai",
          "decimals": 18,
          "chainId": 100,
          "name": "xDai",
          "coinKey": "xDai",
          "priceUSD": "1",
          "logoURI": "https://static.debank.com/image/xdai_token/logo_url/xdai/1207e67652b691ef3bfe04f89f4b5362.png"
        },
        "toToken": {
          "name": "Minerva Wallet SuperToken",
          "symbol": "MIVA",
          "coinKey": "MIVA",
          "decimals": 18,
          "chainId": 100,
          "logoURI": "https://minerva.digital/i/MIVA-Token_200x200.png",
          "address": "0x63e62989d9eb2d37dfdb1f93a22f063635b07d51"
        },
        "fromAmount": "1000000000000000000",
        "slippage": 0.003,
        "fromAddress": "0x552008c0f6870c2f77e5cC1d2eb9bdff03e30Ea0",
        "toAddress": "0x552008c0f6870c2f77e5cC1d2eb9bdff03e30Ea0"
      },
      "estimate": {
        "fromAmount": "1000000000000000000",
        "toAmount": "21922914496086353975",
        "toAmountMin": "21265227061203763356",
        "approvalAddress": "0x1111111254fb6c44bac0bed2854e76f90643097d",
        "feeCosts": [],
        "gasCosts": [
          {
            "type": "SEND",
            "price": "1",
            "estimate": "252364",
            "limit": "315455",
            "amount": "252364",
            "amountUSD": "0.00",
            "token": {
              "address": "0x0000000000000000000000000000000000000000",
              "symbol": "xDai",
              "decimals": 18,
              "chainId": 100,
              "name": "xDai",
              "coinKey": "xDai",
              "priceUSD": "1",
              "logoURI": "https://static.debank.com/image/xdai_token/logo_url/xdai/1207e67652b691ef3bfe04f89f4b5362.png"
            }
          }
        ],
        "data": {
          "fromToken": {
            "name": "xDAI",
            "address": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
            "symbol": "xDAI",
            "decimals": 18,
            "logoURI": "https://raw.githubusercontent.com/trustwallet/assets/master/blockchains/ethereum/assets/0x6B175474E89094C44Da98b954EedeAC495271d0F/logo.png"
          },
          "toToken": {
            "name": "Minerva Wallet SuperToken",
            "address": "0x63e62989d9eb2d37dfdb1f93a22f063635b07d51",
            "symbol": "MIVA",
            "decimals": 18,
            "logoURI": "https://minerva.digital/i/MIVA-Token_200x200.png"
          },
          "toTokenAmount": "21922914496086353975",
          "fromTokenAmount": "1000000000000000000",
          "protocols": [
            [
              [
                {
                  "name": "GNOSIS_HONEYSWAP",
                  "part": 100,
                  "fromTokenAddress": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee",
                  "toTokenAddress": "0x63e62989d9eb2d37dfdb1f93a22f063635b07d51"
                }
              ]
            ]
          ],
          "estimatedGas": 252364
        }
      }
    }
  ]
}

Headers

​
x-lifi-api-key
string

Authentication header, contact support if you want to get registered.

Query Parameters

​
skipSimulation
boolean

Parameter to skip transaction simulation. The quote will be returned faster but the transaction gas limit won't be accurate.

Body

application/json

The step object

Object that represents one step of a Route

​
id
string
required

Unique identifier of the step

​
type
enum<string>
required

The type of the step

Available options:
swap,
cross,
lifi
​
tool
string
required

The tool used for this step. E.g. relay

​
action
object
required

The action of the step

Example:
{
  "fromChainId": 100,
  "fromAmount": "1000000000000000000",
  "fromToken": {
    "address": "0x63e62989d9eb2d37dfdb1f93a22f063635b07d51",
    "symbol": "MIVA",
    "decimals": 18,
    "chainId": 100,
    "name": "Minerva Wallet SuperToken",
    "coinKey": "MIVA",
    "priceUSD": "0.0455272371751059",
    "logoURI": ""
  },
  "toChainId": 137,
  "toToken": {
    "address": "0xc0b2983a17573660053beeed6fdb1053107cf387",
    "symbol": "MIVA",
    "decimals": 18,
    "chainId": 137,
    "name": "Minerva Wallet SuperToken",
    "coinKey": "MIVA",
    "priceUSD": "0",
    "logoURI": ""
  },
  "slippage": 0.003
}
​
toolDetails
object

The details of the tool used for this step. E.g. relay

​
estimate
object

The estimation for the step

Example:
{
  "fromAmount": "1000000000000000000",
  "toAmount": "999500000000000000",
  "toAmountMin": "999500000000000000",
  "tool": "allbridge",
  "executionDuration": 60,
  "approvalAddress": "0x115909BDcbaB21954bEb4ab65FC2aBEE9866fa93",
  "feeCosts": [
    {
      "name": "Gas Fee",
      "description": "Covers gas expense for sending funds to user on receiving chain.",
      "percentage": "0",
      "token": {
        "address": "0x63e62989d9eb2d37dfdb1f93a22f063635b07d51",
        "symbol": "MIVA",
        "decimals": 18,
        "chainId": 100,
        "name": "Minerva Wallet SuperToken",
        "coinKey": "MIVA",
        "priceUSD": "0.0455272371751059",
        "logoURI": ""
      },
      "amount": "0",
      "amountUSD": "0.00",
      "included": true
    },
    {
      "name": "Relay Fee",
      "description": "Covers gas expense for claiming user funds on receiving chain.",
      "percentage": "0",
      "token": {
        "address": "0x63e62989d9eb2d37dfdb1f93a22f063635b07d51",
        "symbol": "MIVA",
        "decimals": 18,
        "chainId": 100,
        "name": "Minerva Wallet SuperToken",
        "coinKey": "MIVA",
        "priceUSD": "0.0455272371751059",
        "logoURI": ""
      },
      "amount": "0",
      "amountUSD": "0.00",
      "included": true
    },
    {
      "name": "Router Fee",
      "description": "Router service fee.",
      "percentage": "0.0005",
      "token": {
        "address": "0x63e62989d9eb2d37dfdb1f93a22f063635b07d51",
        "symbol": "MIVA",
        "decimals": 18,
        "chainId": 100,
        "name": "Minerva Wallet SuperToken",
        "coinKey": "MIVA",
        "priceUSD": "0.0455272371751059",
        "logoURI": ""
      },
      "amount": "500000000000000",
      "amountUSD": "22763618587552.95",
      "included": true
    }
  ],
  "gasCosts": [
    {
      "type": "SEND",
      "price": "1.22",
      "estimate": "140000",
      "limit": "175000",
      "amount": "170800",
      "amountUSD": "0.00",
      "token": {
        "address": "0x0000000000000000000000000000000000000000",
        "symbol": "xDai",
        "decimals": 18,
        "chainId": 100,
        "name": "xDai",
        "coinKey": "xDai",
        "priceUSD": "1",
        "logoURI": "https://static.debank.com/image/xdai_token/logo_url/xdai/1207e67652b691ef3bfe04f89f4b5362.png"
      }
    }
  ],
  "data": {
    "bid": {
      "user": "0x10fBFF9b9450D3A2d9d1612d6dE3726fACD8809E",
      "router": "0xeE2Ef40F688607CB23618d9312d62392786d13EB",
      "initiator": "0x10fBFF9b9450D3A2d9d1612d6dE3726fACD8809E",
      "sendingChainId": 100,
      "sendingAssetId": "0x63e62989d9eb2d37dfdb1f93a22f063635b07d51",
      "amount": "1000000000000000000",
      "receivingChainId": 137,
      "receivingAssetId": "0xc0b2983a17573660053beeed6fdb1053107cf387",
      "amountReceived": "999500000000000000",
      "receivingAddress": "0x10fBFF9b9450D3A2d9d1612d6dE3726fACD8809E",
      "transactionId": "0x9f54c1764e19367c44706f4a6253941b81e9ec524af5590091aa8ae67e7644ed",
      "expiry": 1643369368,
      "callDataHash": "0xc5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470",
      "callTo": "0x0000000000000000000000000000000000000000",
      "encryptedCallData": "0x",
      "sendingChainTxManagerAddress": "0x115909BDcbaB21954bEb4ab65FC2aBEE9866fa93",
      "receivingChainTxManagerAddress": "0x6090De2EC76eb1Dc3B5d632734415c93c44Fd113",
      "bidExpiry": 1643110469
    },
    "gasFeeInReceivingToken": "0",
    "totalFee": "500000000000000",
    "metaTxRelayerFee": "0",
    "routerFee": "500000000000000"
  }
}
​
integrator
string

A string containing tracking information about the integrator of the API

​
includedSteps
Root Type for Internal Step · object[]
​
referrer
string

A string containing tracking information about the referrer of the integrator

​
execution
any

An objection containing status information about the execution

​
transactionRequest
any

An ether.js TransactionRequest that can be triggered using a wallet provider. (https://docs.ethers.io/v5/api/providers/types/#providers-TransactionRequest)

Response

The step populated with the transaction data

Object that represents one step of a Route

​
id
string
required

Unique identifier of the step

​
type
enum<string>
required

The type of the step

Available options:
swap,
cross,
lifi
​
tool
string
required

The tool used for this step. E.g. relay

​
action
object
required

The action of the step

Example:
{
  "fromChainId": 100,
  "fromAmount": "1000000000000000000",
  "fromToken": {
    "address": "0x63e62989d9eb2d37dfdb1f93a22f063635b07d51",
    "symbol": "MIVA",
    "decimals": 18,
    "chainId": 100,
    "name": "Minerva Wallet SuperToken",
    "coinKey": "MIVA",
    "priceUSD": "0.0455272371751059",
    "logoURI": ""
  },
  "toChainId": 137,
  "toToken": {
    "address": "0xc0b2983a17573660053beeed6fdb1053107cf387",
    "symbol": "MIVA",
    "decimals": 18,
    "chainId": 137,
    "name": "Minerva Wallet SuperToken",
    "coinKey": "MIVA",
    "priceUSD": "0",
    "logoURI": ""
  },
  "slippage": 0.003
}
​
toolDetails
object

The details of the tool used for this step. E.g. relay

​
estimate
object

The estimation for the step

Example:
{
  "fromAmount": "1000000000000000000",
  "toAmount": "999500000000000000",
  "toAmountMin": "999500000000000000",
  "tool": "allbridge",
  "executionDuration": 60,
  "approvalAddress": "0x115909BDcbaB21954bEb4ab65FC2aBEE9866fa93",
  "feeCosts": [
    {
      "name": "Gas Fee",
      "description": "Covers gas expense for sending funds to user on receiving chain.",
      "percentage": "0",
      "token": {
        "address": "0x63e62989d9eb2d37dfdb1f93a22f063635b07d51",
        "symbol": "MIVA",
        "decimals": 18,
        "chainId": 100,
        "name": "Minerva Wallet SuperToken",
        "coinKey": "MIVA",
        "priceUSD": "0.0455272371751059",
        "logoURI": ""
      },
      "amount": "0",
      "amountUSD": "0.00",
      "included": true
    },
    {
      "name": "Relay Fee",
      "description": "Covers gas expense for claiming user funds on receiving chain.",
      "percentage": "0",
      "token": {
        "address": "0x63e62989d9eb2d37dfdb1f93a22f063635b07d51",
        "symbol": "MIVA",
        "decimals": 18,
        "chainId": 100,
        "name": "Minerva Wallet SuperToken",
        "coinKey": "MIVA",
        "priceUSD": "0.0455272371751059",
        "logoURI": ""
      },
      "amount": "0",
      "amountUSD": "0.00",
      "included": true
    },
    {
      "name": "Router Fee",
      "description": "Router service fee.",
      "percentage": "0.0005",
      "token": {
        "address": "0x63e62989d9eb2d37dfdb1f93a22f063635b07d51",
        "symbol": "MIVA",
        "decimals": 18,
        "chainId": 100,
        "name": "Minerva Wallet SuperToken",
        "coinKey": "MIVA",
        "priceUSD": "0.0455272371751059",
        "logoURI": ""
      },
      "amount": "500000000000000",
      "amountUSD": "22763618587552.95",
      "included": true
    }
  ],
  "gasCosts": [
    {
      "type": "SEND",
      "price": "1.22",
      "estimate": "140000",
      "limit": "175000",
      "amount": "170800",
      "amountUSD": "0.00",
      "token": {
        "address": "0x0000000000000000000000000000000000000000",
        "symbol": "xDai",
        "decimals": 18,
        "chainId": 100,
        "name": "xDai",
        "coinKey": "xDai",
        "priceUSD": "1",
        "logoURI": "https://static.debank.com/image/xdai_token/logo_url/xdai/1207e67652b691ef3bfe04f89f4b5362.png"
      }
    }
  ],
  "data": {
    "bid": {
      "user": "0x10fBFF9b9450D3A2d9d1612d6dE3726fACD8809E",
      "router": "0xeE2Ef40F688607CB23618d9312d62392786d13EB",
      "initiator": "0x10fBFF9b9450D3A2d9d1612d6dE3726fACD8809E",
      "sendingChainId": 100,
      "sendingAssetId": "0x63e62989d9eb2d37dfdb1f93a22f063635b07d51",
      "amount": "1000000000000000000",
      "receivingChainId": 137,
      "receivingAssetId": "0xc0b2983a17573660053beeed6fdb1053107cf387",
      "amountReceived": "999500000000000000",
      "receivingAddress": "0x10fBFF9b9450D3A2d9d1612d6dE3726fACD8809E",
      "transactionId": "0x9f54c1764e19367c44706f4a6253941b81e9ec524af5590091aa8ae67e7644ed",
      "expiry": 1643369368,
      "callDataHash": "0xc5d2460186f7233c927e7db2dcc703c0e500b653ca82273b7bfad8045d85a470",
      "callTo": "0x0000000000000000000000000000000000000000",
      "encryptedCallData": "0x",
      "sendingChainTxManagerAddress": "0x115909BDcbaB21954bEb4ab65FC2aBEE9866fa93",
      "receivingChainTxManagerAddress": "0x6090De2EC76eb1Dc3B5d632734415c93c44Fd113",
      "bidExpiry": 1643110469
    },
    "gasFeeInReceivingToken": "0",
    "totalFee": "500000000000000",
    "metaTxRelayerFee": "0",
    "routerFee": "500000000000000"
  }
}
​
integrator
string

A string containing tracking information about the integrator of the API

​
includedSteps
Root Type for Internal Step · object[]
​
referrer
string

A string containing tracking information about the referrer of the integrator

​
execution
any

An objection containing status information about the execution

​
transactionRequest
any

An ether.js TransactionRequest that can be triggered using a wallet provider. (https://docs.ethers.io/v5/api/providers/types/#providers-TransactionRequest)