# roan-maverick/tradingview-indicator-for-ai-agents architecture

> Architecture diagram of the GitHub repository roan-maverick/tradingview-indicator-for-ai-agents, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-14). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/roan-maverick/tradingview-indicator-for-ai-agents
- Repository: https://github.com/roan-maverick/tradingview-indicator-for-ai-agents

## Overview

AI Agent Lens is a TradingView Pine indicator that turns each closed candle into a structured market-context packet, then sends it by webhook for an AI agent to interpret as a trading signal. The chart indicator also presents scores, market structure, levels, and trade visualizations. The documented optional Python receiver stores incoming packets for later agent use. The repository has one substantial runtime source file; its distinct responsibilities are shown as nodes sharing that path. Relationships reflect the README; no source excerpts were available.

Main entry points: [`ai-agent-lens.pine`](https://github.com/roan-maverick/tradingview-indicator-for-ai-agents/blob/main/ai-agent-lens.pine) (Market analysis), [`examples/sample_signal.json`](https://github.com/roan-maverick/tradingview-indicator-for-ai-agents/blob/main/examples/sample_signal.json) (Trading signal), [`examples/webhook_receiver.py`](https://github.com/roan-maverick/tradingview-indicator-for-ai-agents/blob/main/examples/webhook_receiver.py) (Python receiver), [`agent/AGENT_PROMPT.md`](https://github.com/roan-maverick/tradingview-indicator-for-ai-agents/blob/main/agent/AGENT_PROMPT.md) (Agent prompt)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_indicator["Chart indicator"]
  node_market_analysis["Market analysis<br/>[ai-agent-lens.pine]"]
  node_score_trade["Scores and risk map<br/>[ai-agent-lens.pine]"]
  node_chart_display["Chart display<br/>[ai-agent-lens.pine]"]
  node_packet["Candle JSON packet<br/>[ai-agent-lens.pine]"]
  node_alert["Webhook alert<br/>[ai-agent-lens.pine]"]
end

subgraph group_agent["Agent workflow"]
  node_prompt["Agent prompt<br/>[AGENT_PROMPT.md]"]
  node_signal["Trading signal<br/>[sample_signal.json]"]
end

subgraph group_receiver["Packet receiver"]
  node_receiver_app["Python receiver"]
  node_packet_store[("Saved packets")]
end

node_trader(("Trader"))
node_tradingview["TradingView chart"]
node_webhook["Agent webhook"]
node_ai_agent["AI agent"]

node_tradingview -->|"runs indicator"| node_market_analysis
node_market_analysis -->|"calculates scores"| node_score_trade
node_market_analysis -->|"builds packet"| node_packet
node_score_trade -->|"renders context"| node_chart_display
node_tradingview -->|"shows indicator"| node_chart_display
node_packet -->|"supplies JSON"| node_alert
node_alert -->|"sends packet"| node_webhook
node_webhook -.->|"receives packet"| node_receiver_app
node_receiver_app -->|"saves packets"| node_packet_store
node_packet -->|"provides context"| node_ai_agent
node_prompt -->|"guides analysis"| node_ai_agent
node_ai_agent -->|"returns decision"| node_signal
node_signal -->|"presents signal"| node_trader

click node_market_analysis "https://github.com/roan-maverick/tradingview-indicator-for-ai-agents/blob/main/ai-agent-lens.pine"
click node_score_trade "https://github.com/roan-maverick/tradingview-indicator-for-ai-agents/blob/main/ai-agent-lens.pine"
click node_chart_display "https://github.com/roan-maverick/tradingview-indicator-for-ai-agents/blob/main/ai-agent-lens.pine"
click node_packet "https://github.com/roan-maverick/tradingview-indicator-for-ai-agents/blob/main/ai-agent-lens.pine"
click node_alert "https://github.com/roan-maverick/tradingview-indicator-for-ai-agents/blob/main/ai-agent-lens.pine"
click node_receiver_app "https://github.com/roan-maverick/tradingview-indicator-for-ai-agents/blob/main/examples/webhook_receiver.py"
click node_prompt "https://github.com/roan-maverick/tradingview-indicator-for-ai-agents/blob/main/agent/AGENT_PROMPT.md"
click node_signal "https://github.com/roan-maverick/tradingview-indicator-for-ai-agents/blob/main/examples/sample_signal.json"

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_market_analysis,node_score_trade,node_chart_display,node_packet,node_alert,node_tradingview toneBlue
class node_prompt,node_signal toneAmber
class node_receiver_app,node_packet_store,node_webhook toneMint
class node_trader,node_ai_agent toneIndigo
```

## Components

### Chart indicator

- [Market analysis](https://github.com/roan-maverick/tradingview-indicator-for-ai-agents/blob/main/ai-agent-lens.pine): `ai-agent-lens.pine`
- [Scores and risk map](https://github.com/roan-maverick/tradingview-indicator-for-ai-agents/blob/main/ai-agent-lens.pine): `ai-agent-lens.pine`
- [Chart display](https://github.com/roan-maverick/tradingview-indicator-for-ai-agents/blob/main/ai-agent-lens.pine): `ai-agent-lens.pine`
- [Candle JSON packet](https://github.com/roan-maverick/tradingview-indicator-for-ai-agents/blob/main/ai-agent-lens.pine): `ai-agent-lens.pine`
- [Webhook alert](https://github.com/roan-maverick/tradingview-indicator-for-ai-agents/blob/main/ai-agent-lens.pine): `ai-agent-lens.pine`

### Agent workflow

- [Agent prompt](https://github.com/roan-maverick/tradingview-indicator-for-ai-agents/blob/main/agent/AGENT_PROMPT.md): `agent/AGENT_PROMPT.md`
- [Trading signal](https://github.com/roan-maverick/tradingview-indicator-for-ai-agents/blob/main/examples/sample_signal.json): `examples/sample_signal.json`

### Packet receiver

- [Python receiver](https://github.com/roan-maverick/tradingview-indicator-for-ai-agents/blob/main/examples/webhook_receiver.py): `examples/webhook_receiver.py`
- **Saved packets**

### Other components

- **Trader**
- **TradingView chart**
- **Agent webhook**
- **AI agent**

## Connections

- TradingView chart → Market analysis: runs indicator (evidence: `README.md`)
- Market analysis → Scores and risk map: calculates scores (evidence: `README.md`)
- Market analysis → Candle JSON packet: builds packet (evidence: `README.md`)
- Scores and risk map → Chart display: renders context (evidence: `README.md`)
- TradingView chart → Chart display: shows indicator (evidence: `README.md`)
- Candle JSON packet → Webhook alert: supplies JSON (evidence: `README.md`)
- Webhook alert → Agent webhook: sends packet (evidence: `README.md`)
- Agent webhook → Python receiver: receives packet (evidence: `README.md`)
- Python receiver → Saved packets: saves packets (evidence: `README.md`)
- Candle JSON packet → AI agent: provides context (evidence: `README.md`)
- Agent prompt → AI agent: guides analysis (evidence: `README.md`)
- AI agent → Trading signal: returns decision (evidence: `README.md`)
- Trading signal → Trader: presents signal (evidence: `README.md`)