Skip to main content
POST
/
v1
/
tokens
/
{chainId}
/
search
Search for tokens on a specific blockchain
curl --request POST \
  --url https://api.hydric.org/v1/tokens/{chainId}/search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "search": "ETH",
  "config": {
    "limit": 10,
    "orderBy": {
      "field": "tvl",
      "direction": "desc"
    },
    "cursor": null
  },
  "filters": {
    "minimumTotalValuePooledUsd": 10000,
    "minimumSwapsCount": 100,
    "minimumSwapVolumeUsd": 100000,
    "ignoreWrappedNative": false
  }
}
'
{
  "tokens": [
    {
      "chainId": 1,
      "address": "0x0000000000000000000000000000000000000000",
      "decimals": 18,
      "name": "Ether",
      "symbol": "ETH",
      "logoUrl": "https://logos.hydric.org/tokens/1/0x0000000000000000000000000000000000000000"
    }
  ],
  "filters": {
    "minimumTotalValuePooledUsd": 10000,
    "minimumSwapsCount": 100,
    "minimumSwapVolumeUsd": 100000,
    "ignoreWrappedNative": false
  },
  "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
​
search
string
required

The search term to filter assets by ticker symbol or name.

  • Ticker Symbol or Name: (e.g., 'ETH', 'USD', 'Wrapped') — Case-insensitive substring match.
Minimum string length: 1
Example:

"ETH"

​
config
object

Configuration for the search results such as limit, order, cursor, etc.

​
filters
object

Additional filters to personalize the search results.

Response

The search results were successfully retrieved.

​
tokens
object[]
required

List of matching tokens on the specified blockchain

​
filters
object
required

The filters applied to the search.

​
nextCursor
object

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

Example:

"eJzLKCkpSs3LT0rNz0tRBAAdewMF"