AI paper trading project inspired by nof1 Alpha Arena, using ccxt for quotation. It enables users to set up and test AI trading bots on the crypto market without financial risk, offering an OpenAI-compatible API for seamless integration of custom AI agents.

How It Works

The system facilitates AI-driven crypto trading through a paper trading environment, allowing developers to test and refine strategies without financial risk. It integrates with the ccxt library for fetching real-time market data quotes across various exchanges. A key feature is its OpenAI-compatible API, which simplifies the process of connecting custom AI trading agents, enabling them to interact with the simulated market as if it were a live environment.

Quick Start & Requirements

• Installation: Execute pnpm run install:all to install all JavaScript dependencies and synchronize the Python environment.
• Prerequisites: Requires Node.js version 18 or higher, pnpm package manager, Python 3.10 or higher, and the uv Python package manager.
• Development: Launch both the backend (default port 5611) and frontend (default port 5621) development servers concurrently using pnpm run dev. Note that the frontend is pre-configured for port 5621; adjustments to frontend/app/main.tsx are necessary if running the backend on a different port (e.g., 5611). An alternative backend startup command is provided for running on port 5621.
• Build: The frontend is built using Vite; run pnpm run build to generate static assets. The backend is a standard FastAPI application.
• Links: The README does not provide direct links to official quick-start guides, demos, or further documentation.

Highlighted Details

• Features paper trading for risk-free AI bot testing.
• Provides an OpenAI-compatible API for seamless AI agent integration.
• Utilizes ccxt for fetching cryptocurrency market data quotes.

Maintenance & Community

The provided README does not contain information regarding contributors, community channels (like Discord/Slack), or a roadmap.

Licensing & Compatibility

• License: MIT.
• Compatibility: The MIT license is permissive and generally compatible with commercial and closed-source applications.

Limitations & Caveats

The project is currently limited to paper trading; real trading functionality is a future development goal (TODO). Leverage trading is also a planned feature and not yet implemented. Frontend port configuration might require manual adjustment based on backend port choices.