Skip to main content

Core identifying metadata for a token on a single blockchain.

​
chainId
enum<number>
required

The chain id of the network where the token resides.

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

1

​
address
string
required

The contract address of the token on its host network.

  • ERC-20 Tokens: The 20-byte hex contract address.
  • Native Assets (e.g., ETH, MATIC): Represented by the "Zero Address" (0x000...000).
Example:

"0x0000000000000000000000000000000000000000"

​
decimals
number
required

The number of decimal places used to represent the smallest fractional unit of the token (e.g., 18 for ETH, 6 for USDC).

Example:

18

​
name
string
required

The full human-readable name of the asset (e.g., "Ethereum", "Wrapped Bitcoin").

Example:

"Ether"

​
symbol
string
required

The ticker symbol of the token (e.g., "ETH", "WBTC")..

Example:

"ETH"

​
logoUrl
string
required

The URL of the token logo.

Example:

"https://logos.hydric.org/tokens/1/0x0000000000000000000000000000000000000000"