Get tokens by category and chain

Returns token details for a specific chain filtered by the specified category (gainers, losers, etc.)

GEThttps://api.1inch.com/token-details/category/{chainId}
Supported on:
EthereumBaseSolanaBNB ChainSonicUnichainArbitrumAvalancheZKsyncGnosisOptimismPolygonLinea

Parameters

sortField
* string (Enum)query
sortField
sortType
* string (Enum)query
sort direction desc or asc
category
* string (Enum)query
category

Request Body

This request doesn’t have any request body.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
const axios = require('axios');

async function httpCall() {
  const url = 'https://api.1inch.com/token-details/category/{chainId}';

  const config = {
    headers: {
      Authorization: `Bearer ${API_KEY}`,
    },
    params: {},
    paramsSerializer: {
      indexes: null,
    },
  };
  const body = {};

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

Returns

200
array
items
CategoryTokenResponseDto object
token
string
Token contract address
chain_id
* number
Chain ID where the token exists
internal_id
* object
Internal identifier from the data provider
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]
CategoryQuoteDto 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
tvl
number
Total value locked
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
[
  {
    "token": "0x111111111117dc0aa78b770fa6a738034120c302",
    "chain_id": 1,
    "internal_id": 1027,
    "provider": "coinmarketcap",
    "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",
      "tvl": 100000000
    }
  }
]

Did you find what you need?