Skip to main content

Multiple tokens grouped together to represent a basket of assets for a specific primitive or theme.

​
id
enum<string>
required

The unique identifier of the token basket.

Available options:
usd-stablecoins,
eth-pegged-tokens,
btc-pegged-tokens,
hype-pegged-tokens,
monad-pegged-tokens,
xau-stablecoins,
eur-stablecoins
Example:

"usd-stablecoins"

​
name
string
required

The human-readable name of the basket.

Example:

"USD Stablecoins"

​
description
string
required

A detailed description of what the basket represents.

Example:

"A basket of the most liquid USD stablecoins in the ecosystem."

​
logoUrl
string
required

The URL of the basket logo.

Example:

"https://cdn.jsdelivr.net/gh/hydric-org/token-baskets/assets/logos/usd-stablecoins.png"

​
chainIds
number[]
required

List of chain IDs where this basket is available.

Example:
[1, 143]
​
addresses
object[]
required

List of underlying token addresses across supported chains.

Example:
[
  {
    "chainId": 1,
    "address": "0xdac17f958d2ee523a2206206994597c13d831ec7"
  },
  { "chainId": 143, "address": "0x1234..." }
]
​
tokens
object[]
required

Token metadata for the assets in this basket.

Example:
[
  {
    "chainId": 1,
    "address": "0x0000000000000000000000000000000000000000",
    "decimals": 18,
    "name": "Ether",
    "symbol": "ETH",
    "logoUrl": "https://logos.hydric.org/tokens/1/0x0000000000000000000000000000000000000000"
  }
]