N3X_DOCS.md
$ Introduction
N3X is a real-time monitoring and analytics dashboard for Solana tokens powered by Birdeye API. It provides comprehensive token analysis, risk assessment, and market intelligence.
⚠️ DISCLAIMER
This tool is for informational and research purposes only. Not financial advice. Always do your own research before making investment decisions.
What is N3X?
N3X is an informational tool designed to help traders monitor new token launches and analyze their characteristics before making trading decisions. It provides:
- Real-time token price monitoring
- Liquidity and volume analytics
- Automated risk assessment
- Market trend analysis
- Direct trading integration
$ Getting Started
Quick Start
Start using N3X in three simple steps:
bash
# 1. Visit the scanner
https://your-n3x-scanner.vercel.app
# 2. Choose your filter
- Trending: Top tokens by rank
- New Listings: Recently created tokens
- Top Gainers: Best performing tokens
# 3. Click to interact
- Click Card → View on DexScreener
- Click Trade → Swap on JupiterUnderstanding the Interface
The N3X interface is designed for quick decision-making:
Token Cards
Real-time data in card format
Filter Tabs
Switch between token categories
Quick Actions
One-click trading and analysis
Risk Badges
Instant safety indicators
$ Features
Core Features
$ Token Analysis
Understanding Token Cards
Each token card displays crucial information:
| Field | Description | Format |
|---|---|---|
| Token Name | Token symbol and identifier | $SYMBOL |
| 24h Change | Price change over last 24 hours | +12.5% / -8.3% |
| Current Price | Real-time token price | $0.000123 |
| Liquidity | Total liquidity available | $123.4K |
| Volume 24h | Trading volume in last 24 hours | $1.5M |
| Market Cap | Total market capitalization | $5.2M |
| Status Badge | Automated risk assessment | SAFE / CAUTION / RISKY |
Price Formatting
N3X automatically formats prices based on their value:
javascript
// Very small values (< 0.000001)
formatPrice(0.00000012) → "$1.2e-7"
// Small values (< $0.01)
formatPrice(0.000123) → "$0.000123"
// Medium values (< $1)
formatPrice(0.1234) → "$0.1234"
// Large values (>= $1)
formatPrice(123.456) → "$123.46"$ Risk Levels
Risk Assessment System
N3X uses liquidity as the primary risk indicator:
SAFE
Liquidity > $50,000
Higher liquidity provides better price stability and lower slippage. Generally safer for trading.
CAUTION
$10,000 - $50,000
Moderate liquidity. Proceed with caution. May experience higher volatility and slippage.
RISKY
Liquidity < $10,000
Low liquidity increases risk significantly. High slippage and volatility expected. Extreme caution advised.
⚡ IMPORTANT
Risk levels are automated indicators based solely on liquidity. They do not account for other factors like smart contract security, tokenomics, or market manipulation. Always conduct thorough research.
$ API Reference
Birdeye API Integration
N3X uses Birdeye API for real-time Solana token data:
Endpoints Used
GET
/api/birdeye?endpoint=trending
Fetch trending tokens sorted by rank
Response:
{
"success": true,
"data": {
"tokens": [
{
"address": "EPjFWdd5...",
"symbol": "USDC",
"price": 1.00,
"priceChange24h": 0.02,
"liquidity": 15000000,
"volume24h": 50000000,
"mc": 25000000000
}
]
}
}GET
/api/birdeye?endpoint=new
Fetch newly created tokens
GET
/api/birdeye?endpoint=price&address=TOKEN_ADDRESS
Get specific token price data
Rate Limiting
📊 API Limits
- Rate Limit: 60 requests per minute
- Update Interval: 30 seconds
- Cache Strategy: Local cache with 30s refresh
$ FAQ
Frequently Asked Questions
How often does the data update?
Token data updates automatically every 30 seconds. You can also manually refresh by switching between filter tabs.
What does the TRADE button do?
The TRADE button opens Jupiter aggregator with the selected token pre-filled, allowing you to swap tokens directly.
How is the risk level determined?
Risk levels are based on liquidity: SAFE (>$50K), CAUTION ($10K-$50K), RISKY (<$10K). This is an automated indicator and should not be the sole factor in your decision.
Why are some tokens missing data?
Some newly created tokens may not have complete data immediately available. The API may return partial information which is displayed as available.
Can I use N3X for trading advice?
No. N3X is an informational tool only. It does not provide financial advice. Always conduct your own research and consult with financial professionals before making investment decisions.
Is my API key secure?
Yes. The Birdeye API key is stored securely in Vercel serverless functions and is never exposed to the client browser.
$ Changelog
Version History
v1.3.0
2026-01-29
Current
✨ Added
- Modern card grid layout
- Filter tabs (Trending/New/Top Gainers)
- Rich card design with hover effects
- Dual click actions (card + trade button)
- Professional styling inspired by DexScreener
- Entrance animations and smooth transitions
🔄 Changed
- Replaced terminal-style list with card grid
- Improved responsive design (1-4 columns)
- Enhanced visual hierarchy
v1.2.0
2026-01-28
✨ Added
- Direct links to DexScreener
- One-click token interaction
🗑️ Removed
- Modal dialog system (simplified UX)
v1.1.0
2026-01-27
✨ Added
- Interactive token modal with detailed information
- Links to DexScreener, Birdeye, Jupiter, and Raydium
- Copy contract address functionality
v1.0.0
2026-01-26
🎉 Initial Release
- Real-time token monitoring
- Birdeye API integration
- Terminal-style interface
- Risk assessment badges
- Animated background effects
- Custom cursor system