C
Trade Copier API
v1.2.0
No coding needed

Start Here — The Simple Explanation

When Finradar opens, protects, or closes a trade, the same action executes on your MT4/MT5 broker account via MetaCopier. Finradar never sees your broker login; you control the position size.

📱

Setup happens in the app: PnL Calendar page → copier settings. No code needed.

Set it up in 3 steps

1

Create a MetaCopier account

Sign up at MetaCopier and connect your MT4 or MT5 broker account. Set your position size there (fixed lot or risk factor).

2

Copy your webhook URL and secret

MetaCopier gives you a webhook URL and a secret. The secret makes sure only your Finradar account can move your money.

3

Paste into Finradar and toggle on

In the Finradar app, open the PnL Calendar page, paste both values, and switch the copier on. Trades now execute automatically.

Prefer the friendly overview with visuals? See the Trade Copier page.

Looking for the notification webhooks instead? See the Webhook documentation.

🛠️

Below this line: the technical reference for developers.

MetaCopier Dispatch Endpoint

POST/webhook/metacopier/dispatch

Forward a trade action payload to the MetaCopier URL saved for the user. The backend validates premium status, MetaCopier credentials, and per-event-type flags before dispatching.

Behavior

  • Requires user to be premium (is_premium = true).
  • Requires metacopier_enabled = true and valid credentials in the saved config.
  • Checks the corresponding event type flag before dispatching — returns 400 if the event type is disabled.
  • Automatically injects the saved MetaCopier secret into event_payload.secret if missing.
Request Body
{
  "user_id": "string",
  "event_payload": {
    "event_type": "new_setup | trigger | close",
    "action": "open | close",
    "symbol": "XAUUSD",
    "direction": "buy | sell",
    "entry_zone": "2500.50-2501.00",
    "stop_loss": "2499.50",
    "tp1": "2505.00",
    "tp2": "2510.00",
    "setup_id": "setup_123_456",
    "timestamp": "2026-05-13T10:30:45.000Z"
  }
}

Event Type Filtering

event_typeConfig FlagDispatched When
new_setupsend_new_setup_eventsA new trading setup is identified.
triggersend_trigger_eventsPrice enters the entry zone.
closesend_close_eventsA setup is closed or invalidated.

Universal Symbol Conversion

Signals use yfinance-format symbols and are converted to broker/CFD format automatically before dispatch:

Finradar (yfinance)Broker (CFD)
AAPLAAPL
NQ=FUS100
GC=FXAUUSD
EURUSD=XEURUSD
BTC-USDBTCUSD

Example: Open Order Payload

The payload MetaCopier receives when a trade opens — absolute stop and target prices, a stable tradeKey, and your secret on every request.

Payload
{
  "secret": "•••",
  "action": "open",
  "symbol": "AAPL",
  "orderType": "buy",
  "tradeKey": "2213_0",
  "stopLoss": 221.80,
  "stopLossType": "price",
  "takeProfit": 234.50,
  "takeProfitType": "price"
}