v8

latestOpenAPI 3.1.1raw.githubusercontent.com2026-08-01124480.3 KB

Advanced

Populate an advanced route step transaction

Re-quotes the selected step and returns executable transaction data. For later steps, pass the actual previous step output as context.previousStepReceivedAmount.

post/v1/advanced/stepTransaction

Headers

x-api-keystring

Optional API key for higher rate limits and fee rules.

Request body

Example request

{
  "step": {
    "tool": "RELAY",
    "estimate": {
      "fees": {
        "total": {
          "amount": "2679",
          "currencySymbol": "USDC",
          "currencyAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
          "chainId": 8453,
          "decimals": 6
        },
        "breakdown": [
          {
            "amount": "2679",
            "currencySymbol": "USDC",
            "currencyAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
            "chainId": 8453,
            "decimals": 6,
            "type": "gas",
            "amountUsd": "0.01"
          }
        ],
        "totalUsd": "0.01"
      },
      "simulation": {
        "source": "TENDERLY",
        "executionStatus": "SUCCESS",
        "outputValidation": "VERIFIED",
        "simulatedOutputAmount": "996100",
        "advertisedOutputAmount": "997321",
        "deviation": {
          "absolute": "-1200",
          "bps": -12,
          "percent": "-0.12%"
        },
        "gasUsed": "142331",
        "reason": "Simulation exceeded budget",
        "latencyMs": 712,
        "providerResults": [
          {
            "source": "TENDERLY",
            "executionStatus": "SUCCESS",
            "outputValidation": "VERIFIED",
            "simulatedOutputAmount": "996100",
            "deviation": {
              "absolute": "-1200",
              "bps": -12,
              "percent": "-0.12%"
            },
            "gasUsed": "142331",
            "reason": "Exceeded 700ms",
            "latencyMs": 312
          }
        ]
      }
    },
    "warnings": [
      {
        "code": "SOLANA_INSUFFICIENT_BALANCE",
        "message": "Solana simulation reported insufficient balance."
      }
    ],
    "transactionRequest": {
      "gas": {
        "gasPrice": "0x3b9aca00",
        "maxFeePerGas": "0x59682f00",
        "maxPriorityFeePerGas": "0x3b9aca00"
      }
    }
  }
}

Response

Populated advanced step with executable transaction data.

idstring required

routeIdstring required

type'swap' | 'bridge' required

toolstring required

integratorstring

feenumber

bridgeScanBridgeScanMetadataDto

Example response

{
  "tool": "RELAY",
  "estimate": {
    "fees": {
      "total": {
        "amount": "2679",
        "currencySymbol": "USDC",
        "currencyAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
        "chainId": 8453,
        "decimals": 6
      },
      "breakdown": [
        {
          "amount": "2679",
          "currencySymbol": "USDC",
          "currencyAddress": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913",
          "chainId": 8453,
          "decimals": 6,
          "type": "gas",
          "amountUsd": "0.01"
        }
      ],
      "totalUsd": "0.01"
    },
    "simulation": {
      "source": "TENDERLY",
      "executionStatus": "SUCCESS",
      "outputValidation": "VERIFIED",
      "simulatedOutputAmount": "996100",
      "advertisedOutputAmount": "997321",
      "deviation": {
        "absolute": "-1200",
        "bps": -12,
        "percent": "-0.12%"
      },
      "gasUsed": "142331",
      "reason": "Simulation exceeded budget",
      "latencyMs": 712,
      "providerResults": [
        {
          "source": "TENDERLY",
          "executionStatus": "SUCCESS",
          "outputValidation": "VERIFIED",
          "simulatedOutputAmount": "996100",
          "deviation": {
            "absolute": "-1200",
            "bps": -12,
            "percent": "-0.12%"
          },
          "gasUsed": "142331",
          "reason": "Exceeded 700ms",
          "latencyMs": 312
        }
      ]
    }
  },
  "warnings": [
    {
      "code": "SOLANA_INSUFFICIENT_BALANCE",
      "message": "Solana simulation reported insufficient balance."
    }
  ],
  "transactionRequest": {
    "gas": {
      "gasPrice": "0x3b9aca00",
      "maxFeePerGas": "0x59682f00",
      "maxPriorityFeePerGas": "0x3b9aca00"
    }
  }
}