8000 GitHub - oxnr/picotop
[go: up one dir, main page]
More Web Proxy on the site http://driver.im/
Skip to content

oxnr/picotop

Repository files navigation

Picojeet

A sophisticated Bitcoin cycle prediction platform that delivers actionable trading signals through advanced on-chain analytics and real-time market intelligence.

๐ŸŽฏ Overview

Picojeet is an advanced Bitcoin cycle analysis platform that combines multiple data sources and proprietary algorithms to predict market cycles with precision. The platform features real-time market analysis, historical pattern recognition, and innovative correlation studies between crypto app rankings and market psychology.

Current Prediction: Bitcoin Cycle Top at $176K in 3-6 months

๐Ÿš€ Key Features

๐Ÿ”ฎ Advanced Cycle Prediction Engine

Mathematical Model: Our proprietary algorithm analyzes historical data, cycle patterns, and volatility factors to predict the next Bitcoin cycle top with high confidence.

Current Prediction: $176K target based on:

  • Current price: $108,700
  • Enhanced growth factor: 1.63 (63% mid-bull cycle expectation)
  • Cycle analysis: 3-6 months to peak timing (Mid Bull phase)
  • Historical pattern matching: 2017-2018 and 2020-2021 cycle comparisons
  • Adjusted thresholds: Extended Mid Bull phase for more accurate timing

Prediction Formula

Predicted Peak = Current Price ร— Dynamic Growth Factor ร— Cycle Multiplier ร— Volatility Dampener

Where:
- Current Price = $108,700 (real-time)
- Dynamic Growth Factor = 1.63 (enhanced 63% mid-bull cycle expectation)
- Cycle Multiplier = f(months_to_peak, phase_progression, historical_patterns)
- Volatility Dampener = sin(cycle_position) ร— volatility_constant
- Peak Timing = 3-6 months from current (Mid Bull phase analysis)
- Phase Threshold = Extended to <75 for sustained Mid Bull positioning

Result: $176K predicted cycle top (170-180K target range)

How It Works

  1. Historical Data Analysis: Uses monthly high values from CoinMarketCap (2013-2025)
  2. Pattern Recognition: Identifies recurring cycle patterns and timing
  3. Volatility Adjustment: Accounts for market volatility using mathematical smoothing
  4. Real-time Updates: Dynamically adjusts predictions as market conditions change
  5. Confidence Scoring: Provides confidence levels based on data convergence

Data Inputs

  • Price History: Monthly high values from April 2013 to current
  • Cycle Timing: Historical cycle lengths and peak patterns
  • Market Position: Current cycle stage assessment
  • Volatility Metrics: Price volatility and trend analysis
  • External Factors: Institutional adoption, regulatory environment

๐Ÿ“Š Enhanced Bitcoin Chart

Real-time Visualization featuring:

  • Historical Price Line (Blue): Monthly high values from 2013-2025
  • Current Price Point (Purple): Live price with "Current" tooltip
  • Prediction Line (Orange Dashed): 18-month future predictions
  • Perfect Label Alignment: Month/year labels correctly positioned under data points
  • Dynamic Updates: Automatically adjusts for current month

๐Ÿ“Š Advanced Metrics Dashboard

  • Pi Cycle Top Indicator: Mathematical convergence analysis
  • Rainbow Chart Analysis: Logarithmic price bands with position tracking
  • NUPL Cycle Timing: Net Unrealized Profit/Loss analysis
  • SOPR Analysis: Spent Output Profit Ratio with forecasting
  • MVRV Z-Score: Market Value to Realized Value deviation tracking
  • Bitcoin Dominance: Multi-timeframe analysis with ALT season implications
  • Fear & Greed Index: Real-time sentiment tracking with historical context

๐Ÿ“ฑ App Store Intelligence

  • Crypto App Rankings: Real-time tracking of Coinbase, Phantom, Trust Wallet rankings
  • Market Psychology Correlation: App store positioning as retail sentiment indicator
  • Retail Interest Tracking: App download patterns correlate with market cycles
  • Historical Performance: Track ranking changes during previous cycles

๐ŸŽจ Premium User Experience

  • Enhanced Theme System: Seamless dark/light mode with proper contrast optimization
  • Responsive Design: Mobile-first approach with desktop enhancements
  • Scroll-triggered Animations: BRRR videos spawn randomly during navigation
  • Interactive Charts: Month/year labeling with hover tooltips and real-time updates
  • Performance Optimized: 60fps animations with memory management

๐Ÿ›  Tech Stack

Core Framework

  • Next.js 15: React framework with App Router for optimal performance
  • TypeScript 5.0+: Full type safety across the entire application
  • Tailwind CSS 3.4+: Utility-first styling with custom theme variables
  • Framer Motion 11+: Smooth animations and micro-interactions

Data & Visualization

  • Recharts 2.8+: Advanced charting library for market data visualization
  • React Query (TanStack Query): Intelligent data fetching with caching and error handling
  • Multiple APIs: CoinGecko, Coinpaprika, Fear & Greed Index integration
  • Real-time Processing: Live market data with fallback mechanisms

UI/UX

  • Phosphor Icons: Consistent, beautiful iconography
  • CSS Variables: Theme-aware color system for dark/light modes
  • Custom Components: Reusable UI elements with animation support
  • Responsive Utilities: Mobile-first design patterns

๐Ÿ“ Architecture

src/
โ”œโ”€โ”€ app/                          # Next.js App Router
โ”‚   โ”œโ”€โ”€ api/                     # API routes & endpoints
โ”‚   โ”‚   โ”œโ”€โ”€ bitcoin/             # Bitcoin price & metrics
โ”‚   โ”‚   โ”‚   โ”œโ”€โ”€ route.ts         # Current price endpoint
โ”‚   โ”‚   โ”‚   โ””โ”€โ”€ historical/      # Historical data endpoint
โ”‚   โ”‚   โ”œโ”€โ”€ rankings/            # App store rankings
โ”‚   โ”‚   โ””โ”€โ”€ app-store/           # iOS/Google Play data
โ”‚   โ”œโ”€โ”€ api-test/                # Development testing interface
โ”‚   โ”œโ”€โ”€ layout.tsx               # Root layout with theme provider
โ”‚   โ””โ”€โ”€ page.tsx                 # Main dashboard page
โ”œโ”€โ”€ components/                   # Reusable UI components
โ”‚   โ”œโ”€โ”€ charts/                  # Market analysis visualizations
โ”‚   โ”‚   โ”œโ”€โ”€ enhanced-bitcoin-chart.tsx    # Main prediction chart
โ”‚   โ”‚   โ”œโ”€โ”€ visual-rainbow-chart.tsx      # Rainbow band analysis
โ”‚   โ”‚   โ”œโ”€โ”€ visual-nupl-chart.tsx         # NUPL cycle tracking
โ”‚   โ”‚   โ”œโ”€โ”€ visual-sopr-chart.tsx         # SOPR analysis
โ”‚   โ”‚   โ”œโ”€โ”€ visual-mvrv-chart.tsx         # MVRV Z-Score tracking
โ”‚   โ”‚   โ”œโ”€โ”€ comprehensive-metrics.tsx     # Advanced predictions
โ”‚   โ”‚   โ””โ”€โ”€ metric-gauge.tsx              # Interactive gauge displays
โ”‚   โ”œโ”€โ”€ dashboard/               # Dashboard-specific components
โ”‚   โ”‚   โ”œโ”€โ”€ live-dashboard.tsx   # Main dashboard layout
โ”‚   โ”‚   โ”œโ”€โ”€ metric-card.tsx      # Prediction display cards
โ”‚   โ”‚   โ””โ”€โ”€ stats-card.tsx       # Metric display cards
โ”‚   โ”œโ”€โ”€ rankings/                # App store ranking components
โ”‚   โ”‚   โ””โ”€โ”€ top-apps-rankings.tsx # Crypto app tracking
โ”‚   โ”œโ”€โ”€ layout/                  # Navigation & structure
โ”‚   โ”‚   โ”œโ”€โ”€ app-layout.tsx       # Main layout wrapper
โ”‚   โ”‚   โ”œโ”€โ”€ sidebar.tsx          # Navigation sidebar
โ”‚   โ”‚   โ”œโ”€โ”€ header.tsx           # Top navigation with branding
โ”‚   โ”‚   โ””โ”€โ”€ footer.tsx           # Footer component
โ”‚   โ”œโ”€โ”€ metrics/                 # Metric-specific components
โ”‚   โ”‚   โ””โ”€โ”€ action-signal.tsx    # Trading signal displays
โ”‚   โ””โ”€โ”€ ui/                      # Base UI components
โ”‚       โ”œโ”€โ”€ data-status.tsx      # API health monitoring
โ”‚       โ”œโ”€โ”€ mini-chart.tsx       # Small chart components
โ”‚       โ”œโ”€โ”€ odyssey-banner.tsx   # Branding components
โ”‚       โ”œโ”€โ”€ picojeet-logo.tsx    # Legacy logo component
โ”‚       โ””โ”€โ”€ brrr-video.tsx       # Scroll animations
โ”œโ”€โ”€ lib/                         # Core utilities & services
โ”‚   โ”œโ”€โ”€ api/                     # Data fetching services
โ”‚   โ”‚   โ”œโ”€โ”€ bitcoin.ts           # Bitcoin API client
โ”‚   โ”‚   โ”œโ”€โ”€ enhanced-bitcoin.ts  # Multi-source aggregation
โ”‚   โ”‚   โ””โ”€โ”€ real-app-store.ts    # App store APIs
โ”‚   โ”œโ”€โ”€ analysis/                # Prediction algorithms
โ”‚   โ”‚   โ””โ”€โ”€ cycle-predictor.ts   # Main prediction engine
โ”‚   โ”œโ”€โ”€ constants/               # Configuration & constants
โ”‚   โ”‚   โ””โ”€โ”€ signals.ts           # Trading signal definitions
โ”‚   โ”œโ”€โ”€ contexts/                # React contexts
โ”‚   โ”‚   โ””โ”€โ”€ theme-provider.tsx   # Theme management
โ”‚   โ”œโ”€โ”€ providers/               # Data providers
โ”‚   โ”‚   โ””โ”€โ”€ query-provider.tsx   # React Query setup
โ”‚   โ”œโ”€โ”€ types/                   # TypeScript definitions
โ”‚   โ”‚   โ””โ”€โ”€ index.ts             # Main type definitions
โ”‚   โ””โ”€โ”€ utils/                   # Utility functions
โ”‚       โ”œโ”€โ”€ cn.ts                # Tailwind class utilities
โ”‚       โ”œโ”€โ”€ historical-data.ts   # Historical data processing
โ”‚       โ””โ”€โ”€ index.ts             # General utilities
โ”œโ”€โ”€ hooks/                       # Custom React hooks
โ”‚   โ”œโ”€โ”€ use-bitcoin-data.ts      # Market data management
โ”‚   โ”œโ”€โ”€ use-app-rankings.ts      # App store data
โ”‚   โ”œโ”€โ”€ use-top-apps.ts          # Top app tracking
โ”‚   โ””โ”€โ”€ use-scroll-brrr.ts       # Scroll-triggered animations
โ””โ”€โ”€ styles/                      # Global styling
    โ””โ”€โ”€ globals.css              # Theme variables & base styles

๐Ÿšฆ Getting Started

Prerequisites

  • Node.js 18+ (Recommended: Latest LTS)
  • Yarn 1.22+ (Package manager)

Quick Setup

  1. Clone the repository:
git clone https://github.com/oxnr/picotop.git
cd picotop
  1. Install dependencies:
yarn install
  1. Start development server:
yarn dev
  1. Open application: Navigate to http://localhost:3000

Environment Configuration

Create .env.local for API keys (optional - app works with public APIs):

# Optional: Add your API keys for enhanced data
COINGECKO_API_KEY=your_key_here
COINPAPRIKA_API_KEY=your_key_here

๐Ÿ“Š Data Sources & APIs

Market Data

  • BGeo Metrics API: Primary Bitcoin price, NUPL, SOPR, MVRV, and dominance data
  • CoinGecko: Secondary Bitcoin price and historical data
  • Coinpaprika: Backup price feeds and market metrics
  • Fear & Greed Index: CNN Business sentiment tracking
  • Historical Highs: CoinMarketCap monthly high values (2013-2025)

App Store Rankings

  • iOS App Store: Crypto app positioning in Finance category
  • Google Play Store: Android app rankings and trends
  • Real-time Updates: 30-second refresh cycles during market hours

Prediction Engine

  • Mathematical Models: Pi Cycle, Rainbow Chart, NUPL analysis
  • Pattern Recognition: Historical cycle analysis and timing
  • Volatility Analysis: Market volatility and trend calculations
  • Real-time Adjustments: Dynamic prediction updates

๐ŸŽฏ Market Analysis Features

Cycle Prediction Methodology

Our prediction engine combines multiple analytical approaches:

  1. Historical Pattern Analysis: Studies 12+ years of Bitcoin price data
  2. Mathematical Modeling: Uses exponential growth curves and volatility dampening
  3. Cycle Timing: Analyzes historical cycle lengths and peak patterns
  4. Market Psychology: Incorporates retail sentiment via app store rankings
  5. Risk Management: Provides confidence intervals and uncertainty bands

Trading Signals

  • ACCUMULATE: Deep value zones, high confidence buy signals
  • HOLD: Fair value ranges, maintain positions
  • DISTRIBUTE: Late cycle warning, begin taking profits
  • SELL: Euphoria zones, maximum profit realization

Correlation Studies

  • App Rankings: Crypto app store positioning vs. market psychology
  • Retail Interest: App downloads correlation with price movements
  • Historical Patterns: 2017 ICO boom vs. 2021 institutional cycle analysis

๐ŸŽจ Design System

Theme Support

  • Dark Mode: Primary interface with purple/blue gradients
  • Light Mode: High contrast with proper text legibility
  • CSS Variables: Theme-aware color system with semantic tokens
  • Smooth Transitions: Seamless theme switching with animation

Animation Philosophy

  • Subtle Interactions: Enhance without overwhelming user experience
  • Performance Focused: 60fps smooth animations with hardware acceleration
  • Contextual Feedback: Visual responses to user actions
  • BRRR Elements: Playful scroll-triggered videos for engagement

๐Ÿ”ฎ Current Market Analysis

Real-time Status

  • Current Price: $108,700 (live data)
  • Predicted Peak: $176,000 (63% growth from current Mid Bull phase)
  • Time to Peak: 3-6 months (Mid Bull phase analysis)
  • Late Bull Timing: 2-6 months for sustained Late Bull scenarios
  • Confidence Level: High (based on enhanced cycle progression models)
  • Current Signal: ACCUMULATE/HOLD

Cycle Position

  • Stage: Mid Bull phase (extended threshold <75 for accurate timing)
  • Next Phase: Late Bull acceleration toward cycle peak
  • Key Levels: Watch for $130K breakthrough into Late Bull territory
  • Target Range: 170-180K based on dynamic growth factor methodology
  • Risk Factors: Regulatory changes, macro conditions, cycle phase transition timing

๐Ÿค Contributing

We welcome contributions to improve Picojeet! Areas of focus:

  • Algorithm Enhancement: Improve prediction accuracy
  • New Metrics: Additional on-chain indicators
  • Mobile Optimization: Enhanced mobile experience
  • API Integrations: Additional data sources
  • UI/UX Improvements: Animation and interaction enhancements

Development Setup

  1. Fork the repository
  2. Create a feature branch: git checkout -b feature/amazing-feature
  3. Make your changes and test thoroughly
  4. Commit your changes: git commit -m 'Add amazing feature'
  5. Push to the branch: git push origin feature/amazing-feature
  6. Open a Pull Request

๐Ÿงช Testing

Run the test suite:

yarn test

Check API endpoints:

yarn test:api

๐Ÿ“„ License

MIT License - see LICENSE for details.

๐Ÿ™‹โ€โ™‚๏ธ Support & Community

  • GitHub Issues: Bug reports and feature requests
  • Documentation: Complete guides in /docs
  • API Documentation: Interactive API explorer at /api-test

โšก Built for precision trading - Time your positions like a pro โšก

Delivering actionable Bitcoin cycle predictions through advanced analytics

About

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published
0