Token Metadata

This registry stores token metadata, on-chain contract references, ecosystem tags, and social or technical URLs. It supports multi-chain deployments and self-reported data.

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

{
  "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
}