Q
QuantifyIntelligence
Pricing ← Home
Guide

AI Agent & Webhooks

Trader and Pro plans · Updated 12 November 2026

Set up in minutes, stay in control. This guide walks you through connecting the Agent to your own bot or broker, testing it safely and understanding every order it sends.

Contents

  • 1. What the Agent does
  • 2. Before you start
  • 3. Add your webhook
  • 4. Add a secret
  • 5. Choose your order format
  • 6. Test your webhook
  • 7. Approve for the week
  • 8. Paper trading
  • 9. How the Agent runs
  • 10. Broker statuses
  • 11. Your controls
  • 12. If your plan ends

1. What the Agent does

On the Trader and Pro plans, the Agent watches the shares you add, re-checks them through market hours and makes trade decisions: open, hold or close. It sizes positions using your portfolio value, tracks every position, and closes it when the thesis breaks or a stop or target is hit.

Connecting a webhook is optional. With one, the Agent sends its orders to your own bot or broker connection. Without one, it still runs, decides and tracks positions, and every order is logged as "Not sent — no webhook address set".

2. Before you start

  1. Be on Trader or Pro. Trader monitors up to 20 symbols; Pro up to 45.
  2. Enter your portfolio value on the Agent tab. It's used to size positions.
  3. Add the shares you want watched. The Agent only watches what you add.
  4. Turn on the switches you want: the swing agent, the long-term agent, and Positions only if you want it to manage exits on existing positions without opening new ones.
  5. Set your circuit breaker in Settings: your maximum number of Agent signals per day.

3. Add your webhook

A webhook is a web address belonging to your own bot or broker connection. The platform sends each order there as a web request. Any platform or broker that accepts orders by webhook works.

  1. Get the webhook address from your bot or broker connection.
  2. Paste it into Settings → Webhook address and save.

Quantify never holds your money or logs in to your broker account. It only sends orders to the address you provide, so that endpoint is your choice and your responsibility.

4. Add a secret (optional, strongly recommended)

Anyone who knows a webhook address could send orders to it. A secret / API key proves the order came from your account.

  • Standard format: the secret goes in the order body.
  • Custom format: the secret is sent only where your template or a header uses it — ideal for platforms that expect a key in a header, for example Authorization: Bearer ….
  • Key already in the address? Some platforms put the key in the webhook address itself. In that case you can leave the secret empty.

If a secret looks necessary but none is saved, you'll see a warning when you save. The secret is always hidden in delivery records and test results.

5. Choose your order format

In Settings → Order format, pick one of two options:

  • Standard — the format webhooktradebot reads. Nothing else to set up.
  • Custom template — for almost any other webhook-based platform. Write a template for each order type, sent as JSON or as form fields, and check it with the live preview. Ready-made examples are included: a generic JSON template and one for Tradier.

Custom template options

  • Symbol format: add your own text before or after the ticker, separately for UK and US shares, and choose how share classes are written.
  • Quantity: send a number of shares, or a money amount (shares × price). Partial closes use a percentage of the position, for example 50%.
  • Prices: sent in the unit the share is quoted in — pence for most London shares, dollars for US shares.
  • Extra headers: add any headers your platform needs, including one that carries your secret.

6. Test your webhook

Before you rely on it, use Settings → Test your webhook. Choose an order type (open long, open short, close long or close short), a symbol and a quantity. The platform sends one real order in your format, then shows the response code, the time taken, your endpoint's reply, and the exact body sent with your secret hidden.

Test against a demo account. Your bot or broker may execute the test order. Testing needs a current weekly approval, and you can send up to 10 tests every 10 minutes.

The Recent deliveries list in Settings shows every order sent or attempted, with its status and response code.

7. Approve for the week

New orders are sent to your broker only while you have a current weekly approval. On the Agent tab, read the "Information, not advice" notice, tick "I have read and accept…" and select I approve for 7 days. You can renew at any time; the status bar shows whether orders are approved this week.

  • Without a current approval: no new orders (opening, or adding to a position) are sent. They're logged as "Not sent — weekly approval needed", and the position is still tracked.
  • Exits are always sent: stop, target and close orders for open positions go out even without a current approval, so your positions stay protected.
  • Declining is fine: analysis and every other feature keep working.

8. Paper trading

There's no separate paper-trading mode, and you don't need one: point your webhook at a demo (paper) account at your broker, and everything works exactly as it would live. Or run the Agent with no webhook at all and watch its decisions in the signal log.

9. How the Agent runs

  • Watched shares are re-checked every 30 minutes during market hours, and sooner when a condition the Agent is waiting for is met.
  • Event-driven positions are also re-checked around their event: the trading day before it and the trading day after.
  • Stops and targets on open positions are checked about every 5 minutes while that share's market is open.
  • Prices are delayed by about 15–20 minutes. They are not real-time.
  • Your broker doesn't hold the stop. The platform checks it and sends a close order, so a fast market can move past a stop before the close is sent. If you want a hard stop, set one at your broker as well.
  • The Agent's re-checks never use your reports. Your plan's symbol limit covers them.

10. Broker statuses

Every order shows its broker status in the signal log and on the Usage tab:

  • Delivered — your endpoint accepted the request. The response code, time taken and start of the reply are recorded. Delivered means received by your endpoint, not filled at your broker.
  • Not sent — no webhook address set — add one in Settings.
  • Not sent — weekly approval needed — approve on the Agent tab.
  • Not sent — the opening order was never sent to your broker — the platform never sends a close for a position your broker doesn't hold.
  • Not sent — your order format needs updating — re-save your order format in Settings.
  • Failed — your endpoint returned an error. The code and reply are shown, and the position isn't changed.
  • Unknown — timed out — your endpoint didn't answer in time. Check your broker.

When an order is "not sent", the platform still tracks the position as if it had been placed, so your record shows what the Agent would have done. The full signal log is kept for the life of your account and can be downloaded as CSV.

11. Your controls

  • Positions only: no new entries; the Agent only manages exits on existing positions.
  • Circuit breaker: your maximum number of Agent signals per day. Every signal counts, sent or not.
  • Pause or switch off the Agent at any time.
  • Weekly approval: let it lapse and new orders stop.

12. If your plan ends

If your subscription ends, or you move to a plan without the Agent, the Agent switches off completely: no re-checks, no decisions and no orders. Open positions are no longer watched, so manage them directly at your broker. Analysis keeps working with any credits or free reports left on your account.

Ready to try it? Start with 3 free reports — no card needed. The Agent and webhook orders come with the Trader and Pro plans.

This guide describes AI-generated information and software tools. It is not financial advice. See our Risk Warning and Terms and Conditions.

QuantifyTrades provides AI-generated information, not financial advice. Trading involves risk of loss.
© 2026 QuantifyTrades. Not FCA authorised. Not SEC registered.
Home FAQ Agent Guide Risk Warning Terms Privacy