{ "openapi": "3.0.0", "paths": { "/v1.3/multi-chain": { "get": { "description": "Get 1inch whitelisted multi-chain tokens info", "operationId": "TokenListMultiChainController-tokens-57f248b0-3e5f-4302-a31a-461a57e5d6d3", "parameters": [ { "name": "cf-ipcountry", "required": true, "in": "header", "schema": { "$ref": "#/components/schemas/Object" } }, { "name": "provider", "required": false, "in": "query", "description": "Provider code. Default value is 1inch", "schema": { "example": "1inch", "type": "string" } }, { "name": "country", "required": false, "in": "query", "description": "Country code", "schema": { "example": "US", "type": "string" } } ], "responses": { "200": { "description": "Token info map", "content": { "application/json": { "schema": { "type": "object" } } } } }, "summary": "1inch whitelisted multi-chain tokens", "tags": ["tokens"] } }, "/v1.3/multi-chain/token-list": { "get": { "description": "Get 1inch whitelisted multi-chain tokens in list", "operationId": "TokenListMultiChainController-tokensList-f2a9c639-d990-4f8b-8fdb-e554e1cbfd12", "parameters": [ { "name": "cf-ipcountry", "required": true, "in": "header", "schema": { "$ref": "#/components/schemas/Object" } }, { "name": "provider", "required": false, "in": "query", "description": "Provider code. Default value is \"1inch\"", "schema": { "example": "1inch", "type": "string" } }, { "name": "country", "required": false, "in": "query", "description": "Country code", "schema": { "example": "US", "type": "string" } } ], "responses": { "200": { "description": "Token list", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TokenListResponseDto" } } } } }, "summary": "1inch whitelisted multi-chain tokens in list format", "tags": ["tokens"] } }, "/v1.3/multi-chain/supported-chains": { "get": { "description": "Get all supported chain ids", "operationId": "TokenListMultiChainController-getSupportedChains-ea7c9b60-9498-4a80-9512-7a271f4960d9", "parameters": [], "responses": { "200": { "description": "" } }, "summary": "Get all supported chain ids", "tags": ["tokens"] } }, "/v1.3/search": { "get": { "description": "Search multi-chain tokens by name or symbol", "operationId": "SearchCrossChainController-searchAllChains-7e92f03a-0cee-40fb-967a-81e98366a396", "parameters": [ { "name": "query", "required": false, "in": "query", "description": "Text to search for in token address, token symbol, or description", "schema": { "example": "1inch", "type": "string" } }, { "name": "ignore_listed", "required": false, "in": "query", "description": "Whether to ignore listed tokens", "schema": { "example": false, "type": "boolean" } }, { "name": "only_positive_rating", "required": true, "in": "query", "schema": { "type": "boolean" } }, { "name": "limit", "required": false, "in": "query", "description": "Maximum number of tokens to return", "schema": { "example": 10, "type": "number" } }, { "name": "country", "required": true, "in": "query", "schema": { "$ref": "#/components/schemas/Object" } }, { "name": "cf-ipcountry", "required": true, "in": "header", "schema": { "$ref": "#/components/schemas/Object" } } ], "responses": { "200": { "description": "Search results", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/TokenDto" } } } } }, "400": { "description": "Invalid chain ID" } }, "summary": "Search multi-chain tokens by name or symbol", "tags": ["tokens"] } }, "/v1.2/{chainId}": { "get": { "description": "Get 1inch whitelisted tokens info", "operationId": "TokenListController-tokens-d585e06e-cfbf-4aab-bd3d-55cbde67c522", "parameters": [ { "name": "chainId", "required": true, "in": "path", "schema": { "type": "number" } }, { "name": "cf-ipcountry", "required": true, "in": "header", "schema": { "$ref": "#/components/schemas/Object" } }, { "name": "provider", "required": false, "in": "query", "description": "Provider code. Default value is 1inch", "schema": { "example": "1inch", "type": "string" } }, { "name": "country", "required": false, "in": "query", "description": "Country code", "schema": { "example": "US", "type": "string" } } ], "responses": { "200": { "description": "Token info map", "content": { "application/json": { "schema": { "type": "object", "properties": { "0x111111111117dc0aa78b770fa6a738034120c302": { "$ref": "#/components/schemas/ProviderTokenDto" } } } } } }, "400": { "description": "Invalid chain ID", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BadRequestErrorDto" } } } } }, "summary": "1inch whitelisted tokens", "tags": ["tokens"] } }, "/v1.3/{chainId}": { "get": { "description": "Get 1inch whitelisted tokens info", "operationId": "TokenListController-tokens-37dd6ef3-e84e-494d-b3f4-02251e0c825b", "parameters": [ { "name": "chainId", "required": true, "in": "path", "schema": { "type": "number" } }, { "name": "cf-ipcountry", "required": true, "in": "header", "schema": { "$ref": "#/components/schemas/Object" } }, { "name": "provider", "required": false, "in": "query", "description": "Provider code. Default value is 1inch", "schema": { "example": "1inch", "type": "string" } }, { "name": "country", "required": false, "in": "query", "description": "Country code", "schema": { "example": "US", "type": "string" } } ], "responses": { "200": { "description": "Token info map", "content": { "application/json": { "schema": { "type": "object", "properties": { "0x111111111117dc0aa78b770fa6a738034120c302": { "$ref": "#/components/schemas/ProviderTokenDto" } } } } } }, "400": { "description": "Invalid chain ID", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BadRequestErrorDto" } } } } }, "summary": "1inch whitelisted tokens", "tags": ["tokens"] } }, "/v1.4/{chainId}": { "get": { "description": "Get 1inch whitelisted tokens info", "operationId": "TokenListController-tokens-2f58dad5-a39b-4801-aba0-a38a2387a392", "parameters": [ { "name": "chainId", "required": true, "in": "path", "schema": { "type": "number" } }, { "name": "cf-ipcountry", "required": true, "in": "header", "schema": { "$ref": "#/components/schemas/Object" } }, { "name": "provider", "required": false, "in": "query", "description": "Provider code. Default value is 1inch", "schema": { "example": "1inch", "type": "string" } }, { "name": "country", "required": false, "in": "query", "description": "Country code", "schema": { "example": "US", "type": "string" } } ], "responses": { "200": { "description": "Token info map", "content": { "application/json": { "schema": { "type": "object", "properties": { "0x111111111117dc0aa78b770fa6a738034120c302": { "$ref": "#/components/schemas/ProviderTokenDto" } } } } } }, "400": { "description": "Invalid chain ID", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BadRequestErrorDto" } } } } }, "summary": "1inch whitelisted tokens", "tags": ["tokens"] } }, "/v1.2/{chainId}/token-list": { "get": { "description": "Get 1inch whitelisted tokens in list", "operationId": "TokenListController-tokensList-df7f6bde-61d3-42e9-b7ea-79232cde03bb", "parameters": [ { "name": "chainId", "required": true, "in": "path", "schema": { "type": "number" } }, { "name": "cf-ipcountry", "required": true, "in": "header", "schema": { "$ref": "#/components/schemas/Object" } }, { "name": "provider", "required": false, "in": "query", "description": "Provider code. Default value is \"1inch\"", "schema": { "example": "1inch", "type": "string" } }, { "name": "country", "required": false, "in": "query", "description": "Country code", "schema": { "example": "US", "type": "string" } } ], "responses": { "200": { "description": "Token list", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TokenListResponseDto" } } } }, "400": { "description": "Invalid chain ID", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BadRequestErrorDto" } } } } }, "summary": "1inch whitelisted tokens in list format", "tags": ["tokens"] } }, "/v1.3/{chainId}/token-list": { "get": { "description": "Get 1inch whitelisted tokens in list", "operationId": "TokenListController-tokensList-d379afaa-45ce-4d93-8fe7-e1537c699f02", "parameters": [ { "name": "chainId", "required": true, "in": "path", "schema": { "type": "number" } }, { "name": "cf-ipcountry", "required": true, "in": "header", "schema": { "$ref": "#/components/schemas/Object" } }, { "name": "provider", "required": false, "in": "query", "description": "Provider code. Default value is \"1inch\"", "schema": { "example": "1inch", "type": "string" } }, { "name": "country", "required": false, "in": "query", "description": "Country code", "schema": { "example": "US", "type": "string" } } ], "responses": { "200": { "description": "Token list", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TokenListResponseDto" } } } }, "400": { "description": "Invalid chain ID", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BadRequestErrorDto" } } } } }, "summary": "1inch whitelisted tokens in list format", "tags": ["tokens"] } }, "/v1.4/{chainId}/token-list": { "get": { "description": "Get 1inch whitelisted tokens in list", "operationId": "TokenListController-tokensList-00e61483-97cd-423a-ab79-5c2316232efd", "parameters": [ { "name": "chainId", "required": true, "in": "path", "schema": { "type": "number" } }, { "name": "cf-ipcountry", "required": true, "in": "header", "schema": { "$ref": "#/components/schemas/Object" } }, { "name": "provider", "required": false, "in": "query", "description": "Provider code. Default value is \"1inch\"", "schema": { "example": "1inch", "type": "string" } }, { "name": "country", "required": false, "in": "query", "description": "Country code", "schema": { "example": "US", "type": "string" } } ], "responses": { "200": { "description": "Token list", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/TokenListResponseDto" } } } }, "400": { "description": "Invalid chain ID", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BadRequestErrorDto" } } } } }, "summary": "1inch whitelisted tokens in list format", "tags": ["tokens"] } }, "/v1.2/{chainId}/search": { "get": { "description": "Search tokens by name or symbol", "operationId": "SearchController-searchSingleChain-a8b343eb-141a-42d9-9a9f-d17d61b13875", "parameters": [ { "name": "chainId", "required": true, "in": "path", "schema": { "type": "number" } }, { "name": "query", "required": false, "in": "query", "description": "Text to search for in token address, token symbol, or description", "schema": { "example": "1inch", "type": "string" } }, { "name": "ignore_listed", "required": false, "in": "query", "description": "Whether to ignore listed tokens", "schema": { "example": false, "type": "boolean" } }, { "name": "only_positive_rating", "required": true, "in": "query", "schema": { "type": "boolean" } }, { "name": "limit", "required": false, "in": "query", "description": "Maximum number of tokens to return", "schema": { "example": 10, "type": "number" } }, { "name": "country", "required": true, "in": "query", "schema": { "$ref": "#/components/schemas/Object" } }, { "name": "cf-ipcountry", "required": true, "in": "header", "schema": { "$ref": "#/components/schemas/Object" } } ], "responses": { "200": { "description": "Search results", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/TokenDto" } } } } }, "400": { "description": "Invalid chain ID" } }, "summary": "Search tokens by name or symbol", "tags": ["tokens"] } }, "/v1.3/{chainId}/search": { "get": { "description": "Search tokens by name or symbol", "operationId": "SearchController-searchSingleChain-3b361327-5220-4c37-b8dd-9fb07efa0091", "parameters": [ { "name": "chainId", "required": true, "in": "path", "schema": { "type": "number" } }, { "name": "query", "required": false, "in": "query", "description": "Text to search for in token address, token symbol, or description", "schema": { "example": "1inch", "type": "string" } }, { "name": "ignore_listed", "required": false, "in": "query", "description": "Whether to ignore listed tokens", "schema": { "example": false, "type": "boolean" } }, { "name": "only_positive_rating", "required": true, "in": "query", "schema": { "type": "boolean" } }, { "name": "limit", "required": false, "in": "query", "description": "Maximum number of tokens to return", "schema": { "example": 10, "type": "number" } }, { "name": "country", "required": true, "in": "query", "schema": { "$ref": "#/components/schemas/Object" } }, { "name": "cf-ipcountry", "required": true, "in": "header", "schema": { "$ref": "#/components/schemas/Object" } } ], "responses": { "200": { "description": "Search results", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/TokenDto" } } } } }, "400": { "description": "Invalid chain ID" } }, "summary": "Search tokens by name or symbol", "tags": ["tokens"] } }, "/v1.4/{chainId}/search": { "get": { "description": "Search tokens by name or symbol", "operationId": "SearchController-searchSingleChain-f864d01e-64b8-42c9-8dee-806caec04402", "parameters": [ { "name": "chainId", "required": true, "in": "path", "schema": { "type": "number" } }, { "name": "query", "required": false, "in": "query", "description": "Text to search for in token address, token symbol, or description", "schema": { "example": "1inch", "type": "string" } }, { "name": "ignore_listed", "required": false, "in": "query", "description": "Whether to ignore listed tokens", "schema": { "example": false, "type": "boolean" } }, { "name": "only_positive_rating", "required": true, "in": "query", "schema": { "type": "boolean" } }, { "name": "limit", "required": false, "in": "query", "description": "Maximum number of tokens to return", "schema": { "example": 10, "type": "number" } }, { "name": "country", "required": true, "in": "query", "schema": { "$ref": "#/components/schemas/Object" } }, { "name": "cf-ipcountry", "required": true, "in": "header", "schema": { "$ref": "#/components/schemas/Object" } } ], "responses": { "200": { "description": "Search results", "content": { "application/json": { "schema": { "type": "array", "items": { "$ref": "#/components/schemas/TokenDto" } } } } }, "400": { "description": "Invalid chain ID" } }, "summary": "Search tokens by name or symbol", "tags": ["tokens"] } }, "/v1.2/{chainId}/custom": { "get": { "description": "Get tokens info", "operationId": "CustomTokensController-getTokensInfo-a4e1872c-7e3b-4e47-aa86-c89a0e5c6577", "parameters": [ { "name": "chainId", "required": true, "in": "path", "schema": { "type": "number" } }, { "name": "addresses", "required": true, "in": "query", "schema": { "type": "array", "items": { "type": "string" } } }, { "name": "cf-ipcountry", "required": true, "in": "header", "schema": { "$ref": "#/components/schemas/Object" } } ], "responses": { "200": { "description": "Tokens info map", "content": { "application/json": { "schema": { "type": "object", "properties": { "0x111111111117dc0aa78b770fa6a738034120c302": { "$ref": "#/components/schemas/TokenInfoDto" } } } } } }, "400": { "description": "Invalid chain ID or address", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BadRequestErrorDto" } } } } }, "summary": "Get many tokens", "tags": ["tokens"] } }, "/v1.3/{chainId}/custom": { "get": { "description": "Get tokens info", "operationId": "CustomTokensController-getTokensInfo-ff9d82aa-211e-483f-a7fe-4274022b0162", "parameters": [ { "name": "chainId", "required": true, "in": "path", "schema": { "type": "number" } }, { "name": "addresses", "required": true, "in": "query", "schema": { "type": "array", "items": { "type": "string" } } }, { "name": "cf-ipcountry", "required": true, "in": "header", "schema": { "$ref": "#/components/schemas/Object" } } ], "responses": { "200": { "description": "Tokens info map", "content": { "application/json": { "schema": { "type": "object", "properties": { "0x111111111117dc0aa78b770fa6a738034120c302": { "$ref": "#/components/schemas/TokenInfoDto" } } } } } }, "400": { "description": "Invalid chain ID or address", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BadRequestErrorDto" } } } } }, "summary": "Get many tokens", "tags": ["tokens"] } }, "/v1.4/{chainId}/custom": { "get": { "description": "Get tokens info", "operationId": "CustomTokensController-getTokensInfo-f175ef82-c52d-497a-90a3-a72eae81651f", "parameters": [ { "name": "chainId", "required": true, "in": "path", "schema": { "type": "number" } }, { "name": "addresses", "required": true, "in": "query", "schema": { "type": "array", "items": { "type": "string" } } }, { "name": "cf-ipcountry", "required": true, "in": "header", "schema": { "$ref": "#/components/schemas/Object" } } ], "responses": { "200": { "description": "Tokens info map", "content": { "application/json": { "schema": { "type": "object", "properties": { "0x111111111117dc0aa78b770fa6a738034120c302": { "$ref": "#/components/schemas/TokenInfoDto" } } } } } }, "400": { "description": "Invalid chain ID or address", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BadRequestErrorDto" } } } } }, "summary": "Get many tokens", "tags": ["tokens"] } }, "/v1.2/{chainId}/custom/{address}": { "get": { "description": "Get token info", "operationId": "CustomTokensController-getTokenInfo-b8326e2d-82fc-4cf7-9dd8-565276025edb", "parameters": [ { "name": "chainId", "required": true, "in": "path", "schema": { "type": "number" } }, { "name": "address", "required": true, "in": "path", "schema": { "example": "0x111111111117dc0aa78b770fa6a738034120c302", "type": "string" } }, { "name": "cf-ipcountry", "required": true, "in": "header", "schema": { "$ref": "#/components/schemas/Object" } } ], "responses": { "200": { "description": "Token info", "content": { "application/json": { "schema": { "type": "object", "$ref": "#/components/schemas/TokenDto" } } } }, "400": { "description": "Invalid chain ID or address", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BadRequestErrorDto" } } } } }, "summary": "Get single token", "tags": ["tokens"] } }, "/v1.3/{chainId}/custom/{address}": { "get": { "description": "Get token info", "operationId": "CustomTokensController-getTokenInfo-39010d7e-13f1-477d-b460-b63c2fcc0717", "parameters": [ { "name": "chainId", "required": true, "in": "path", "schema": { "type": "number" } }, { "name": "address", "required": true, "in": "path", "schema": { "example": "0x111111111117dc0aa78b770fa6a738034120c302", "type": "string" } }, { "name": "cf-ipcountry", "required": true, "in": "header", "schema": { "$ref": "#/components/schemas/Object" } } ], "responses": { "200": { "description": "Token info", "content": { "application/json": { "schema": { "type": "object", "$ref": "#/components/schemas/TokenDto" } } } }, "400": { "description": "Invalid chain ID or address", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BadRequestErrorDto" } } } } }, "summary": "Get single token", "tags": ["tokens"] } }, "/v1.4/{chainId}/custom/{address}": { "get": { "description": "Get token info", "operationId": "CustomTokensController-getTokenInfo-88ae8969-79d8-4c5e-8b4b-a6874b500576", "parameters": [ { "name": "chainId", "required": true, "in": "path", "schema": { "type": "number" } }, { "name": "address", "required": true, "in": "path", "schema": { "example": "0x111111111117dc0aa78b770fa6a738034120c302", "type": "string" } }, { "name": "cf-ipcountry", "required": true, "in": "header", "schema": { "$ref": "#/components/schemas/Object" } } ], "responses": { "200": { "description": "Token info", "content": { "application/json": { "schema": { "type": "object", "$ref": "#/components/schemas/TokenDto" } } } }, "400": { "description": "Invalid chain ID or address", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/BadRequestErrorDto" } } } } }, "summary": "Get single token", "tags": ["tokens"] } } }, "info": { "title": "1inch Tokens API", "description": "", "version": "1.3", "contact": {} }, "tags": [ { "name": "tokens", "description": "" } ], "servers": [], "components": { "schemas": { "ProviderTokenDto": { "type": "object", "properties": { "chainId": { "type": "number" }, "symbol": { "type": "string" }, "name": { "type": "string" }, "address": { "type": "string" }, "decimals": { "type": "number" }, "logoURI": { "type": "string" }, "providers": { "type": "array", "items": { "type": "string" } }, "eip2612": { "type": "boolean" }, "isFoT": { "type": "boolean" }, "displayedSymbol": { "type": "string" }, "tags": { "type": "array", "items": { "type": "string" } } }, "required": [ "chainId", "symbol", "name", "address", "decimals", "providers", "tags" ] }, "Object": { "type": "object", "properties": {} }, "TagDto": { "type": "object", "properties": { "provider": { "type": "string" }, "value": { "type": "string" } }, "required": ["provider", "value"] }, "TokenInfoDto": { "type": "object", "properties": { "address": { "type": "string" }, "chainId": { "type": "number" }, "decimals": { "type": "number" }, "extensions": { "type": "object" }, "logoURI": { "type": "string" }, "name": { "type": "string" }, "symbol": { "type": "string" }, "tags": { "type": "array", "items": { "type": "string" } } }, "required": [ "address", "chainId", "decimals", "logoURI", "name", "symbol", "tags" ] }, "VersionDto": { "type": "object", "properties": { "major": { "type": "number" }, "minor": { "type": "number" }, "patch": { "type": "number" } }, "required": ["major", "minor", "patch"] }, "TokenListResponseDto": { "type": "object", "properties": { "keywords": { "type": "array", "items": { "type": "string" } }, "logoURI": { "type": "string" }, "name": { "type": "string" }, "tags": { "type": "object", "additionalProperties": { "$ref": "#/components/schemas/TagDto" } }, "tags_order": { "type": "array", "items": { "type": "string" } }, "timestamp": { "type": "string" }, "tokens": { "type": "array", "items": { "$ref": "#/components/schemas/TokenInfoDto" } }, "version": { "$ref": "#/components/schemas/VersionDto" } }, "required": [ "keywords", "logoURI", "name", "tags", "tags_order", "timestamp", "tokens", "version" ] }, "TokenDto": { "type": "object", "properties": { "chainId": { "type": "number" }, "symbol": { "type": "string" }, "name": { "type": "string" }, "address": { "type": "string" }, "decimals": { "type": "number" }, "logoURI": { "type": "string" }, "rating": { "type": "number" }, "eip2612": { "type": "boolean" }, "isFoT": { "type": "boolean" }, "tags": { "type": "array", "items": { "$ref": "#/components/schemas/TagDto" } }, "providers": { "type": "array", "items": { "type": "string" } } }, "required": [ "chainId", "symbol", "name", "address", "decimals", "rating", "tags", "providers" ] }, "BadRequestErrorDto": { "type": "object", "properties": { "statusCode": { "type": "number", "example": 400 }, "message": { "type": "string" }, "error": { "type": "string" } }, "required": ["statusCode", "message", "error"] } } } }