# marketcalls/openalgo-docs architecture

> Architecture diagram of the GitHub repository marketcalls/openalgo-docs, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-28). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/marketcalls/openalgo-docs
- Repository: https://github.com/marketcalls/openalgo-docs

## Overview

This repository is OpenAlgo’s documentation, not its application source. The graph summarizes the platform architecture and workflows described in the README and product documentation; edges reflect documented capabilities, not inspected runtime call sites.

Main entry points: [`developers/design-documentation/api-layer.md`](https://github.com/marketcalls/openalgo-docs/blob/main/developers/design-documentation/api-layer.md) (Unified API), [`connect-brokers/brokers/README.md`](https://github.com/marketcalls/openalgo-docs/blob/main/connect-brokers/brokers/README.md) (Broker plugins), [`api-documentation/v1/data-api/README.md`](https://github.com/marketcalls/openalgo-docs/blob/main/api-documentation/v1/data-api/README.md) (Market data), [`README.md`](https://github.com/marketcalls/openalgo-docs/blob/main/README.md) (External signals)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entrypoints["Trading entrypoints"]
  node_external_signals["External signals<br/>[README.md]"]
  node_hosted_python["Hosted Python"]
  node_visual_flows["Visual strategies"]
  node_ai_agents["AI agents<br/>[README.md]"]
end

subgraph group_execution["Execution and safety"]
  node_api["Unified API<br/>[api-layer.md]"]
  node_approval["Order approval<br/>[action-center.md]"]
  node_broker_plugins["Broker plugins<br/>[README.md]"]
  node_sandbox["Sandbox execution<br/>[README.md]"]
end

subgraph group_data["Market and account data"]
  node_market_data["Market data<br/>[README.md]"]
  node_account_data["Account and order data<br/>[README.md]"]
  node_websocket["Live updates<br/>[websockets.md]"]
end

subgraph group_strategy["Strategies and analysis"]
  node_portfolio_tools["Portfolio analysis"]
  node_options_tools["Options analytics"]
  node_strategy_rms["Strategy monitoring"]
end

subgraph group_interfaces["User interfaces"]
  node_trading_terminal["Chart terminal"]
  node_scalping_terminal["Scalping terminal<br/>[fast-scalper.md]"]
end

node_traders(("Traders and developers"))
node_broker["Broker services"]

node_traders -->|"create signals"| node_external_signals
node_external_signals -->|"send requests"| node_api
node_traders -->|"configure strategies"| node_hosted_python
node_traders -->|"build flows"| node_visual_flows
node_traders -->|"use tools"| node_ai_agents
node_ai_agents -->|"invoke tools"| node_api
node_hosted_python -->|"submit orders"| node_api
node_visual_flows -->|"trigger orders"| node_api
node_api -.->|"request review"| node_approval
node_api -->|"dispatch operations"| node_broker_plugins
node_approval -->|"approve orders"| node_broker_plugins
node_broker_plugins -->|"submit operations"| node_broker
node_broker -->|"return results"| node_broker_plugins
node_broker_plugins -->|"provide account state"| node_account_data
node_api -->|"serve market queries"| node_market_data
node_broker_plugins -.->|"use paper execution"| node_sandbox
node_traders -->|"request analysis"| node_portfolio_tools
node_traders -->|"explore options"| node_options_tools
node_traders -->|"trade charts"| node_trading_terminal
node_traders -->|"manage scalps"| node_scalping_terminal
node_trading_terminal -->|"consume live data"| node_market_data
node_scalping_terminal -->|"monitor live ticks"| node_market_data
node_strategy_rms -->|"monitor orders"| node_account_data
node_market_data -->|"stream updates"| node_websocket

click node_external_signals "https://github.com/marketcalls/openalgo-docs/blob/main/README.md"
click node_hosted_python "https://github.com/marketcalls/openalgo-docs/blob/main/new-features/python-strategy-hosting.md"
click node_visual_flows "https://github.com/marketcalls/openalgo-docs/blob/main/new-features/flow-visual-strategy-builder.md"
click node_ai_agents "https://github.com/marketcalls/openalgo-docs/blob/main/mcp/README.md"
click node_api "https://github.com/marketcalls/openalgo-docs/blob/main/developers/design-documentation/api-layer.md"
click node_approval "https://github.com/marketcalls/openalgo-docs/blob/main/new-features/action-center.md"
click node_broker_plugins "https://github.com/marketcalls/openalgo-docs/blob/main/connect-brokers/brokers/README.md"
click node_sandbox "https://github.com/marketcalls/openalgo-docs/blob/main/README.md"
click node_market_data "https://github.com/marketcalls/openalgo-docs/blob/main/api-documentation/v1/data-api/README.md"
click node_account_data "https://github.com/marketcalls/openalgo-docs/blob/main/api-documentation/v1/accounts-api/README.md"
click node_websocket "https://github.com/marketcalls/openalgo-docs/blob/main/api-documentation/v1/websockets.md"
click node_portfolio_tools "https://github.com/marketcalls/openalgo-docs/blob/main/new-features/portfolio-analytics.md"
click node_options_tools "https://github.com/marketcalls/openalgo-docs/blob/main/analytics-and-options-tools.md"
click node_strategy_rms "https://github.com/marketcalls/openalgo-docs/blob/main/new-features/strategy-rms-engine.md"
click node_trading_terminal "https://github.com/marketcalls/openalgo-docs/blob/main/new-features/trading-terminal.md"
click node_scalping_terminal "https://github.com/marketcalls/openalgo-docs/blob/main/new-features/fast-scalper.md"

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_external_signals,node_hosted_python,node_visual_flows,node_ai_agents toneBlue
class node_api,node_approval,node_broker_plugins,node_sandbox toneAmber
class node_market_data,node_account_data,node_websocket toneMint
class node_portfolio_tools,node_options_tools,node_strategy_rms toneRose
class node_trading_terminal,node_scalping_terminal,node_traders,node_broker toneIndigo
```

## Components

### Trading entrypoints

- [External signals](https://github.com/marketcalls/openalgo-docs/blob/main/README.md): `README.md`
- [Hosted Python](https://github.com/marketcalls/openalgo-docs/blob/main/new-features/python-strategy-hosting.md): `new-features/python-strategy-hosting.md`
- [Visual strategies](https://github.com/marketcalls/openalgo-docs/blob/main/new-features/flow-visual-strategy-builder.md): `new-features/flow-visual-strategy-builder.md`
- [AI agents](https://github.com/marketcalls/openalgo-docs/blob/main/mcp/README.md): `mcp/README.md`

### Execution and safety

- [Unified API](https://github.com/marketcalls/openalgo-docs/blob/main/developers/design-documentation/api-layer.md): `developers/design-documentation/api-layer.md`
- [Order approval](https://github.com/marketcalls/openalgo-docs/blob/main/new-features/action-center.md): `new-features/action-center.md`
- [Broker plugins](https://github.com/marketcalls/openalgo-docs/blob/main/connect-brokers/brokers/README.md): `connect-brokers/brokers/README.md`
- [Sandbox execution](https://github.com/marketcalls/openalgo-docs/blob/main/README.md): `README.md`

### Market and account data

- [Market data](https://github.com/marketcalls/openalgo-docs/blob/main/api-documentation/v1/data-api/README.md): `api-documentation/v1/data-api/README.md`
- [Account and order data](https://github.com/marketcalls/openalgo-docs/blob/main/api-documentation/v1/accounts-api/README.md): `api-documentation/v1/accounts-api/README.md`
- [Live updates](https://github.com/marketcalls/openalgo-docs/blob/main/api-documentation/v1/websockets.md): `api-documentation/v1/websockets.md`

### Strategies and analysis

- [Portfolio analysis](https://github.com/marketcalls/openalgo-docs/blob/main/new-features/portfolio-analytics.md): `new-features/portfolio-analytics.md`
- [Options analytics](https://github.com/marketcalls/openalgo-docs/blob/main/analytics-and-options-tools.md): `analytics-and-options-tools.md`
- [Strategy monitoring](https://github.com/marketcalls/openalgo-docs/blob/main/new-features/strategy-rms-engine.md): `new-features/strategy-rms-engine.md`

### User interfaces

- [Chart terminal](https://github.com/marketcalls/openalgo-docs/blob/main/new-features/trading-terminal.md): `new-features/trading-terminal.md`
- [Scalping terminal](https://github.com/marketcalls/openalgo-docs/blob/main/new-features/fast-scalper.md): `new-features/fast-scalper.md`

### Other components

- **Traders and developers**
- **Broker services**

## Connections

- Traders and developers → External signals: create signals
- External signals → Unified API: send requests
- Traders and developers → Hosted Python: configure strategies
- Traders and developers → Visual strategies: build flows
- Traders and developers → AI agents: use tools
- AI agents → Unified API: invoke tools
- Hosted Python → Unified API: submit orders
- Visual strategies → Unified API: trigger orders
- Unified API → Order approval: request review
- Unified API → Broker plugins: dispatch operations
- Order approval → Broker plugins: approve orders
- Broker plugins → Broker services: submit operations
- Broker services → Broker plugins: return results
- Broker plugins → Account and order data: provide account state
- Unified API → Market data: serve market queries
- Broker plugins → Sandbox execution: use paper execution
- Traders and developers → Portfolio analysis: request analysis
- Traders and developers → Options analytics: explore options
- Traders and developers → Chart terminal: trade charts
- Traders and developers → Scalping terminal: manage scalps
- Chart terminal → Market data: consume live data
- Scalping terminal → Market data: monitor live ticks
- Strategy monitoring → Account and order data: monitor orders
- Market data → Live updates: stream updates