Corax Crypto
Autonomous HFT Agent

Quantum Spatial Interface • 100% Polars-Native Execution • Web3 Cross-Chain Bridging

---

⚠️ Hackathon Origins & Evolution

Corax Crypto was proudly featured in the Agora Agents Hackathon (Pod 4), but it is important to note:
It was not built solely for the hackathon.
This project is the culmination of extensive research and development in high-frequency trading, autonomous economic actors, and spatial computing, continuing to evolve far beyond the scope of a single event.

---

⚡ System Overview

Corax Crypto is a next-generation, asynchronous High-Frequency Trading (HFT) platform and Autonomous Economic Actor (AEA). It bridges the gap between raw quantitative execution, decentralized on-chain settlement, and high-level macro intelligence.

Corax Crypto pioneers a new standard using a 100% Polars-native data pipeline, an asynchronous ccxt.pro execution loop, and a stunning Cyberpunk-themed 3D WebGL Command Center.

---

🏆 World-Class Features

We have pushed the boundaries of what an automated trading agent can do. Explore our core world-class implementations:

🔥 1. Statistical Arbitrage (Pairs Trading) Engine

Utilizes Polars to perform blazing-fast, vectorized calculations of rolling Z-Scores across asset pairs, identifying and trading statistically significant mean-reverting deviations in real-time.

🧠 2. Predictive Regime Detection (Markov Chain HMM)

Upgrades standard regime classification by tracking historical state transitions. It builds a live probability matrix to actively predict the next market regime, allowing strategies to pre-position before the shift occurs.

🛡️ 3. Liquidity Velocity Circuit Breaker

A dynamic, microsecond-level safety mechanism that calculates the rate-of-change (velocity) of liquidity and price. If liquidity evaporates violently, it triggers a protective halt before traditional drawdown limits are even hit.

📝 4. Autonomous Trade Rationale Journaling

Every executed trade triggers an asynchronous call to the LLM Copilot, generating a contextual rationale based on the current regime, price action, and signal. This rationale is logged to a highly queryable JSON journal for advanced post-trade analysis.

🌌 5. Quantum Liquidity Heatmap (3D WebGL)

The UI features a toggleable 'HEATMAP' mode in the Three.js spatial interface. It visualizes market volume and order book depth as glowing, dynamic floor tiles, providing operators with a literal "heat signature" of market liquidity.

---

📸 Media Showcase: The Quantum Command Center

Experience the market through our fully immersive 3D WebGL interface.

🌐 Corax Telemetry HUD

Live L2 Order Book visualization, reactive particle systems, and real-time LLM synthesis overlay.

💬 NLP Telegram Command Center

Natural language execution and emergency Risk Manager Kill Switch via aiogram.

💻 Async Terminal Logs

Non-blocking asyncio loop handling simultaneous multiplexing across Binance, Bybit, and OKX.

---

🛠️ Architecture Deep-Dive

🔬 Click to explore the technical stack

• Core Engine: Python 3.11+, fully non-blocking asyncio loop. pydantic-settings enforces a 'Fail-Fast' environment validation upon boot.
• Data Layer: Polars for dataframes, PyArrow for Parquet data persistence. Millisecond-level HFT execution loop.
• API & Comms: decoupled FastAPI + Uvicorn layer serving real-time WebSockets to the frontend.
• Trading: ccxt.pro for async Level 2 depth streaming. Dynamic Profitability Calculator accounts for CEX fees, slippage, and on-chain bridge fees.
• UI/Visualization: Vanilla JS, Three.js (WebGL) for the 3D Quantum Market Dashboard, Lightweight Charts for candlestick rendering.
• Risk Management: Strict enforcement of max risk percentage, daily drawdown limits (Kill Switch), and dynamic ATR Trailing Stops.

🚀 Setup & Deployment Instructions

Corax Crypto uses a 'Fail-Fast' design. It will crash immediately at startup if required .env secrets are missing.

Option A: Docker (Recommended)

git clone https://github.com/PelleNybe/corax-crypto.git
cd corax-crypto
cp .env.example .env
# Edit .env with your Circle W3S API keys and Exchange credentials
docker compose up -d --build

Option B: Local Environment (Poetry)

Requires package-mode = false in pyproject.toml.

curl -sSL https://install.python-poetry.org | python3 -
poetry install
cp .env.example .env
poetry run python main.py

---

👨‍💻 Visionaries Behind the Code

Pelle Nyberg

CEO • Deep Tech Developer • AI & Robotics Innovator

Pelle specializes in pushing the boundaries of autonomous systems, quantitative finance, and spatial computing. With a passion for building next-generation technology, his work bridges the gap between complex algorithms and immersive human-computer interfaces.

---

Corax CoLAB

Mission: Intelligent Automation and Deep Tech.

© 2026 Corax CoLAB. Licensed under the GPLv3 License.
Building the future of autonomous finance.