Skip to content
Switch branches/tags
This branch is 2 commits ahead, 26 commits behind forkdelta:master.
Fetch upstream

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Bitcratic logo Bitcratic Tokenbase

Bitcratic is a decentralized exchange with over 700 tradable ERC20-compliant tokens. Tokenbase is our ERC20 token knowledgebase.


Token information is stored in YAML format, one token per file, in tokens/0xTOKENADDRESS.yaml.

Common YAML

  • # Comment is a YAML comment. The hash # must be preceded by a space.
  • key: value is a key-value pair.
  • - item is a list entry. It is possible to have a list entry of a non-scalar type, e.g.: - key: value is a list entry containing a key-value pair.


A token listing file must include the following information:

---  # Mandatory "start of the document" marker
addr: '0x…'  # token contract address, in single quotes
decimals: 18 # Token decimals
name: Human Readable Token Name  # Required
symbol: TOKEN  # Required: Token symbol


Description of the token can be included:

addr: '0x5b0751713b2527d7f002c0c4e2a37e1219610a6b'
decimals: 18
description: The World’s first DAPP to bet on the price of Cryptocurrencies
name: Horse
symbol: HORSE

If you need more than one line of description, use the folded scalar notation:

addr: '0x5b0751713b2527d7f002c0c4e2a37e1219610a6b'
decimals: 18
description: >-
  The World’s first DAPP to bet on the price of Cryptocurrencies
  Ethorse is an Ethereum Smart Contract based DApp for betting on the price of
  Cryptocurrencies and win from everyone who bets against you.
name: Horse
symbol: HORSE

Note that folded scalar notation requires two new lines for a paragraph break (like Reddit format).

Description may contain HTML.


Links can be included to refer the user to external resources relevant to the token. They are represented by a list of key-value pairs, where key is the type of the link. The following types are currently recognized:

  • Bitcointalk
  • Blog
  • CoinMarketCap
  • Discord
  • Email
  • Facebook
  • Github
  • Reddit
  • Slack
  • Telegram
  • Twitter
  • WeChat
  • Website
  • Whitepaper
  • YouTube


addr: '0x5b0751713b2527d7f002c0c4e2a37e1219610a6b'
decimals: 18
- Email:
- Telegram:
- Twitter:
- Website:
- Whitepaper:
name: Horse
symbol: HORSE


Notice is a special field used to communicate critical information regarding contract or token status. This information should be prominently displayed to the user before any interaction occurs. Example:

addr: '0x44f12955189e3f01be5daf1dd9002ee4d774f42b'
decimals: 18
name: AfterSchool Token
notice: >-
  On October 12, Afterschool voluntarily suspended its ongoing crowdsale and will be returning all pledged ETH
  to the contributors.
  <a href="">Read the announcement.</a>
symbol: AST

Notice may cointain HTML.


A repository of ERC20 token information. Tokens listed are tradeable on We welcome contributions! 🎉




No releases published


No packages published