# bhardwajtanuj/kotak-neo-async-trade-cli architecture

> Architecture diagram of the GitHub repository bhardwajtanuj/kotak-neo-async-trade-cli, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/bhardwajtanuj/kotak-neo-async-trade-cli
- Repository: https://github.com/bhardwajtanuj/kotak-neo-async-trade-cli

## Overview

Kotak Neo CLI lets a user track a symbol, enter a buy or sell trade, and monitor its exit orders asynchronously. The main event loop handles prompts and starts LTP streaming; TradeManager places the entry, validates risk, places stop-loss and target orders, then monitors them as a registered background task. AsyncNeoAPI wraps blocking client calls in retrying asynchronous calls. The README documents resilience and graceful shutdown; the excerpts show the mock client, but not a configured live broker client.

Main entry points: [`main.py`](https://github.com/bhardwajtanuj/kotak-neo-async-trade-cli/blob/main/main.py) (CLI Event Loop), [`trade_manager.py`](https://github.com/bhardwajtanuj/kotak-neo-async-trade-cli/blob/main/trade_manager.py) (Order Placement), [`async_neo.py`](https://github.com/bhardwajtanuj/kotak-neo-async-trade-cli/blob/main/async_neo.py) (Async API Adapter), [`models.py`](https://github.com/bhardwajtanuj/kotak-neo-async-trade-cli/blob/main/models.py) (Trade Record)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_cli["CLI and Streaming"]
  node_main["CLI Event Loop<br/>[main.py]"]
  node_ltp["LTP Stream<br/>[main.py]"]
end

subgraph group_trading["Trade Lifecycle"]
  node_manager["Trade Manager<br/>[trade_manager.py]"]
  node_validation["Risk Validation<br/>[trade_manager.py]"]
  node_orders["Order Placement<br/>[trade_manager.py]"]
  node_oco["OCO Monitor<br/>[trade_manager.py]"]
  node_registry["Monitor Registry<br/>[trade_manager.py]"]
end

subgraph group_api["Broker Integration"]
  node_adapter["Async API Adapter<br/>[async_neo.py]"]
  node_mock["Mock Broker Client<br/>[async_neo.py]"]
end

subgraph group_domain["Trade Data"]
  node_trade["Trade Record<br/>[models.py]"]
end

node_user(("Trader"))
node_broker["Kotak Neo Broker"]

node_user -->|"enters commands"| node_main
node_main -->|"starts stream"| node_ltp
node_ltp -->|"requests prices"| node_adapter
node_main -->|"submits trade"| node_manager
node_manager -->|"executes trade"| node_orders
node_orders -->|"validates risk"| node_validation
node_orders -->|"places and reads orders"| node_adapter
node_orders -->|"creates record"| node_trade
node_orders -->|"registers monitor"| node_registry
node_registry -->|"runs task"| node_oco
node_oco -->|"checks and cancels"| node_adapter
node_main -->|"shuts down"| node_registry
node_main -->|"selects mock"| node_mock
node_adapter -->|"calls client"| node_mock
node_adapter -.->|"wraps broker calls"| node_broker

click node_main "https://github.com/bhardwajtanuj/kotak-neo-async-trade-cli/blob/main/main.py"
click node_ltp "https://github.com/bhardwajtanuj/kotak-neo-async-trade-cli/blob/main/main.py"
click node_manager "https://github.com/bhardwajtanuj/kotak-neo-async-trade-cli/blob/main/trade_manager.py"
click node_validation "https://github.com/bhardwajtanuj/kotak-neo-async-trade-cli/blob/main/trade_manager.py"
click node_orders "https://github.com/bhardwajtanuj/kotak-neo-async-trade-cli/blob/main/trade_manager.py"
click node_oco "https://github.com/bhardwajtanuj/kotak-neo-async-trade-cli/blob/main/trade_manager.py"
click node_registry "https://github.com/bhardwajtanuj/kotak-neo-async-trade-cli/blob/main/trade_manager.py"
click node_trade "https://github.com/bhardwajtanuj/kotak-neo-async-trade-cli/blob/main/models.py"
click node_adapter "https://github.com/bhardwajtanuj/kotak-neo-async-trade-cli/blob/main/async_neo.py"
click node_mock "https://github.com/bhardwajtanuj/kotak-neo-async-trade-cli/blob/main/async_neo.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_main,node_ltp toneBlue
class node_manager,node_validation,node_orders,node_oco,node_registry toneAmber
class node_adapter,node_mock toneMint
class node_trade toneRose
class node_user,node_broker toneIndigo
```

## Components

### CLI and Streaming

- [CLI Event Loop](https://github.com/bhardwajtanuj/kotak-neo-async-trade-cli/blob/main/main.py): `main.py`
- [LTP Stream](https://github.com/bhardwajtanuj/kotak-neo-async-trade-cli/blob/main/main.py): `main.py`

### Trade Lifecycle

- [Trade Manager](https://github.com/bhardwajtanuj/kotak-neo-async-trade-cli/blob/main/trade_manager.py): `trade_manager.py`
- [Risk Validation](https://github.com/bhardwajtanuj/kotak-neo-async-trade-cli/blob/main/trade_manager.py): `trade_manager.py`
- [Order Placement](https://github.com/bhardwajtanuj/kotak-neo-async-trade-cli/blob/main/trade_manager.py): `trade_manager.py`
- [OCO Monitor](https://github.com/bhardwajtanuj/kotak-neo-async-trade-cli/blob/main/trade_manager.py): `trade_manager.py`
- [Monitor Registry](https://github.com/bhardwajtanuj/kotak-neo-async-trade-cli/blob/main/trade_manager.py): `trade_manager.py`

### Broker Integration

- [Async API Adapter](https://github.com/bhardwajtanuj/kotak-neo-async-trade-cli/blob/main/async_neo.py): `async_neo.py`
- [Mock Broker Client](https://github.com/bhardwajtanuj/kotak-neo-async-trade-cli/blob/main/async_neo.py): `async_neo.py`

### Trade Data

- [Trade Record](https://github.com/bhardwajtanuj/kotak-neo-async-trade-cli/blob/main/models.py): `models.py`

### Other components

- **Trader**
- **Kotak Neo Broker**

## Connections

- Trader → CLI Event Loop: enters commands (evidence: `main.py`)
- CLI Event Loop → LTP Stream: starts stream (evidence: `main.py`)
- LTP Stream → Async API Adapter: requests prices (evidence: `main.py`)
- CLI Event Loop → Trade Manager: submits trade (evidence: `main.py`)
- Trade Manager → Order Placement: executes trade (evidence: `trade_manager.py`)
- Order Placement → Risk Validation: validates risk (evidence: `trade_manager.py`)
- Order Placement → Async API Adapter: places and reads orders (evidence: `trade_manager.py`)
- Order Placement → Trade Record: creates record (evidence: `trade_manager.py`)
- Order Placement → Monitor Registry: registers monitor (evidence: `trade_manager.py`)
- Monitor Registry → OCO Monitor: runs task (evidence: `trade_manager.py`)
- OCO Monitor → Async API Adapter: checks and cancels (evidence: `trade_manager.py`)
- CLI Event Loop → Monitor Registry: shuts down (evidence: `main.py`)
- CLI Event Loop → Mock Broker Client: selects mock (evidence: `main.py`)
- Async API Adapter → Mock Broker Client: calls client (evidence: `async_neo.py`)
- Async API Adapter → Kotak Neo Broker: wraps broker calls
