1inch API
1inch API
1inch API
1inch API
Introduction
Approve
Healthcheck
Quote / Swap
Protocols
Tokens
NodeJS Web3 Example
Legal
Limit Order Protocol
Powered by GitBook

Tokens

All supported tokens

All requests and examples are made for Ethereum mainnet, if you plan to use the API on other chains, change the request url as follows: https://api.1inch.exchange/v3.0/56/<method> — for Binance Smart Chain https://api.1inch.exchange/v3.0/137/<method> — for Polygon

get
Tokens

https://api.1inch.exchange/v3.0/1/tokens
Get array of all supported tokens (any erc20 token can be used in a quote and swap)
Request
Response
Request
​
Response
200: OK
Success response.
"tokens": {
    "tokenAddress": {      // token contract address
      "symbol": "string",
      "name": "string",
      "decimals": 0,       // how divisible a token can be, from 0 to 18
      "address": "string", // token contract address
      "logoURI": "string"  // link to the token logo 
    }
}

Request url https://api.1inch.exchange/v3.0/1/tokens

curl curl -X GET "https://api.1inch.exchange/v3.0/1/tokens" -H "accept: application/json"

Response body
Response headers
Response body
{
  "tokens": {
    "0xc011a73ee8576fb46f5e1c5751ca3b9fe0af2a6f": {
      "symbol": "SNX",
      "name": "Synthetix Network Token",
      "decimals": 18,
      "address": "0xc011a73ee8576fb46f5e1c5751ca3b9fe0af2a6f",
      "logoURI": "https://tokens.1inch.exchange/0xc011a73ee8576fb46f5e1c5751ca3b9fe0af2a6f.png"
    },
    //...
    "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48": {
      "symbol": "USDC",
      "name": "USD Coin",
      "address": "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
      "decimals": 6,
      "logoURI": "https://tokens.1inch.exchange/0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48.png"
    }
}
Response headers
access-control-allow-origin: * 
 cache-control: public,max-age=300,s-maxage=300 
 cf-cache-status: EXPIRED 
 cf-ray: 5f635fc2bcd62d28-LHR 
 cf-request-id: 0691fa2db600002d2812849000000001 
 content-encoding: gzip 
 content-type: application/json; charset=utf-8 
 date: Sun,22 Nov 2020 14:34:56 GMT 
 etag: W/"1cdc4-vy/SnvhGu34/huIysfy9eQGPttQ" 
 expect-ct: max-age=604800,report-uri="https://report-uri.cloudflare.com/cdn-cgi/beacon/expect-ct" 
 server: cloudflare 
 status: 200 
 vary: Origin,Accept-Encoding 
 x-powered-by: Express

Test your request in web interface: https://api.1inch.exchange/swagger/ethereum/#/Tokens/TokensController_getProtocols​

Previous
Protocols
Next
NodeJS Web3 Example
Last updated 2 months ago