Multi-Chain Tokens

The multichainTokens resource is designed for applications that need a holistic view of assets across the entire DeFi ecosystem. It provides unified models that aggregate metadata, liquidity, etc. from multiple chains into a single entry. Access this resource via hydric.multichainTokens.

Listing Tokens

The list method returns a paginated list of tokens containing metadata for multiple blockchains. This is ideal for building “Top Tokens” or “Exploration” views.

const { tokens, nextCursor } = await hydric.multichainTokens.list({
  config: {
    limit: 10,
    orderBy: { field: "tvl", direction: "desc" },
  },
  filters: {
    chainIds: [1, 8453], // Optional: Filter to specific chains (e.g., Ethereum and Base)
  },
});

Performance Note: Aggegrating data across chains is computationally expensive. If you only need data for a single specific chain, use the Single-Chain Tokens resource for significantly faster responses.

Searching Tokens

Search for assets by ticker symbol or name across all supported blockchains.

const { tokens } = await hydric.multichainTokens.search({
  search: "USDC",
  config: { limit: 5 },
});

for (const token of tokens) {
  console.log(
    `${token.symbol}: Available on chains ${token.chainIds.join(", ")}`,
  );
}

Data Model

The MultiChainTokenMetadata object includes:

address: The canonical address (if applicable).
symbol: The token ticker (e.g., “USDC”).
name: Full token name.
chainIds: An array of numeric IDs for every chain where this token has liquidity.
logoUrl: A verified icon for the asset.

Error Handling Single-Chain Tokens

About SDK

SDK Reference

Multi-Chain Tokens

Listing Tokens

Searching Tokens

Data Model

​Listing Tokens

​Searching Tokens

​Data Model

Listing Tokens

Searching Tokens

Data Model