Swap Request

Generate a transaction payload for a swap request.

Related Queries

• All Tokens: Use this query to fetch valid token IDs for asset_in.token, recipient release assets, and swap route tokens.
• Token Denoms: Use this query to fetch the correct native, smart, or voucher denom details used in asset_in.token_type and recipients[].denom.
• All Chains: Use this query to fetch valid destination chain UIDs for recipients[].user.chain_uid. In most integrations, sender.chain_uid is derived from the connected wallet or source chain context.

tip

• This swap flow supports native, smart, or voucher assets depending on the token denom specified for release in recipients[].denom.
• If you are looking to swap voucher -> voucher tokens, consider using Gasless Voucher Swap.

Endpoint

Method: POST

https://api.euclidprotocol.com/api/v1/execute/swap

Examples

curl -X 'POST'   'https://api.euclidprotocol.com/api/v1/execute/swap'   -H 'accept: application/json'   -H 'Content-Type: application/json'   -d '{
  "amount_in": "1000000",
  "asset_in": {
    "token": "usdc",
    "token_type": {
      "smart": {
        "contract_address": "0x3c499c542cef5e3811e1192ce70d8cc03d5c3359"
      }
    }
  },
  "slippage": "100",
  "recipients": [
    {
      "user": {
        "address": "0x1111111111111111111111111111111111111111",
        "chain_uid": "polygon"
      },
      "amount": {
        "less_than_or_equal": "995000"
      },
      "denom": {
        "smart": {
          "contract_address": "0xc2132d05d31c914a87c6611c10748aeb04b58e8f"
        }
      },
      "forwarding_message": "",
      "unsafe_refund_as_voucher": false
    }
  ],
  "sender": {
    "address": "0x1111111111111111111111111111111111111111",
    "chain_uid": "polygon"
  },
  "swap_path": {
    "path": [
      {
        "route": [
          "usdc",
          "usdt"
        ],
        "dex": "euclid",
        "amount_in": "1000000",
        "amount_out": "1003064",
        "chain_uid": "vsl",
        "amount_out_for_hops": [
          "usdt: 1003064"
        ]
      }
    ],
    "total_price_impact": "0.00"
  }
}'

{
   "chain_id":"137",
   "contract":"0x08E6604931E9c2a978D4861b912f7894CC6063F7",
   "meta":"{"asset_in_type":"smart","releases":[{"dex":"euclid","release_address":[{"chain_uid":"polygon","address":"0x1111111111111111111111111111111111111111","amount":"995000"}],"token":"usdt","amount":""}],"swaps":{"path":[{"route":["usdc","usdt"],"dex":"euclid","chain_uid":"vsl","amount_in":"1000000","amount_out":"1003064"}]}}",
   "msgs":[
      {
         "chainId":"137",
         "to":"0x3c499c542cef5e3811e1192ce70d8cc03d5c3359",
         "data":"0x095ea7b300000000000000000000000008E6604931E9c2a978D4861b912f7894CC6063F700000000000000000000000000000000000000000000000000000000000f4240",
         "value":"0x0"
      },
      {
         "chainId":"137",
         "to":"0x08E6604931E9c2a978D4861b912f7894CC6063F7",
         "data":"0x1ec47621...",
         "value":"0x0"
      }
   ],
   "rest_url":"https://polygon-bor-rpc.publicnode.com",
   "rpc_url":"https://polygon-bor-rpc.publicnode.com",
   "sender":{
      "chain_uid":"polygon",
      "address":"0x1111111111111111111111111111111111111111"
   },
   "type":"evm"
}

curl -X 'POST'   'https://api.euclidprotocol.com/api/v1/execute/swap'   -H 'accept: application/json'   -H 'Content-Type: application/json'   -d '{
    "amount_in": "100000000000000000",
    "asset_in": {
      "token": "bsc",
      "token_type": {
        "smart": {
          "contract_address": "0x3246d25b42f6b3deca5b40334775fa4d6e333010"
        }
      }
    },
    "slippage": "500",
    "recipients": [
      {
        "user": {
          "address": "0x887e4aac216674d2c432798f851c1ea5d505b2e1",
          "chain_uid": "0g"
        },
        "amount": {
          "less_than_or_equal": "3563664058479"
        },
        "denom": {
          "native": {
            "denom": "bsc"
          }
        }
      }
    ],
    "partner_fee": {
      "partner_fee_bps": 10,
      "recipient": "0x8ed341da628fb9f540ab3a4ce4432ee9b4f5d658"
    },
    "sender": {
      "address": "0x887e4aac216674d2c432798f851c1ea5d505b2e1",
      "chain_uid": "neuron"
    },
    "swap_path": {
      "path": [
        {
          "route": [
            "euclid",
            "bnb"
          ],
          "dex": "euclid",
          "amount_in": "100000000000000000",
          "amount_out": "8152420272192926720",
          "chain_uid": "vsl",
          "amount_out_for_hops": [
            "bnb: 8152420272192926720"
          ]
        }
      ],
      "total_price_impact": "0.00"
    }
  }'

{
   "type":"cosmwasm",
   "sender":{
      "chain_uid":"neuron",
      "address":"0x887e4aac216674d2c432798f851c1ea5d505b2e1"
   },
   "contract":"euclid1aagn260yt7xtvq0jdecxu265zqzkc6mhc4glql2q2nmdsqwzmyzs8lfhhx",
   "chain_id":"neuron-1",
   "rpc_url":"https://rpc.neuron.euclidprotocol.com",
   "rest_url":"https://lcd.neuron.euclidprotocol.com",
   "msgs":[
      {
         "contractAddress":"0x3246d25b42f6b3deca5b40334775fa4d6e333010",
         "msg":{
            "send":{
               "amount":"100000000000000000",
               "contract":"euclid1aagn260yt7xtvq0jdecxu265zqzkc6mhc4glql2q2nmdsqwzmyzs8lfhhx",
               "msg":"eyJzd2FwIjp7ImFzc2V0X2luIjp7InRva2VuIjoiZXVjbGlkIiwidG9rZW5fdHlwZSI6eyJzbWFydCI6eyJjb250cmFjdF9hZGRyZXNzIjoiMHgzMjQ2ZDI1YjQyZjZiM2RlY2E1YjQwMzM0Nzc1ZmE0ZDZlMzMzMDEwIn19fSwiYXNzZXRfb3V0IjoiYm5iIiwiY3Jvc3NfY2hhaW5fYWRkcmVzc2VzIjpudWxsLCJtZXRhIjoie1wiYXNzZXRfaW5fdHlwZVwiOlwic21hcnRcIixcInJlbGVhc2VzXCI6W3tcImRleFwiOlwiZXVjbGlkXCIsXCJyZWxlYXNlX2FkZHJlc3NcIjpbe1wiY2hhaW5fdWlkXCI6XCJuZXVyb25cIixcImFkZHJlc3NcIjpcIjB4ODg3ZTRhYWMyMTY2NzRkMmM0MzI3OThmODUxYzFlYTVkNTA1YjJlMVwiLFwiYW1vdW50XCI6XCIwXCJ9XSxcInRva2VuXCI6XCJibmJcIixcImFtb3VudFwiOlwiXCJ9XSxcInN3YXBzXCI6e1wicGF0aFwiOlt7XCJyb3V0ZVwiOltcImV1Y2xpZFwiLFwiYm5iXCJdLFwiZGV4XCI6XCJldWNsaWRcIixcImNoYWluX3VpZFwiOlwidnNsXCIsXCJhbW91bnRfaW5cIjpcIjEwMDAwMDAwMDAwMDAwMDAwMFwiLFwiYW1vdW50X291dFwiOlwiODE1MjQyMDI3MjE5MjkyNjcyMFwifV19fSIsIm1pbl9hbW91bnRfb3V0IjoiNzc0NDc5OTI1ODU4MzI4MDM2MiIsInBhcnRuZXJfZmVlIjp7InBhcnRuZXJfZmVlX2JwcyI6MTAsInJlY2lwZW50IjoiIn0sInN3YXBzIjpbeyJ0b2tlbl9pbiI6ImV1Y2xpZCIsInRva2VuX291dCI6ImJuYiJ9XX19"
            }
         },
         "funds":[
            
         ]
      }
   ],
   "meta":"{\"asset_in_type\":\"smart\",\"releases\":[{\"dex\":\"euclid\",\"release_address\":[{\"chain_uid\":\"neuron\",\"address\":\"0x887e4aac216674d2c432798f851c1ea5d505b2e1\",\"amount\":\"0\"}],\"token\":\"bnb\",\"amount\":\"\"}],\"swaps\":{\"path\":[{\"route\":[\"euclid\",\"bnb\"],\"dex\":\"euclid\",\"chain_uid\":\"vsl\",\"amount_in\":\"100000000000000000\",\"amount_out\":\"8152420272192926720\"}]}}"
}

Parameters

tip

You should obtain the swap_path from the Get Routes endpoint. The response includes one or more route options detailing the path and DEX for each hop. Use the selected route in your swap call.

Field	Type	Description
amount_in	string	Amount of the input token to be swapped.
asset_in	TokenWithDenom	Input token and its type (either native or smart).
slippage	string	Slippage tolerance in basis points (e.g., "500" for 5%).
recipients	RecipientWithDenom[]	Recipients for the output asset. Defaults to the sender if omitted.
partner_fee	PartnerFee	Partner fee configuration. Includes basis points and recipient.
sender	CrossChainUserWithAmount	Address and chain initiating the swap.
swap_path	SwapPath	Routing path with token hops and DEX info. Use values from the Get Routes endpoint.

RecipientWithDenom

Field	Type	Description
user	CrossChainUserWithAmount	Recipient address and chain.
amount	Limit	Optional output limits for the recipient.
denom	TokenType	Token denom/type to release to the recipient.
forwarding_message	string	Optional forwarding payload (base64 or string, chain-dependent).
unsafe_refund_as_voucher	boolean	If true, failed release refunds are sent as vouchers to the recipient (router cannot validate recipient address). If false, refund is sent to the sender.

SwapPath

Field	Type	Description
path	SwapPathStep[]	Steps for the swap route, each defining a DEX and token route.

SwapPathStep

Field	Type	Description
route	string[]	Token sequence for the step (e.g., ["usdc", "euclid", "eth"]).
dex	string	DEX used for this step. Currently only "euclid" is supported.
chain_uid	string	UID of the chain where this step is executed.
amount_in	string	Input amount for this step.
amount_out	string	Estimated output amount for this step.

PartnerFee

Field	Type	Description
partner_fee_bps	number	Fee in basis points (e.g., 10 = 0.1%).
recipient	string	Address to receive the fee (typically on the same chain as sender).