Tradetronclaw

README

# Tradetron OpenClaw Plugin

> **WARNING: This project is in BETA. Use at your own risk.**
>
> This plugin is under active development and is NOT production-ready.
> APIs may change without notice. Features may break. Data accuracy is not guaranteed.
> **Do NOT rely on this for trading decisions.**
>
> This plugin provides **read-only** access to Tradetron.tech. It cannot start, stop, or exit strategies.
> However, bugs could theoretically cause unexpected behavior. Always verify data on tradetron.tech directly.

---

An [OpenClaw](https://github.com/nicoepp/openclaw) plugin that integrates with [Tradetron.tech](https://tradetron.tech), an Indian algo trading platform. Lets your AI assistant monitor strategies, analyze P&L, and review trade history through natural conversation.

## Features

- **Portfolio Overview** — See all deployed strategies with status and P&L
- **Live Positions** — Current open positions with real-time M2M P&L
- **P&L Breakdown** — P&L grouped by broker and strategy type (positional vs intraday)
- **Strategy Detail** — Deep dive with positions, greeks, and counter history
- **Trade Analysis** — Win rate, repair impact, monthly trends, drawdowns from trade history
- **Reports** — P&L reports with date range and exchange filters

## Prerequisites

- An [OpenClaw](https://github.com/nicoepp/openclaw) instance
- A [Tradetron.tech](https://tradetron.tech) account with deployed strategies

## Installation

1. Copy the plugin folder to your OpenClaw plugins directory:
   ```bash
   cp -r tradetron-plugin ~/.your-instance/my-plugins/tradetron
   ```

2. Restart the OpenClaw gateway:
   ```bash
   cd ~/your-instance && docker compose restart openclaw-gateway
   ```

3. Verify the plugin loaded:
   ```
   Check gateway logs for: "discovered non-bundled plugins may auto-load: tradetron"
   ```

## Authentication

This plugin uses Tradetron's session cookies (there is no official API). You need to:

1. Log into tradetron.tech in your browser
2. Open DevTools (F12) > Application > Cookies > tradetron.tech
3. Copy the `tradetron_session` and `XSRF-TOKEN` cookie values
4. Tell your bot to set them up using the `tradetron_set_auth` tool

Session cookies expire approximately 17 hours after login. You'll need to provide fresh cookies when they expire.

## Tools

| Tool | Description |
|------|-------------|
| `tradetron_set_auth` | Set session cookies for authentication |
| `tradetron_auth_status` | Check if authentication is valid |
| `tradetron_portfolio` | Overview of all strategies |
| `tradetron_positions` | Current open positions with M2M P&L |
| `tradetron_pnl_breakdown` | P&L by broker and strategy type |
| `tradetron_strategy_detail` | Deep dive into a single strategy |
| `tradetron_trade_analysis` | Historical trade analysis with stats |
| `tradetron_report` | P&L report export with filters |

## How It Works

Tradetron.tech does not have a public API. This plugin uses reverse-engineered endpoints discovered through browser network traffic analysis. It authenticates using session cookies extracted from a logged-in browser session.

**All operations are read-only.** No strategy control endpoints (start/stop/exit) are exposed.

## Disclaimer

This project is not affiliated with, endorsed by, or associated with Tradetron.tech in any way. It uses undocumented/internal APIs that may change or break at any time without notice.

**Use entirely at your own risk.** The authors are not responsible for any financial losses, data inaccuracies, or other damages arising from use of this plugin.

## License

MIT