{"id":28633253,"url":"https://github.com/heyimsteve/crypn","last_synced_at":"2025-07-19T04:33:58.411Z","repository":{"id":288147489,"uuid":"928121852","full_name":"heyimsteve/crypn","owner":"heyimsteve","description":"Crypn is a powerful cryptocurrency analytics platform that provides real-time market data, advanced charting tools, and comprehensive trading insights. Whether you're a seasoned trader or just getting started, Crypn offers the tools you need to make informed decisions in the crypto market.","archived":false,"fork":false,"pushed_at":"2025-06-02T15:35:09.000Z","size":335,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-12T15:07:52.583Z","etag":null,"topics":["ai","analytics","api","app","crypn","cryptocurrency","hyperliquid","insights","market-data","platform","react","trading","trading-strategies","websocket"],"latest_commit_sha":null,"homepage":"https://crypn.app","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/heyimsteve.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-02-06T05:07:36.000Z","updated_at":"2025-06-04T06:08:08.000Z","dependencies_parsed_at":null,"dependency_job_id":"9b2c00cc-451c-427c-9970-1d878538565f","html_url":"https://github.com/heyimsteve/crypn","commit_stats":null,"previous_names":["heyimsteve/crypn"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/heyimsteve/crypn","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/heyimsteve%2Fcrypn","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/heyimsteve%2Fcrypn/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/heyimsteve%2Fcrypn/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/heyimsteve%2Fcrypn/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/heyimsteve","download_url":"https://codeload.github.com/heyimsteve/crypn/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/heyimsteve%2Fcrypn/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265888949,"owners_count":23844536,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","analytics","api","app","crypn","cryptocurrency","hyperliquid","insights","market-data","platform","react","trading","trading-strategies","websocket"],"created_at":"2025-06-12T15:07:50.056Z","updated_at":"2025-07-19T04:33:58.227Z","avatar_url":"https://github.com/heyimsteve.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Crypn - Cryptocurrency Analytics Platform\n\nCrypn is a powerful cryptocurrency analytics platform that provides real-time market data, advanced charting tools, and comprehensive trading insights for the Hyperliquid DEX. Whether you're a seasoned trader or just getting started, Crypn offers the tools you need to make informed decisions in the crypto market.\n\n## App Preview\n\n\u003cimg width=\"1655\" alt=\"Screenshot 2025-04-15 at 9 31 36 PM\" src=\"https://github.com/user-attachments/assets/5b0c468c-f339-42b3-9a1c-d0166005afb9\" /\u003e\n\n\u003cimg width=\"1651\" alt=\"Screenshot 2025-04-15 at 9 32 55 PM\" src=\"https://github.com/user-attachments/assets/a35a697a-4639-4768-ba8b-e0f0f689eccf\" /\u003e\n\n\u003cimg width=\"1655\" alt=\"Screenshot 2025-04-15 at 9 33 54 PM\" src=\"https://github.com/user-attachments/assets/493b2340-38ee-422b-8663-3354811ec4d2\" /\u003e\n\n\u003cimg width=\"1653\" alt=\"Screenshot 2025-04-15 at 9 34 26 PM\" src=\"https://github.com/user-attachments/assets/39bb0a42-9653-43f8-a80b-94c5d192b5b1\" /\u003e\n\n\u003cimg width=\"1654\" alt=\"Screenshot 2025-04-15 at 9 34 49 PM\" src=\"https://github.com/user-attachments/assets/658786d9-2a4a-41e3-96ad-a6dffc8dea94\" /\u003e\n\n\u003cimg width=\"1655\" alt=\"Screenshot 2025-04-15 at 9 35 13 PM\" src=\"https://github.com/user-attachments/assets/a54a3b4b-3689-4d94-be58-d36bcd61bc7e\" /\u003e\n\n\u003cimg width=\"1652\" alt=\"Screenshot 2025-04-15 at 9 35 30 PM\" src=\"https://github.com/user-attachments/assets/6f4779c8-99cf-4581-9a28-877359a9a7a2\" /\u003e\n\n\u003cimg width=\"1654\" alt=\"Screenshot 2025-04-15 at 9 36 25 PM\" src=\"https://github.com/user-attachments/assets/79292394-9adf-4ff7-b177-76c3d9312df8\" /\u003e\n\n\u003cimg width=\"1655\" alt=\"Screenshot 2025-04-15 at 9 36 54 PM\" src=\"https://github.com/user-attachments/assets/deb12f5a-7e4c-4188-99e5-f7b0f8f5a7f3\" /\u003e\n\n\n\n## Features\n\n- **Real-time Data**: Connect to Hyperliquid's WebSocket API for live market data\n- **Multiple Timeframe Analysis**: View charts ranging from 1-minute to monthly timeframes\n- **Advanced Technical Indicators**: Over 30 technical indicators including:\n  - MACD, RSI, Bollinger Bands, Stochastic, DMI/ADX\n  - Ichimoku Cloud, TD Sequential, Fibonacci levels\n  - Advanced pattern recognition (Head \u0026 Shoulders, Harmonic Patterns)\n  - Liquidity Swings analysis\n  - Support \u0026 Resistance detection\n- **Market Overview**: View all Hyperliquid assets with current prices, volumes, and funding rates\n- **Position Tracking**: Track your open positions and trade history\n- **Cross-Vault Analysis**: Track and compare multiple vault positions simultaneously\n- **Consensus signals**: Identify potential trading opportunities using multi-indicator analysis\n\n## Getting Started\n\n### Prerequisites\n\n- Node.js (v14 or higher)\n- npm (v6 or higher)\n\n### Installation\n\n1. Clone the repository:\n```bash\ngit clone https://github.com/heyimsteve/crypn.git\ncd crypn\n```\n\n2. Install dependencies:\n```bash\nnpm install\n```\n\n3. Start the development server:\n```bash\nnpm start\n```\n\n4. The application will open in your browser at `http://localhost:3000`\n\n## Project Structure\n\n```\ncrypn/\n├── public/              # Static files\n├── src/\n│   ├── components/      # Reusable UI components\n│   ├── pages/           # Page components\n│   ├── utils/           # Helper functions\n│   ├── App.js           # Main application component\n│   ├── index.js         # Application entry point\n│   └── TabContext.js    # Context for tab management\n├── package.json         # Project dependencies\n└── README.md            # Project documentation\n```\n\n## Key Components\n\n### Data Fetching\n\nThe application connects to Hyperliquid's API endpoints to fetch market data:\n\n- `fetchChartData.js`: Fetches candle data, order book, and recent trades\n- `indicators.js`: Calculates technical indicators from raw price data\n- WebSocket connections: Maintains real-time data feeds\n\n### Charts and Indicators\n\nAll chart components are built using the Lightweight Charts library:\n\n- `PriceChart.js`: Main price chart with candlesticks\n- `VolumeChart.js`: Volume histogram chart\n- `MacdChart.js`, `RsiChart.js`, etc.: Individual indicator charts\n- `ConsensusChart.js`: Multi-indicator analysis chart\n\n### Dashboard and Trading Views\n\n- `Dashboard.js`: User or vault position dashboard\n- `PerpsData.js`: Overview of all perpetual contracts\n- `OpenOrders.js`: Track open orders\n- `TradeHistory.js`: View trade history\n- `Market.js`: Live market overview\n\n## API Integration\n\nThe application integrates with the Hyperliquid API:\n\n### REST Endpoints\n\n- `https://api.hyperliquid.xyz/info` - Used for most data queries\n- `https://api.hyperliquid.xyz/exchange` - Used for trading operations (not implemented in this version)\n\n### WebSocket Connections\n\n- `wss://api.hyperliquid.xyz/ws` - Used for real-time data streaming\n\n## Core Utilities\n\n### Indicator Calculations\n\nThe `indicators.js` file contains implementations of all technical indicators:\n\n- `calculateRSI()`: Relative Strength Index calculation\n- `calculateMACD()`: Moving Average Convergence Divergence\n- `calculateBollingerBands()`: Bollinger Bands calculation\n- `calculateTDSequential()`: TD Sequential indicator\n- `detectHeadAndShoulders()`: Pattern recognition algorithms\n- `calculateConsensusSignals()`: Multi-indicator signal generator\n\n### Dashboard Analytics\n\n- `calculateROE()`: Return on Equity calculations\n- `formatNumber()`: Consistent number formatting with appropriate decimals\n- `getMarketTrend()`: Market trend analysis\n\n## Multi-Vault Analysis\n\nThe application supports tracking multiple vaults simultaneously:\n\n- Compare positions across different vaults\n- Consensus view combining all vault positions\n- Analyze performance across different strategies\n\n## Configuration\n\nThe application reads wallet addresses from:\n\n1. URL parameters (e.g., `?wallet=0x123...`)\n2. User input in the WalletInput component\n3. Predefined vault addresses for the vault dashboard\n\n## Adding New Indicators\n\nTo add a new indicator:\n\n1. Implement the indicator calculation in `indicators.js`\n2. Create a new chart component in the components directory\n3. Add the component to the appropriate page (typically `CoinDetails.js`)\n\n## License\n\nThis project is licensed under the MIT License - see the LICENSE file for details.\n\n## Acknowledgments\n\n- Hyperliquid API for providing the market data\n- Lightweight Charts library for chart rendering\n- TradingView for chart styling inspiration\n- React and Tailwind CSS for the UI framework\n\n## Contributing\n\nContributions are welcome! Please feel free to submit a Pull Request.\n\n1. Fork the project\n2. Create your feature branch (`git checkout -b feature/amazing-feature`)\n3. Commit your changes (`git commit -m 'Add some amazing feature'`)\n4. Push to the branch (`git push origin feature/amazing-feature`)\n5. Open a Pull Request\n\n## Contact\n\nProject Link: [https://github.com/heyimsteve/crypn](https://github.com/heyimsteve/crypn)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fheyimsteve%2Fcrypn","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fheyimsteve%2Fcrypn","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fheyimsteve%2Fcrypn/lists"}