Skip to main content
POST
/
v1
/
tokens
/
search
Search for multi-chain assets
curl --request POST \
  --url https://api.hydric.org/v1/tokens/search \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "search": "ETH",
  "config": {
    "matchAllSymbols": false,
    "limit": 10,
    "orderBy": {
      "field": "tvl",
      "direction": "desc"
    },
    "cursor": null
  },
  "filters": {
    "chainIds": [
      1,
      8453
    ],
    "minimumTotalValuePooledUsd": 10000,
    "minimumSwapsCount": 100,
    "minimumSwapVolumeUsd": 100000,
    "ignoreWrappedNative": false
  }
}
'
{
  "tokens": [
    {
      "addresses": [
        {
          "chainId": 1,
          "address": "0x0000000000000000000000000000000000000000"
        }
      ],
      "symbol": "USDC",
      "name": "USD Coin",
      "logoUrl": "https://logos.hydric.org/tokens/1/0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
      "chainIds": [
        1,
        8453
      ]
    }
  ],
  "filters": {
    "chainIds": [
      1,
      8453
    ],
    "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

Body

application/json

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 Multichain tokens

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"