{ "openapi": "3.0.0", "paths": { "/v6.0/1/quote": { "get": { "operationId": "getQuote", "summary": "Find the best quote to swap with 1inch Router", "parameters": [ { "name": "src", "required": true, "in": "query", "example": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee", "schema": { "type": "string" } }, { "name": "dst", "required": true, "in": "query", "example": "0x111111111117dc0aa78b770fa6a738034120c302", "schema": { "type": "string" } }, { "name": "amount", "required": true, "in": "query", "example": "10000000000000000", "schema": { "type": "string" } }, { "name": "protocols", "required": false, "in": "query", "description": "All supported liquidity sources by default", "schema": { "type": "string", "x-go-type-skip-optional-pointer": true } }, { "name": "fee", "required": false, "in": "query", "description": "Partner fee. min: 0; max: 3 Should be the same for /quote and /swap", "schema": { "minimum": 0, "maximum": 3, "type": "number", "x-go-type-skip-optional-pointer": true } }, { "name": "gasPrice", "required": false, "in": "query", "description": "Network price per gas in wei. By default fast network gas price", "schema": { "type": "string", "x-go-type-skip-optional-pointer": true } }, { "name": "complexityLevel", "required": false, "in": "query", "schema": { "minimum": 0, "maximum": 2, "type": "number", "x-go-type-skip-optional-pointer": true } }, { "name": "parts", "required": false, "in": "query", "schema": { "minimum": 0, "maximum": 50, "type": "number", "x-go-type-skip-optional-pointer": true } }, { "name": "mainRouteParts", "required": false, "in": "query", "schema": { "minimum": 0, "maximum": 10, "type": "number", "x-go-type-skip-optional-pointer": true } }, { "name": "gasLimit", "required": false, "in": "query", "schema": { "minimum": 100000, "maximum": 11500000, "type": "number", "x-go-type-skip-optional-pointer": true } }, { "name": "includeTokensInfo", "required": false, "in": "query", "description": "Return fromToken and toToken info in response", "schema": { "type": "boolean", "x-go-type-skip-optional-pointer": true } }, { "name": "includeProtocols", "required": false, "in": "query", "description": "Return used swap protocols in response", "schema": { "type": "boolean", "x-go-type-skip-optional-pointer": true } }, { "name": "includeGas", "required": false, "in": "query", "description": "Return approximated gas in response", "schema": { "type": "boolean", "x-go-type-skip-optional-pointer": true } }, { "name": "connectorTokens", "required": false, "in": "query", "schema": { "minimum": 0, "maximum": 5, "type": "string", "x-go-type-skip-optional-pointer": true } }, { "name": "excludedProtocols", "required": false, "in": "query", "description": "excluded supported liquidity sources", "schema": { "type": "string", "x-go-type-skip-optional-pointer": true } } ], "responses": { "200": { "description": "", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/QuoteResponse" } } } }, "400": { "description": "", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/QuoteRequestError" } } } } }, "tags": [ "Swap" ] } }, "/v6.0/1/swap": { "get": { "operationId": "getSwap", "summary": "Generate calldata to swap on 1inch Router", "parameters": [ { "name": "src", "required": true, "in": "query", "example": "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee", "schema": { "type": "string" } }, { "name": "dst", "required": true, "in": "query", "example": "0x111111111117dc0aa78b770fa6a738034120c302", "schema": { "type": "string" } }, { "name": "amount", "required": true, "in": "query", "example": "10000000000000000", "schema": { "type": "string" } }, { "name": "from", "required": true, "in": "query", "description": "The address that calls the 1inch contract", "schema": { "type": "string" } }, { "name": "origin", "required": true, "in": "query", "description": "An EOA address that initiate the transaction", "schema": { "type": "string" } }, { "name": "slippage", "required": true, "in": "query", "example": 1, "description": "min: 0; max: 50", "schema": { "minimum": 0, "maximum": 50, "type": "number" } }, { "name": "protocols", "required": false, "in": "query", "description": "All supported liquidity sources by default", "schema": { "type": "string", "x-go-type-skip-optional-pointer": true } }, { "name": "fee", "required": false, "in": "query", "description": "Partner fee. min: 0; max: 3 Should be the same for /quote and /swap", "schema": { "minimum": 0, "maximum": 3, "type": "number", "x-go-type-skip-optional-pointer": true } }, { "name": "gasPrice", "required": false, "in": "query", "description": "Network price per gas in wei. By default fast network gas price", "schema": { "type": "string", "x-go-type-skip-optional-pointer": true } }, { "name": "complexityLevel", "required": false, "in": "query", "schema": { "minimum": 0, "maximum": 2, "type": "number", "x-go-type-skip-optional-pointer": true } }, { "name": "parts", "required": false, "in": "query", "schema": { "minimum": 0, "maximum": 50, "type": "number", "x-go-type-skip-optional-pointer": true } }, { "name": "mainRouteParts", "required": false, "in": "query", "schema": { "minimum": 0, "maximum": 10, "type": "number", "x-go-type-skip-optional-pointer": true } }, { "name": "gasLimit", "required": false, "in": "query", "schema": { "minimum": 100000, "maximum": 11500000, "type": "number", "x-go-type-skip-optional-pointer": true } }, { "name": "includeTokensInfo", "required": false, "in": "query", "description": "Return fromToken and toToken info in response", "schema": { "type": "boolean", "x-go-type-skip-optional-pointer": true } }, { "name": "includeProtocols", "required": false, "in": "query", "description": "Return used swap protocols in response", "schema": { "type": "boolean", "x-go-type-skip-optional-pointer": true } }, { "name": "includeGas", "required": false, "in": "query", "description": "Return approximated gas in response", "schema": { "type": "boolean", "x-go-type-skip-optional-pointer": true } }, { "name": "connectorTokens", "required": false, "in": "query", "schema": { "minimum": 0, "maximum": 5, "type": "string", "x-go-type-skip-optional-pointer": true } }, { "name": "excludedProtocols", "required": false, "in": "query", "description": "excluded supported liquidity sources", "schema": { "type": "string", "x-go-type-skip-optional-pointer": true } }, { "name": "permit", "required": false, "in": "query", "description": "https://eips.ethereum.org/EIPS/eip-2612", "schema": { "type": "string", "x-go-type-skip-optional-pointer": true } }, { "name": "receiver", "required": false, "in": "query", "description": "This address will receive funds after the swap. By default same address as \"from\" param", "schema": { "type": "string", "x-go-type-skip-optional-pointer": true } }, { "name": "referrer", "required": false, "in": "query", "schema": { "type": "string", "x-go-type-skip-optional-pointer": true } }, { "name": "allowPartialFill", "required": false, "in": "query", "description": "By default set to false", "schema": { "type": "boolean", "x-go-type-skip-optional-pointer": true } }, { "name": "disableEstimate", "required": false, "in": "query", "description": "Enable this flag to disable onchain simulation", "schema": { "type": "boolean", "x-go-type-skip-optional-pointer": true } }, { "name": "usePermit2", "required": false, "in": "query", "description": "Enable this flag in case you did an approval to permit2 smart contract", "schema": { "type": "boolean", "x-go-type-skip-optional-pointer": true } } ], "responses": { "200": { "description": "", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SwapResponse" } } } }, "400": { "description": "", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SwapRequestError" } } } } }, "tags": [ "Swap" ] } }, "/v6.0/1/approve/spender": { "get": { "operationId": "getSpender", "summary": "Address of the 1inch Router that is trusted to spend funds for the swap", "parameters": [], "responses": { "200": { "description": "", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/SpenderResponse" } } } } }, "tags": [ "Approve" ] } }, "/v6.0/1/approve/transaction": { "get": { "operationId": "getApprove", "summary": "Generate approve calldata to allow 1inch Router to perform a swap", "parameters": [ { "name": "tokenAddress", "required": true, "in": "query", "example": "0x111111111117dc0aa78b770fa6a738034120c302", "description": "Token address you want to swap", "schema": { "type": "string" } }, { "name": "amount", "required": false, "in": "query", "example": "100000000000", "description": "The number of tokens that the 1inch Router is allowed to swap.If not specified, it will be allowed to spend an infinite amount of tokens.", "schema": { "type": "string", "x-go-type-skip-optional-pointer": true } } ], "responses": { "200": { "description": "Transaction body to allow the exchange with the 1inch Router", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ApproveCallDataResponse" } } } } }, "tags": [ "Approve" ] } }, "/v6.0/1/approve/allowance": { "get": { "operationId": "getAllowance", "summary": "Get the number of tokens that the 1inch Router is allowed to swap", "parameters": [ { "name": "tokenAddress", "required": true, "in": "query", "example": "0x111111111117dc0aa78b770fa6a738034120c302", "description": "Token address you want to swap", "schema": { "type": "string" } }, { "name": "walletAddress", "required": true, "in": "query", "description": "Wallet address for which you want to check", "schema": { "type": "string" } } ], "responses": { "200": { "description": "", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/AllowanceResponse" } } } } }, "tags": [ "Approve" ] } }, "/v6.0/1/liquidity-sources": { "get": { "operationId": "getLiquiditySources", "summary": "List of liquidity sources that are available for routing in the 1inch Aggregation Protocol", "parameters": [], "responses": { "200": { "description": "", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/ProtocolsResponse" } } } } }, "tags": [ "Info" ] } }, "/v6.0/1/tokens": { "get": { "operationId": "getTokens", "summary": "List of tokens that are available for swap in the 1inch Aggregation protocol", "parameters": [], "responses": { "200": { "description": "All supported tokens (can also use your own)", "content": { "application/json": { "schema": { "type": "object", "properties": { "tokens": { "type": "object", "properties": { "0x111111111117dc0aa78b770fa6a738034120c302": { "$ref": "#/components/schemas/TokenInfo" } } } } } } } } }, "tags": [ "Info" ] } } }, "info": { "title": "1inch Swap API", "description": "\n