Frequently Asked Questions

CoinTrail is a comprehensive cryptocurrency tracking and portfolio management platform built with Laravel. It features real-time price tracking via CoinGecko API, user portfolios, price alerts, subscription tiers, and a modern admin panel powered by Filament.

CoinTrail requires:

• PHP 8.2 or higher
• MySQL 8.0+ or MariaDB 10.6+
• Required PHP extensions: BCMath, Ctype, cURL, DOM, Fileinfo, GD, JSON, Mbstring, OpenSSL, PDO, PDO MySQL, Tokenizer, XML, Zip
• Apache with mod_rewrite or Nginx
• SSL certificate (required for payment gateways)

See the Requirements page for full details.

Yes, CoinTrail can run on shared hosting that meets the requirements. However, VPS or dedicated hosting is recommended for:

• Better performance with more concurrent users
• Reliable cron job execution
• Full control over PHP configuration
• Ability to run queue workers for background jobs

Yes! CoinTrail includes the complete, unencrypted source code. You have full access to all PHP, JavaScript, CSS, and Blade template files. This allows you to customize and extend the application as needed.

CoinTrail includes a web-based installer:

1. Upload all files to your server
2. Navigate to yoursite.com/install
3. Follow the guided installation wizard
4. Enter your database credentials
5. Verify your Envato purchase code
6. Create your admin account

See the Installation Guide for detailed steps.

Your purchase code is provided by Envato/CodeCanyon:

1. Log in to your CodeCanyon account
2. Go to Downloads
3. Find CoinTrail in your purchases
4. Click "Download" → "License Certificate & Purchase Code"
5. Your purchase code is in the downloaded text file

A 500 error usually indicates a server configuration issue:

1. Check permissions: Ensure storage/ and bootstrap/cache/ have write permissions (755 or 775)
2. Check logs: Look in storage/logs/laravel.log for specific error messages
3. Verify .env: Ensure database credentials are correct
4. Clear cache: Run php artisan config:clear && php artisan cache:clear
5. Check PHP version: Ensure PHP 8.2+ is being used

Yes, CoinTrail can be installed in a subdirectory (e.g., yoursite.com/crypto/). During installation, make sure to:

• Set the correct APP_URL in your .env file
• Point your web server to the public/ directory
• Update any webhook URLs in payment gateway settings

CoinTrail works with the free CoinGecko Demo API, which provides:

• 10,000 API calls per month
• 30 calls per minute rate limit
• No API key required for basic usage

For higher traffic sites, you may want to upgrade to a paid CoinGecko plan. CoinTrail's tiered update system is optimized to work within free tier limits.

Check the following:

1. Cron jobs: Verify cron is configured: * * * * * php /path/artisan schedule:run
2. Admin panel: Check Admin → Settings → Cron Settings for last run times
3. API quota: You may have exceeded CoinGecko's free tier limits
4. Logs: Review storage/logs/laravel.log for API errors
5. Manual test: Run php artisan crypto:update-prices --tier=top --limit=10

CoinTrail uses a tiered update system optimized for API quotas:

• Top 100 coins: Every 5 minutes
• Coins 101-500: Every 15 minutes
• Coins 501-1000: Every 30 minutes
• Remaining coins: Every 60 minutes

You can adjust these intervals in Admin → Settings → API Settings.

CoinTrail supports 20+ payment gateways:

• Card Payments: Stripe, PayPal, Razorpay, Paystack, Mollie
• Cryptocurrency: CoinGate, NOWPayments, Coinbase Commerce
• Manual: Bank Transfer, Custom payment methods

See Payment Gateways for full configuration details.

Yes! CoinTrail integrates with multiple crypto payment processors:

• CoinGate: Bitcoin, Ethereum, Litecoin, and 70+ cryptocurrencies
• NOWPayments: 100+ cryptocurrencies with auto-conversion
• Coinbase Commerce: Major cryptocurrencies with Coinbase integration

Manual payments work as follows:

1. User selects bank transfer at checkout
2. User sees your bank account details
3. User makes payment and uploads proof (receipt/screenshot)
4. Admin reviews the payment in the admin panel
5. Admin approves or rejects the payment
6. User's subscription is activated upon approval

Yes! Portfolio tracking is available for Premium and Pro subscribers:

• Add holdings with purchase price and quantity
• Track profit/loss in real-time
• Record buy/sell transactions
• View portfolio allocation charts
• Export transaction history (Pro tier)

Price alerts notify users when cryptocurrencies reach target prices:

• Set alerts for price going above or below a target
• Receive email notifications when triggered
• Alerts are checked during each price update cycle
• Alert limits by tier: Free (5), Premium (50), Pro (Unlimited)