GET Firm quote

Get signed order data for selling a ERC20 / native token. Submit the return data to Native router to execute swap.

get

/v1/firm-quote

Query parameters

from_addressstringrequired

Address of the user that sells the token_in

Pattern: ^0x[a-fA-F0-9]{40}$

to_addressstring

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

Pattern: ^0x[a-fA-F0-9]{40}$

beneficiary_addressstring

Address of the end user that initiated the swap request.

Pattern: ^0x[a-fA-F0-9]{40}$

src_chainstring · enumrequired

Blockchain name, eg: ethereum, arbitrum, ...

Options: ethereum, arbitrum

dst_chainstring · enumrequired

Blockchain name, eg: ethereum, arbitrum, ...

Options: ethereum, arbitrum

token_instringrequired

Address of the token to be sold

Pattern: ^0x[a-fA-F0-9]{40}$

token_outstringrequired

Address of the token to be bought

Pattern: ^0x[a-fA-F0-9]{40}$

amountnumber · default: 0

Amount of token to be sold, in ether unit.

amount_weistring · default: 0

Amount of token to be sold, in wei unit.

expiry_timenumber · default: 0

The expiry time of the quote, in seconds.

slippagenumber · default: 0

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

timeout_millisnumber · default: 2000

Timeout in milliseconds

Header parameters

apiKeystringrequired

The API key that was assigned to you by Native

Responses

application/json

cURL

JavaScript

Python

HTTP

cURL

curl -L \
  --url 'https://v2.api.native.org/swap-api-v2/v1/firm-quote?from_address=text&src_chain=ethereum&dst_chain=ethereum&token_in=text&token_out=text' \
  --header 'apiKey: text'

200

500

200

{
  "success": true,
  "functionCall": "text",
  "widgetFeeSignature": "text",
  "recipient": "text",
  "calldata": "text",
  "amountIn": "text",
  "amountOut": "text",
  "toWrap": true,
  "toUnwrap": true,
  "tokenTransferFeeOnPercent": 1,
  "errorMessage": "text",
  "router_version": "text",
  "gasCostUsd": 1,
  "estimateDuration": 1,
  "bridge": {},
  "amountInOffset": 1,
  "amountOutMinimumOffset": 1,
  "source": "p0",
  "orders": [
    {
      "pool": "text",
      "signer": "text",
      "recipient": "text",
      "sellerToken": "text",
      "buyerToken": "text",
      "effectiveSellerTokenAmount": "text",
      "sellerTokenAmount": "text",
      "buyerTokenAmount": "text",
      "deadlineTimestamp": 1,
      "nonce": 1,
      "quoteId": "text",
      "multiHop": true,
      "signature": "text",
      "externalSwapCalldata": "text",
      "amountOutMinimum": "text",
      "widgetFeeSignature": "text",
      "widgetFee": {
        "signer": "text",
        "feeRecipient": "text",
        "feeRate": 1
      }
    }
  ],
  "fallbackSwapDataArray": [
    "text"
  ],
  "widgetFee": {
    "signer": "text",
    "feeRecipient": "text",
    "feeRate": 1
  },
  "txRequest": {
    "target": "text",
    "calldata": "text",
    "value": "text"
  }
}

Success