AMM Fallback

Only supported in version 4 and above

Native's own liquidity provides remarkable depth and competitiveness for major assets like WETH and WBTC. However, to use the Swap API in wallets or swap widgets, Native offers an AMM fallback option to support trading of nearly any tokens.

To enable this feature for your API key, contact Native team members through an existing channel.

Quote and Swap

To use this feature:

• Make sure your API key is whitelisted for AMM fallback.

• Use version=4 when calling /firm-quote.

/indicative-quote and /firm-quote will automatically utilise AMM liquidity if the quoted pair is not available from Native's own liquidity. No adjustment is needed. All returned fields will work as expected.

Please note that in liquidity fallback. The contract function that gets called is different. Normally, it should be tradeRFQT, but in AMM fallback, it will be externalSwap.

To track which function the swap tx is calling. Check txRequest.function.

Get Tradable Token

AMM fallback enables trading for thousands of tokens, therefore it is impractical to show individual trading pairs in /orderbook endpoint. Instead, we offer a new endpoint to keep track of all the supported tokens.

Call /widget-tokens?chains={chainName} with your API key.

Example:

## Get All Supported Tokens on Ethereum Including AMM Fallback
curl "https://v2.api.native.org/swap-api-v2/v1/widget-tokens?chains=ethereum" \
     -H "apiKey: $YOUR_KEY_HERE"

{
  "ethereum": [
    {
      "name": "World Liberty Financial",
      "desc": "",
      "logo": "https://s2.coinmarketcap.com/static/img/coins/64x64/33251.png",
      "chain": "ethereum",
      "symbol": "WLFI",
      "address": "0xdA5e1988097297dCdc1f90D4dFE7909e847CBeF6",
      "decimals": 18,
      "isFeatured": false,
      "isStablecoin": true,
      "isSupported": true
    },
    {
      "name": "Skate",
      "desc": "",
      "logo": "https://static.native.org/logo/tokens/1_0x61DBbBb552dc893ab3aAd09F289f811E67cEf285.jpg",
      "chain": "ethereum",
      "symbol": "SKATE",
      "address": "0x61DBbBb552dc893ab3aAd09F289f811E67cEf285",
      "decimals": 18,
      "isFeatured": false,
      "isStablecoin": true,
      "isSupported": true
    },
    // ...
  ]
}