#Tokens
Tokens are ERC20 Ethereum contracts that represent fungible assets. They are the most common type of asset on Ethereum and are used in a wide variety of applications, including decentralized exchanges, lending protocols, and more.
#Token classification
When dealing with tokens you will often times want to exclude certain tokens from your queries.
#Bluechips
Bluechip tokens are the most established and widely recognized tokens in the Ethereum ecosystem. They are typically large-cap tokens with a long history of stability and reliability. Examples include Ether (ETH), Wrapped Ether (WETH), and Tether (USDT). These can be excluded when you are for example looking for what tokens certain wallets are buying, as in these cases they are likely using these tokens as a base currency, rather than actively trading them.
#Low quality tokens
Gatsby understands that tokens that are honeypots or that have very low liquidity and are therefore not tradable are unlikely to be useful in queries. It is ultimately up to you to decide exactly how these should be filtered out (and if they should be filtered out in the first case), but in some cases Gatsby will automatically exclude them from the results. In general, asking for "active" tokens or similar should get it on the right path, but you can always inspect the results to see if the filtering is behaving as expected.
#Token attributes
#address
The address of the token contract on Ethereum. These are 20-byte hexadecimal strings that are unique to each token. For example, the address of the Wrapped Ether (WETH) contract is 0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2.
#name
The name of the token, for example Wrapped Ether. This is a longer string that is used to represent the token in user interfaces. This is set by the creator of the token contract.
#symbol
The symbol of the token is a shorter version of its name, typically consisting of 3 to 5 uppercase letters that help users easily identify and differentiate between tokens. This is set by the token creator at the time of contract deployment. For example, the symbol for Wrapped Ether is WETH.
#decimals
The number of decimal places that the token uses. This is used to convert the raw token balance (which is an integer) into a human-readable number. For example, Wrapped Ether has 18 decimal places, so a balance of 1000000000000000000 is displayed as 1.0.
#total_supply
The total supply of a token.
#honeypot
The honeypot attribute is a boolean indicator identifying whether a token is considered a honeypot due to being at high risk of being untradeable on exchanges.
#block 0
Block 0 for a token is the first block in which the token was tradable.
#main_uniswap_pair_address
The address of the token's main Uniswap pair, useful for retrieving historical price data.
#last_swap_price_usd
The token's last recorded swap price in USD.
#last_swap_price_eth
The token's last recorded swap price in Ether.
#last_swap_timestamp
The timestamp of the last recorded swap for the token.
#market_cap_usd
The token's current market capitalization in USD.
#holder_count
The total number of unique holders currently owning the token.