GET /calldata

Similar to /firm-quote, but the response is raw calldata that can be directly submitted on-chain.

bGET https://newapi.native.org/v1/firm-quote/calldata

Header and Params are exactly the same as /firm-quote.

Headers

Name
Description

apiKey

API Key retrieved from the Native app

Params

Name
Description

chain*

token_in*

Token address for the token to be sold

token_out*

Token address for the token to be bought

amount (optional)

Amount of token to be sold, in ether unit

amount_wei (optional)

amount of token to be sold, in wei unit

from_address*

Address of the user that sells the token_in

beneficiary_address

Address of the end user that initiated the swap request

to_address

Address of the user that receives the token_out If empty, this address will be the same as from_address

expiry_time (optional)

Expiry time in seconds This variable will be passed on to the market makers to consider when they give the quote. Market makers would be able to give better quote for a shorter expiry time. It will affect the

deadlineTimestamp in the response if the quote from that market maker is chosen. If not provided, we will just use the default expiry time by the liquidity source.

slippage (optional)

Number in percentage value

For example, passing the value 5 means 5%, 0.1 means 0.1% slippage tolerance. By default it's 0.

Example

https://newapi.native.org/v1/firm-quote/calldata?chain=ethereum&token_in=0xEeeeeEeeeEeEeeEeEeEeeEEEeeeeEeeeeeeeEEeE&token_out=0xdAC17F958D2ee523a2206206994597C13D831ec7&amount=1&from_address=0x42d4e9ee3f725c84b7934e4fda64f2be0f803130&deadline_timestamp=1692085583

In this example, the wallet 0x42d4e9ee3f725c84b7934e4fda64f2be0f803130 requests transaction data for swapping 1 ETH to USDT on the Ethereum network.

Response

Name
Description

from

The address that will send the calldata to the NativeRouter

to

The address of the NativeRouter

calldata

The raw input data that will be executed by the NativeRouter

value

The msg.value for the transaction. Will be 0 if the seller token is a non-native token.

amountOut

Amount of token to be sold, in wei unit

amountInOffset (optional)

The offset position (in bytes) of the param amountIn. You can modify this value freely. Will be undefined if the target liquidity pool is not a native pool (non-PMM pool).

amountOutMinimumOffset (optional)

The offset position (in bytes) of the param amountOutMinimum. You can modify this value to protect yourself from slippage accordingly. Will be undefined if the target liquidity pool is not a native pool (non-PMM pool).

Example

{
    "from": "0x42d4e9ee3f725c84b7934e4fda64f2be0f803130",
    "to": "0xEAd050515E10fDB3540ccD6f8236C46790508A76",
    "calldata": "0xc7cd97480000000000000000000000000000000000000000000000000000000000000020000000000000000000000000000000000000000000000000000000000000012000000000000000000000000042d4e9ee3f725c84b7934e4fda64f2be0f8031300000000000000000000000000000000000000000000000000de0b6b3a7640000000000000000000000000000000000000000000000000000000000006d0060b000000000000000000000000067297ee4eb097e072b4ab6f1620268061ae804640000000000000000000000002397d2fde31c5704b02ac1ec9b770f23d70d8ec4000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000002a000000000000000000000000000000000000000000000000000000000000003200000000000000000000000000000000000000000000000000000000000000149000000000000000000000000000000000000000000000000000c94c046e2059d2008b6c3d07b061a84f790c035c2f6dc11a0be703d130bf4686b3d4b6eb91a8e26ac629c5bea608242d4e9ee3f725c84b7934e4fda64f2be0f803130dac17f958d2ee523a2206206994597c13d831ec7c02aaa39b223fe8d0a0e5c4f27ead9083c756cc2000000000000000000000000000000000000000000000000000000006e1a3d770000000000000000000000000000000000000000000000000de0b6b3a764000000000000000000000000000000000000000000000000000000000000653a214342d4e9ee3f725c84b7934e4fda64f2be0f8031309b7994d5ee304111ba952c1ceb20b03928017af9661bfc8653fbd7d27c26c7db5f43ccf2927ae147e41f9e18e9a0b0f81e766bc67dfbcca6e954c10d7e93ddd24f94c1ce8db4ee49d96c11c84a153f801b00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000041360a02816ec26c8cfb04d0f0ad10c480f184332c62d9e56c6180ab4d1992166e79d4a135dff39bc8f8159d14b5e3c57e6e4d030a27ca6590f05739c8c66cc2ef1b000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
    "value": "1000000000000000000", // Amount of native token, will be 0 for non-native tokens
    "amountOut": "2375239915",
    "amountInOffset": 100, // <OPTIONAL> Will be undefined if the target liquidity pool is not a native pool (non-PMM pool).
    "amountOutMinimumOffset": 132 // <OPTIONAL> Will be undefined if the target liquidity pool is not a native pool (non-PMM pool).
}

  • from, to, calldata: The calldata can be sent from the from address to the to address to execute the swap. Ensure that the from address has sufficient allowance set for the NativeRouter (which is the to address).

  • amountInOffset: This indicates the offset position (in bytes) of the amountIn parameter. For example, in the sample response above, the amountIn (uint256) occupies bytes 100-131. This is useful if you want to adjust the amountIn within the calldata.

  • amountOutMinimumOffset: This indicates the offset position (in bytes) of the amountOutMinimum parameter. For example, in the sample response above, the amountOutMinimum (uint256) occupies bytes 132-163. This is useful if you want to adjust the amountOutMinimum (for slippage protection) within the calldata.

If you prefer to use only Native pools (PMM-only pricing), please contact the Native team to have this option configured for you.

Explore this endpoint and see how it works here.

Last updated