Overview
The DexScreenerClient is a powerful Python tool designed for analyzing and managing cryptocurrency pair data across multiple blockchains. Whether you're a trader, developer, or blockchain enthusiast, this tool provides actionable insights into trending, top-gaining, and newly listed pairs with seamless integration capabilities.
Key Features
- Multi-Chain Support: Compatible with major blockchains like Solana, BSC, and more (default: Solana).
- Real-Time Data Analysis: Fetch and analyze live pair metrics for informed decision-making.
- Custom File Generation: Export data as CSV or JSON for offline analysis.
- Data Visualization: Print clean data frames for at-a-glance insights.
- Supabase Integration: Centralize data management by storing results directly in Supabase.
👉 Explore advanced crypto tools here
Installation & Dependencies
- Python 3.8+: Ensure Python is installed.
Required Libraries:
pip install pandas requests supabase
How It Works
Core Function: i_am_the_watcher_free_version
This function orchestrates data retrieval and processing. Configure it to match your workflow:
Parameters:
| Parameter | Type | Description | Default |
|-----------|------|-------------|---------|
| chain | str | Target blockchain (e.g., "solana", "bsc") | "solana" |
| shouldGenerateFiles | bool | Generates output files if True | True |
| shouldPrintDataFrames | bool | Prints data frames for visualization | False |
| shouldAddToSupabase | bool | Sends data to Supabase | False |
Example:
i_am_the_watcher_free_version(
chain="bsc",
shouldPrintDataFrames=True,
shouldAddToSupabase=False
)Module Breakdown
Data Retrieval Modules:
get_trending_pairs: Identifies high-momentum pairs.get_top_gaining_pairs: Highlights assets with rapid price appreciation.get_newest_pairs: Tracks freshly listed tokens.
Data Processing:
create_data_frame: Structures raw API data into pandas DataFrames.data_frames_array_print: Labels and displays DataFrame arrays.
Output Modules:
generate_files: Exports data to CSV/JSON.pairs_loop: Handles Supabase batch inserts.
👉 Discover more blockchain analysis tools
Step-by-Step Guide
Clone the Repository:
git clone https://github.com/liqtags/DexScreenerClient.gitConfigure Settings:
- Update
consts.pywith your Supabase credentials (if used).
- Update
Run the Tool:
python main.py --chain solana --generate-files
FAQs
1. Which blockchains are supported?
The tool currently supports Solana, BSC, Ethereum, and others. Specify the chain via the chain parameter.
2. How do I disable file generation?
Set shouldGenerateFiles=False in the function call.
3. Can I use this for real-time trading signals?
While it provides trend data, always cross-validate with other tools before trading.
4. Is Supabase mandatory?
No—it’s optional. Set shouldAddToSupabase=False to skip integration.
5. How frequently should I run the script?
For active trading, run hourly. For research, daily updates suffice.
Best Practices
- Keyword Optimization: Focus on terms like crypto pairs, Solana analysis, and trending tokens for SEO.
- Data Hygiene: Regularly clear outdated files or database entries.
This guide ensures you harness the DexScreenerClient’s full potential—whether for trading, research, or blockchain analytics.