DexScreener Analysis Bot

A robust TypeScript-based bot designed to analyze newly listed and boosted tokens on DexScreener, identifying potential trading opportunities based on comprehensive metrics and rigorous safety checks.

Features

• Real-time Monitoring: Tracks the latest token listings on the Solana and Base chains.
• Advanced Token Analysis:

- Evaluates liquidity within a range of $10,000 - $200,000. - Analyzes trading volume, ensuring a minimum of $500. - Assesses price movements and trends. - Reviews social media presence for legitimacy.

• Security & Safety Checks:

- Integrates RugCheck for Solana tokens. - Detects suspicious activities such as liquidity manipulation and volume anomalies. - Identifies unnatural transaction patterns.

• Data Storage & Reporting:

- Saves identified high-potential tokens in a structured JSON format. - Provides color-coded console logs for improved readability.

Prerequisites

Ensure the following are installed and configured before running the bot:

• Bun runtime
• Stable internet connection for API interactions

Installation

• Clone the repository:

git clone https://github.com/Immutal0/dexscreener-analysis-bot-meme.git
   cd dexscreener-analysis-bot-meme

• Install dependencies:

bun install

Usage

To start the bot, run:

bun run start

Execution Workflow:

• Fetches the latest token listings from DexScreener.
• Filters tokens belonging to Solana and Base chains.
• Analyzes key token metrics.
• Conducts security and anomaly checks.
• Saves eligible tokens to data/interesting_tokens.json.

Configuration

Current filter and analysis thresholds:

• Liquidity: $10,000 - $200,000
• Minimum Trading Volume: $500
• Price Movement: Between 0% and 2000%
• Minimum Social Score: 1 (indicating social media presence)
• Suspicious Activity Detection:

- Liquidity-to-volume ratio < 0.1 - High trading volume with an abnormally low number of transactions - One-sided trading behavior - Extreme price fluctuations

Token Evaluation Criteria

A token is flagged as promising if it meets all the following conditions:

• Liquidity falls within the $10,000 - $200,000 range.
• 24-hour trading volume exceeds $500.
• Price change is positive but does not exceed 2000%.
• Social Score is ≥ 1, ensuring some level of market presence.
• Passes RugCheck verification (for Solana tokens).
• Exhibits no suspicious trading patterns.

Output & Logging

• Console Logs: Provides real-time insights with colored output for easy readability.
• Alerts & Warnings: Highlights potential trading opportunities and risks.
• JSON Storage: Saves high-potential tokens in data/interesting_tokens.json.

Dependencies

The bot relies on the following key dependencies:

• axios: For API requests
• axios-retry: To handle request failures with retry logic
• chalk: For enhanced console output formatting
• dotenv: For managing environment configurations

Project Structure

src/
├── analyzers/
│   └── tokenAnalyzer.ts    # Token analysis logic
├── services/
│   ├── dexscreener.ts      # DexScreener API integration
│   └── rugcheck.ts         # RugCheck API integration
├── storage/
│   └── tokenStorage.ts     # Token data management
├── types/
│   └── types.ts           # TypeScript type definitions
└── index.ts               # Main application entry point

Error Handling

• API failures are logged and retried automatically.
• Network issues are detected, triggering retry mechanisms.
• Invalid or corrupted data is filtered out before analysis.
• Critical errors gracefully terminate the process to prevent inconsistent results.