Kairos

Kairos is an automated crypto arbitrage platform and dashboard designed to monitor, execute, and visualize arbitrage trades between Polygon (Amoy testnet) and Hedera (Testnet). The system continuously scans both blockchains for price discrepancies, executes trades when profitable opportunities arise, and provides real-time feedback to users via a modern web dashboard. Users can view recent trades, live account balances, and profit notifications, with direct links to transaction explorers for transparency. The project aims to demonstrate cross-chain arbitrage automation, blockchain integration, and user-friendly visualization of trading activity.

Kairos is built as a full-stack application with three main components:

Backend (Python Flask API Server): The backend serves as the bridge between the arbitrage agent and the frontend dashboard. It exposes RESTful endpoints for live balances, recent trades, and agent control (start/stop/status). It parses logs generated by the agent, extracts transaction hashes, and formats trade data for the frontend. Threading is used for status updates, and subprocess management ensures the agent runs independently.

Arbitrage Agent (Python): The agent is responsible for monitoring price feeds on Polygon and Hedera, calculating arbitrage opportunities, and executing trades using Web3 (for Polygon) and the Hedera SDK. It logs every trade with real transaction hashes, updates balances, and sends desktop notifications for profit events. Environment variables are managed with dotenv for security. The agent’s logic is streamlined for efficiency, and it handles both mock and real trades for testing and demonstration.

Frontend (React/Next.js): The dashboard is built with React and Next.js, styled using Tailwind CSS and Lucide icons for a clean, modern look. Axios is used for API calls to the backend. The UI displays balance, recent trades (with "View Tx" links to blockchain explorers), and profit notifications.

Notable Details and Hacks: Real transaction hashes are parsed from agent logs and surfaced in the UI for transparency. Profit notifications are dynamic, reflecting real market variance. The backend uses threading and subprocesses to keep the agent responsive and isolated. The project demonstrates integration of two blockchains, cross-chain trade execution, and real-time data visualization.

Partner technologies (Polygon, Hedera, Hedera SDK) enabled rapid development, secure key management, and a polished user experience. The log parsing and transaction hash extraction were particularly hacky, requiring careful handling to ensure real trades were displayed correctly.