FAQ

General Questions

What is Alert Lions?

Alert Lions is a comprehensive platform for monitoring, analyzing, and tracking cryptocurrency tokens across multiple blockchain networks. We provide real-time detection, risk assessment, security analysis, and alerting capabilities.

Which blockchains are supported?

We support:

  • Ethereum (Mainnet)

  • Binance Smart Chain (BSC)

  • Polygon

  • Arbitrum

  • Base

  • Solana (soon for Pro plan)

Note: Solana support is coming soon but currently hidden from the interface.

How do you detect new tokens?

We monitor blockchain transactions in real-time using advanced indexing technology. When a new token contract is deployed, we automatically detect it, analyze its contract code, and add it to our database.

How often is token data updated?

  • Real-time: New token detections, price changes, liquidity updates

  • Every 60 seconds: DexScreener data (liquidity, price) auto-refreshes

  • Manual refresh: Available with 10-second cooldown


Account & Subscription Questions

How do I create an account?

  1. Visit our website

  2. Click "Sign Up"

  3. Enter your email address

  4. Verify your email

  5. Complete your profile

Can I try before purchasing?

Yes! We offer a Free plan with limited features. You can also start with a 7-day trial of Basic or Pro plans (if available).

What payment methods do you accept?

We accept all major credit cards and debit cards through Stripe.

How do I upgrade my plan?

  1. Go to Settings → Subscription

  2. Click "Upgrade Plan"

  3. Select your desired plan

  4. Complete the checkout process

  5. Your plan will be activated immediately

How do I cancel my subscription?

  1. Go to Settings → Subscription

  2. Click "Manage Billing" or "Cancel Subscription"

  3. Follow the prompts in Stripe billing portal

  4. Your subscription will remain active until the end of your billing period

Can I get a refund?

Refund policies depend on your subscription plan. Contact support at [email protected] for refund requests.

What happens if I don't pay?

If payment fails:

  1. You'll receive an email notification

  2. Your account will be downgraded to Free plan after 3 days

  3. You'll lose access to paid features

  4. Your data (watchlist, preferences) will be preserved for 30 days


Feature Questions

What is Risk Score?

Risk Score is a numerical value (0-100) indicating how safe a token is:

  • 0-30: Low risk (Safe/Low)

  • 31-60: Medium risk

  • 61-90: High risk

  • 91-100: Critical risk or honeypot

Important: Lower scores mean safer tokens. A score of 0 is the safest, while 100 indicates a honeypot or scam.

How is Risk Score calculated?

Our algorithm analyzes multiple factors:

  • Contract code security

  • Ownership status (renounced = safer)

  • Liquidity locks

  • Mint function presence

  • Blacklist/pause capabilities

  • Trading restrictions

  • Creator reputation

  • Historical scam patterns

Why can't I see Risk Score on Free plan?

Risk Score is a premium feature to encourage upgrades. Free users can see tokens but not their risk assessment.

What is Initial Liquidity vs Current Liquidity?

  • Initial Liquidity: The liquidity amount when the token was first created (stored in our database)

  • Current Liquidity: Real-time liquidity from DexScreener (updates every 60 seconds)

Both values help you understand:

  • Whether liquidity was added at launch

  • If liquidity has increased or decreased

  • Potential rug pull risks (liquidity removed)

How does the Watchlist work?

The Watchlist lets you track your favorite tokens:

  1. Navigate to any token detail page

  2. Click "Add to Watchlist"

  3. Token appears in your Watchlist

  4. Receive updates when tokens change

Limitations:

  • Free users: Not available

  • Basic+ users: Unlimited capacity

What are WebSocket updates?

WebSocket provides real-time notifications without page refresh:

  • Token Created: New token detected

  • Token Updated: Price/liquidity/risk changed

  • Alerts: Security or market warnings

Available for: Basic and Pro users only

Connection Limits:

  • Basic: 1 connection

  • Pro: 10 connections

What is Creator Reputation?

Creator Reputation analyzes token creators' history:

  • Total tokens created: Number of launches

  • Success rate: Percentage of successful tokens

  • Scam rate: Percentage of scam tokens

  • Overall score: 0-100 reputation rating

Use cases:

  • Identify repeat scammers

  • Find trustworthy creators

  • Track creator trends


Technical Questions

Do I need to install anything?

No! Alert Lions is a web-based platform. Just visit our website in any modern browser.

Which browsers are supported?

  • Chrome (recommended)

  • Firefox

  • Safari

  • Edge

  • Opera

Note: We recommend using the latest browser version for best performance.

Do you have a mobile app?

Not yet, but our website is fully responsive and works great on mobile browsers. We're planning mobile apps for iOS and Android in the future.

Can I use the API?

Yes, but only for Pro users. Our API provides programmatic access to:

  • Token data

  • Creator information

  • Watchlist management

Rate Limit: 1,000 requests per day

How do I get API access?

  1. Upgrade to Pro plan

  2. Go to Settings → API Keys

  3. Generate an API key

  4. Use the key in your API requests

Documentation: Available in the API section of Settings

What is the API rate limit?

  • Pro Plan: 1,000 requests per day

  • Resets at midnight UTC

  • Exceeding limit returns 429 status code

How secure is my data?

We take security seriously:

  • ✅ Encrypted connections (HTTPS)

  • ✅ Secure authentication (JWT tokens)

  • ✅ No storage of sensitive financial data

  • ✅ Regular security audits

  • ✅ GDPR compliant

Do you store my wallet addresses?

We only store wallet addresses you explicitly provide (watchlist, API usage). We never scan or monitor your wallet activity without permission.


Troubleshooting Questions

Why can't I see some features?

Features are locked based on your plan:

  • Free: Limited to basic viewing

  • Basic: Risk scores, watchlist, creator page

  • Pro: Full access including history, raw data, API

Check your plan in Settings → Subscription.

The dashboard is loading slowly

Try these solutions:

  1. Refresh the page: Clear cache (Ctrl+Shift+R or Cmd+Shift+R)

  2. Check internet connection: Ensure stable connection

  3. Reduce filters: Too many filters can slow down loading

  4. Clear browser cache: Sometimes cached data causes issues

Token data is not updating

  • Initial Liquidity: Updates when we scan the blockchain (may take time)

  • Current Liquidity: Auto-updates every 60 seconds from DexScreener

  • Manual Refresh: Click refresh button (10-second cooldown)

If data still doesn't update:

  1. Check if token has liquidity on DexScreener

  2. Verify token address is correct

  3. Contact support if issue persists

WebSocket is not connecting

For Basic and Pro users:

  1. Check your plan status (must be Basic or Pro)

  2. Refresh the page

  3. Check browser console for errors

  4. Ensure no ad blockers are blocking WebSocket

Connection Limits:

  • If you see "Connection limit exceeded", close other tabs/windows

  • Pro users: Max 10 concurrent connections

I can't add tokens to watchlist

Possible reasons:

  1. Free plan: Watchlist is not available on Free plan

  2. Already in watchlist: Token is already tracked

  3. Server error: Try again in a few moments

Solution: Upgrade to Basic+ for watchlist access.

Risk Score shows as locked

For Free users: Risk score is intentionally locked. Upgrade to Basic+ to view risk scores.

For Basic+ users: If risk score is still locked:

  1. Token may not have been analyzed yet

  2. Wait a few minutes for analysis to complete

  3. Contact support if issue persists

How do I contact support?

Email: [email protected]

Response Times:

  • Free users: 48-72 hours

  • Basic users: 24-48 hours

  • Pro users: 12-24 hours (priority support)

Support Topics:

  • Technical issues

  • Billing questions

  • Feature requests

  • Bug reports

  • Account issues


Billing & Payment Questions

When is my subscription billed?

  • Monthly plans: Billed on the same date each month

  • Annual plans: Billed on the same date each year

  • You'll receive email reminders before billing

Can I change my billing cycle?

Yes! Contact support to change from monthly to annual (or vice versa).

What happens after my trial ends?

  • You'll receive email notifications 3 days and 1 day before trial ends

  • After trial: Account downgrades to Free plan

  • Your data is preserved for 30 days

I was charged twice

This is rare but can happen:

  1. Check your Stripe billing portal

  2. Contact support with transaction IDs

  3. We'll issue a refund for duplicate charges

Can I get an invoice?

Yes! All invoices are available in:

  • Settings → Subscription → Billing Portal

  • Email confirmations after each payment


Security & Privacy Questions

Is my email address safe?

Yes! We never share your email with third parties. We only use it for:

  • Account management

  • Important notifications

  • Security alerts

  • Product updates (you can unsubscribe)

Do you track my activity?

We track:

  • Analytics: Page views, feature usage (anonymized)

  • Performance: Error logs, loading times

  • Account: Login times, plan usage

We do NOT track:

  • Your wallet balances

  • Trading activity

  • Personal information beyond what you provide

Can I delete my account?

Yes! Contact support to request account deletion. Note:

  • Account deletion is permanent

  • All data is removed within 30 days

  • No refunds for remaining subscription time

What data do you collect?

We collect:

  • Account info: Email, plan, preferences

  • Usage data: Feature usage, API calls

  • Token data: Public blockchain information (not your wallets)

We do NOT collect:

  • Wallet private keys

  • Trading history

  • Financial information

  • Personal identification beyond email


Troubleshooting

Common Issues and Solutions

Issue: "Cannot read properties of undefined"

Solution: Refresh the page. This usually happens when data is still loading.

Issue: WebSocket constantly reconnecting

Solutions:

  1. Check your internet connection

  2. Close other tabs/windows using WebSocket

  3. Clear browser cache

  4. Disable browser extensions that might interfere

Issue: API returns 401 Unauthorized

Solution:

  1. Check if your API key is valid

  2. Ensure API key is in Authorization header: Bearer YOUR_API_KEY

  3. Verify your Pro plan is active

  4. Check if you've exceeded rate limits

Issue: Watchlist not saving

Solution:

  1. Verify you're on Basic+ plan

  2. Check browser console for errors

  3. Ensure cookies are enabled

  4. Try logging out and back in

Issue: Charts not loading

Solution:

  1. DexScreener charts require internet connection

  2. Check if DexScreener.com is accessible

  3. Disable ad blockers that might block iframes

  4. Try a different browser


API Reference

Authentication

All API requests require authentication:

Authorization: Bearer YOUR_API_KEY

Endpoints

List Tokens

GET /api/tokens?page=1&limit=20&chain_id=56&risk_level=high

Parameters:

  • page (optional): Page number (default: 1)

  • limit (optional): Items per page (default: 20, max: 100)

  • chain_id (optional): Filter by chain (1=Ethereum, 56=BSC, etc.)

  • risk_level (optional): Filter by risk (low, medium, high, honeypot)

  • has_liquidity (optional): true/false

  • is_actively_traded (optional): true/false

  • q (optional): Search query

Response:

{
  "items": [...],
  "total": 1000,
  "page": 1,
  "limit": 20
}

Get Token Details

GET /api/tokens/{address}?chain_id=56

Response:

{
  "contract_address": "0x...",
  "chain_id": 56,
  "current_risk_score": 45,
  "current_risk_level": "medium",
  "current_liquidity_usd": 125000,
  ...
}

List Creators

GET /api/creators?page=1&limit=20

Get Creator Details

GET /api/creators/{address}

Get Watchlist

GET /api/watchlist

Add to Watchlist

POST /api/watchlist
Body: { "address": "0x...", "chain_id": 56 }

Remove from Watchlist

DELETE /api/watchlist/{address}?chain_id=56

Error Responses

401 Unauthorized

{
  "error": "Unauthorized. Please log in again."
}

429 Too Many Requests

{
  "error": "Rate limit exceeded. Please try again later."
}

404 Not Found

{
  "error": "Token not found"
}

Best Practices

For Traders

  1. Use Risk Scores Wisely

    • Don't rely solely on risk scores

    • Combine with your own research

    • Check creator reputation

    • Verify liquidity trends

  2. Monitor Creator History

    • Check creator's previous tokens

    • Look for patterns (scam rate, success rate)

    • Track creators with good reputation

  3. Set Up Alerts

    • Enable email alerts for important events

    • Use watchlist for tokens you're monitoring

    • Check alerts daily

  4. Use Filters Effectively

    • Filter by risk level appropriate for your strategy

    • Only show tokens with liquidity

    • Focus on actively traded tokens

For Developers

  1. API Rate Limits

    • Stay within 1,000 requests/day

    • Implement caching for frequently accessed data

    • Use WebSocket for real-time updates instead of polling

  2. Error Handling

    • Always handle 401 (authentication) errors

    • Implement retry logic for 429 (rate limit) errors

    • Cache data to reduce API calls

  3. WebSocket Best Practices

    • Reconnect on disconnection

    • Handle connection limit errors gracefully

    • Don't open multiple connections unnecessarily

For Researchers

  1. Creator Analysis

    • Track multiple tokens per creator

    • Analyze success patterns

    • Compare creator performance across chains

  2. Historical Data

    • Use Pro plan for historical analysis

    • Export data for deeper analysis

    • Track trends over time


Glossary

  • Chain: A blockchain network (Ethereum, BSC, etc.)

  • Liquidity: Amount of tokens available for trading

  • Risk Score: Numerical safety indicator (0-100, lower = safer)

  • Honeypot: A token that looks tradeable but isn't (scam)

  • Rug Pull: When creators remove liquidity and steal funds

  • Creator: The wallet address that deployed a token

  • Pair: A trading pair (e.g., TOKEN/WBNB)

  • DEX: Decentralized Exchange (PancakeSwap, Uniswap, etc.)


Support & Contact

Email Support

[email protected]

Response Times

  • Free users: 48-72 hours

  • Basic users: 24-48 hours

  • Pro users: 12-24 hours (priority)

Last updated