Wen API Reference

Get Quote

POST /protocol/get-protocol-quotes

Fetch the quote for buying tokens listed on Wen.markets.

Base URL

https://api.pod.routerintents.com

Body

{
    "ReceiverAddress": "0x2B4fAD70FC7E6579f19163DeEBbc5846bead25C8",
    "SourceTokens": [
        {
            "chainId": "10",
            "address": "0x0b2c639c533813f4aa9d7837caf62653d097ff85",
            "name": "USDC",
            "symbol": "USDC",
            "decimals": 6
        }
    ],
    "DestinationTokens": [
        {
            "chainId": "137",
            "address": "0x2f89e67606290a9068A681A452f2AD8855087166",
            "name": "KID JOKER",
            "symbol": "KIDJ",
            "decimals": 18
        }
    ],
    "Amount": [
        "18000000"
    ],
    "SourceChainId": 10,
    "Protocol": [
        {
            "protocolId": "wen",
            "chainId": "137",
            "action": "swap"
        }
    ]
}
NameTypeDescription

ReceiverAddress

string (required)

Wallet address to receive the desired token

SourceTokens

array (required)

Array of tokens provided by the user on the source side

Amount

array (required)

Array of token amounts being supplied

DestinationTokens

array (required)

Array of tokens to be bought

SourceChainId

int (required)

Network ID of the starting chain, for example: 10 for Optimism

Protocol

object (required)

Intent adapter information for Wen.markets

SenderAddress

string (optional)

If SenderAddress is different from the ReceiverAddress

SlippageTolerance

float (optional)

1 means 1%; by default, this is set to 2%.

Wen.markets Protocol Data

// For protocol, pass the following:
    {
        "protocolId": "wen",
        "chainId": "137",
        "action": "swap",
    }

Response

200: Success
{
    "Code": 0,
    "Errors": [],
    "PayLoad": {
        "appId": "0",
        "quotationType": "BatchTransaction",
        "feeParams": [
            {
                "fee": "9000",
                "recipient": "0x00EB64b501613F8Cf8Ef3Ac4F82Fc63a50343fee",
                "decimals": 6,
                "symbol": "USDC",
                "tokenAddress": "0x0b2c639c533813f4aa9d7837caf62653d097ff85",
                "chainId": 10,
                "name": "USDC",
                "adapter": "batch-handler"
            }
        ],
        "slippageTolerance": 2,
        "sourceTokens": [
            {
                "chainId": "10",
                "address": "0x0b2c639c533813f4aa9d7837caf62653d097ff85",
                "name": "USDC",
                "symbol": "USDC",
                "decimals": 6
            }
        ],
        "amount": [
            "18000000"
        ],
        "sourceChainId": 10,
        "destinationChainId": 137,
        "destinationToken": {
            "chainId": "137",
            "address": "0x2f89e67606290a9068A681A452f2AD8855087166",
            "name": "KID JOKER",
            "symbol": "KIDJ",
            "decimals": 18
        },
        "adapters": [
            {
                "adapterId": "nitro_bridge",
                "adapterType": "bridge",
                "sourceChainId": 10,
                "destChainId": "137",
                "adapterOptions": {
                    "srcToken": {
                        "chainId": "10",
                        "address": "0x0b2c639c533813f4aa9d7837caf62653d097ff85",
                        "name": "USDC",
                        "symbol": "USDC",
                        "decimals": 6
                    },
                    "amountIn": "17991000",
                    "amountOut": "43664305655285055488",
                    "destToken": {
                        "chainId": "137",
                        "address": "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE",
                        "name": "MATIC",
                        "symbol": "MATIC",
                        "decimals": 18,
                        "resourceID": "",
                        "isMintable": false,
                        "isWrappedAsset": false
                    },
                    "receiverAddress": "0x6e19dc0107F1aE2C0C31dce91716249cD6AD101A",
                    "data": {
                        "actionType": 1,
                        "refundAddress": "0x2B4fAD70FC7E6579f19163DeEBbc5846bead25C8",
                        "partnerId": 0,
                        "tokens": [
                            "0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85",
                            "0x4200000000000000000000000000000000000006"
                        ],
                        "bridgeFee": {
                            "amount": "5777338603664",
                            "decimals": 18,
                            "symbol": "WETH",
                            "address": "0x4200000000000000000000000000000000000006"
                        },
                        "isMainnet": true,
                        "quotationParams": {
                            "fromTokenAddress": "0x0b2c639c533813f4aa9d7837caf62653d097ff85",
                            "toTokenAddress": "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE",
                            "amount": "17991000",
                            "fromTokenChainId": 10,
                            "toTokenChainId": "137",
                            "additionalGasLimit": 160000,
                            "slippageTolerance": 2
                        },
                        "forwarderQuotation": {
                            "flowType": "trustless",
                            "isTransfer": "false",
                            "isWrappedToken": false,
                            "allowanceTo": "0x5501A36b1313aC5d27e85418acd2AA4564f50b44",
                            "bridgeFee": {
                                "amount": "5777338603664",
                                "decimals": 18,
                                "symbol": "WETH",
                                "address": "0x4200000000000000000000000000000000000006"
                            },
                            "fuelTransfer": null,
                            "fromTokenAddress": "0x0b2c639c533813f4aa9d7837caf62653d097ff85",
                            "toTokenAddress": "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE",
                            "source": {
                                "chainId": "10",
                                "chainType": "evm",
                                "asset": {
                                    "decimals": 6,
                                    "symbol": "USDC",
                                    "name": "USDC",
                                    "chainId": "10",
                                    "address": "0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85",
                                    "resourceID": "usdc-circle",
                                    "isMintable": false,
                                    "isWrappedAsset": false,
                                    "isReserveAsset": false,
                                    "tokenInstance": {
                                        "decimals": 6,
                                        "symbol": "USDC",
                                        "name": "USDC",
                                        "chainId": 10,
                                        "address": "0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85"
                                    }
                                },
                                "stableReserveAsset": {
                                    "decimals": 18,
                                    "symbol": "WETH",
                                    "name": "WETH",
                                    "chainId": "10",
                                    "address": "0x4200000000000000000000000000000000000006",
                                    "resourceID": "native-eth",
                                    "isMintable": false,
                                    "isWrappedAsset": false,
                                    "isReserveAsset": false
                                },
                                "tokenAmount": "17991000",
                                "stableReserveAmount": "7244999510187305",
                                "path": [
                                    "0x0b2C639c533813f4Aa9D7837CAf62653d097Ff85",
                                    "0x4200000000000000000000000000000000000006"
                                ],
                                "flags": [
                                    "4002"
                                ],
                                "priceImpact": "0.00",
                                "tokenPath": "USDC->WETH",
                                "dataTx": [
                                    "0x90411a320000000000000000000000002691f337abeb0146f16441ca4f82f363275851d5000000000000000000000000000000000000000000000000000000000000006000000000000000000000000000000000000000000000000000000000000001c00000000000000000000000000b2c639c533813f4aa9d7837caf62653d097ff8500000000000000000000000042000000000000000000000000000000000000060000000000000000000000002691f337abeb0146f16441ca4f82f363275851d50000000000000000000000005501a36b1313ac5d27e85418acd2aa4564f50b4400000000000000000000000000000000000000000000000000000000011285580000000000000000000000000000000000000000000000000019bd49e633dd290000000000000000000000000000000000000000000000000019ffd8de2f37510000000000000000000000000000000000000000000000000000000000000002000000000000000000000000d2137a6d0ef438a7c2bb38eeef364500271658be000000000000000000000000000000000000000000000000000000000000014000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000004000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000001a000000000000000000000000000000000000000000000000000000000000002e0000000000000000000000000000000000000000000000000000000000000040000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000800000000000000000000000000000000000000000000000000000000000000064eb5625d90000000000000000000000000b2c639c533813f4aa9d7837caf62653d097ff85000000000000000000000000ff202313e26974cfc4ab0121c485ba54303a2e41000000000000000000000000000000000000000000000000000000000112855800000000000000000000000000000000000000000000000000000000000000000000000000000000ff202313e26974cfc4ab0121c485ba54303a2e410000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000800000000000000000000000000000000000000000000000000000000000000084c31b8d7a0000000000000000000000002691f337abeb0146f16441ca4f82f363275851d50000000000000000000000000000000000000000000000000000000000000001000000000000000000000000000000000000000000000000000000000112855800000000000000000000000000000000000000000000000000000001000276a400000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000000648a6a1e850000000000000000000000004200000000000000000000000000000000000006000000000000000000000000353c1f0bc78fbbc245b3c93ef77b1dcc5b77d2a00000000000000000000000000000000000000000000000000019ffd8de2f375100000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000001a49f865422000000000000000000000000420000000000000000000000000000000000000600000000000000000000000000000001000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000080000000000000000000000000000000000000000000000000000000000000004400000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000800000000000000000000000000000000000000000000000000000000000000064d1660f9900000000000000000000000042000000000000000000000000000000000000060000000000000000000000005501a36b1313ac5d27e85418acd2aa4564f50b4400000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000"
                                ]
                            },
                            "destination": {
                                "chainId": "137",
                                "chainType": "evm",
                                "asset": {
                                    "chainId": "137",
                                    "address": "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE",
                                    "name": "MATIC",
                                    "symbol": "MATIC",
                                    "decimals": 18,
                                    "resourceID": "",
                                    "isMintable": false,
                                    "isWrappedAsset": false
                                },
                                "stableReserveAsset": {
                                    "decimals": 18,
                                    "symbol": "WETH",
                                    "name": "Wrapped Ether",
                                    "chainId": "137",
                                    "address": "0x7ceB23fD6bC0adD59E62ac25578270cFf1b9f619",
                                    "resourceID": "native-eth",
                                    "isMintable": false,
                                    "isWrappedAsset": false,
                                    "isReserveAsset": false
                                },
                                "tokenAmount": "44105359247762688392",
                                "stableReserveAmount": "7239222171583641",
                                "priceImpact": "0.00",
                                "tokenPath": "WETH->WMATIC",
                                "dataTx": [
                                    "0x90411a320000000000000000000000001e82ad8a12068a85fcb96368463b434e77b21201000000000000000000000000000000000000000000000000000000000000006000000000000000000000000000000000000000000000000000000000000001c00000000000000000000000007ceb23fd6bc0add59e62ac25578270cff1b9f6190000000000000000000000000d500b1d8e8ef31e21c99d1db9a6444d3adf12700000000000000000000000001e82ad8a12068a85fcb96368463b434e77b21201000000000000000000000000c57133521ffbd729cb81cc8ddc12d9e9f61e0f6a0000000000000000000000000000000000000000000000000019b808c1fcc4990000000000000000000000000000000000000000000000025df6c6a66b5897840000000000000000000000000000000000000000000000026415b68e3de289880000000000000000000000000000000000000000000000000000000000000002000000000000000000000000d2137a6d0ef438a7c2bb38eeef364500271658be00000000000000000000000000000000000000000000000000000000000001400000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000500000000000000000000000000000000000000000000000000000000000000a000000000000000000000000000000000000000000000000000000000000001c00000000000000000000000000000000000000000000000000000000000000320000000000000000000000000000000000000000000000000000000000000048000000000000000000000000000000000000000000000000000000000000005a000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000800000000000000000000000000000000000000000000000000000000000000064eb5625d90000000000000000000000007ceb23fd6bc0add59e62ac25578270cff1b9f6190000000000000000000000000319000133d3ada02600f0875d2cf03d442c33670000000000000000000000000000000000000000000000000019b808c1fcc499000000000000000000000000000000000000000000000000000000000000000000000000000000000319000133d3ada02600f0875d2cf03d442c336700000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000000a402b9446c0000000000000000000000007ceb23fd6bc0add59e62ac25578270cff1b9f6190000000000000000000000001e82ad8a12068a85fcb96368463b434e77b21201000000000000000000000000ccab6b8ca444378541177fa30e32df6a187839de0000000000000000000000000000000000000000000000000019b808c1fcc499000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000ccab6b8ca444378541177fa30e32df6a187839de00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000000a4627dd56a000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000600000000000000000000000007ceb23fd6bc0add59e62ac25578270cff1b9f6190000000000000000000000001e82ad8a12068a85fcb96368463b434e77b21201000000000000000000000000000000000000000000000000000000000000000100000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000000648a6a1e850000000000000000000000000d500b1d8e8ef31e21c99d1db9a6444d3adf1270000000000000000000000000353c1f0bc78fbbc245b3c93ef77b1dcc5b77d2a00000000000000000000000000000000000000000000000026415b68e3de2898800000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000000000000000000000000000001a49f8654220000000000000000000000000d500b1d8e8ef31e21c99d1db9a6444d3adf127000000000000000000000000000000001000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000080000000000000000000000000000000000000000000000000000000000000004400000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000800000000000000000000000000000000000000000000000000000000000000064d1660f990000000000000000000000000d500b1d8e8ef31e21c99d1db9a6444d3adf1270000000000000000000000000c57133521ffbd729cb81cc8ddc12d9e9f61e0f6a00000000000000000000000000000000000000000000000000000000000000010000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000"
                                ],
                                "path": [
                                    "0x7ceB23fD6bC0adD59E62ac25578270cFf1b9f619",
                                    "0x0d500B1d8E8eF31E21C99d1Db9A6444d3ADf1270"
                                ],
                                "flags": [
                                    "4002"
                                ]
                            },
                            "partnerId": 0,
                            "slippageTolerance": "2",
                            "estimatedTime": 40
                        },
                        "destinationAmount": "44105359247762688392",
                        "destinationAmountPromised": "43664305655285055488"
                    }
                },
                "adapters": [
                    {
                        "adapterId": "wen_swap",
                        "adapterType": "swap",
                        "sourceChainId": "137",
                        "destChainId": "137",
                        "adapterOptions": {
                            "srcToken": {
                                "chainId": "137",
                                "address": "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE",
                                "name": "MATIC",
                                "symbol": "MATIC",
                                "decimals": 18,
                                "resourceID": "",
                                "isMintable": false,
                                "isWrappedAsset": false
                            },
                            "amountIn": "43664305655285055488",
                            "amountOut": "3899117791166465780089571",
                            "destToken": {
                                "chainId": "137",
                                "address": "0x2f89e67606290a9068A681A452f2AD8855087166",
                                "name": "KID JOKER",
                                "symbol": "KIDJ",
                                "decimals": 18
                            },
                            "receiverAddress": "0x2B4fAD70FC7E6579f19163DeEBbc5846bead25C8",
                            "data": {
                                "amountSent": "43664305655285055488",
                                "amountReceived": "3899117791166465780089571",
                                "amountReceivedInEther": 3899117.7911664657,
                                "exchangeRate": "0.000011198508994575",
                                "slippageTolerance": 1,
                                "partnerId": 0
                            }
                        },
                        "adapters": []
                    }
                ],
                "fee": {
                    "fee": "5777338603664",
                    "recipient": "",
                    "decimals": 18,
                    "symbol": "WETH",
                    "tokenAddress": "0x4200000000000000000000000000000000000006",
                    "chainId": 10,
                    "name": "WETH",
                    "adapter": "nitro_bridge"
                }
            }
        ],
        "quote": [
            {
                "amountSent": 17991000,
                "amountReceived": "43664305655285055488",
                "amountReceivedInEther": "43.664306",
                "exchangeRate": "",
                "estimatedTime": 40,
                "slippageTolerance": "2",
                "srcToken": "0x0b2c639c533813f4aa9d7837caf62653d097ff85",
                "destToken": "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE",
                "adapterId": "nitro_bridge",
                "bridgeFee": {
                    "amount": "5777338603664",
                    "decimals": 18,
                    "symbol": "WETH",
                    "address": "0x4200000000000000000000000000000000000006"
                }
            },
            {
                "amountSent": "43664305655285055488",
                "amountReceived": "3899117791166465780089571",
                "amountReceivedInEther": 3899117.7911664657,
                "exchangeRate": "0.000011198508994575",
                "slippageTolerance": 1,
                "srcToken": "0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE",
                "destToken": "0x2f89e67606290a9068A681A452f2AD8855087166",
                "adapterId": "wen_swap",
                "estimatedTime": 0
            }
        ],
        "clientAddress": "0x2B4fAD70FC7E6579f19163DeEBbc5846bead25C8",
        "senderAddress": "0x2B4fAD70FC7E6579f19163DeEBbc5846bead25C8",
        "estimatedTime": 40
    }
}
400: Bad Request
{
  "Code": 1,
  "Error": [
    {
      "Code": "1",
      "Message": [
        {
          "title": "",
          "message": ""
        }
      ]
    }
  ],
  "Payload": null
}

Sample cURL

curl --location 'https://api.pod.routerintents.com/router-intent/protocol/get-protocol-quotes' \
--header 'Accept: */*' \
--header 'Accept-Language: en-GB,en-US;q=0.9,en;q=0.8' \
--header 'Connection: keep-alive' \
--header 'Content-Type: application/json' \
--header 'Origin: https://poc-intents-ui.vercel.app' \
--header 'Referer: https://poc-intents-ui.vercel.app/' \
--header 'Sec-Fetch-Dest: empty' \
--header 'Sec-Fetch-Mode: cors' \
--header 'Sec-Fetch-Site: cross-site' \
--header 'User-Agent: Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/122.0.0.0 Safari/537.36' \
--header 'sec-ch-ua: "Chromium";v="122", "Not(A:Brand";v="24", "Google Chrome";v="122"' \
--header 'sec-ch-ua-mobile: ?0' \
--header 'sec-ch-ua-platform: "macOS"' \
--data '{
    "ReceiverAddress": "0x2B4fAD70FC7E6579f19163DeEBbc5846bead25C8",
    "SourceTokens": [
        {
            "chainId": "10",
            "address": "0x0b2c639c533813f4aa9d7837caf62653d097ff85",
            "name": "USDC",
            "symbol": "USDC",
            "decimals": 6
        }
    ],
    "DestinationTokens": [
        {
            "chainId": "137",
            "address": "0x2f89e67606290a9068A681A452f2AD8855087166",
            "name": "KID JOKER",
            "symbol": "KIDJ",
            "decimals": 18
        }
    ],
    "Amount": [
        "18000000"
    ],
    "SourceChainId": 10,
    "Protocol": [
        {
            "protocolId": "wen",
            "chainId": "137",
            "action": "swap"
        }
    ]
}'


Compose Calldata

POST /adapter/compose-adapter-calldata

Fetch the calldata to execute the quote fetched via the get-protocol-quotes endpoint

Base URL

https://api.pod.routerintents.com

Body

Payload object from the response of the get-protocol-quotes endpoint

Response

{
    "Code": 0,
    "Errors": [],
    "PayLoad": {
        "trnxId": "5619175b-32b2-4bc9-8f3a-3534650cc623",
        "gasPrice": "818125",
        "calldata": "0xabcd",
        "to": "0x1047770a9eb317667fAa472Ed2579E6f8dA086c6",
        "from": "0x2B4fAD70FC7E6579f19163DeEBbc5846bead25C8",
        "value": "0x00",
        "prioritySteps": [],
        "gasLimit": "500000"
    }
}

Notes:

  • In the payload, prioritySteps will contain the approval transaction calldata that needs to be executed before performing the transaction.

  • The estimated gasLimit sent by our APIs are not based on any simulations because it is not possible to simulate gasLimit without having token allowance. The gasLimit sent by our APIs is an estimate of the gas that a tx could use. Since the actual gas limit might differ, we suggest that the API users estimate the gasLimit themselves once the approval tx is mined.

Last updated