Search token pairs for trading

Search for token pairs suitable for trading on a specific chain. Supports single token queries (e.g., "USDC") and pair queries (e.g., "USDC-ETH"). Results are paginated using cursor-based pagination.

GEThttps://api.1inch.com/token/v1.4/{chainId}/pairs
Supported on:
EthereumBaseBNB ChainOptimismPolygonLineaSonicUnichainArbitrumAvalancheZKsyncGnosis

Parameters

chainId
* number path
Blockchain network ID (e.g., 1 for Ethereum, 56 for BSC, 137 for Polygon)
replaceNativeWithWrappedInSource
boolean query
If true, replaces native token (e.g., ETH) with its wrapped version (e.g., WETH) in source position
limit
number query
Maximum number of token pairs to return (1-100)
country
object query
cursor
string query
Base64-encoded cursor for pagination. Use the cursor from the previous response to fetch the next page.
query
string query
Text to search for in token address, symbol, name, or token pair (e.g., "USDC", "USDC-ETH")

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
25
26
27
28
29
const axios = require('axios');

async function httpCall() {
  const url = 'https://api.1inch.com/token/v1.4/{chainId}/pairs';

  const config = {
    headers: {
      Authorization: `Bearer ${API_KEY}`,
    },
    params: {
      replaceNativeWithWrappedInSource: false,
      limit: 50,
      cursor: 'eyJvZmZzZXQiOjUwfQ==',
      query: 'USDC',
    },
    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
400
SearchPairsResponse object
pairs
* array
Array of token pairs (each pair is an array of two token addresses)
items
string
tokens
* array
Array of token details
items
TokenResponse object
chainId
* number
Blockchain network ID
symbol
* string
Token symbol
name
* string
Token name
address
* string
Token contract address
decimals
* number
Number of decimals for token amounts
logoURI
string
URL to token logo image
rating
* number
Token rating score based on community trust
eip2612
boolean
Whether token supports EIP-2612 permit signatures
isFoT
boolean
Whether token has fee-on-transfer mechanism
blacklisted
* boolean
Whether the token is blacklisted
tags
* array
Token tags with provider information
items
TagResponse object
provider
* string
value
* string
marketCap
number
Token market capitalization in USD
providers
* array
List of providers that support this token
items
string
page
* any
Pagination information
allOf[0]
PageInfoResponse object
nextCursor
string
Cursor for next page
hasMore
* boolean
Whether there are more results
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
{
  "pairs": [
    [
      "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
      "0xeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeeee"
    ],
    [
      "0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
      "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2"
    ]
  ],
  "tokens": [
    {
      "chainId": 1,
      "symbol": "USDT",
      "name": "Tether USD",
      "address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
      "decimals": 6,
      "logoURI": "https://tokens.1inch.io/0xdac17f958d2ee523a2206206994597c13d831ec7.png",
      "rating": 5,
      "eip2612": true,
      "isFoT": false,
      "blacklisted": false,
      "tags": [
        {
          "provider": "string",
          "value": "string"
        }
      ],
      "marketCap": 83351941553,
      "providers": ["1inch"]
    }
  ],
  "page": {
    "nextCursor": "...",
    "hasMore": true
  }
}

Did you find what you need?