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.

ParameterTypeRequiredDefaultDescription
amountnumeric string or rational-Swap amount (in coins units)
basestring-Base coin name
relstring-Rel coin name (must be from the same EVM chain as the base coin)
complexity_levelnumber-Maximum number of token-connectors to be used in a transaction, min: 0; max: 3
connector_tokensbooleanfalseToken-connectors can be specified via this parameter. If not set, default token-connectors will be used
feenumber-Partner fee, percentage of src token amount will be sent to referrer address, min: 0; max: 3. Should be the same for quote and swap.
gas_limitnumber-Maximum amount of gas for a swap. Should be the same for a quote and swap. max: 11500000
gas_pricestring-Network price per gas, in Gwei. 1inch takes in account gas expenses to determine exchange route. Should be the same for a quote and swap
include_gasbooleanfalseInclude estimated gas in return value
include_protocolsbooleanfalseReturn used swap protocols in response
include_tokens_infobooleanfalseReturn fromToken and toToken info in response
main_route_partsnumber-Limit maximum number of main route parts. Should be the same for a quote and swap. max: 50
partsnumber-Limit maximum number of parts each main route parts can be split into. Should be the same for a quote and swap. max: 100
protocolsstring-Specify liquidity sources e.g.: &protocols=WETH,CURVE,BALANCER,...,ZRX (by default - all 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": ""
  }
}