Build an unsigned swap transaction for the best route

Build an unsigned swap transaction for the best route. Builds an unsigned transaction for the selected route. Compare it with a fresh quote, validate every returned transaction field, obtain explicit signing approval, and broadcast it through the selected chain's RPC. For an ERC-20 source, approve the router in tx.to for at least srcAmount before executing the returned transaction, or pass a permit or usePermit2 instead.

Paid test badge: not yet. The checks above are free: we call the tool without paying and read the payment request it sends back. The Verified badge needs paid calls whose answers match the promised output, and nobody can buy a badge.

Endpoint

GET https://api.3route.io/v1/:chainId/swap

Our checks, last 30 days

We never call tools that send, buy, move money or file anything, not even without paying.

Example input (from the provider)

{
  "method": "GET",
  "pathParams": {
    "chainId": "128064"
  },
  "queryParams": {
    "amount": "1000000000000000000",
    "dst": "0x5fc5360d0400a0fd4f2af552add042d716f1d168",
    "fee": 0,
    "from": "0x1111111111111111111111111111111111111111",
    "gasPrice": "1000000000",
    "includeBlockNumber": false,
    "includeProtocols": false,
    "includeTokensInfo": false,
    "receiver": "0x1111111111111111111111111111111111111111",
    "referrer": "0x1111111111111111111111111111111111111111",
    "slippage": 1,
    "src": "0x0000000000000000000000000000000000000000",
    "usePermit2": false
  },
  "type": "http"
}

Promised output schema (from the provider)

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "input": {
      "additionalProperties": false,
      "properties": {
        "method": {
          "enum": [
            "GET"
          ],
          "type": "string"
        },
        "pathParams": {
          "additionalProperties": false,
          "properties": {
            "chainId": {
              "description": "Chain ID for the operation.",
              "enum": [
                "4663",
                "42793",
                "128064"
              ],
              "example": "4663",
              "pattern": "^[0-9]+$",
              "type": "string"
            }
          },
          "required": [
            "chainId"
          ],
          "type": "object"
        },
        "queryParams": {
          "additionalProperties": false,
          "properties": {
            "amount": {
              "description": "Positive amount of src to sell in smallest units, as an integer string.",
              "example": "1000000000000000000",
              "pattern": "^[0-9]+$",
              "type": "string"
            },
            "dst": {
              "description": "Address of the token being bought; take one from the token-list operation for the selected chain, or use the zero address, or the case-insensitive sentinel 0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee, for the chain's native asset.",
              "example": "0x5fc5360d0400a0fd4f2af552add042d716f1d168",
              "pattern": "^0x[0-9a-fA-F]{40}$",
              "type": "string"
            },
            "excludedProtocols": {
              "type": "string"
            },
            "fee": {
              "default": 0,
              "maximum": 3,
              "minimum": 0,
              "type": "number"
            },
            "from": {
              "description": "Address that signs and sends the transaction, and that the src tokens are taken from",
              "example": "0x1111111111111111111111111111111111111111",
              "pattern": "^0x[0-9a-fA-F]{40}$",
              "type": "string"
            },
            "gasPrice": {
              "example": "1000000000",
              "pattern": "^[0-9]+$",
              "type": "string"
            },
            "includeBlockNumber": {
              "default": false,
              "type": "boolean"
            },
            "includeProtocols": {
              "default": false,
              "type": "boolean"
            },
            "includeTokensInfo": {
              "default": false,
              "type": "boolean"
            },
            "permit": {
              "pattern": "^0x[0-9a-fA-F]*$",
              "type": "string"
            },
            "protocols": {
              "type": "string"
            },
            "receiver": {
              "example": "0x1111111111111111111111111111111111111111",
              "pattern": "^0x[0-9a-fA-F]{40}$",
              "type": "string"
            },
            "referrer": {
              "example": "0x1111111111111111111111111111111111111111",
              "pattern": "^0x[0-9a-fA-F]{40}$",
              "type": "string"
            },
            "slippage": {
              "default": 1,
              "example": 1,
              "maximum": 50,
              "minimum": 0,
              "type": "number"
            },
            "src": {
              "description": "Address of the token being sold; use the zero address, or the case-insensitive sentinel 0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee, for the chain's native asset.",
              "example": "0x0000000000000000000000000000000000000000",
              "pattern": "^0x[0-9a-fA-F]{40}$",
              "type": "string"
            },
            "usePermit2": {
              "default": false,
              "type": "boolean"
            }
          },
          "required": [
            "src",
            "dst",
            "amount",
            "from"
          ],
          "type": "object"
        },
        "type": {
          "const": "http",
          "type": "string"
        }
      },
      "required": [
        "type",
        "method"
      ],
      "type": "object"
    },
    "output": {
      "properties": {
        "example": {
          "type": "object"
        },
        "type": {
          "type": "string"
        }
      },
      "required": [
        "type"
      ],
      "type": "object"
    }
  },
  "required": [
    "input"
  ],
  "type": "object"
}

This page as JSON