> For the complete documentation index, see [llms.txt](https://effortless-labs.gitbook.io/hyperbola/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://effortless-labs.gitbook.io/hyperbola/registries/token-metadata.md).

# Token Metadata 

### Registry Fields

| Field Name                      | Type            | Description                                                      |
| ------------------------------- | --------------- | ---------------------------------------------------------------- |
| `slug`                          | string          | URL-friendly identifier for the token (e.g., "bounce-token").    |
| `name`                          | string          | Human-readable name of the token.                                |
| `symbol`                        | string          | Ticker symbol of the token (e.g., "AUCTION").                    |
| `logoURI`                       | string (URL)    | Link to the token's logo image.                                  |
| `contracts`                     | array           | List of contract deployments per network. Each object contains:  |
| — `network`                     | string          | Blockchain network name (e.g., "ethereum", "bsc").               |
| — `address`                     | string          | Contract address on the corresponding network.                   |
| — `decimals`                    | integer\|null   | Number of decimal places (nullable if unknown).                  |
| `tags`                          | string\[]       | Internal tag slugs for classification.                           |
| `tagNames`                      | string\[]       | Human-readable version of tags.                                  |
| `tagGroups`                     | string\[]       | Classification group of each tag (e.g., "CATEGORY", "PLATFORM"). |
| `urls`                          | object          | External resource links categorized by type:                     |
| — `website`                     | string\[]       | Official website URLs.                                           |
| — `twitter`                     | string\[]       | Twitter profile links.                                           |
| — `messageBoard`                | string\[]       | Medium or blog URLs.                                             |
| — `chat`                        | string\[]       | Telegram or Discord links.                                       |
| — `facebook`                    | string\[]       | Facebook page links (or "NA" if not available).                  |
| — `explorer`                    | string\[]       | Blockchain explorer URLs.                                        |
| — `reddit`                      | string\[]       | Reddit community links.                                          |
| — `technicalDoc`                | string\[]       | Documentation URLs.                                              |
| — `sourceCode`                  | string\[]       | GitHub or source repository URLs.                                |
| — `announcement`                | string\[]       | Official announcement links.                                     |
| `dateLaunched`                  | ISO date string | Launch date of the token (YYYY-MM-DD format).                    |
| `dateAdded`                     | ISO date string | Date the token was added to the system.                          |
| `selfReportedCirculatingSupply` | float           | Circulating supply provided by the project team.                 |
| `selfReportedTags`              | string\[]       | Additional descriptive tags provided by the team.                |
| `selfReportedMarketCap`         | float           | Market cap based on self-reported supply and price.              |
| `infiniteSupply`                | boolean         | Indicates if the token has infinite supply (`true` or `false`).  |

### Example Entry: Bounce Token

```json
{
  "slug": "bounce-token",
  "name": "Bounce Token",
  "symbol": "AUCTION",
  "logoURI": "https://hyperbola-dev-assets.s3.ap-southeast-1.amazonaws.com/logo/bounce-token",
  "contracts": [
    {
      "network": "ethereum",
      "address": "0xa9b1eb5908cfc3cdf91f9b8b3a74108598009096",
      "decimals": 18
    },
    {
      "network": "bsc",
      "address": "0x1188d953afc697c031851169eef640f23ac8529c",
      "decimals": 18
    }
  ],
  "urls": {
    "website": ["https://bounce.finance/"],
    "twitter": ["https://twitter.com/bounce_finance"],
    "messageBoard": ["https://bouncefinance.medium.com/"],
    "chat": ["https://t.me/bounce_finance"],
    "facebook": ["https://www.facebook.com/NA"],
    "explorer": [
      "https://etherscan.io/token/0xa9b1eb5908cfc3cdf91f9b8b3a74108598009096",
      "https://app.nansen.ai/token-god-mode?chain=ethereum&tab=transactions&tokenAddress=0xa9b1eb5908cfc3cdf91f9b8b3a74108598009096",
      "https://ethplorer.io/address/0xa9b1eb5908cfc3cdf91f9b8b3a74108598009096",
      "https://bscscan.com/token/0x1188d953afc697c031851169eef640f23ac8529c"
    ],
    "reddit": ["https://reddit.com/r/NA"],
    "technicalDoc": ["https://docs.bounce.finance/"],
    "sourceCode": ["https://github.com/bouncefinance"],
    "announcement": ["https://t.me/bouncefinance"]
  },
  "dateLaunched": "2020-07-01T00:00:00.000Z",
  "dateAdded": "2021-02-26T00:00:00.000Z",
  "selfReportedCirculatingSupply": 6590139,
  "selfReportedMarketCap": 75345415.90855807,
  "infiniteSupply": false
}
```