1inch v6.0 Classic Swap Create
API-v21inch_v6_0_classic_swap_create
The 1inch_v6_0_classic_swap_create method returns transaction data for classic swap from 1inch 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.
| Parameter | Type | Required | Description |
|---|---|---|---|
| amount | numeric string or rational | ✓ | Swap amount (in coins units) |
| base | string | ✓ | Base coin name |
| rel | string | ✓ | Rel coin name (must be from the same EVM chain as the base coin) |
| slippage | float | ✓ | Allowed slippage, min: 0; max: 50 |
| allow_partial_fill | bool | ✗ | If true, the algorithm can cancel part of the route, if the rate has become less attractive. Unswapped tokens will return to 'my address'. |
| compatibility | bool | ✗ | Exclude the Unoswap method |
| complexity_level | numeric | ✗ | Maximum number of token-connectors to be used in a transaction, min: 0; max: 3 |
| connector_tokens | string | ✗ | Token-connectors can be specified via this parameter. If not set, default token-connectors will be used |
| disable_estimate | bool | ✗ | If true, disable most of the checks |
| excluded_protocols | string | ✗ | Excluded supported liquidity sources. Should be the same for a quote and swap, max: 5 |
| fee | float | ✗ | 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 rpc. |
| gas_limit | numeric | ✗ | Maximum amount of gas for a swap. Should be the same for a quote and swap. max: 11500000 |
| gas_price | numeric string | ✗ | 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_gas | boolean | ✗ | Include estimated gas in return value |
| include_protocols | boolean | ✗ | Return used swap protocols in response |
| include_tokens_info | boolean | ✗ | Return fromToken and toToken info in response |
| main_route_parts | numeric | ✗ | Limit maximum number of main route parts. Should be the same for a quote and swap. max: 50 |
| parts | numeric | ✗ | Limit maximum number of parts each main route parts can be split into. Should be the same for a quote and swap. max: 100 |
| permit | string | ✗ | Used according https://eips.ethereum.org/EIPS/eip-2612 |
| protocols | string | ✗ | Specify liquidity sources e.g.: &protocols=WETH,CURVE,BALANCER,...,ZRX (by default - all used) |
| receiver | bool | ✗ | This address will receive funds after the swap. By default same address as 'my address' |
| referrer | bool | ✗ | Address to receive the partner fee. Must be set explicitly if fee is also set |
| use_permit2 | bool | ✗ | Enable this flag for auto approval by Permit2 contract if you did an approval to Uniswap Permit2 smart contract for this token. |
| Parameter | Type | Description |
|---|---|---|
| dst_amount | number | Destination token amount, in coins units. |
| src_token | object | Source (base) token information. A standard 1inchTokenInfo object. |
| dst_token | object | Destination (rel) token info. A standard 1inchTokenInfo object. |
| protocols | list | Optional. A list of standard 1inchProtocolInfo objects, used as liquidity sources used to route trade. |
| tx | object | A standard 1inchTxFields object. |
POST
1inch_v6_0_classic_swap_create{
"mmrpc": "2.0",
"userpass": "RPC_UserP@SSW0RD",
"method": "1inch_v6_0_classic_swap_create",
"params": {
"base": "ETH",
"rel": "USDC-ERC20",
"amount": 0.1,
"slippage": 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": ""
}
}