# Home

Welcome to your team’s developer platform

<h2 align="center"><sup><sub><kbd><mark style="color:$primary;">A digital world where exploration builds community and generates rewards.</mark></kbd></sub></sup></h2>

{% columns %}
{% column %}

### Learn more about Utopia

Explore the documentation for Utopia, the foundational layer designed to unify your on-chain experience. We're eliminating the fragmentation of Web3 by bringing Social interactions and DeFi utilities into one cohesive platform.

Here, you'll find everything you need to understand, navigate, and thrive in the universe we're creating.

<a href="/spaces/JPDC2d8OeuGrTQjwkXG1/pages/LThc2RqOxBKU56Qt3TMy" class="button primary" data-icon="rocket-launch">Learn More</a> <a href="/pages/JsKd452Nu8XTrHz68zaF#join-a-community-of-over-1-000-explorers" class="button secondary" data-icon="message-smile">Community</a>
{% endcolumn %}

{% column %}
{% code title="index.js" overflow="wrap" %}

```javascript
// Import the Utopia SDK
import Utopia from "utopia-sdk";

// Initialize the Utopia client with your identity
const utopia = new Utopia({ apiKey: "YOUR_UTOPIA_ACCESS_KEY" });

// Send your first message across the universe
const transmission = await utopia.communication.broadcast({
  message: "Hello, Utopia!",
  channel: "genesis"
});

console.log("Message propagated through the network:", transmission.id);
```

{% endcode %}
{% endcolumn %}
{% endcolumns %}

{% columns %}
{% column %}

<figure><img src="/files/EJqQtKUI5bjaDzY0naau" alt="" width="563"><figcaption></figcaption></figure>
{% endcolumn %}

{% column %}

### Navigate the Utopia Help Center

Help center is designed to empower you with the knowledge to connect, create, and prosper within our on-chain world. Find your path to mastery below.

<a href="/spaces/JycBBSha6TdqL3fRt64n" class="button primary" data-icon="comment-question">Help Center</a>&#x20;
{% endcolumn %}
{% endcolumns %}

<h2 align="center">Join a community of over 1,000 explorers</h2>

<p align="center">Join our Telegram community and follow us on Twitter in just a few steps.</p>

<table data-card-size="large" data-view="cards"><thead><tr><th></th><th></th><th></th><th></th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td><h4><i class="fa-telegram">:telegram:</i></h4></td><td><strong>Telegram community</strong></td><td>Join our Telegram community to post questions, get help, and share resources with over 1,000 explorers of Utopia.</td><td><a href="https://t.me/UtopiaBNB" class="button secondary">Join Telegram</a></td><td></td></tr><tr><td><h4><i class="fa-square-x-twitter">:square-x-twitter:</i></h4></td><td><strong>Twitter</strong></td><td>Follow our project on Twitter for updates, discussions, and the journey to Utopia. Be part of the adventure!</td><td><a href="https://x.com/UtopiaBNB" class="button secondary">Follow us on X</a></td><td></td></tr></tbody></table>


# Tokenomics

Supply, Distribution, Fees and Contract details

## **$UTOPIA** Token

Enhancing the Utopia Tokenomics Model

{% columns %}
{% column %}

<figure><img src="/files/AaX6SZld3ai2s9xXhd4h" alt=""><figcaption></figcaption></figure>
{% endcolumn %}

{% column %}

#### Network Information

* BNB Chain

#### Supply Information

* Max Supply: 1,000,000,000 $UTOPIA
* Total Supply: 1,000,000,000 $UTOPIA
* Circulating Supply: 1,000,000,000 $UTOPIA

#### Distribution Information

* PancakeSwap Liquidity: 950,000,000 $UTOPIA
* Centralized Exchanges Liquidity: 50,000,000 $UTOPIA

[Check Utopia's Block Explorer Page](https://bscscan.com/token/0xd83C128e7498bE555845A6dc331A99E1524C1777)
{% endcolumn %}
{% endcolumns %}

<details>

<summary>Fees Information</summary>

* 2% is going automatically to the TVL(Total Value Locked) of the dApp.
* 3% is going to the Utopia's Marketing Wallet.
* A total 5% is being applied in every buy and sell.

</details>

<details>

<summary>Contract Information</summary>

* The contract is renounced and 100% safe.

</details>


# Welcome to uDegen Docs

Welcome to the official uDegen documentation. This GitBook serves as the comprehensive guide to our ecosystem, designed to provide clarity, transparency, and strategic insights for our community.

Whether you are a seasoned trader or just beginning your journey with us, this documentation will help you navigate our features, understand our underlying mechanics, and stay informed on our latest updates.

***

## Why uDegen Exists

The crypto space doesn’t lack information.\
It lacks clarity, structure, and usable insights.\\

\
Most users are forced to jump between tools, dashboards, social feeds, and charts just to make sense of what’s happening. uDegen is being built to change that experience by bringing analysis, signals, and ecosystem mechanics into one coherent platform.\\

\
Not to replace charts, but to go beyond them.

***

## What uDegen Is Built To Do

uDegen focuses on helping users better analyze tokens and market activity.\
At its core, the platform is designed around:

* uAI, an AI-powered crypto assistant trained on exclusive uDegen analytics, designed to provide context, pattern recognition, and insight rather than price noise.
* Organic trend detection, built to surface real market movement instead of artificial engagement or paid promotion.
* Integrated ecosystem mechanics, where activity inside the platform directly feeds back into the Utopia ecosystem.

***

## Utility That Connects Back to Utopia

uDegen is an utility layer.\\

\
Every interaction inside uDegen is designed to strengthen the broader Utopia ecosystem:

* Payments inside the platform utilize $UTOPIA, with scheduled burns that continuously reduce circulating supply.
* A revenue-sharing model that feeds value back into buybacks, burns, and ecosystem liquidity.
* Value generated by usage flows directly into the Utopia dApp TVL, reinforcing long-term sustainability.

***

## Built for Growth, Not Noise

Beyond analytics, uDegen is structured to support organic expansion:

* A referral system designed around real usage, not spam.
* A revenue-based reward structure that aligns long-term users with the platform’s success.
* A focus on accessibility and clarity over complexity.

The goal isn’t to overwhelm users with features.\\

\
It’s to help them understand, navigate, and grow within crypto more effectively.

***

### Jump right in

<table data-view="cards"><thead><tr><th></th><th></th><th></th><th data-hidden data-card-cover data-type="files"></th><th data-hidden></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td><h4><i class="fa-circle-info">:circle-info:</i></h4></td><td><strong>Data &#x26; Insights</strong></td><td>Your source for pure alpha.</td><td></td><td></td><td><a href="/pages/7FvWQMF0kTK7HGhlQfmo">/pages/7FvWQMF0kTK7HGhlQfmo</a></td></tr><tr><td><h4><i class="fa-money-check-dollar">:money-check-dollar:</i></h4></td><td><strong>Credit Mechanics</strong></td><td>Fueling the uDegen engine.</td><td></td><td></td><td><a href="https://github.com/GitbookIO/gitbook-templates/blob/main/product-docs/broken-reference/README.md">https://github.com/GitbookIO/gitbook-templates/blob/main/product-docs/broken-reference/README.md</a></td></tr><tr><td><h4><i class="fa-hands-holding-heart">:hands-holding-heart:</i></h4></td><td><strong>Revenue Sharing</strong></td><td>Your share of the pie.</td><td></td><td></td><td><a href="/pages/QPzbTvC6XsT5gERiU43E">/pages/QPzbTvC6XsT5gERiU43E</a></td></tr></tbody></table>


# Data & Insights

The Data & Insights module is the central engine of the uDegen platform. It provides a comprehensive, 360-degree view of every token indexed in our system, stripping away the noise to give you the raw data needed for high-conviction trading.

***

### 🔍 Core Token Intelligence

Every project page on uDegen is packed with real-time data points, ensuring you never have to leave the platform to complete your research.

#### 1. Identity & Market Fundamentals

* **Project Profile:** Instant access to the token name, ticker, and official logo.
* **Social Links:** Verified redirects to X (Twitter), Telegram, and the project website.
* **Live Charts:** Real-time price action tracking directly within the interface.
* **Economic Metrics:** Accurate, live data for **Market Cap** and **Liquidity Depth.**

#### 2. Advanced Security & Distribution

* **Safety Analysis:** Automated security checks identifying high-risk functions, honeypots, and tax structures.
* **BubbleMaps Integration:** Visual representation of wallet clusters to spot hidden developer control or coordinated dumps.
* **Holder Insights:** A deep dive into the top holders, including Smart Money tagging to show you where the most profitable wallets are positioned.

#### 3. Social Sentiment & Heat

* **X (Twitter) Intelligence:** A live daily counter of posts from Verified Users mentioning the Contract Address (CA). This allows you to distinguish between bot spam and real organic "heat" from influential accounts.

***

### 📈 The uDegen Score

All of the data points mentioned above-from liquidity stability and security audits to smart money movement and social volume-are fed into our proprietary algorithm to generate the [uDegen Score](/udegen/features/score-system).

This score serves as a master rating, allowing you to compare the relative strength and risk of different projects at a single glance.

***

{% hint style="success" %}
**More Coming Soon:** This is just the beginning. We are constantly integrating new data feeds.
{% endhint %}

***


# Credit Mechanics

The [Alpha Scanner](/udegen/features/markdown) is powered by a credit-based system. This ensures a fair, pay-as-you-go model for high-frequency traders while keeping basic searches accessible for everyone.

***

### 🔍 How it Works

* **Contract Searches:** Each search for a contract address costs 1 Credit.
* **Verified Projects:** Searches for uDegen-verified projects (by name or ticker) are FREE and do not consume credits.
* **Alpha Scanner:** Credits are deducted automatically upon successful data retrieval.

***

### 💳 Credit Pricing

Stock up on credits to keep your edge. Higher tiers offer significantly better value per search.

| **Credits**   | **Price (USD)** | **Cost per Credit** |
| ------------- | --------------- | ------------------- |
| 100 Credits   | $5.00           | $0.050              |
| 300 Credits   | $12.50          | $0.041              |
| 1,000 Credits | $35.00          | $0.035              |

***

### 📥 Funding Your Account

You can top up your credits using **BNB** or **ETH**(SOL will be added soon).

**The $UTOPIA Advantage**

Pay using $UTOPIA tokens to receive an automatic 10% discount on all credit packages.

**How to Deposit:**

1. **Select Your Tier:** Choose the credit package you wish to purchase.
2. **Send Funds:** Transfer the EXACT amount requested to the provided deposit address.
3. **Verify Transaction:** Copy your Transaction Hash (TxID) and paste it into the verification field.
4. **Auto-Confirmation:** Our system will verify the hash and credit your account instantly.

{% hint style="warning" %}
**Important:** Ensure you send the exact amount specified. Sending incorrect amounts may lead to delays in credit processing.
{% endhint %}


# Revenue Sharing

At uDegen, we believe in a circular economy. A significant portion (50% total) of all revenue generated is redistributed to our community, top-performing projects, and the long-term sustainability of the $UTOPIA token.

### 💰Distribution Breakdown

Every dollar of revenue is allocated to drive growth and reward participation:

* **20% - Top Referrers:** Rewarding the community members bringing in the most heat.
* **15% - Trending Projects:** Incentivizing high-activity projects on our platform.
* **10% - Buyback & Burn:** Direct buybacks of $UTOPIA to decrease supply.
* **5% - Ecosystem TVL:** Directly added to the Utopia dApp TVL for stability.
* **100% Burning:** Any revenue generated directly in $UTOPIA tokens is permanently burned.

### 👥 Top Referrals (20%)

| **Rank** | **Payout %** | **Rank** | **Payout %** |
| -------- | ------------ | -------- | ------------ |
| 1st      | 30%          | 6th      | 5%           |
| 2nd      | 20%          | 7th      | 4%           |
| 3rd      | 15%          | 8th      | 3%           |
| 4th      | 10%          | 9th      | 3%           |
| 5th      | 7%           | 10th     | 3%           |

***

### 🔥 Trending Projects (15%)

Projects earn their share of the revenue pool based on a daily points system. At the end of the period (Monthly/Weekly), the 15% pool is split among the top 10 point earners.

**Daily Point System**

Your daily rank on the trending board determines your points:

* **Rank 1:** 10 pts | **Rank 2:** 9 pts | **Rank 3:** 8 pts ... down to **Rank 10:** 1 pt.

#### <sub>**Pool Split**</sub>

| **Rank** | **Pool %** | **Rank** | **Pool %** |
| -------- | ---------- | -------- | ---------- |
| 1st      | 50%        | 6th      | 3%         |
| 2nd      | 20%        | 7th      | 2.5%       |
| 3rd      | 10%        | 8th      | 2%         |
| 4th      | 6%         | 9th      | 1.5%       |
| 5th      | 4%         | 10th     | 1%         |

### 💎 $UTOPIA Sustainability (15%)

We are committed to the long-term value of the Utopia ecosystem:

* **The Burn:** 10% of total revenue is used to buy back $UTOPIA from the market and send it to the dead address.
* **TVL Boost:** 5% of revenue is funneled back into the Utopia dApp TVL, strengthening the protocol's foundation.


# uAI: Designed for You

**uAI** is not just another chatbot; it is a specialized crypto research assistant built directly into the heart of the **uDegen** ecosystem. By bridging advanced artificial intelligence with our proprietary real-time database, uAI provides actionable insights that standard AI models cannot reach.

***

### ⚡**Why uAI is Different**

Most AI assistants rely on static or outdated web data. **uAI** is different because it is natively integrated with the **uDegen** infrastructure. When you ask a question, uAI doesn't just "guess"—it queries our live data feeds to give you the most accurate picture of the market.

#### Core Capabilities

* **Real Token Data:** Access live pricing, liquidity metrics, and contract health instantly.
* **Holder Insights:** Deep-dive into wallet clusters, "smart money" movements, and distribution patterns.
* **Market Research Tools:** Generate summaries of trending narratives and identify emerging micro-trends before they hit the mainstream.
* **Structured Crypto Information:** Get clean, organized data on tokenomics, tax structures, and developer history without manual digging.

***

### 🧠 Integrated Intelligence

We believe in **Integrated Intelligence**, not just generative text. Because **uAI** lives inside our ecosystem, it understands the context of your research:

> "uAI doesn't just tell you what a token is; it tells you who is holding it, how the contract is behaving, and how it ranks against the rest of the uDegen market."

***

### 🛠 How to Use uAI

uAI is accessible directly through the uDegen dashboard.

* **Prompt-Based Research:** Ask complex questions like *"Which trending tokens have the lowest top-10 holder concentration?"*
* **Contract Analysis:** Drop a contract address, and uAI will cross-reference it with our database for a full risk/reward brief.
* **Ecosystem Sync:** uAI recognizes your tier and credit balance, ensuring a seamless research experience.

***


# Alpha Scanner

The **Alpha Scanner** is the high-speed gateway to the **uDegen** database, designed to give you an instant edge across the most active chains in decentralized finance.

***

### ⚡ Multichain Reach

Don't get restricted by a single ecosystem. The Alpha Scanner allows you to track and analyze tokens across **40+ networks**, including:

* **BNB Chain**
* **Ethereum**
* **Solana**
* **Base**
* **And 36+ other EVM and non-EVM chains.**

***

### 🔍 Search Functionality

Finding the right data should be seamless. You can query the scanner in two ways:

1. **Contract Address:** Paste any smart contract address for an instant deep-dive into its metrics.
2. **Verified Search:** For projects officially listed and verified within the uDegen ecosystem, you can search directly by Token Name or Ticker-completely **FREE** of charge.

***

### 🔥 Real-Time Heatmap

The moment you open the Alpha Scanner, you are greeted with the Top 5 Trending Tokens inside the uDegen platform from the last 24 hours.

This live leaderboard helps you:

* Identify where the community's attention is shifting.
* Spot emerging momentum before it hits the broader market.
* Track which projects are climbing the points ladder for our **Revenue Sharing** pool.

***


# New Listings&#x20;

The **New Listings** page features the latest projects officially verified and added to the uDegen ecosystem. Unlike automated scrapers, every project here has undergone an internal organic review by our team to ensure it meets our baseline standards for data integrity and community presence.

***

### 🛡️ The Listing Process

We believe in supporting quality projects. Listing on uDegen is **free** for all teams. To be considered for a listing, teams must complete our comprehensive submission form, which requires:

* **Project Identity:** High-resolution logo and accurate ticker/name.
* **Social Footprint:** Verified links to official Telegram, X (formerly Twitter), and website.
* **Public Verification:** A public post from the project's official social account confirming the uDegen listing request.

***

### ⚡ Review Options

While the standard review is free, we offer two "Express" options for teams looking to accelerate their launch:

* **Express Review ($100):** Prioritizes your project in our queue for an ultra-fast internal review.
* **Community Alert ($50):** Triggers a direct email notification to our entire database of registered users once your listing is live.

***

### 📢 Visibility & Exposure

Once a project is approved and listed, it receives immediate ecosystem-wide exposure:

* **X (Twitter) Announcement:** An official shout-out from the uDegen Official X Account.
* **The Listings Ladder:** Featured prominently in the "New Listings" section on the uDegen web platform.
* **Free Alpha Search:** Verified tokens can be searched by name or ticker in the Alpha Scanner with zero credit cost for all users.

***

### ⚠️ Important: Refund & Re-evaluation Policy

To maintain the integrity of our ecosystem, please note that payments for **Express Review ($100) are non-refundable**, even if a project fails to meet our internal listing requirements initially. However, our team will closely monitor the project over the following days and provide priority re-evaluation as the project evolves.

Similarly, if a project pays for the **Community Alert ($50)** but is not immediately listed, the funds are held and the email notification will be automatically triggered the moment the project successfully clears the review process and goes live.

***

{% hint style="info" %}
**Note to Developers:** Providing incorrect info or failing the social verification step will result in a rejected application. Ensure your public verification post is live before submitting the form.
{% endhint %}

***


# Trending System

The uDegen Trending Ladder is the definitive pulse of the ecosystem, showcasing the tokens with the highest organic activity on our platform over the last 24 hours.

***

### 📈 The Trending Ladder

Our leaderboard highlights the projects currently capturing the most attention from the uDegen community. Unlike many "paid" trending lists, the uDegen ladder is **100% organic.**

* **Update Frequency:** The ladder is updated once daily to provide a consolidated view of the day's top performers.
* **Selection Criteria:** Tokens are ranked based on a proprietary algorithm that monitors real-time activity across the uDegen platform.
* **Algorithm Privacy:** To maintain the integrity of the ladder and prevent manipulation, the specific metrics and weightings of our algorithm remain confidential.

***

### 📢 Stay Updated

You can track the trending rankings directly on our platform or via our dedicated social feed:

* **Telegram Channel:** Join [t.me/trendings](https://www.google.com/search?q=https://t.me/trendings) to receive daily updates on the top 10 projects directly in your feed.
* **Alpha Scanner Integration:** As mentioned in the [Alpha Scanner](/udegen/features/markdown), the Top 5 trending tokens are also featured prominently every time you open the scanner.

***

### 🏆 Rewards for Trending

Landing on the Trending Ladder isn't just about visibility; it is a gateway to the uDegen [Revenue Sharing pool](/udegen/the-gateway/revenue-sharing).

* **Points System:** Every day a project maintains a spot in the Top 10, it accumulates points based on its rank.
* **Revenue Split:** At the end of each period (Monthly/Weekly), the top 10 point-earners split **15% of the total platform revenue.**

***


# Score System

The **uDegen Score** is our proprietary rating system designed to give traders an instant, data-driven snapshot of any project's health and potential. Instead of manually digging through multiple explorers, the uDegen Score aggregates complex data points into a single, easy-to-understand number.

***

### 📊 How the Score is Calculated

Our algorithm analyzes hundreds of data points in real-time. While the exact weighting is proprietary to prevent manipulation, the score is primarily determined by the following core factors:

**On-Chain Metrics**

* **Holders:** Evaluation of holder concentration and "smart money" accumulation.
* **Liquidity:** Assessment of liquidity depth, pair stability, and lock status.
* **Volume:** Analysis of organic trading volume vs. bot activity.
* **Market Cap:** Valuation relative to the project's current growth stage.

**Security & Safety**

* **Contract Audit:** Automated checks for honeypots, high taxes, and mint functions.
* **Security Score:** A dedicated sub-metric focusing on the safety of the smart contract code.

**Market Dynamics**

* **Social Sentiment:** Real-time monitoring of community engagement and "hype" levels across social platforms.
* **Price Action:** Analysis of recent price trends (increases or decreases) to detect momentum or overextension.

**uDegen Verification**

* **Verified Status:** Projects that have undergone manual review by the uDegen Team receive a significant scoring boost. This indicates a higher level of trust and transparency.

***

### 💡 What the Score Tells You

* **High Score (80-100):** Indicates a project with strong fundamentals, high community engagement, and verified security.
* **Medium Score (50-79):** A project with potential but perhaps lacking in one area, such as liquidity depth or long-term holder growth.
* **Low Score (<50):** Proceed with extreme caution. This often flags projects with high-risk contract functions or inorganic "wash" trading.

***

{% hint style="info" %}
**Disclaimer:** The uDegen Score is a tool for research and information purposes only. It is not financial advice. Always perform your own due diligence (DYOR) before investing in any crypto asset.
{% endhint %}

***


# Binance Alpha Listings

Stay ahead of the curve with the Binance Alpha Listings tracker. This specialized ladder is designed to monitor and display the newest tokens entering the Binance ecosystem, specifically focusing on early-stage listings and "Alpha" opportunities.

***

### ⚡ What is Binance Alpha?

In the world of Tier-1 exchanges, speed is everything. The Binance Alpha Listings page tracks tokens as they are added to Binance’s high-growth categories (such as the Seed Tag or Monitoring Tag sections). These tokens often represent the highest volatility and potential within the Binance ecosystem.

#### Key Features

* **Real-Time Tracking:** Be the first to know when a new contract is identified and indexed by our system.
* **Instant Analysis:** Every listing is linked directly to our Alpha Scanner, allowing you to check liquidity, holder data, and contract safety immediately.
* **Filter by Chain:** Easily distinguish between BSC, ETH, and other chain deployments for new Binance-bound projects.

***

### 🔍 Why Follow This Ladder?

Binance listings are often a major catalyst for price action and liquidity. By using this tracker, you can:

* **Identify Momentum:** Spot which tokens are transitioning from DEXs to the world’s largest CEX.
* **Strategic Entry:** Use the uDegen data insights to decide if a new listing has the "legs" for a long-term run or is a short-term volatility play.
* **Unified Data:** No need to refresh multiple tabs; get the listing info, the contract address, and the uAI research brief all in one place.

***


# uDegen Score API

The **uDegen API** allows developers, third-party dashboards, and bots to integrate our proprietary scoring data and latest verifications into their own platforms. Our public endpoints provide a streamlined way to access real-time intelligence across all supported networks.

***

### GET /api/coins/score

This is a public, read-only endpoint that returns the total score for every coin currently indexed in the uDegen database.

#### Request Details

* **Method:** `GET`
* **Authentication:** None required.
* **Query Parameters:** None.
* **Caching:** Results are cached in **Redis** for **1 hour** (`TTL: 3600s`).

#### Example Request

```
Bash
```

```
curl https://udegen.io/api/coins/score
```

***

#### Response Schema

**200 OK**

Returns a list of all coin scores. A `totalScore` of `null` indicates the coin has been indexed but has not yet completed the scoring process.

```
JSON
```

```
{
  "success": true,
  "data": [
    {
      "network": "ethereum",
      "address": "0xAbC123...def",
      "totalScore": 87.5
    },
    {
      "network": "solana",
      "address": "So1Ana...",
      "totalScore": null
    }
  ]
}
```

**500 Internal Server Error**

Returned if a server-side error occurs during data retrieval.

```
JSON
```

```
{
  "success": false,
  "error": "Internal Server Error"
}
```

***

#### Use Cases

1. **Leaderboards:** Fetch the dataset and sort client-side by `totalScore` to render a ranked list of top-performing projects.
2. **Portfolio Overlays:** Cross-reference a user's holdings (via `network` + `address`) to display uDegen Scores directly inside a wallet UI.
3. **External Bots:** Telegram or Discord bots can poll this endpoint hourly to alert communities of score changes or new high-score listings.

***

#### Example Integration (TypeScript)

```
TypeScript
```

```
type CoinScore = {
  network: string;
  address: string;
  totalScore: number | null;
};

type ScoreResponse =
  | { success: true; data: CoinScore[] }
  | { success: false; error: string };

async function fetchCoinScores(): Promise<CoinScore[]> {
  const res = await fetch("https://udegen.io/api/coins/score");
  const json: ScoreResponse = await res.json();

  if (!json.success) throw new Error(json.error);

  return json.data;
}
```

***

#### Technical Implementation Notes

* **Data Integrity:** All responses are validated against a Zod discriminatedUnion schema server-side, ensuring consumers receive strictly typed data.
* **Performance:** To ensure maximum speed, the first request after cache expiry repopulates Redis. We recommend that high-frequency integrators respect the 1-hour TTL to avoid unnecessary load.
* **Response Size:** This endpoint currently returns *all* scored coins in a single payload. As our database expands, pagination or filtering parameters may be introduced to maintain performance.

***


# uDegen Verified Tokens API

The **Verified Tokens API** provides a complete directory of projects that have passed the uDegen organic review process. This endpoint is designed for developers who need accurate project metadata, branding, and social links to build integrated directories or portfolio tools.

***

### GET /api/coins

This public, read-only endpoint returns all projects currently marked as `isVerifiedProject === true`. It excludes all unreviewed or unverified assets to ensure data quality.

#### Request Details

* **Method:** `GET`
* **Authentication:** None.
* **Query Parameters:** None.
* **Caching:** Results are cached in Redis for 1 hour (`TTL: 3600s`).

#### Example Request

```
Bash
```

```
curl https://udegen.io/api/coins
```

***

### Response Schema

#### 200 OK

Returns an array of verified project objects.

```
JSON
```

```
{
  "success": true,
  "data": [
    {
      "network": "ethereum",
      "address": "0xAbC123...def",
      "name": "SomeToken",
      "symbol": "STK",
      "logo": "https://example.com/logo.png",
      "urls": {
        "website": "https://sometoken.io",
        "twitter": "https://twitter.com/sometoken",
        "telegram": "https://t.me/sometoken"
      }
    },
    {
      "network": "solana",
      "address": "So1Ana...",
      "name": "AnotherCoin",
      "symbol": "ANC",
      "logo": null
    }
  ]
}
```

#### Data Details

* `logo`: Returns a `string` URL or `null` if no branding is available.
* `urls`: This object is omitted if no social links exist. If present, it contains only valid, non-empty URLs.
* **Supported URL Keys:** `website`, `telegram`, `twitter`, `discord`, `facebook`, `instagram`, `reddit`, `tiktok`, `github`.

***

### Use Cases

1. **Project Directories:** Fetch the dataset to render a browsable catalog of uDegen-verified assets with full branding and social links.
2. **Instant Search:** Load the dataset client-side to enable per-keystroke filtering and autocomplete without repeated API latency.
3. **Portfolio Enrichment:** Match user wallet addresses against our list to display rich metadata (logos, names) for verified holdings.
4. **Community Bots:** Integration for Telegram/Discord bots to display social links for verified projects upon user command.

***

### Example Integration (TypeScript)

```
TypeScript
```

```
type CoinUrls = Partial<{
  website: string; telegram: string; twitter: string;
  discord: string; facebook: string; instagram: string;
  reddit: string; tiktok: string; github: string;
}>;

type Coin = {
  network: string;
  address: string;
  name: string;
  symbol: string;
  logo: string | null;
  urls?: CoinUrls;
};

type CoinsResponse =
  | { success: true; data: Coin[] }
  | { success: false; error: string; };

async function fetchListedCoins(): Promise<Coin[]> {
  const res = await fetch("https://udegen.io/api/coins");
  const json: CoinsResponse = await res.json();

  if (!json.success) throw new Error(json.error);

  return json.data;
}
```

***

#### Technical Implementation Notes

* **Clean URL Data:** Our backend uses a Zod transform to strip out null or empty URL fields. If a key like `twitter` exists in the response, you are guaranteed a valid URL string.
* **Cache Strategy:** The system uses the Redis key `coins:listed`. The first request after the 1-hour TTL triggers a database repopulation.
* **Payload Considerations:** Currently, this endpoint returns the entire verified dataset. Future versions may include pagination as the list of uDegen-verified projects grows.

***


# Get Support

Need assistance? The uDegen and Utopia teams are here to help. Depending on your needs, you can reach out through our community channels or direct professional support lines.

***

### 📱 Community & Real-Time Support

For quick questions, community insights, or real-time updates, join our primary Telegram hub:

* **Utopia Telegram:** [t.me/utopiabnb](https://www.google.com/search?q=https://t.me/utopiabnb)

{% hint style="info" %}
Best for: General inquiries, community discussions, and ecosystem news.
{% endhint %}

***

### ✉️ Direct Support

For account-specific issues, credit disputes, or partnership inquiries, please contact us via email. To help us resolve your issue faster, please include your Wallet Address and any relevant Transaction Hashes.

#### uDegen Platform Support

* **Email:** <support@udegen.io>

{% hint style="info" %}
Contact for: Alpha Scanner issues, Credit Mechanics, and uAI inquiries.
{% endhint %}

#### Utopia Ecosystem Support

* **Email:** <support@utopiabnb.com>

{% hint style="info" %}
Contact for: $UTOPIA token questions, dApp TVL, and ecosystem-wide concerns.
{% endhint %}

***

{% hint style="warning" %}
**Safety Note:** Our team will never DM you first or ask for your Seed Phrase/Private Keys. Always ensure you are communicating through our official channels.
{% endhint %}

***


# Brand Assets

<p align="center"><strong>uDegen Logo without background</strong></p>

<figure><img src="/files/Iv3tkZ89EiMFdSt2hZDl" alt=""><figcaption></figcaption></figure>

***

<p align="center"><strong>uDegen Logo with background</strong></p>

<figure><img src="/files/5RMNVFUhpPvboeIUKFR8" alt=""><figcaption></figcaption></figure>

***

<p align="center"><strong>uDegen Logo round</strong></p>

<figure><img src="/files/u7oBRD0dBiJ8fATnavo1" alt=""><figcaption></figcaption></figure>

***

<p align="center"><strong>uDegen Banner</strong></p>

<figure><img src="/files/gY6AUtEDpvDWRItlXODC" alt=""><figcaption></figcaption></figure>

***

<p align="center"><strong>Utopia Logo without background</strong></p>

<figure><img src="/files/HOxMjRZA2EFpOvFoUOU9" alt=""><figcaption></figcaption></figure>

***

<p align="center"><strong>Utopia Logo with background</strong></p>

<figure><img src="/files/HfC4gvLwmWsORheAnxHy" alt=""><figcaption></figcaption></figure>

***


# Explore the Utopia

Learn more about the Decentralized Application of Utopia.

Embark on a journey with Utopia. Hire Explorers to seek out the universe and earn daily BNB rewards. Our unique system is fueled by a 2% transaction fee on $UTOPIA, which is directly converted into BNB for the reward pool. The more Explorers you dispatch, the greater your share of the treasure, driving the ecosystem's Total Value Locked (TVL) ever higher as more adventurers join the quest.


# Rewards and Eligibility

Access to the Utopia dApp is granted by holding a minimum of 10,000 $UTOPIA tokens. This enables you to participate in the core exploration mechanic, where you deploy Explorers to earn up to 8% daily rewards in BNB. Your long-term rewards are determined by your strategic choices—scale your earnings by deploying more Explorers and optimizing your search strategy. This sustainable model is powered by a 2% transaction fee, ensuring continuous rewards for all explorers.


# Best Strategy

For optimal long-term growth and protocol sustainability, we recommend the 7-Day Compounding Strategy. This approach involves reinvesting your daily BNB rewards to hire additional Explorers for seven consecutive days, followed by collecting your accumulated rewards on the eighth day. This disciplined method accelerates the growth of your Explorer fleet, maximizes compound returns, and contributes significantly to the overall stability and health of the Utopia ecosystem.


# Referral System

The Utopia protocol integrates an on-chain, one-tier referral mechanism. When you refer new participants, you automatically receive an 8% reward in BNB from both their initial deposit and subsequent withdrawal transactions. This system provides a seamless and trustless way to earn commissions while contributing to ecosystem growth.

{% hint style="success" %}
Rewards are accrued in your total earnings within the dApp and are distributed upon claiming them.
{% endhint %}


# Platform Fee

Utopia applies a 4% platform fee on deposit and reward collection transactions. These fees are strategically reinvested to bolster the ecosystem's Total Value Locked (TVL) and fund marketing initiatives for sustainable growth.\
In contrast, the compounding action carries a 0% fee. This makes the 7-day compounding strategy the most efficient method for maximizing long-term returns, as it allows you to reinvest 100% of your earnings to accelerate the growth of your Explorer fleet.


# Roadmap

{% hint style="success" %}
This roadmap outlines our journey: launching our community, securing vital integrations and listings, renouncing the contract, and cementing Utopia's position among the leading projects.
{% endhint %}

### Phase 1: Genesis Launch

*Objective: Establish a fair and secure foundation, and ignite the core community.*<br>

* Fair Launch of the $UTOPIA token.
* dApp V1 Launch with core exploration and staking mechanics.
* Initial Community Building on Twitter and Telegram.
* Listings on Key Tracking Sites (CoinGecko, CoinMarketCap etc).
* Initial Integrations with DeFi tracking platforms (DeFiLlama, DappRadar) for TVL & metric transparency.

***

### Phase 2: The Great Expansion

*Objective: Achieve full decentralization and expand reach through major exchange listings.*<br>

* Strategic Centralized Exchange (CEX) Listings on top-tier platforms (e.g., Gate.io, MEXC, KuCoin).
* Aggressive Community Growth Campaigns and referral program scaling.
* dApp V2 Upgrade with enhanced UI/UX and additional explorer strategies.
* Smart Contract Migration & 0% Tax Activation to achieve full decentralization.

***

### Phase 3: The AI Awakening

*Objective: Introduce groundbreaking AI utility to become the most user-friendly dApp in the space.*<br>

* Development & Beta Testing of the Utopia AI Companion.
* Official Launch of the Utopia AI Companion, offering users:  \
  ◦ Personalized strategy recommendations for explorers.  \
  ◦ Simplified on-ramping and dApp navigation.  \
  ◦ Market and reward analytics in plain language.
* Partnerships with leading AI and Web3 data platforms.

***

### Phase 4: Dominance & The Metaverse

*Objective: Cement Utopia as a top project and explore new technological frontiers.*<br>

* Break into the Top 500 Projects by fully diluted market capitalization.
* Explore Multi-Chain Expansion to Ethereum, Arbitrum, or Solana to access new user bases.
* Utopia NFT Collection Launch: "Explorer Badges" or "AI Companions" that provide in-dApp benefits.
* Research & Development for the "Utopia Metaverse Gateway," a long-term vision for a fully immersive experience.


# Help Center

<h2 align="center">What can we help you find?</h2>

<p align="center">Browse the topics below or contact us via email to ask anything you need help with.</p>

<p align="center"><a href="https://t.me/UtopiaBNB" class="button primary">Ask on Telegram</a> <a href="mailto:support@utopiabnb.com" class="button secondary">Contact Support</a></p>

<table data-card-size="large" data-view="cards"><thead><tr><th align="center"></th><th align="center"></th><th align="center"></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td align="center"><h4><i class="fa-leaf">:leaf:</i></h4></td><td align="center"><strong>Getting started</strong></td><td align="center">Get help with the basics</td><td><a href="https://utopiabnb.com/">https://utopiabnb.com/</a></td></tr><tr><td align="center"><h4><i class="fa-money-bill-wave">:money-bill-wave:</i></h4></td><td align="center"><strong>Explore the dApp</strong></td><td align="center">Start earning BNB</td><td><a href="https://www.utopiabnb.com/dapp">https://www.utopiabnb.com/dapp</a></td></tr><tr><td align="center"><h4><i class="fa-heart">:heart:</i></h4></td><td align="center"><strong>Community</strong></td><td align="center">Join our community</td><td><a href="https://t.me/UtopiaBNB">https://t.me/UtopiaBNB</a></td></tr><tr><td align="center"><h4><i class="fa-bullhorn">:bullhorn:</i></h4></td><td align="center"><strong>Product updates</strong></td><td align="center">See what’s new</td><td><a href="https://x.com/UtopiaBNB">https://x.com/UtopiaBNB</a></td></tr></tbody></table>


