# Schema

This schema provides a standardized way to present user information and token recommendations in our GitBook. It’s designed to bring consistency and clarity, making it simple for everyone—whether you’re a contributor, reader, developer, or analyst—to engage with the data. By structuring contributions into two key sections—**User Information** (with wallet address and submission timestamp) and **Tokens** (detailing metadata, market metrics, and insights)—this format ensures transparency and usability. Following this schema helps create a reliable, organized resource that benefits the whole community, so we encourage all contributors to adopt it for maximum impact.

***

## User Information

* **User Wallet Address**: The unique blockchain wallet address of the user making the recommendation.
* **Submission Time**: Date and time of submission.

## Tokens

Each recommended token includes the following fields:

* **Token Metadata**
  * **Contract**: The smart contract address of the token.
  * **Chain**: The blockchain network on which the token is deployed (e.g., Ethereum, Solana).
  * **Market Metrics**
    * **Name**: The official name of the token.
    * **Symbol**: The ticker symbol used to represent the token.
    * **Price**: The current market price of the token.
    * **Market Cap**: The total market capitalization of the token.
    * **Price Change (24h)**: The percentage change in the token's price over the past 24 hours.
    * **Trading Volume (24h)**: The total amount of the token traded in the last 24 hours.
    * **Circulating Supply**: The number of tokens currently in circulation.
    * **Volatility (24h)**: Measures the price fluctuation of the token within 24 hours.
    * **Risk Score**: A numerical score indicating the investment risk associated with the token.
    * **Security Status**: The security classification of the token, such as "Low Risk" or "High Risk".
* **Token Icon Url**: The link to the image URL of the shared token.
* **Token Category**: Specifies the type of token, such as Meme Coin, Gaming, AI Agent, or other classifications.
* **On-Chain Analysis**: A summary of the token’s blockchain-based activity, including transaction trends, whale movements, or smart contract interactions.
* **Reason for Recommendation**: The user’s explanation for why this token is recommended.
* **Recommendation Tags**: A set of attributes selected by the user that justify the recommendation.
* **Time of Recommendation**: The exact timestamp (ISO 8601 format) when the recommendation was made.
* **Suggestion**: The recommended action to take regarding the token (e.g., Buy, Hold, Sell).
* **Suggestion Tags**: Additional attributes selected by the user that support the suggestion.

***

