Skip to content

cleanmind777/Coin-Market

Repository files navigation

Clean Mind - Crypto Monitor Platform

A comprehensive cryptocurrency monitoring platform built with Next.js, TypeScript, and the CoinGecko API. Track market trends, manage your portfolio, and stay updated with real-time crypto data.

🚀 Features

📊 Market Overview

  • Global Market Data - Total market cap, 24h volume, active cryptocurrencies
  • Bitcoin Dominance - Track BTC's market share
  • Real-time Updates - Live data from CoinGecko API

🔥 Trending Coins

  • Top Trending - Discover the most searched and popular cryptocurrencies
  • Score-based Ranking - See which coins are gaining momentum
  • Visual Indicators - Easy-to-read trending metrics

💰 Portfolio Management

  • Track Investments - Add and monitor your crypto holdings
  • P&L Calculation - Real-time profit/loss tracking
  • Performance Analytics - Detailed portfolio performance metrics
  • Cost Basis Tracking - Monitor your entry prices

⭐ Watchlist

  • Favorite Coins - Keep track of cryptocurrencies you're interested in
  • Quick Access - Fast access to your most-watched coins
  • Price Alerts - Stay updated on price movements

📈 Market Analysis

  • Top Cryptocurrencies - Comprehensive list of all major cryptos
  • Advanced Filtering - Sort by market cap, price, volume, or 24h change
  • Search Functionality - Find any cryptocurrency quickly
  • Real-time Data - Live price updates and market metrics

🛠️ Technology Stack

  • Frontend: Next.js 14, React 18, TypeScript
  • Styling: Tailwind CSS, Radix UI components
  • Charts: Recharts for data visualization
  • API: CoinGecko API v3
  • Icons: Lucide React
  • State Management: React hooks and local state

🚀 Getting Started

Prerequisites

  • Node.js 18+
  • npm or yarn

Installation

  1. Clone the repository:
git clone <repository-url>
cd clean-mind-crypto
  1. Install dependencies:
npm install
  1. Start the development server:
npm run dev
  1. Open http://localhost:3000 in your browser

📱 Pages & Features

Dashboard (/)

  • Market overview with global statistics
  • Trending cryptocurrencies
  • Top cryptocurrencies by market cap
  • Real-time data refresh

Markets (/markets)

  • Complete list of cryptocurrencies
  • Advanced search and filtering
  • Sort by various metrics
  • Detailed market data

Portfolio (/portfolio)

  • Add and manage crypto investments
  • Real-time P&L tracking
  • Portfolio performance analytics
  • Cost basis management

Watchlist (/watchlist)

  • Track favorite cryptocurrencies
  • Quick access to important coins
  • Search within watchlist
  • Easy add/remove functionality

🔧 API Integration

The platform uses the CoinGecko API v3 for all cryptocurrency data:

  • Global Market Data - Market cap, volume, and dominance metrics
  • Coin Listings - Comprehensive cryptocurrency information
  • Price Data - Real-time and historical price information
  • Trending Data - Popular and trending cryptocurrencies
  • Market Charts - Historical price and volume data

🎨 UI Components

Built with a modern, clean design using:

  • Radix UI - Accessible component primitives
  • Tailwind CSS - Utility-first styling
  • Custom Components - Reusable UI elements
  • Responsive Design - Mobile-first approach
  • Dark Mode Support - Built-in theme switching

📊 Data Features

  • Real-time Updates - Live cryptocurrency data
  • Historical Data - Price charts and historical metrics
  • Market Metrics - Market cap, volume, dominance
  • Performance Tracking - 24h, 7d, 30d price changes
  • Search & Filter - Advanced data filtering capabilities

🔮 Future Enhancements

  • Price alerts and notifications
  • Advanced charting with technical indicators
  • Portfolio analytics and reporting
  • Mobile app development
  • Social features and community
  • Advanced trading tools
  • News integration
  • DeFi protocol tracking

🤝 Contributing

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Commit your changes (git commit -m 'Add some amazing feature')
  4. Push to the branch (git push origin feature/amazing-feature)
  5. Open a Pull Request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

📞 Support

If you have any questions or need help, please open an issue on GitHub or contact the development team.


Clean Mind Crypto Monitor - Track, Analyze, and Manage Your Cryptocurrency Investments with Confidence.

About

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published