FinRL_DeepSeek_Crypto_Trading

# LARSA: LLM-Augmented Regime-Switching Agent

[![CI](https://github.com/mattbusel/FinRL_DeepSeek_Crypto_Trading/actions/workflows/ci.yml/badge.svg)](https://github.com/mattbusel/FinRL_DeepSeek_Crypto_Trading/actions/workflows/ci.yml)
[![Python 3.10+](https://img.shields.io/badge/python-3.10%2B-blue.svg)](https://www.python.org/downloads/)
[![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
[![Code style: ruff](https://img.shields.io/badge/code%20style-ruff-black.svg)](https://docs.astral.sh/ruff/)
[![Type checked: mypy](https://img.shields.io/badge/type%20checked-mypy-blue.svg)](https://mypy.readthedocs.io/)

---

> **DISCLAIMER: LARSA is experimental research software. It is NOT financial advice. Crypto trading carries substantial risk of loss. Never deploy real capital without fully understanding the system, the risks, and the applicable laws in your jurisdiction. Always start with dry-run or paper trading mode. Past simulated performance does not guarantee future results.**

---

## What is LARSA?

LARSA (LLM-Augmented Regime-Switching Agent) is a hybrid reinforcement learning and large language model trading system for crypto assets. It extracts structured sentiment and risk signals from BTC news via the DeepSeek V3 API, mines predictive factors with a recurrent neural network trained on Alpha101 features, trains an ensemble of three DQN-family agents (D3QN, DoubleDQN, TwinD3QN) that vote on trade decisions, and dynamically shifts ensemble weights based on a detected market regime (bull, bear, sideways, volatile). The system supports single-asset BTC trading, multi-asset crypto portfolios, live paper trading on Binance price feeds, production-safe live trading via the Live Trading Bridge, per-trade explainability reports, and automated hyperparameter search.

Round 2 additions extend LARSA with a multi-agent LLM debate layer, alternative data feeds, a continuous online learning pipeline, and advanced portfolio optimisation strategies —