Returns details for token

POSThttps://api.1inch.com/token-details/v1.0/details/{chain}/{provider}
Supported on:
EthereumBaseSolanaBNB ChainLineaSonicUnichainArbitrumAvalancheZKsyncGnosisOptimismPolygon

Parameters

sortField
* string (Enum)query
sortField
sortType
* string (Enum)query
sort direction desc or asc
provider
* string (Enum)path
chain
* number path
Chain id of network

Request Body

BatchAddressesRequestDto object
tokenAddresses
* array
Addresses of token contracts
items
string
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
const axios = require('axios');

async function httpCall() {
  const url =
    'https://api.1inch.com/token-details/v1.0/details/{chain}/{provider}';

  const config = {
    headers: {
      Authorization: `Bearer ${API_KEY}`,
    },
    params: {},
    paramsSerializer: {
      indexes: null,
    },
  };
  const body = {
    tokenAddresses: [
      '0x111111111117dC0aa78b770fA6A738034120C302',
      '0x1f9840a85d5aF5bf1D1762F925BDADdC4201F984',
    ],
  };

  try {
    const response = await axios.post(url, body, config);
    console.log(response.data);
  } catch (error) {
    console.error(error);
  }
}

Returns

200
InfoDataResponse object
assets
* any
Token assets information including links and descriptions
allOf[0]
AssetsResponse object
name
* string
Token name
website
* string
Official website URL
sourceCode
* string
Source code repository URL
whitePaper
* string
Whitepaper URL
description
* string
Full description of the token project
shortDescription
* string
Short description of the token project
research
* string
Research or analysis URL
explorer
* string
Block explorer URL for the token
name
* string
Name of the social platform
url
* string
URL to the social profile
handle
* string
Social handle or username
details
* any
Token market details and price data
allOf[0]
DetailsResponse object
provider
* string
Data provider name
providerURL
* string
URL to the provider page for this token
vol24
* number
24-hour trading volume in USD
marketCap
* number
Total market capitalization in USD
circulatingSupply
* number
Circulating supply of the token
totalSupply
* number
Total supply of the token
quote
* any
Current price quote and market data
allOf[0]
Quote object
price
* number
Current token price in USD
volume_24h
* number
24-hour trading volume in USD
volume_change_24h
* number
Percentage change in volume over 24 hours
percent_change_1h
* number
Percentage price change in the last hour
percent_change_24h
* number
Percentage price change in the last 24 hours
percent_change_7d
* number
Percentage price change in the last 7 days
percent_change_30d
* number
Percentage price change in the last 30 days
percent_change_60d
* number
Percentage price change in the last 60 days
percent_change_90d
* number
Percentage price change in the last 90 days
market_cap
* number
Total market capitalization in USD
last_updated
* string
Timestamp of the last price update
JSON
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
{
  "assets": {
    "name": "1inch Network",
    "website": "https://1inch.io",
    "sourceCode": "https://github.com/1inch",
    "whitePaper": "string",
    "description": "string",
    "shortDescription": "string",
    "research": "string",
    "explorer": "string",
    "social_links": [
      {
        "name": "twitter",
        "url": "https://twitter.com/1inch",
        "handle": "@1inch"
      }
    ]
  },
  "details": {
    "provider": "coingecko",
    "providerURL": "string",
    "vol24": 15000000,
    "marketCap": 450000000,
    "circulatingSupply": 1000000000,
    "totalSupply": 1500000000,
    "quote": {
      "price": 0.45,
      "volume_24h": 15000000,
      "volume_change_24h": 5.2,
      "percent_change_1h": -0.5,
      "percent_change_24h": 2.3,
      "percent_change_7d": -3.1,
      "percent_change_30d": 12.5,
      "percent_change_60d": 8.7,
      "percent_change_90d": -15.2,
      "market_cap": 450000000,
      "last_updated": "string"
    }
  }
}

Did you find what you need?