TradeBridge — User Guide
On this page
Getting started
Install and first run
Copy linkTradeBridge is a Windows application, and it runs on a Windows cloud machine — see Before you start for why that is required rather than optional. Minimum specification: 1 vCPU · 4 GB RAM · 50 GB HA NVMe. You can bring your own or use MyAlgoMate's cloud server.
Getting the installer. After your purchase, sign in to your MyAlgoMate account and open your subscriptions. Your TradeBridge subscription is listed there with a Download button.
- Download the installer from that page.
- Connect to your cloud machine (Remote Desktop).
- Copy the installer across, run it, and start TradeBridge.
Sign in with your MyAlgoMate account — the email and password you registered with. These are not your broker credentials; brokers are added later, one account at a time.
On first start the application downloads the day's instrument list. Until that finishes START stays unavailable and the footer reads Downloading instruments…. It happens once per day.
Figures shown in screenshots throughout this guide are sample data for illustration, not results.
The workspace
Copy linkEverything happens in one window.
- The menu bar — Session, Accounts, Portfolios, Strategies, View, Settings, Help. Everything you can do is in one of those.
- Seven tabs — Portfolio, Strategies, Legs Detail, Order Book, Position, A/C Management and Index Summary. Each answers a different question about what is happening.
- The log panel at the bottom, with Application Logs and Execution Logs.
- The footer shows internet and feed status, and the date and time.
Paper Trade or live
Copy linkThe command bar carries the controls you will use most, and the badge that matters most.
- START begins the trading session. Nothing executes until you press it.
- EXIT ALL squares off everything, immediately.
- The PAPER TRADE badge shows the current mode. In Paper mode the whole system runs — signals arrive, contracts resolve, positions appear — but no order reaches your broker.
Run a new setup in Paper first. It is the only way to watch a strategy behave end to end without money involved.
Connect your accounts
Add a broker account
Copy linkA/C Management lists every broker account you have added.
Each row carries its own controls — Login / Logout, Exit All for that account, RMS for its risk limits, and a … menu for the rest — alongside its login status, P&L, funds, margin, risk caps and multiplier.
To add one, open Accounts ▸ Add Account… and pick your broker.
The same menu holds Login All Accounts, Login Selected, Auto Login on startup, and Save / Load Account Template… for moving a set-up between machines.
What each broker asks for
Copy linkEvery account starts with the same three fields — A/C Name (your own label), Client ID and Multiplier — and then the form changes to match the broker you picked.
Most brokers ask for some combination of a password or MPIN, a TOTP secret, and an API key and secret that you generate in your broker's own developer portal. A few also want a vendor or dealer code, a base URL, or your date of birth.
The exact fields for your broker are listed on our brokers page — myalgomate.com/brokers — which is kept up to date as brokers change their requirements. You do not have to go looking for it: the Add Account dialog links straight to your broker's page once you have picked the broker.
Brokers running on the XTS platform share one longer form instead:
Market and Interactive API Key and Secret Key pairs, a Base URL, a User Type, and optional Hostlookup, Binary Market Data and Dealer Code.
Two sections at the foot of the form are shared by every account: Telegram alerts, and a Proxy if your network needs one.
Get the API key and secret from your broker's own developer or API portal. TradeBridge cannot create them for you.
Groups and multipliers
Copy linkRunning several accounts does not mean running the same size on all of them, or assigning every account by hand every time.
Multiplier — sizing per account
Set it per account in the Add Account form; it is also a column in the A/C Management grid. The strategy's lot count is multiplied by it on that account.
Example. You build a strategy with 2 lots. On an account whose multiplier is 3, that account trades 2 × 3 = 6 lots. An account left at multiplier 1 trades the 2 lots as written.
That is how one strategy serves a large account and a small one at the same time — you size the strategy once and let each account scale itself.
Groups — assigning accounts without remembering them
A group is a named set of accounts. Open Accounts ▸ Group Manager….
Type a name, press Create Group, tick the accounts that belong to it, and Save Members.
GROUP-A with the seven and GROUP-B with the three. From then on you assign the group rather than picking accounts one by one, and you do not have to remember which account belongs where.Add an account to a group later and it inherits everything that group already runs.
Logging in and account templates
Copy linkAccounts must be logged in before you start the trading session — logging in is not available afterwards.
| Menu item | What it does |
|---|---|
| Login All Accounts | Logs in every account you have added |
| Login Selected / Logout Selected | Acts only on the rows you have ticked |
| Auto Login on startup | A checkbox — logs your accounts in automatically each time the application starts |
| Delete Selected | Removes the ticked accounts |
| Save Account Template… | Writes your account set-up to a file |
| Load Account Template… | Restores it — use this when moving to a new cloud machine |
Each row in A/C Management also has its own Login / Logout button, and the Login Status and Login Message columns tell you what happened if one fails.
Build a strategy
Portfolios
Copy linkA portfolio is a group of related strategies. You assign accounts — or a group of accounts — to the portfolio once, and every strategy inside it runs on them. You do not repeat that assignment for each strategy.
Open Portfolios ▸ Create Portfolio….
- Portfolio Name — must be unique. It is how executions are tracked and reported.
- Run Portfolio For — choose Account or Group.
- Tick the accounts or groups it runs on. The count of what you have selected is shown as you go.
- Press Create Portfolio.
Because the accounts live on the portfolio, changing them moves every strategy inside it at once — which is the point. Build your strategies, drop them in a portfolio, and manage the account assignment in one place.
From the Portfolio tab and the Portfolios menu you can also:
- Activate / deactivate a portfolio with the toggle on its row.
- Exit Selected or Reset Selected for the whole portfolio at once.
- Fire a pending portfolio immediately by hand rather than waiting for a signal.
- Import Portfolios… and Export All Portfolios… — a backup, and the way to move a configuration to another machine.
The basics
Copy linkOpen Strategies ▸ Create Strategy…. The top band is the whole identity of the strategy.
| Field | What it does |
|---|---|
| Name | Yours. It also becomes part of the webhook URL. |
| Portfolio | Which portfolio — and therefore which accounts — this runs on. |
| Segment | Indices, Equity or MCX. |
| Index | The underlying, for Indices and MCX. Equity leaves it blank; the symbol arrives with the signal. |
| Underlying | Price the strikes off Spot, Future, or a synthetic future. |
| Product | MIS for intraday, NRML to carry forward. |
| Trade Type | Intraday, Positional or STBT. |
| Start Time · Stop Entry · Exit Time | The window a signal may act in — see Send your signals. |
The legs
Copy linkA leg is one instrument you trade. A short straddle is two legs; an iron condor is four.
Each row sets instrument type (CE / PE / FUT / EQ), buy or sell, size, how the strike is chosen, and its own Target, SL, Trail and Expiry. Copy a leg, delete it, or ADD LEG up to eight.
Choosing the strike — evaluated live when the signal fires, never fixed in advance:
| Mode | In short |
|---|---|
| ATM Points | N strikes either side of at-the-money |
| ATM % | A percentage away from spot |
| Direct Strike | A strike you name |
| Closest Premium | The strike trading nearest a premium |
| Closest Delta | The strike nearest a delta |
| CP Strikes based on SP | Call and put derived from a chosen sell strike |
| Straddle Width | Derived from the ATM straddle price |
Tick Hedge and every leg gains a hedge configuration, pairing a short option with a long one for the margin benefit.
Sizing is fixed lots, or capital-based: give the capital plus a minimum and maximum lot count and TradeBridge sizes the leg to fit.
How orders are placed
Copy linkThe ORDER SETTING tab controls how an order reaches the broker — separately for entry, exit and stop-loss orders, because they do not want the same treatment.
- Limit Price Ref — price the order off LTP, best bid/ask, immediate-fill or average bid/ask.
- Limit Buffer — how far through that price to sit, in percent or points.
- If Not Filled — revise the limit price or wait; set the interval and how many revisions before giving up.
- Order Rejection Retry — retry a rejected order N times at an interval you set.
- Place SL in Broker / Trail SL in Broker — push the stop-loss to the broker as a real resting order rather than holding it in the software.
Other Setting
Copy linkThe OTHER SETTING tab holds the finer execution rules — when exits are evaluated, how prices are rounded, and how strikes are selected.
Target and SL check frequency
How often the software evaluates whether a target or stop-loss has been reached.
| Setting | When it checks |
|---|---|
| Live | Every second |
| 1 min · 3 min · 5 min | At the close of each candle on that timeframe |
Choose Live for tight intraday exits. Choose a timeframe when you want a candle to complete before acting, so an intra-candle spike does not take you out.
SL and Target reference price
Whether the level is calculated from the leg's real entry price — the price actually filled — or from the LTP at the moment entry was triggered. They differ when there is slippage between the signal and the fill.
Wait for hedge to execute
When hedging is enabled, this makes the software place the hedge first and wait for it to execute before firing the main leg. Doing it in that order means the protective long is in place before the short goes on, which is what keeps the margin benefit. Without it the main leg can go first and the account is briefly exposed to full margin.
Ceiling for SL and Target
Rounds the calculated stop-loss or target price up to the next whole number.
246.30 becomes 247. A target of 81.10 becomes 82.Strike rounding
Rounds the selected strike to a multiple you set, separately for main and hedge legs — so the software only ever picks strikes that actually exist for that underlying.
10000 and the strike will be 220000, 230000 and so on — never 224500. For NIFTY, set 100 and strikes land on 24800, 24900, 25000.Direction is configurable too: round Towards OTM, Towards ITM, or to the Closest strike.
Premium and delta match tolerance
When a strike is chosen by Closest Premium or Closest Delta, the nearest contract may not be an exact match. Set how close it must be, and what happens when nothing falls inside that tolerance: Avoid Entry, Keep waiting, or Wait for X seconds and then take the closest available.
Before you save
Copy linkThe foot of the dialog counts your legs by side and type as you build.
It also warns about things that are valid but rarely intended — a strategy with neither a max loss nor a max profit, for example, which will run uncapped. Fix what it flags, then ADD STRATEGY.
Risk management
Limits on a strategy
Copy linkYour signal decides when to enter. The risk manager decides when to get out regardless.
| Control | What it does |
|---|---|
| Max Loss · Max Profit | Exit when the loss or profit reaches this figure |
| Frequency | How often the limit is checked |
| Exit Mode | Immediately, after a delay, or after a number of ticks — so one spike does not trigger an exit |
| Trail Max Loss (X / Y) | Tighten the loss limit as profit builds: for every X gained, the limit moves by Y |
| Protect Profit | Ignore, Lock Min Profits, Trail Profits, or Lock & Trail Profits |
| If Profit Reaches · Lock Min Profit At | The profit that starts locking, and the minimum then held |
| Increase In Profit · Trail Min Profit By | How far profit must rise to move the lock, and by how much |
Set here, these limits travel with the strategy — every account running it inherits them.
Limits on an account
Copy linkA broker account usually carries several strategies at once. Account-level risk watches the account as a whole, whatever any individual strategy is doing.
Press RMS on any row of A/C Management.
| Control | What it does |
|---|---|
| Max Loss | Exit everything on this account when the loss reaches this figure |
| Max Profit | Exit everything on this account when the profit reaches this figure |
| Frequency | How often the limit is checked |
| Exit Mode | Immediately, after a delay in seconds, or after a number of ticks — so one spike does not trigger an exit |
| Trail Max Loss (X / Y) | Tighten the loss limit as the account gains: for every X gained, the limit moves by Y |
| Protect Profit | Ignore, Lock Min Profits, Trail Profits, or Lock & Trail Profits |
| If Profit Reaches · Lock Min Profit At | The profit that starts locking, and the minimum then held |
| Increase In Profit · Trail Min Profit By | How far profit must rise to move the lock, and by how much |
| Exit Time | Square this account off at a time you choose |
Once set, the A/C Management grid shows the state beside the settings — the account's running P&L, whether trading has been stopped, and the profit currently locked — so you can see a limit working rather than merely configured.
Account limits and strategy limits are independent, and both apply. A strategy can be stopped by its own rule while the account carries on, or an account limit can flatten everything on that account at once.
Risk settings stay editable while trading is live, so you can always tighten one mid-session. Anything switched off reads Disabled rather than showing a stale number.
Limits across all accounts
Copy linkThe widest of the three scopes. Global limits watch the combined position of every account together, so a day that goes wrong across several accounts at once is still capped even when no single account or strategy breached its own rule.
Open Settings ▸ RMS Settings.
| Control | What it does |
|---|---|
| Max Loss (-) | Exit every account when the combined loss reaches this figure |
| Max Profit (+) | Exit every account when the combined profit reaches this figure |
| Frequency | How often the combined total is checked |
| Exit Mode | Immediately, after a delay in seconds, or after a number of ticks |
| Trail Max Loss X / Y | Tighten the combined loss limit as the total gains: for every X gained, the limit moves by Y |
| Intraday Time Base Exit | Square everything off, across all accounts, at the time you set |
| Protect Profit | Ignore, Lock Min Profits, Trail Profits, or Lock & Trail Profits, applied to the combined profit |
| If Profit Reaches · Lock Min Profit At | The combined profit that starts locking, and the minimum then held |
| Increase In Profit · Trail Min Profit By | How far the total must rise to move the lock, and by how much |
Press Save RMS after any change — the screen tells you so.
A worked example. Set Max Profit to a figure and it is the total across all accounts that is measured. If three accounts are up and one is down, it is the net of all four that counts; when that net reaches your figure, all four are squared off together.
All three scopes run at once. Global, per account and per strategy limits are independent, and whichever triggers first acts. A strategy can be stopped by its own rule while everything else carries on, or the global limit can flatten the lot.
Unlike Index Settings and Telegram, RMS settings stay editable while trading is live, so you can tighten a limit mid-session.
Send your signals
Before you start — what you need
Copy linkConnecting a signal source needs three things in place. None of them is difficult, but missing one is the usual reason a first setup does not fire.
1 · A Windows cloud machine. This is required, not recommended. The signal listener lives inside TradeBridge, so if the application is closed — or the machine sleeps, restarts for updates, or loses power — nothing is listening and your signals are lost with no warning to the sender.
A cloud machine solves three problems at once: it stays on around the clock, it does not sleep or reboot under you, and it has a stable public address, where a home broadband address changes and silently breaks the URLs you have already given to Chartink or TradingView.
Minimum specification: 1 vCPU · 4 GB RAM · 50 GB HA NVMe.
Bring your own, or use MyAlgoMate's cloud server, which comes ready for this.
2 · A paid plan on your signal source.
| Source | What you need |
|---|---|
| Chartink | A paid subscription. Webhook alerts and real-time scans are premium features — on a free plan the scan data is delayed, so entries arrive late even when everything else is correct. |
| TradingView | A paid plan. Webhook notifications are not available on the free tier. |
3 · An address your signal source can reach. Chartink and TradingView are cloud services, so they must reach your machine over the internet. On a cloud machine this is normally already the case — one more reason it is the supported setup. See Local IP or Public IP for what to check.
Everything after this assumes those three are done, plus a strategy built and the broker accounts connected.
Get your entry and exit URLs
Copy linkEvery strategy gets two URLs — one that opens a position, one that closes it. They live in the Webhook band of the Create Strategy screen, directly under the strategy details.
- Give the strategy a Name first. The GENERATE buttons stay disabled until you do, because the name is built into the URL.
- Pick your Integration — Chartink, Trading View or Custom. This tells TradeBridge how to read what arrives.
- Choose Public IP or Local IP (next section).
- Press GENERATE on the ENTRY row, then on the EXIT row.
- Press COPY and paste the URL into Chartink or TradingView.
A URL looks like this:
http://203.0.113.10:8080/CI_S1_Entry/a1b2c3d4-e5f6-4a7b-8c9d-000000000001/The CI_ marks it as Chartink (TI_ is TradingView, Custom has no prefix), S1 is your strategy name, Entry is the signal type, and the long code at the end is a token unique to that URL.
That token is also the only thing protecting the URL. Treat it like a password: do not post it in a screenshot, a forum, or a shared document.
Local IP or Public IP
Copy linkThe Public IP / Local IP switch decides which address goes into the URL. It is a real trade-off, not a formality.
| Local IP | Public IP | |
|---|---|---|
| Reachable from | Only your own network or VPN | Anywhere on the internet |
| Use it when | Your code, Excel or scanner runs on the same network as TradeBridge | The signal comes from Chartink, TradingView or a cloud server |
| Exposure | Nothing is reachable from outside | The port is open to the internet; the token is what protects it |
| Stability | Your local address rarely changes | A home broadband address usually changes, and the URL changes with it |
| Extra setup | None | The port must be forwarded to this machine on your router or cloud firewall |
Chartink and TradingView are cloud services, so they need the Public IP URL. Your own code running on the same machine or network can use the Local IP one.
Three things worth knowing:
- TradeBridge adds the Windows Firewall rule for port 8080 by itself. The router port-forward is the part you have to do.
- If your broadband address changes, the public URL you pasted stops matching and signals are dropped. A static IP or a dynamic-DNS setup avoids re-issuing URLs every time.
- You can publish the URL on a different port. TradeBridge always listens on 8080, but the port in the URL you hand out is yours to choose — useful when a network blocks 8080 outbound, or when you would rather expose the standard web port. Forward the outside port to 8080 on the TradeBridge machine, then edit the port in the ENTRY and EXIT boxes to match what the outside world will call. For example, forward external 80 → 8080 and publish:
http://203.0.113.10:80/TI_NIFTY_LONG_Entry/a1b2c3d4-e5f6-4a7b-8c9d-000000000003/The URL in the strategy must match what the caller uses, port included. TradeBridge matches an incoming call against the URL it has stored, so a strategy holding:8080will not answer a call made to:80, and the reverse is also true. And remember that pressing GENERATE writes a fresh:8080URL — re-apply your port after any regeneration.
How many scanners or alerts do you need?
Copy linkPlan this before you start creating things, because the number grows faster than people expect.
A strategy carries its own direction. Whether each leg buys or sells is fixed when you build the strategy, and neither Chartink nor TradingView sends a direction — their alerts say what and when, never which way. So a long setup and a short setup are two different strategies, with two different sets of URLs.
Every strategy needs two signals: one for entry, one for exit.
That gives a simple formula:
signals = strategies × 2, where strategies = one per direction, per underlying
An index or a commodity counts as one underlying. A whole basket of stocks also counts as one, because a single Equity strategy handles every symbol its scan returns.
| What you want to trade | Strategies | Signals |
|---|---|---|
| A basket of stocks, long only | 1 | 2 — entry and exit, any number of stocks |
| A basket of stocks, long and short | 2 | 4 |
| NIFTY, long only | 1 | 2 |
| NIFTY, long and short | 2 | 4 |
| NIFTY and BANKNIFTY, long and short | 4 | 8 |
| GOLD and CRUDEOIL, long only | 2 | 4 |
The first two rows are the bargain: one pair of signals covers a basket of any size. The rest grow one strategy at a time, because an index or commodity strategy trades only the underlying it was built with — you choose it in the Index dropdown, and the incoming signal cannot change it.
If your system reverses — buy closes the short and opens the long — you can halve these numbers by sharing one URL between two strategies. See Reversal systems, next.
Name everything so the pairing is obvious. NIFTY Long Entry, NIFTY Long Exit, NIFTY Short Entry, NIFTY Short Exit takes a moment longer and saves you pasting the wrong URL later.
If you want a single signal to decide direction for itself, that is what the Custom JSON integration is for — it takes an explicit order side per leg. Chartink and TradingView cannot express it.
Reversal systems — one signal, two strategies
Copy linkMany systems are always in the market: a buy alert closes the short and opens a long, a sell alert does the reverse. You do not need four signals for that — you need two.
The trick is that a URL is not owned by one strategy. When a call arrives, TradeBridge checks it against every strategy's entry URL and every strategy's exit URL, and everything that matches acts on it. So the same URL can be one strategy's exit and another's entry.
Wire it like this, with a Long strategy and a Short strategy:
| Your signal | Paste that URL into |
|---|---|
| Buy | Long strategy's ENTRY — and Short strategy's EXIT |
| Sell | Short strategy's ENTRY — and Long strategy's EXIT |
To do it, generate the URL on one strategy, press COPY, then open the other strategy and paste it into the opposite box instead of pressing GENERATE there. The URL boxes accept pasted text — that is what makes this possible.
Now one buy alert flattens the short and opens the long in a single call, and you maintain two alerts instead of four.
Three things to know before you rely on it:
- The exit is triggered first, then the entry — that ordering is deliberate, so a reversal closes before it opens. But TradeBridge does not wait for the exit to fill before placing the entry. If your account is tight on margin, the new position may be requested while the old one is still closing.
- The URL keeps the name of the strategy it was generated on. A URL reading
…/CI_MULTI_STOCK_LONG_Entry/…sitting in the Short strategy's EXIT box looks wrong and is not. Only the token identifies it. - Regenerating breaks both ends. Press GENERATE on that URL and every strategy using it stops responding, not just the one you were looking at. Repaste it everywhere it appears.
Chartink — many stocks from one scanner
Copy linkChartink drives Equity strategies. The Chartink option is available when the segment is Equity; for indices and commodities use TradingView or the Custom API.
Build the strategy with Segment: Equity and leave the symbol alone — there is no symbol to set, because it arrives with the alert.
Your scan returns a list, and TradeBridge enters every symbol in it from that one call. You do not need a scanner per stock, and you do not need to name the stocks anywhere in TradeBridge.
The Symbol column in those results is exactly what arrives, so the scan that returns twelve rows opens twelve positions.
Two consequences to plan for:
- There is no cap. If your scan returns forty symbols, TradeBridge attempts forty entries. Keep the scan tight, and size each leg on the assumption that several may fire together.
- A symbol already in the position is skipped, not doubled. If the same stock appears in a later alert while its leg is still open, TradeBridge logs that it was skipped and moves on.
Chartink does not send an exchange, so TradeBridge looks the symbol up on NSE and falls back to BSE. Symbols that are not listed on either are reported as not found.
Direction still splits it. The scan says which stocks, not which way to trade them — that is fixed on the strategy. A long basket and a short basket are two Equity strategies, each with its own scanner pair.
Chartink — creating the entry and exit alerts
Copy linkEach scanner needs its own alert, and each alert carries one TradeBridge URL.
- Open your entry scan and press Create Alert.
- Give it an Alert Name you will recognise later.
- Paste the strategy's ENTRY URL into the Webhook box — the field that reads "Enter url/link for which a POST callback will be triggered on a alert". It is marked OPTIONAL; for TradeBridge it is the only part that matters.
- Press Save alert, then repeat with your exit scan and the strategy's EXIT URL.
The Schedule settings decide how often your signal can fire:
| Setting | What to use |
|---|---|
| Frequency | How often the scan runs. This is the fastest your signal can arrive — a 5-minute frequency cannot produce a 1-minute entry. |
| Minimum matches | How many results are needed before the alert fires. Leave at 1 for a stock basket. |
| After trigger | Continue keeps the alert live for the rest of the day; Pause stops it after the first hit. Use Pause if the strategy should only enter once. |
| Duplicates | Unique sends each symbol once; Duplicate lets it fire again. For a stock basket either is safe — TradeBridge skips any symbol that already has an open position. The difference appears after a position closes: on Duplicate a later alert can re-enter the same stock, on Unique it cannot. |
You do not need to tick anything under Delivery. Email, SMS and the rest are for you; the webhook is what reaches TradeBridge.
Name alerts after the signal, not after the strategy. Multi Stock ST Buy and Multi Stock ST Sell are better than Entry and Exit, because the same alert can be an entry for one strategy and an exit for another — see Reversal systems. If you only ever trade one direction, … Entry / … Exit is perfectly clear.
Leave Payload Columns alone. TradeBridge reads the standard fields Chartink sends — the list of stocks and their trigger_prices. If you have changed them, press View JSON and check both are still there before you save.
Chartink is always told the signal was received, even when TradeBridge rejects it. A green result in Chartink means "delivered", not "traded" — the app's own messages are the place to check whether anything happened.
Which is what Test webhook is for. Press it and the call goes to TradeBridge exactly as a real alert would, so you can watch it land in the execution log before market hours.
TradingView — creating the entry alert
Copy linkA TradingView alert needs three things from you: a condition, a Message, and a Webhook URL.
Open the Create alert on … dialog and set the top half as you normally would.
| Row | What to set |
|---|---|
| Condition | Your entry rule. TradeBridge does not care what it is. |
| Interval | The timeframe the condition is evaluated on. |
| Trigger | Once per bar close is the safe default — Once per bar can fire on a bar that later reverses. |
| Expiration | Set Open-ended, or the alert quietly stops working on its expiry date. |
The bottom two rows are the ones that matter, and both open their own panel:
- Message › — replace the text with TradeBridge's JSON. See the next section; this step is not optional and TradingView's default text will not work.
- Notifications › — tick Webhook URL and paste the strategy's ENTRY URL into the box beneath it. Its own description says it plainly: "Sends a POST request to your specified URL when your alert triggers."
Then press Create, and build a second alert the same way carrying the EXIT URL.
Every strategy needs its own pair, and a long strategy and a short strategy are two different strategies — a TradingView alert carries no direction, so it cannot tell TradeBridge which way to trade. Running NIFTY both ways means four alerts, unless you share URLs as described in Reversal systems.
Webhook alerts are a paid TradingView feature. If Webhook URL is missing from your Notifications panel, that is why.
TradingView — the alert message
Copy linkTradingView pre-fills the Message box with a description of your condition — something like MA Cross (50, 200) Crossing Up MA Cross (50, 200) on {{ticker}}, 1W.
Delete all of it. That text means nothing to TradeBridge. Replace it with this, and nothing else:
{
"symbol": "{{ticker}}",
"exchange": "{{exchange}}",
"time": "{{time}}",
"timenow": "{{timenow}}"
}The pieces in double braces are TradingView's own placeholders — it fills them in when the alert fires. You do not edit them, and you do not need the Add placeholder button; the four you need are already in the text above.
You can copy this text straight out of TradeBridge: set the integration to Trading View and press SAMPLE PAYLOADS.
"symbol": "{{exchange}}:{{ticker}}" and do not type a symbol like NSE:RELIANCE by hand. TradeBridge looks the contract up from the symbol alone and reads the exchange from its own field, so a combined value finds nothing and the entry is abandoned. The two fields are separate for exactly this reason.TradingView — one alert per index
Copy linkAlerts on an index work exactly like the one above — the dialog is the same, you just open it on the index rather than on a stock. What changes is what TradeBridge does with it.
For an Indices or MCX strategy, the symbol in the alert is ignored. The strategy trades the index or commodity you chose when you built it, and the alert is a pure trigger.
So each index or commodity needs its own strategy and its own pair of alerts — one entry, one exit — and again, one set per direction. An alert placed on a BANKNIFTY chart pointed at a NIFTY strategy will enter NIFTY, and nothing will warn you, so keep each alert on the chart it belongs to.
Set the message to the standard JSON even for index alerts. It costs nothing and keeps every alert in your account identical.
TradingView — alerts on a watchlist
Copy linkFor stocks you do not need an alert per symbol. Build a watchlist, then create the alert with the watchlist as its subject instead of a single chart — the dialog title reads Create alert on <your watchlist>.
Everything else is identical to a single-symbol alert, with one extra row: Session, which decides whether the condition is evaluated in regular hours only or extended hours too. Regular is what you want for Indian equities.
This works because of the message. {{ticker}} and {{exchange}} are filled in per symbol, so TradingView sends TradeBridge one call for each stock that triggers, each naming itself. Add a stock to the watchlist and it is covered; remove it and it is not.
The strategy behind it is an ordinary Equity strategy with no symbol set — the same one described in the Chartink stocks section. A symbol that already has an open leg is skipped rather than entered twice.
If you trade the same watchlist both ways, use two watchlists or two alert sets — one pointed at your long strategy, one at your short — because the alert itself cannot say which.
Sending signals from your own code
Copy linkChoose Custom as the integration when you have written your own strategy. Instead of TradeBridge inferring what to trade, you state it outright in JSON and POST it to the strategy's URL.
Press SAMPLE PAYLOADS in the Webhook band for a working example of every action, ready to copy.
| Action | What it does |
|---|---|
| STRATEGY_ENTRY | Enter one or more strategies, each with its own legs |
| STRATEGY_EXIT | Exit the strategies you name |
| STRATEGY_EXIT_ALL | Exit everything currently running |
| LEG_EXIT | Exit individual legs, leaving the rest of the strategy running |
| LEG_PARTIAL_EXIT | Book part of a leg, by LOTS or PERCENT |
Each leg in `STRATEGY_ENTRY` carries:
| Field | Values |
|---|---|
| LegID | Your own id — referenced later by LEG_EXIT and LEG_PARTIAL_EXIT |
| Exchange | NSE · NFO · BFO · BSE · MCX |
| InstrumentType | The instrument, for example OPTSTK; equity legs are handled separately |
| Symbol | The underlying |
| ExpiryDate | dd/MM/yyyy |
| StrikePrice | Numeric |
| OptionType | CE · PE · FUT · EQ |
| OrderSide | BUY · SELL — the only integration that can state direction |
| QuantityLots | Lots, not units — the lot size is applied for you |
| HedgeConfig | { Enabled, StrikePrice, QuantityLots } |
| StopLoss | { Enabled, Type, Value } — SL: %, SL: Pts or SL: Abs |
| TakeProfit | { Enabled, Type, Value } — TGT: %, TGT: Pts or TGT: Abs |
The ids are yours to choose, and yours to reuse
This is the part that catches people out. TradeBridge does not invent identifiers for you — your code supplies them, and every later call refers back to the same ones.
| Id | You set it when | You reuse it to |
|---|---|---|
| Webhook strategy id | Creating a new strategy in the payload | Add more legs to it, exit some of its legs, or exit the whole strategy |
| Webhook strategy name | Same call, alongside the id | Same — it travels with the id |
| Leg id | Creating each leg | Exit that leg, or book part of it |
Both must be unique. Pick an id per strategy and an id per leg, store them on your side, and use the same values for the rest of that strategy's life. Send a new strategy id and you have started a new strategy; send an existing one and you are acting on the strategy that already exists.
STRATEGY_ENTRY with strategy id S-101 and legs L1 and L2 opens the position. Later, LEG_EXIT with strategy id S-101 and leg id L1 closes just that leg. STRATEGY_EXIT with S-101 closes what is left.STRATEGY_ENTRY example includes // notes explaining each field. They are helpful to read and invalid as JSON — strip them before sending, or the call is rejected.Because OrderSide is stated per leg, one Custom URL can drive both directions — the only integration where that is true.
When a signal does not arrive
Copy linkTradeBridge writes what it did with every signal. Open the logs at the bottom of the window and switch to EXECUTION LOGS.
| Message | What it means |
|---|---|
| Webhook listening has started… | The URL is live and waiting. If this is missing, press START. |
| New Entry Stocks: … signal received. | The call arrived and was accepted. |
| Multi-stock Chartink alert: processing entry for N stocks (…) | A basket alert; each symbol is being entered. |
| Webhook contract selected for leg … | The contract was resolved — the order is on its way. |
| … webhook entry skipped: SYMBOL already has an active leg. | That stock is already open. Working as intended. |
| Webhook entry skipped: NAME is not enabled in Index Settings. | Tick the index or commodity in Settings ▸ Index Settings. |
| Webhook contract not found for … | The symbol could not be matched — usually a prefixed symbol, a typo, or something not listed on NSE or BSE. |
| Received alert from an unknown source… | The URL does not match any strategy. Usually the strategy was renamed, or GENERATE was pressed after the URL was pasted into Chartink or TradingView. |
If nothing appears in the log at all, the call never reached the application. Work through this in order:
- Is TradeBridge running and started? The listener only exists while the app is open and trading has been started.
- Is the URL current? Renaming a strategy, or pressing GENERATE again, invalidates what you pasted earlier.
- Public URL from a cloud service? Port 8080 must be forwarded on your router, and your broadband address must not have changed.
- Is it inside the trading window? Signals arriving before Start Time are ignored, and nothing new opens after Stop Entry Time.
Go live
Pressing START
Copy linkSTART begins the trading session. Before it will do anything useful:
- Instruments downloaded — the footer stops saying Downloading instruments….
- Accounts logged in — use Accounts ▸ Login All Accounts. Logging in is not possible after START.
- Indices enabled — tick what you trade in Settings ▸ Index Settings.
- A portfolio active, with strategies inside it.
- Mode checked — Paper or live, shown on the command bar.
The Setup Guide tracks all of this and links each step to the screen that fixes it.
After START, your webhook URLs begin listening and your strategies wait for their signal.
Monitor and manage
The seven live views
Copy linkEach tab answers one question.
Portfolio — what is scheduled and what is running, with a per-portfolio execution tally.
Strategies — every live strategy, its status, P&L and risk state.
Legs Detail — one row per leg: symbol, side, quantity, entry and exit price, target, SL, trail.
Order Book — every order placed, with status and any rejection message.
Position — net positions by symbol, with LTP, bid, ask and delta.
A/C Management — the accounts themselves: login state, funds, margin, risk caps.
Index Summary — the underlyings you trade, with spot, futures and synthetic-future prices, the ATM strike, and your net position in each.
Making the grids yours
Copy linkEvery grid carries the same tools, and every change is remembered for next time.
- COLUMNS — show or hide any column and drag them into the order you want. The counter shows how many of the total are visible.
- Filter — a spreadsheet-style panel on each column header: search, tick the values you want, select all results, or clear.
- Freeze — keep the identifying columns in place while the rest scrolls.
- Pin actions — promote the row buttons you use most out of the … menu.
- Reset puts a grid back to its defaults.
Exiting positions
Copy linkThere is an exit at every level, and each is one click.
| Where | What it exits |
|---|---|
| Legs Detail row | That leg only |
| Strategies row, or Strategies ▸ Exit Selected | That strategy |
| Portfolio row, or Portfolios ▸ Exit Selected | That portfolio |
| A/C Management row ▸ Exit All | Everything on that account |
| EXIT ALL on the command bar | Everything, everywhere |
Part Book on a strategy row books part of a position rather than all of it.
Booking part of a position
Copy linkPart Book closes a portion of an open position and leaves the rest running under its original rules. There are three ways to reach it.
1 · The whole strategy. Open Part Book from the row actions on a live strategy in the Strategies tab. Every leg is booked proportionally — it works the same whether the strategy has one leg or eight.
2 · A single leg. Do the same from a row in Legs Detail to book part of that leg only. The other legs are untouched and carry on under their own rules.
3 · From your own code. Send LEG_PARTIAL_EXIT to the strategy's webhook URL, naming the leg and how much to book. Useful when your strategy decides to scale out on its own.
Choosing the amount — the same two units everywhere:
- By Lots — the number of lots to close.
- By Percentage — a share of the open quantity, between 0 and 100.
In the JSON API these are LOTS and PERCENT, set as partbookType.
Whatever is left keeps its target, stop-loss and trailing rules, and the strategy stays live — so the remainder still manages itself and can still be exited normally later.
The MTM chart
Copy linkOpen View ▸ MTM Chart… for the MTM Visualizer — mark-to-market plotted across the session rather than only the current number.
It opens as a window, not a dialog. Clicking elsewhere does not close it, so you can leave it running beside the workspace while you edit a strategy or watch the order book. Drag the title bar to move it, drag any edge or corner to resize it, and it reopens where and how you left it.
Reading the chart
- The filled area shows which side of zero the day is on — green above, red below.
- Move the pointer across it for a crosshair and a tooltip listing every visible line at that moment.
- The last leg is dashed with a pulsing head. That is the minute still forming: it tracks the live figure continuously and settles into a normal point when the minute closes. Hovering it labels it forming.
- Drag across the chart to zoom into a time range. Reset Zoom clears it.
Choosing what to plot
- Level — Global, Account, Portfolio or Strategy, as four buttons rather than a dropdown.
- Below Global, a second picker names what it is choosing — Account, Portfolio or Strategy — and shows how many there are. It remembers your choice per level.
- The legend along the bottom is also the control: click a chip to show or hide that line. At least one always stays on.
Global MTM, High and Low run along the top with the time each extreme was set. Figures update every half second and the curve every couple of seconds — there is no refresh button because nothing waits for one. If the connection drops, the badge turns amber and the last curve stays on screen rather than blanking.
The live tracking on the last leg applies to the Global view. Account, portfolio and strategy curves move as each minute is recorded.
Settings
Index and commodity settings
Copy linkOpen Settings ▸ Index Settings. This is where you choose which underlyings the software tracks.
The left panel lists NSE / equity indices — NIFTY, BANKNIFTY, FINNIFTY, MIDCPNIFTY, SENSEX and BANKEX. The right lists MCX commodities — GOLD, GOLDM, SILVER, SILVERM, CRUDEOIL and NATURALGAS. The count of active ones is shown above each.
For each row:
- Active Index — the tick that switches it on. Untick anything you do not trade to keep the feed and the grids focused.
- Expiry Date — the expiry this underlying uses, with DTE (days to expiry) beside it.
Index Settings become read-only while trading is live — press STOP to change them.
Telegram alerts
Copy linkOpen Settings ▸ Telegram Alerts to receive updates away from the machine.
- Send Telegram Alerts — the master switch.
- Bot Token — from BotFather in Telegram, when you create the bot.
- Channel Id — the channel or chat the bot posts to.
- Live MTM Alerts — optional periodic updates rather than event alerts only.
- Telegram Time Frame — how often those periodic updates are sent.
The settings are shared by every account, so this is configured once. Like Index Settings, they are read-only while trading is live.
Appearance and data
Copy linkOpen Settings ▸ General.
| Setting | What it does |
|---|---|
| Theme | Dark or Light |
| Density | Comfortable or Compact row height in every grid |
| Delta Base On | Whether delta is computed against spot or the future — this affects Closest Delta strike selection |
| Auto Delete Logs | How many days of logs to keep before they are removed |
Settings ▸ Reset & Data clears stored state if you want to start clean. It is read-only while trading is live, and there is a separate reset per area rather than one blunt button.
Reports and housekeeping
Exporting your data
Copy linkSession ▸ Export All Grids… writes every grid to Excel in one step.
Individual grids export from their own controls, and Portfolios ▸ Export All Portfolios… saves your portfolio definitions — useful as a backup, or to move a setup to another machine. Account set-ups travel the same way through Accounts ▸ Save / Load Account Template….
The export follows the API's own column order and includes every column, not only the visible ones.
Logs
Copy linkThe panel at the bottom of the window has two tabs.
- Application Logs — the application's own activity: logins, downloads, connection state.
- Execution Logs — what your strategies did: signals received, contracts chosen, orders placed, exits, and every skip reason.
Both are searchable and filterable by column, OPEN LOG shows the file on disk, and CLEAR empties the view. Settings ▸ General controls how many days of logs are kept.