Skip to main content
NeuraTrade Hero Light

Welcome to NeuraTrade

NeuraTrade is a multi-service cryptocurrency trading platform that combines high-performance Go backend services with intelligent TypeScript sidecar services for exchange integration and Telegram delivery. Built for serious traders who demand speed, reliability, and autonomous execution.

Quickstart

Get NeuraTrade running locally in under 5 minutes

Installation

Detailed installation guide with prerequisites and configuration

API Reference

Complete API documentation for market data, arbitrage, and trading

Architecture

Learn about NeuraTrade’s multi-service architecture

Core Capabilities

Arbitrage Detection

Real-time detection of arbitrage opportunities across multiple exchanges:
  • Spot Arbitrage: Cross-exchange price differentials
  • Futures Arbitrage: Funding rate arbitrage between spot and perpetual futures
  • Triangular Arbitrage: Multi-asset arbitrage paths

Autonomous Trading

AI-powered agents that execute trading strategies autonomously:
  • Analyst Agent: Market analysis and signal generation
  • Trader Agent: Order execution and position management
  • Risk Manager: Portfolio safety and risk controls

Market Intelligence

  • WebSocket market data streaming
  • Technical indicators (RSI, MACD, Bollinger Bands)
  • Order book depth analysis
  • Sentiment analysis from news and social media

Production-Ready

  • Redis caching for sub-millisecond response times
  • SQLite for development, PostgreSQL for production
  • Circuit breakers and rate limiting
  • Telegram notifications and bot interface

Platform Architecture

NeuraTrade consists of three core services:
NeuraTrade/
├── services/backend-api/      # Go API, strategy engine, persistence
├── services/ccxt-service/     # Bun + CCXT exchange bridge
└── services/telegram-service/ # Bun + grammY bot delivery

Backend API (Go)

High-performance core engine handling:
  • Market data collection and caching
  • Arbitrage opportunity detection
  • Risk management and position tracking
  • Technical analysis and signal generation
  • Database persistence and migrations

CCXT Service (Bun + TypeScript)

Exchange integration layer providing:
  • Unified API across 100+ exchanges
  • Real-time ticker and orderbook data
  • Order execution and position management
  • WebSocket streaming support

Telegram Service (Bun + TypeScript)

User interface and notification delivery:
  • Interactive Telegram bot commands
  • Real-time trade notifications
  • Portfolio monitoring and alerts
  • Admin controls via chat

Key Features

Multi-Exchange Support

Connect to 100+ cryptocurrency exchanges through unified CCXT interface

Real-Time Data

WebSocket streaming for sub-second market data updates and execution

AI Agents

Autonomous trading agents with customizable strategies and risk controls

Risk Management

Portfolio safety gates, drawdown limits, daily loss caps, position throttling

Paper Trading

Test strategies risk-free with realistic simulation mode

Telegram Integration

Control your trading platform and receive notifications via Telegram

API Endpoints

NeuraTrade exposes a RESTful API at http://localhost:8080:
EndpointPurpose
/healthHealth check and service status
/api/v1/market/pricesReal-time market prices
/api/v1/arbitrage/opportunitiesCurrent arbitrage opportunities
/api/v1/futures-arbitrage/opportunitiesFunding rate arbitrage
/api/v1/analysis/signalsTrading signals and indicators
/api/v1/trading/positionsActive positions and orders
The default API listens on port 8080. You can configure this via the SERVER_PORT environment variable.

Runtime State

All runtime data, logs, and configuration are stored in:
~/.neuratrade/
├── config.json          # Runtime configuration (API keys, chat IDs)
├── neuratrade.db       # SQLite database (development)
├── logs/
   ├── backend.log     # Backend service logs
   ├── gateway.log     # Gateway orchestration logs
   └── telegram.log    # Telegram service logs
└── pids/               # Process ID files for gateway
Never commit the ~/.neuratrade/ directory or its contents. It contains sensitive API keys and credentials.

Next Steps

Quickstart Guide

Get your first arbitrage opportunity in 5 minutes

Configuration

Configure exchanges, API keys, and trading parameters

Build docs developers (and LLMs) love