Skip to main content
POST
/
v1
/
tokens
/
{chainId}
Get a list of tokens on a specific blockchain
curl --request POST \
  --url https://api.hydric.org/v1/tokens/{chainId} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "config": {
    "limit": 10,
    "orderBy": {
      "field": "tvl",
      "direction": "desc"
    },
    "cursor": null
  },
  "filters": {
    "minimumTotalValuePooledUsd": 50000,
    "minimumSwapsCount": 1000,
    "minimumSwapVolumeUsd": 100000,
    "ignoreWrappedNative": true
  }
}
'
{
  "tokens": [
    {
      "chainId": 1,
      "address": "0x0000000000000000000000000000000000000000",
      "decimals": 18,
      "name": "Ether",
      "symbol": "ETH",
      "logoUrl": "https://logos.hydric.org/tokens/1/0x0000000000000000000000000000000000000000"
    }
  ],
  "nextCursor": "eJzLKCkpSs3LT0rNz0tRBAAdewMF"
}

Authorizations

​
Authorization
string
header
required

Use the docs sandbox API key for authentication: hydric_docs_4N4ocuirsN8Sh

Path Parameters

​
chainId
enum<number>
required

The chain id of the network. This must be a supported network chain id.

Available options:
1,
143,
130,
999,
8453,
9745,
534352
Example:

143

Body

application/json
​
config
object

Configuration for the token list request such as limit, order, cursor, etc.

​
filters
object

Filters for the token list request to personalize the response.

Response

The token list for the specified blockchain was successfully retrieved.

​
tokens
object[]
required

List of tokens on the specified blockchain

​
nextCursor
object

Cursor for the next page. Null if no more results.

Example:

"eJzLKCkpSs3LT0rNz0tRBAAdewMF"