> For the complete documentation index, see [llms.txt](https://docs.openalgo.in/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.openalgo.in/developers/design-documentation/14-tradingview-and-gocharting.md).

# 14 - TradingView & GoCharting

## Overview

OpenAlgo integrates with TradingView and GoCharting platforms to receive trading signals via webhooks. These charting platforms can trigger automated trades when alert conditions are met.

## Architecture Diagram

```
┌──────────────────────────────────────────────────────────────────────────────┐
│                   TradingView / GoCharting Integration                        │
└──────────────────────────────────────────────────────────────────────────────┘

┌─────────────────────────────────────────────────────────────────────────────┐
│                    TradingView / GoCharting                                  │
│                                                                              │
│  ┌─────────────────────────────────────────────────────────────────────┐   │
│  │  Pine Script Strategy / Alert                                        │   │
│  │                                                                      │   │
│  │  strategy.entry() → Webhook trigger                                 │   │
│  │  strategy.exit()  → Webhook trigger                                 │   │
│  │  alert()          → Webhook trigger                                 │   │
│  └─────────────────────────────────────────────────────────────────────┘   │
└─────────────────────────────────────────────────────────────────────────────┘
                              │
                              │ HTTP POST (Webhook)
                              ▼
┌─────────────────────────────────────────────────────────────────────────────┐
│                     OpenAlgo REST API                                        │
│                                                                              │
│  POST /api/v1/placeorder      (Simple orders)                               │
│  POST /api/v1/placesmartorder (Position-based orders)                       │
└─────────────────────────────────────────────────────────────────────────────┘
```

## TradingView Webhook Setup

### Webhook URL

```
http://your-domain.com/api/v1/placeorder
```

### Alert Message Format

```json
{
    "apikey": "your_openalgo_api_key",
    "symbol": "{{ticker}}",
    "exchange": "NSE",
    "action": "{{strategy.order.action}}",
    "quantity": {{strategy.order.contracts}},
    "product": "MIS",
    "pricetype": "MARKET"
}
```

### Pine Script Variables

| Variable                       | Description    | Example             |
| ------------------------------ | -------------- | ------------------- |
| `{{ticker}}`                   | Trading symbol | SBIN                |
| `{{strategy.order.action}}`    | BUY or SELL    | BUY                 |
| `{{strategy.order.contracts}}` | Order quantity | 100                 |
| `{{close}}`                    | Closing price  | 625.50              |
| `{{time}}`                     | Alert time     | 2024-01-15T09:30:00 |

## Symbol Format Examples

### Equity

```json
{
    "apikey": "your_api_key",
    "symbol": "SBIN",
    "exchange": "NSE",
    "action": "BUY",
    "quantity": 100,
    "product": "MIS",
    "pricetype": "MARKET"
}
```

### Index Futures (NFO - Expires Tuesday)

```json
{
    "apikey": "your_api_key",
    "symbol": "NIFTY21JAN25FUT",
    "exchange": "NFO",
    "action": "BUY",
    "quantity": 65,
    "product": "MIS",
    "pricetype": "MARKET"
}
```

### Index Options (NFO - Expires Tuesday)

```json
{
    "apikey": "your_api_key",
    "symbol": "NIFTY21JAN2521500CE",
    "exchange": "NFO",
    "action": "BUY",
    "quantity": 65,
    "product": "MIS",
    "pricetype": "MARKET"
}
```

### Bank Nifty Options (NFO - Expires Tuesday)

```json
{
    "apikey": "your_api_key",
    "symbol": "BANKNIFTY21JAN2548000CE",
    "exchange": "NFO",
    "action": "BUY",
    "quantity": 30,
    "product": "MIS",
    "pricetype": "MARKET"
}
```

### SENSEX Options (BFO - Expires Thursday)

```json
{
    "apikey": "your_api_key",
    "symbol": "SENSEX23JAN2572000CE",
    "exchange": "BFO",
    "action": "BUY",
    "quantity": 20,
    "product": "MIS",
    "pricetype": "MARKET"
}
```

## Lot Sizes Reference

| Index      | Lot Size | Exchange | Expiry   |
| ---------- | -------- | -------- | -------- |
| NIFTY      | 65       | NFO      | Tuesday  |
| BANKNIFTY  | 30       | NFO      | Tuesday  |
| FINNIFTY   | 25       | NFO      | Tuesday  |
| MIDCPNIFTY | 50       | NFO      | Monday   |
| SENSEX     | 20       | BFO      | Thursday |
| BANKEX     | 30       | BFO      | Monday   |

## Smart Order for Position Management

### Webhook URL

```
http://your-domain.com/api/v1/placesmartorder
```

### Alert Message

```json
{
    "apikey": "your_api_key",
    "symbol": "SBIN",
    "exchange": "NSE",
    "action": "BUY",
    "position_size": 100,
    "product": "MIS",
    "pricetype": "MARKET"
}
```

### Position Size Logic

| Current Position | position\_size | Result             |
| ---------------- | -------------- | ------------------ |
| 0                | 100            | BUY 100            |
| 100              | 0              | SELL 100 (close)   |
| 100              | -100           | SELL 200 (reverse) |
| -50              | 50             | BUY 100 (reverse)  |

## GoCharting Webhook Setup

### Webhook URL

```
http://your-domain.com/api/v1/placeorder
```

### Alert Message

Same format as TradingView:

```json
{
    "apikey": "your_api_key",
    "symbol": "RELIANCE",
    "exchange": "NSE",
    "action": "BUY",
    "quantity": 10,
    "product": "CNC",
    "pricetype": "LIMIT",
    "price": 2450.00
}
```

## JSON Generator Endpoints

OpenAlgo provides JSON generators for easy webhook configuration:

### TradingView JSON Generator

**Endpoint:** `/tv-json`

Features:

* Select symbol, exchange, product
* Generate webhook JSON
* Copy to clipboard

### GoCharting JSON Generator

**Endpoint:** `/gc-json`

Features:

* Select symbol, exchange, product
* Generate webhook JSON
* Copy to clipboard

## Price Types

| Price Type | Description               | Required Fields          |
| ---------- | ------------------------- | ------------------------ |
| `MARKET`   | Execute at market price   | -                        |
| `LIMIT`    | Execute at specific price | `price`                  |
| `SL`       | Stop Loss Limit           | `price`, `trigger_price` |
| `SL-M`     | Stop Loss Market          | `trigger_price`          |

## Complete Webhook Examples

### Intraday Equity Buy

```json
{
    "apikey": "abc123def456",
    "symbol": "TATAMOTORS",
    "exchange": "NSE",
    "action": "BUY",
    "quantity": 500,
    "product": "MIS",
    "pricetype": "MARKET"
}
```

### Delivery Equity Buy

```json
{
    "apikey": "abc123def456",
    "symbol": "INFY",
    "exchange": "NSE",
    "action": "BUY",
    "quantity": 50,
    "product": "CNC",
    "pricetype": "LIMIT",
    "price": 1650.00
}
```

### NIFTY Option Buy (Tuesday Expiry)

```json
{
    "apikey": "abc123def456",
    "symbol": "NIFTY21JAN2521800CE",
    "exchange": "NFO",
    "action": "BUY",
    "quantity": 65,
    "product": "MIS",
    "pricetype": "MARKET"
}
```

### SENSEX Option Buy (Thursday Expiry)

```json
{
    "apikey": "abc123def456",
    "symbol": "SENSEX23JAN2572500PE",
    "exchange": "BFO",
    "action": "BUY",
    "quantity": 20,
    "product": "MIS",
    "pricetype": "MARKET"
}
```

## Key Files Reference

| File                                 | Purpose                    |
| ------------------------------------ | -------------------------- |
| `blueprints/tv_json.py`              | TradingView JSON generator |
| `blueprints/gc_json.py`              | GoCharting JSON generator  |
| `restx_api/place_order.py`           | Order placement API        |
| `restx_api/place_smart_order.py`     | Smart order API            |
| `frontend/src/pages/TradingView.tsx` | TradingView JSON helper UI |
| `frontend/src/pages/GoCharting.tsx`  | GoCharting JSON helper UI  |