| Service | Status |
|---|---|
| Backend |  |
| Frontend |  |
| Blockchain |  |
| Data Processing |  |
"See the Unseen, Trade the Future."
OnChain Sage is an AI-driven, decentralized trading assistant that combines real-time social sentiment analysis with on-chain market data to identify high-potential crypto tickers. By integrating data from Twitter, Raydium, Dex Screener, and more, OnChain Sage empowers crypto traders with actionable insights to make informed decisions.
- Overview
- Core Concept
- Key Features
- Architecture & Tech Stack
- Getting Started
- Development
- Contributing
- License
OnChain Sage leverages cutting-edge AI and blockchain technologies to provide a comprehensive analysis of crypto trends. It monitors both social media sentiment and on-chain metrics to deliver reliable trading signals. The platform is built as an open-source, modular system, inviting community contributions while ensuring robust, scalable performance.
- Data-Driven Trading: Integrates social sentiment analysis from Twitter with on-chain analytics from platforms like Raydium and Dex Screener.
- Decentralized Payment Model: Utilizes the Starknet network and STRK tokens to manage gas fees and premium access.
- Open-Source Collaboration: Encourages a vibrant contributor community with a modular monorepo structure for easy maintenance and scalability.
- Real-Time Social Sentiment Analysis: Uses NLP and ML models to analyze Twitter data and detect emerging trends.
- On-Chain Data Insights: Monitors liquidity, volume, and whale activity via on-chain APIs.
- Actionable Trading Signals: Provides categorized signals (high-confidence, emerging, risky) to guide trading decisions.
- User-Friendly Dashboard: A responsive Next.js-based interface with dynamic visualizations (Chart.js/D3.js).
- Secure Blockchain Integration: Smart contracts written in Cairo on Starknet manage STRK token transactions and premium access.
- Modular and Open-Source: Encourages community contributions with a well-defined monorepo structure.
- Framework: Next.js, React
- Styling: Tailwind CSS
- Visualizations: Chart.js, D3.js
- Runtime: Node.js with NestJs
- Language: TypeScript
- Languages: Python (TensorFlow, PyTorch, OpenAI API)
- Network: Starknet
- Smart Contracts: Written in Cairo
- Token Handling: STRK for gas fees and premium services
- Database: PostgreSQL/MongoDB, Redis for caching
- Containerization & Orchestration: Docker, Kubernetes
- Deployment: AWS/GCP or similar cloud platforms
- Social Data: Twitter API
- On-Chain Analytics: Raydium and Dex Screener APIs
- Node.js (v14+)
- npm
- Python 3.8+ (if working on data processing services)
- Docker (for containerized development)
- Access to a Starknet wallet (e.g., MetaMask or Argent)
- Clone the Repository
git clone https://github.com/degenspot/onchainsage.git cd onchainsage Install Dependencies
Using npm (for workspaces):
npm install Environment Configuration
Create environment configuration files for each app (e.g., .env in apps/frontend, apps/backend, etc.) based on the examples provided in the docs/ folder. Run the Applications
Frontend:
"npm run dev --workspace=apps/frontend"
Backend: "npm run start:dev --workspace=apps/backend",
Data Processing & Blockchain Services: Follow the README files in each respective directory. Development This project follows a monorepo structure managed via Turborepo or Nx. Each component is developed in its own folder under apps/ and shared utilities are stored under packages/.
Folder Structure:
├── apps/
│ ├── frontend/
│ ├── backend/
│ ├── blockchain/
│ └── data-processing/
├── packages/
│ ├── ui/
│ ├── sdk/
│ ├── common/
│ └── integrations/
├── docs/
├── infrastructure/
└── .github/
**Contributing**
We welcome contributions from the community! Please see our CONTRIBUTING.md for details on our code of conduct, branching strategy, and how to submit pull requests.
License
MIT License
For any questions or feedback, please open an issue or reach out to the maintainers.