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

1. Clone the repository:

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

2. Install dependencies:

   bun install

Usage

To start the bot, run:

bun run start

Execution Workflow:

1. Fetches the latest token listings from DexScreener.
2. Filters tokens belonging to Solana and Base chains.
3. Analyzes key token metrics.
4. Conducts security and anomaly checks.
5. 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:

1. Liquidity falls within the $10,000 - $200,000 range.
2. 24-hour trading volume exceeds $500.
3. Price change is positive but does not exceed 2000%.
4. Social Score is ≥ 1, ensuring some level of market presence.
5. Passes RugCheck verification (for Solana tokens).
6. 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.