Create Swap

Creates a new swap based on the provided request. Network parameters accept either network names (e.g. ETHEREUM_MAINNET) or numeric chain IDs for EVM networks (e.g. 1). Token parameters accept either asset names (e.g. USDC, ETH) or token contract addresses (e.g. 0xa0b8…). For native tokens via contract address, use the network’s zero address (e.g. 0x0000000000000000000000000000000000000000 for EVM, 11111111111111111111111111111111 for Solana).

POST /api/v2/swaps

cURL

Example 1

curl --request POST \
  --url https://api.layerswap.io/api/v2/swaps \
  --header 'Content-Type: application/json' \
  --header 'X-LS-APIKEY: <api-key>' \
  --data '
{
  "destination_address": "0x",
  "reference_id": null,
  "source_network": "ETHEREUM_MAINNET",
  "source_token": "ETH",
  "destination_network": "ARBITRUM_MAINNET",
  "destination_token": "ETH",
  "refuel": false,
  "use_deposit_address": false,
  "use_depository": false,
  "use_new_deposit_address": null,
  "amount": 0.0042,
  "source_address": null,
  "slippage": null,
  "refund_address": null
}
'

200

{
  "error": {
    "code": "<string>",
    "message": "<string>",
    "metadata": {}
  },
  "data": {
    "quote": {
      "total_fee": 123,
      "total_fee_in_usd": 123,
      "source_network": {
        "name": "<string>",
        "display_name": "<string>",
        "logo": "<string>",
        "chain_id": "<string>",
        "node_url": "<string>",
        "nodes": [
          "<string>"
        ],
        "transaction_explorer_template": "<string>",
        "account_explorer_template": "<string>",
        "source_rank": 123,
        "destination_rank": 123,
        "token": {
          "symbol": "<string>",
          "display_asset": "<string>",
          "logo": "<string>",
          "contract": "<string>",
          "decimals": 123,
          "price_in_usd": 123,
          "precision": 123,
          "listing_date": "2023-11-07T05:31:56Z",
          "source_rank": 123,
          "destination_rank": 123,
          "group": "<string>"
        },
        "metadata": {
          "listing_date": "2023-11-07T05:31:56Z",
          "evm_oracle_contract": "<string>",
          "evm_multicall_contract": "<string>",
          "zks_paymaster_contract": "<string>",
          "watchdog_contract": "<string>"
        },
        "deposit_methods": [
          "<string>"
        ]
      },
      "source_token": {
        "symbol": "<string>",
        "display_asset": "<string>",
        "logo": "<string>",
        "contract": "<string>",
        "decimals": 123,
        "price_in_usd": 123,
        "precision": 123,
        "listing_date": "2023-11-07T05:31:56Z",
        "source_rank": 123,
        "destination_rank": 123,
        "group": "<string>"
      },
      "destination_network": {
        "name": "<string>",
        "display_name": "<string>",
        "logo": "<string>",
        "chain_id": "<string>",
        "node_url": "<string>",
        "nodes": [
          "<string>"
        ],
        "transaction_explorer_template": "<string>",
        "account_explorer_template": "<string>",
        "source_rank": 123,
        "destination_rank": 123,
        "token": {
          "symbol": "<string>",
          "display_asset": "<string>",
          "logo": "<string>",
          "contract": "<string>",
          "decimals": 123,
          "price_in_usd": 123,
          "precision": 123,
          "listing_date": "2023-11-07T05:31:56Z",
          "source_rank": 123,
          "destination_rank": 123,
          "group": "<string>"
        },
        "metadata": {
          "listing_date": "2023-11-07T05:31:56Z",
          "evm_oracle_contract": "<string>",
          "evm_multicall_contract": "<string>",
          "zks_paymaster_contract": "<string>",
          "watchdog_contract": "<string>"
        },
        "deposit_methods": [
          "<string>"
        ]
      },
      "destination_token": {
        "symbol": "<string>",
        "display_asset": "<string>",
        "logo": "<string>",
        "contract": "<string>",
        "decimals": 123,
        "price_in_usd": 123,
        "precision": 123,
        "listing_date": "2023-11-07T05:31:56Z",
        "source_rank": 123,
        "destination_rank": 123,
        "group": "<string>"
      },
      "requested_amount": 123,
      "receive_amount": 123,
      "fee_discount": 123,
      "min_receive_amount": 123,
      "blockchain_fee": 123,
      "service_fee": 123,
      "avg_completion_time": "<string>",
      "refuel_in_source": 123,
      "slippage": 123,
      "rate": 123,
      "path": [
        {
          "provider": "<string>",
          "order": 123
        }
      ]
    },
    "refuel": {
      "token": {
        "symbol": "<string>",
        "display_asset": "<string>",
        "logo": "<string>",
        "contract": "<string>",
        "decimals": 123,
        "price_in_usd": 123,
        "precision": 123,
        "listing_date": "2023-11-07T05:31:56Z",
        "source_rank": 123,
        "destination_rank": 123,
        "group": "<string>"
      },
      "network": {
        "name": "<string>",
        "display_name": "<string>",
        "logo": "<string>",
        "chain_id": "<string>",
        "node_url": "<string>",
        "nodes": [
          "<string>"
        ],
        "transaction_explorer_template": "<string>",
        "account_explorer_template": "<string>",
        "source_rank": 123,
        "destination_rank": 123,
        "token": {
          "symbol": "<string>",
          "display_asset": "<string>",
          "logo": "<string>",
          "contract": "<string>",
          "decimals": 123,
          "price_in_usd": 123,
          "precision": 123,
          "listing_date": "2023-11-07T05:31:56Z",
          "source_rank": 123,
          "destination_rank": 123,
          "group": "<string>"
        },
        "metadata": {
          "listing_date": "2023-11-07T05:31:56Z",
          "evm_oracle_contract": "<string>",
          "evm_multicall_contract": "<string>",
          "zks_paymaster_contract": "<string>",
          "watchdog_contract": "<string>"
        },
        "deposit_methods": [
          "<string>"
        ]
      },
      "amount": 123,
      "amount_in_usd": 123
    },
    "reward": {
      "token": {
        "symbol": "<string>",
        "display_asset": "<string>",
        "logo": "<string>",
        "contract": "<string>",
        "decimals": 123,
        "price_in_usd": 123,
        "precision": 123,
        "listing_date": "2023-11-07T05:31:56Z",
        "source_rank": 123,
        "destination_rank": 123,
        "group": "<string>"
      },
      "network": {
        "name": "<string>",
        "display_name": "<string>",
        "logo": "<string>",
        "chain_id": "<string>",
        "node_url": "<string>",
        "nodes": [
          "<string>"
        ],
        "transaction_explorer_template": "<string>",
        "account_explorer_template": "<string>",
        "source_rank": 123,
        "destination_rank": 123,
        "token": {
          "symbol": "<string>",
          "display_asset": "<string>",
          "logo": "<string>",
          "contract": "<string>",
          "decimals": 123,
          "price_in_usd": 123,
          "precision": 123,
          "listing_date": "2023-11-07T05:31:56Z",
          "source_rank": 123,
          "destination_rank": 123,
          "group": "<string>"
        },
        "metadata": {
          "listing_date": "2023-11-07T05:31:56Z",
          "evm_oracle_contract": "<string>",
          "evm_multicall_contract": "<string>",
          "zks_paymaster_contract": "<string>",
          "watchdog_contract": "<string>"
        },
        "deposit_methods": [
          "<string>"
        ]
      },
      "amount": 123,
      "amount_in_usd": 123,
      "campaign_type": "<string>",
      "nft_contract_address": "<string>"
    },
    "swap": {
      "id": "<string>",
      "created_date": "2023-11-07T05:31:56Z",
      "source_network": {
        "name": "<string>",
        "display_name": "<string>",
        "logo": "<string>",
        "chain_id": "<string>",
        "node_url": "<string>",
        "nodes": [
          "<string>"
        ],
        "transaction_explorer_template": "<string>",
        "account_explorer_template": "<string>",
        "source_rank": 123,
        "destination_rank": 123,
        "token": {
          "symbol": "<string>",
          "display_asset": "<string>",
          "logo": "<string>",
          "contract": "<string>",
          "decimals": 123,
          "price_in_usd": 123,
          "precision": 123,
          "listing_date": "2023-11-07T05:31:56Z",
          "source_rank": 123,
          "destination_rank": 123,
          "group": "<string>"
        },
        "metadata": {
          "listing_date": "2023-11-07T05:31:56Z",
          "evm_oracle_contract": "<string>",
          "evm_multicall_contract": "<string>",
          "zks_paymaster_contract": "<string>",
          "watchdog_contract": "<string>"
        },
        "deposit_methods": [
          "<string>"
        ]
      },
      "source_token": {
        "symbol": "<string>",
        "display_asset": "<string>",
        "logo": "<string>",
        "contract": "<string>",
        "decimals": 123,
        "price_in_usd": 123,
        "precision": 123,
        "listing_date": "2023-11-07T05:31:56Z",
        "source_rank": 123,
        "destination_rank": 123,
        "group": "<string>"
      },
      "source_exchange": {
        "name": "<string>",
        "display_name": "<string>",
        "logo": "<string>",
        "metadata": {
          "oauth": {
            "authorize_url": "<string>",
            "connect_url": "<string>"
          },
          "listing_date": "2023-11-07T05:31:56Z"
        }
      },
      "destination_network": {
        "name": "<string>",
        "display_name": "<string>",
        "logo": "<string>",
        "chain_id": "<string>",
        "node_url": "<string>",
        "nodes": [
          "<string>"
        ],
        "transaction_explorer_template": "<string>",
        "account_explorer_template": "<string>",
        "source_rank": 123,
        "destination_rank": 123,
        "token": {
          "symbol": "<string>",
          "display_asset": "<string>",
          "logo": "<string>",
          "contract": "<string>",
          "decimals": 123,
          "price_in_usd": 123,
          "precision": 123,
          "listing_date": "2023-11-07T05:31:56Z",
          "source_rank": 123,
          "destination_rank": 123,
          "group": "<string>"
        },
        "metadata": {
          "listing_date": "2023-11-07T05:31:56Z",
          "evm_oracle_contract": "<string>",
          "evm_multicall_contract": "<string>",
          "zks_paymaster_contract": "<string>",
          "watchdog_contract": "<string>"
        },
        "deposit_methods": [
          "<string>"
        ]
      },
      "destination_token": {
        "symbol": "<string>",
        "display_asset": "<string>",
        "logo": "<string>",
        "contract": "<string>",
        "decimals": 123,
        "price_in_usd": 123,
        "precision": 123,
        "listing_date": "2023-11-07T05:31:56Z",
        "source_rank": 123,
        "destination_rank": 123,
        "group": "<string>"
      },
      "destination_exchange": {
        "name": "<string>",
        "display_name": "<string>",
        "logo": "<string>",
        "metadata": {
          "oauth": {
            "authorize_url": "<string>",
            "connect_url": "<string>"
          },
          "listing_date": "2023-11-07T05:31:56Z"
        }
      },
      "requested_amount": 123,
      "destination_address": "<string>",
      "status": "<string>",
      "fail_reason": "<string>",
      "use_deposit_address": true,
      "metadata": {
        "sequence_number": 123,
        "reference_id": "<string>",
        "exchange_account": "<string>"
      },
      "transactions": [
        {
          "from": "<string>",
          "to": "<string>",
          "timestamp": "2023-11-07T05:31:56Z",
          "transaction_hash": "<string>",
          "confirmations": 123,
          "max_confirmations": 123,
          "amount": 123,
          "type": "<string>",
          "status": "<string>",
          "token": {
            "symbol": "<string>",
            "display_asset": "<string>",
            "logo": "<string>",
            "contract": "<string>",
            "decimals": 123,
            "price_in_usd": 123,
            "precision": 123,
            "listing_date": "2023-11-07T05:31:56Z",
            "source_rank": 123,
            "destination_rank": 123,
            "group": "<string>"
          },
          "network": {
            "name": "<string>",
            "display_name": "<string>",
            "logo": "<string>",
            "chain_id": "<string>",
            "node_url": "<string>",
            "nodes": [
              "<string>"
            ],
            "transaction_explorer_template": "<string>",
            "account_explorer_template": "<string>",
            "source_rank": 123,
            "destination_rank": 123,
            "token": {
              "symbol": "<string>",
              "display_asset": "<string>",
              "logo": "<string>",
              "contract": "<string>",
              "decimals": 123,
              "price_in_usd": 123,
              "precision": 123,
              "listing_date": "2023-11-07T05:31:56Z",
              "source_rank": 123,
              "destination_rank": 123,
              "group": "<string>"
            },
            "metadata": {
              "listing_date": "2023-11-07T05:31:56Z",
              "evm_oracle_contract": "<string>",
              "evm_multicall_contract": "<string>",
              "zks_paymaster_contract": "<string>",
              "watchdog_contract": "<string>"
            },
            "deposit_methods": [
              "<string>"
            ]
          },
          "fee_amount": 123,
          "fee_token": {
            "symbol": "<string>",
            "display_asset": "<string>",
            "logo": "<string>",
            "contract": "<string>",
            "decimals": 123,
            "price_in_usd": 123,
            "precision": 123,
            "listing_date": "2023-11-07T05:31:56Z",
            "source_rank": 123,
            "destination_rank": 123,
            "group": "<string>"
          }
        }
      ]
    },
    "deposit_actions": [
      {
        "type": "<string>",
        "to_address": "<string>",
        "amount": 123,
        "order": 123,
        "amount_in_base_units": "<string>",
        "network": {
          "name": "<string>",
          "display_name": "<string>",
          "logo": "<string>",
          "chain_id": "<string>",
          "node_url": "<string>",
          "nodes": [
            "<string>"
          ],
          "transaction_explorer_template": "<string>",
          "account_explorer_template": "<string>",
          "source_rank": 123,
          "destination_rank": 123,
          "token": {
            "symbol": "<string>",
            "display_asset": "<string>",
            "logo": "<string>",
            "contract": "<string>",
            "decimals": 123,
            "price_in_usd": 123,
            "precision": 123,
            "listing_date": "2023-11-07T05:31:56Z",
            "source_rank": 123,
            "destination_rank": 123,
            "group": "<string>"
          },
          "metadata": {
            "listing_date": "2023-11-07T05:31:56Z",
            "evm_oracle_contract": "<string>",
            "evm_multicall_contract": "<string>",
            "zks_paymaster_contract": "<string>",
            "watchdog_contract": "<string>"
          },
          "deposit_methods": [
            "<string>"
          ]
        },
        "token": {
          "symbol": "<string>",
          "display_asset": "<string>",
          "logo": "<string>",
          "contract": "<string>",
          "decimals": 123,
          "price_in_usd": 123,
          "precision": 123,
          "listing_date": "2023-11-07T05:31:56Z",
          "source_rank": 123,
          "destination_rank": 123,
          "group": "<string>"
        },
        "fee_token": {
          "symbol": "<string>",
          "display_asset": "<string>",
          "logo": "<string>",
          "contract": "<string>",
          "decimals": 123,
          "price_in_usd": 123,
          "precision": 123,
          "listing_date": "2023-11-07T05:31:56Z",
          "source_rank": 123,
          "destination_rank": 123,
          "group": "<string>"
        },
        "call_data": "<string>",
        "gas_limit": "<string>",
        "encoded_args": [
          "<string>"
        ]
      }
    ]
  }
}

Authorizations

X-LS-APIKEY · string · header · required

Headers

X-LS-APIKEY · string · default: NDBxG+aon6WlbgIA2LfwmcbLU52qUL9qTnztTuTRPNSohf/VnxXpRaJlA5uLSQVqP8YGIiy/0mz+mMeZhLY4/Q

Body

application/json

destination_address · string

reference_id · string | null

source_exchange · string | null

destination_exchange · string | null

source_network · string

source_token · string

destination_network · string

destination_token · string

refuel · boolean

use_deposit_address · boolean

use_depository · boolean

use_new_deposit_address · boolean | null

amount · number<double> | null

source_address · string | null

slippage · string | null

refund_address · string | null

Response

200 - application/json

Success

error · object

Show child attributes

data · object

Show child attributes