> ## Documentation Index
> Fetch the complete documentation index at: https://tokenterminal.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# tokens

> Tables in tt-primitives.tokens

## Tables

### token\_metadata

Reference data for ERC-20 and native tokens across multiple blockchains including name, ticker symbol, decimal precision, and unique identifier. Used for normalizing token amounts and enriching on-chain transaction data with human-readable token information.

<Accordion title="Columns">
  | Column     | Type     | Description                                                                                                                                                                                                                        |
  | ---------- | -------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
  | `id`       | `STRING` | Unique identifier for the token, typically the contract address on EVM chains or a module path on non-EVM chains like Aptos. Hex-encoded, 0x-prefixed format for addresses; colon-separated module identifiers for non-EVM tokens. |
  | `chain`    | `STRING` | Blockchain network identifier where the data originates. Lowercase string naming the specific blockchain network.                                                                                                                  |
  | `name`     | `STRING` | Token's full name as defined in its smart contract metadata. May include special characters, emojis, or descriptive phrases beyond the trading symbol.                                                                             |
  | `symbol`   | `STRING` | Token symbol or ticker used to represent the asset in trading interfaces and wallets. Typically 2-10 uppercase characters, may include hyphens or special characters for LP tokens or derivative positions.                        |
  | `decimals` | `STRING` | Number of decimal places used to represent the smallest unit of the token. Most EVM tokens use 18 decimals, while some chains like Aptos commonly use 8.                                                                           |
</Accordion>

<Accordion title="Sample Data">
  | id                                                                                             | name                        | chain    | symbol  | decimals |
  | ---------------------------------------------------------------------------------------------- | --------------------------- | -------- | ------- | -------- |
  | 0x9c775a70a5335ab38f029181ed86da3d0ee9c7c228d0c40f0aef1ab17edc261d::coin\_factory::EmojicoinLP | ⬛🪨 emojicoin LP            | aptos    | LP-1964 | 8        |
  | 0x5bfbc36bb624149991bdce0c65a1770db9760d91                                                     | Position Down               | arbitrum | DOWN    | 18       |
  | 0x498f37f26758424a29c6ad79ab0365dc7cbd1855                                                     | Anthony Edwards - 29 - 2750 | arbitrum | UNDER   | 18       |
</Accordion>

<Accordion title="Example Query">
  **Get sample data**

  ```sql theme={null}
  SELECT *
  FROM `tt-primitives.tokens.token_metadata`
  LIMIT 100
  ```
</Accordion>

***