On this page

latest contributor to this doc

Last Edit:

@smk762

1inch v6.0 Classic Swap Quote

API-v21inch_v6_0_classic_swap_quote

The 1inch_v6_0_classic_swap_quote method returns best quote from 1inch classic swap API version 6.0.

To use methods which interface with the 1inch API, you need to set the 1inch_api url in your MM2.json file. You'll also need to set your 1inch API key as an environment variable called ONE_INCH_API_TEST_AUTH, e.g. ONE_INCH_API_TEST_AUTH="Bearer YourAPIkey".

As this feature is still experimental, you will need to build KDF from source on the dev branch with a build flag, e.g. cargo build --features test-ext-api.

Refer to the 1inch Classic Swap documentation for more information.

ParameterTypeRequiredDescription
basestringBase coin name
relstringRel coin name (must be from the same EVM chain as the base coin)
amountnumeric string or rationalSwap amount (in coins units)
feeFloatPartner fee, percentage of src token amount will be sent to referrer address, min: 0; max: 3. Should be the same for quote and swap.
protocolsstringSpecify liquidity sources e.g.: &protocols=WETH,CURVE,BALANCER,...,ZRX (by default - all used)
gas_pricenumeric stringNetwork price per gas, in Gwei. 1inch takes in account gas expenses to determine exchange route. Should be the same for a quote and swap
complexity_levelnumericMaximum number of token-connectors to be used in a transaction, min: 0; max: 3
partsnumericLimit maximum number of parts each main route parts can be split into. Should be the same for a quote and swap. max: 100
main_route_partsnumericLimit maximum number of main route parts. Should be the same for a quote and swap. max: 50
gas_limitnumericMaximum amount of gas for a swap. Should be the same for a quote and swap. max: 11500000
include_tokens_infobooleanReturn fromToken and toToken info in response
include_protocolsbooleanReturn used swap protocols in response
include_gasbooleanInclude estimated gas in return value
connector_tokensbooleanToken-connectors can be specified via this parameter. If not set, default token-connectors will be used

ParameterTypeDescription
dst_amountrational numberDestination token amount, in coins units.
src_tokenobjectSource (base) token information. A standard 1inchTokenInfo object.
dst_tokenobjectDestination (rel) token info. A standard 1inchTokenInfo object.
protocolslistOptional. A list of standard 1inchProtocolInfo objects, used as liquidity sources used to route trade.
gasnumericOptional. Estimated gas.

POST
1inch_v6_0_classic_swap_quote
{
  "mmrpc": "2.0",
  "userpass": "RPC_UserP@SSW0RD",
  "method": "1inch_v6_0_classic_swap_quote",
  "params": {
    "base": "ETH",
    "rel": "USDC-ERC20",
    "amount": 0.1,
    "include_tokens_info": true,
    "include_protocols": true,
    "include_gas": true,
    "fee": 0,
    "complexity_level": 3,
    "gas_limit": 11500000,
    "main_route_parts": 50,
    "parts": 100,
    "protocols": ""
  }
}