MT4/MT5 to MT4/MT5 cloud copier API

MT4/MT5 to MT4/MT5 cloud copier

A master (sender) account and its followers (receivers), copied in our cloud - no VPS, no terminal on your side. The sender and its receivers run on the same cloud server (TPcopier places them). The sender's investor (read-only) password is enough; a receiver needs its trading password.

Your API accounts copy each other too. Accounts added with "bridge":"mt-api" are kept as copier accounts ("bridge":"mt-copy") and share its slots: POST /api/v1/hosting/pipes with {"sender_id":S,"receiver_id":R} links two of them, and each keeps its own slot. From then on each runs while a pipeline uses it, as every copier account does. Two accounts on different cloud servers are brought onto one by themselves - the receiver moves to its sender's (or a sender with no receivers yet to its receiver's), restarting there in a minute or two; the answer's moved says which. A workspace's new accounts are placed where its others run. Every copy event and copy webhook carries sender_ticket and receiver_ticket - market and pending copies alike (side: BUY, SELL, BUY_LIMIT ...).

# 1. the sender (master): the answer's "id" is S
curl -X POST -H "Authorization: Bearer $TPC_KEY" -H "Content-Type: application/json" \
     -d '{"platform":"mt5","login":"5012345","password":"INVESTOR_PASSWORD","server":"Broker-Live","label":"Master","bridge":"mt-copy","role":"s"}' \
     https://tpcopier.com/api/v1/hosting/accounts

# 2. each follower: copies S from now on - the answer has its "id" and its pipeline's "pipe_id" (P)
curl -X POST -H "Authorization: Bearer $TPC_KEY" -H "Content-Type: application/json" \
     -d '{"platform":"mt5","login":"7001234","password":"TRADING_PASSWORD","server":"Broker-Live","label":"Follower 1","bridge":"mt-copy","role":"r","sender_id":S}' \
     https://tpcopier.com/api/v1/hosting/accounts

# 3. its lots and rules (all settings: the table below). Symbols are matched by themselves (XAUUSD to Gold, US30 to DJ30...):
#    map only an exception
curl -X PATCH -H "Authorization: Bearer $TPC_KEY" -H "Content-Type: application/json" \
     -d '{"settings":{"lot_mode":"multiplier","lot_value":1,"copy_sltp":true,"symbol_map":{"XAUUSD":"GOLD"}}}' https://tpcopier.com/api/v1/hosting/pipes/P

# 4. pause it, and resume it - paused, it opens nothing new but still follows the closes, stops and targets of what it copied
curl -X PATCH -H "Authorization: Bearer $TPC_KEY" -H "Content-Type: application/json" -d '{"enabled":false}' https://tpcopier.com/api/v1/hosting/pipes/P

# 5. watch it: each account's state and each pipeline - then today's copies, their speed and the last ones
curl -H "Authorization: Bearer $TPC_KEY" https://tpcopier.com/api/v1/hosting
curl -H "Authorization: Bearer $TPC_KEY" https://tpcopier.com/api/v1/hosting/copier

# 6. every copy, with both tickets, its lots, price and speed - and, with status=failed, what was not copied and why
curl -H "Authorization: Bearer $TPC_KEY" "https://tpcopier.com/api/v1/hosting/copier/events?pipe_id=P&status=failed"

Slots: one account each, each from its own day

The copier's receivers and the accounts your software trades alone (added with bridge mt-api, trading guide) each sit in a slot. A slot runs a whole month - or 3, 6 or 12, the same price a month - from the moment it is paid, and renews by itself from your wallet a day before its own end. Add an account through the API and it takes its slot at once: a free one if you have one, else a new one booked from your wallet - the first today, the second on the 20th, each counted from its own day. Delete an account and its slot is free again, still paid until its end, for the next one. The sender (master) comes free with its receivers.

# every account, however it was added - its state, money, positions, and its slot: from, until, renews by itself
curl -H "Authorization: Bearer $TPC_KEY" https://tpcopier.com/api/v1/hosting/accounts

# every slot: its account (or free), from, until, days left, renewing or not - and your wallet against this week's renewals
curl -H "Authorization: Bearer $TPC_KEY" https://tpcopier.com/api/v1/hosting/slots

# book 2 slots ahead, each a month from now, from your wallet (transfer / binance: pay it with the answer's ref / checkout_url)
curl -X POST -H "Authorization: Bearer $TPC_KEY" -H "Content-Type: application/json" \
     -d '{"count":2,"months":1,"method":"wallet","accept_no_refund":true}' https://tpcopier.com/api/v1/hosting/slots/book

# or say how many you want in all: the ones missing are booked from today
curl -X POST -H "Authorization: Bearer $TPC_KEY" -H "Content-Type: application/json" \
     -d '{"bridge":"mt-copy","slots":6,"months":1,"method":"wallet","accept_no_refund":true}' https://tpcopier.com/api/v1/hosting/slots

# put account R in slot 12 (out of the slot it held), free slot 12, or stop it renewing
curl -X PUT -H "Authorization: Bearer $TPC_KEY" -H "Content-Type: application/json" -d '{"account_id":R}' https://tpcopier.com/api/v1/hosting/slots/12
curl -X PUT -H "Authorization: Bearer $TPC_KEY" -H "Content-Type: application/json" -d '{"account_id":0}' https://tpcopier.com/api/v1/hosting/slots/12
curl -X PUT -H "Authorization: Bearer $TPC_KEY" -H "Content-Type: application/json" -d '{"auto_renew":false}' https://tpcopier.com/api/v1/hosting/slots/12

# rename an account, or give it its new password
curl -X PATCH -H "Authorization: Bearer $TPC_KEY" -H "Content-Type: application/json" -d '{"label":"Follower EU"}' https://tpcopier.com/api/v1/hosting/accounts/R

# another account in its slot - its pipeline, links, settings and slot move over, the old one goes
curl -X POST -H "Authorization: Bearer $TPC_KEY" -H "Content-Type: application/json" \
     -d '{"login":"7009999","password":"TRADING_PASSWORD","server":"Broker-Live"}' https://tpcopier.com/api/v1/hosting/accounts/R/replace

# delete it: its slot is free again, still paid until its end
curl -X DELETE -H "Authorization: Bearer $TPC_KEY" https://tpcopier.com/api/v1/hosting/accounts/R

When the wallet is short. A slot that cannot renew ends on its day: its account stops and its state says why; the slot and the account are kept for 7 days, and a wallet topped up in that time renews the slot by itself - the account runs again. You are told once a day (a notification and slots.renew_failed), and every account whose renewal the wallet cannot cover in the next 7 days says "wallet_short": true in its slot. Each change comes by webhook: account.added, account.removed, slots.bought, slot.assigned, slots.renewed, slots.renew_failed, slots.buy_failed, wallet.credited.

A MetaTrader signal bridge (Telegram, WhatsApp, Discord, TradingView to MT4/5) is a plan of 1, 2, 3, 5 or 10 accounts: POST /api/v1/hosting/slots with its bridge and the accounts in all - the days already paid turn into days at the new price, "months":0 adds accounts until the end it has - and PUT /api/v1/hosting/slots/auto renews it and buys room by itself (auto_renew, renew_months, auto_slots). POST /api/v1/hosting/slots/quote says a price first; your wallet: GET /api/v1/wallet, money onto it: POST /api/v1/wallet/top-up.

Equity protection

Stop a receiver losing more than you allow: when it loses daily_pct % in a day, or total_pct % from its highest equity, our cloud server tells you (notify), stops copying into it (stop_copying) or closes everything and stops (close_all) - checked there every few seconds, so it acts even when your code is not running. A trip comes as a notification and the protection.tripped webhook.

curl -X PUT -H "Authorization: Bearer $TPC_KEY" -H "Content-Type: application/json" \
     -d '{"daily_pct":5,"total_pct":20,"action":"stop_copying"}' https://tpcopier.com/api/v1/hosting/accounts/R/protection
# after a trip, when you are ready: {"reset":true}

Start, stop, reconnect

POST /api/v1/hosting/accounts/{id}/action with {"action":"start"}, stop (its terminal closes), reconnect (a fresh sign-in) or delete (terminal and data removed). To trade or read an account yourself - positions, history, prices, orders - see the MT4/MT5 trading API.

Coming from CopyFactory?

Further reading: MetaTrader 5's guide to positions, orders and deals.

Endpoints in this guide

Base address https://tpcopier.com. Send your key with every request - Authorization: Bearer tpc_... - up to 120 requests a minute. Open an endpoint for its fields, its answers and an example.

curl -H "Authorization: Bearer $TPC_KEY" \
     "https://tpcopier.com/api/v1/hosting"

curl -H "Authorization: Bearer $TPC_KEY" \
     "https://tpcopier.com/api/v1/hosting/copier"

{
  "platform": "mt5",
  "login": "",
  "password": "",
  "server": "",
  "label": "",
  "bridge": "",
  "role": "",
  "links": [
    {
      "kind": "",
      "source_id": 0
    }
  ],
  "sender_id": 0,
  "broker": ""
}

curl -X POST -H "Authorization: Bearer $TPC_KEY" -H "Content-Type: application/json" \
     -d '{"platform": "mt5", "login": "", "password": "", "server": "", "label": "", "bridge": "", "role": "", "links": [{"kind": "", "source_id": 0}], "sender_id": 0, "broker": ""}' \
     "https://tpcopier.com/api/v1/hosting/accounts"

curl -H "Authorization: Bearer $TPC_KEY" \
     "https://tpcopier.com/api/v1/hosting/accounts"

{
  "password": ""
}

curl -X POST -H "Authorization: Bearer $TPC_KEY" -H "Content-Type: application/json" \
     -d '{"password": ""}' \
     "https://tpcopier.com/api/v1/hosting/accounts/{aid}/password"

{
  "action": "reconnect"
}

curl -X POST -H "Authorization: Bearer $TPC_KEY" -H "Content-Type: application/json" \
     -d '{"action": "reconnect"}' \
     "https://tpcopier.com/api/v1/hosting/accounts/{aid}/action"

curl -H "Authorization: Bearer $TPC_KEY" \
     "https://tpcopier.com/api/v1/hosting/accounts/{aid}/log"

curl -H "Authorization: Bearer $TPC_KEY" \
     "https://tpcopier.com/api/v1/hosting/ea-form"

curl -H "Authorization: Bearer $TPC_KEY" \
     "https://tpcopier.com/api/v1/hosting/brokers"

{
  "inputs": {}
}

curl -X PUT -H "Authorization: Bearer $TPC_KEY" -H "Content-Type: application/json" \
     -d '{"inputs": {}}' \
     "https://tpcopier.com/api/v1/hosting/accounts/{aid}/ea"

{
  "sender_id": 0,
  "receiver_id": 0,
  "settings": {}
}

curl -X POST -H "Authorization: Bearer $TPC_KEY" -H "Content-Type: application/json" \
     -d '{"sender_id": 0, "receiver_id": 0, "settings": {}}' \
     "https://tpcopier.com/api/v1/hosting/pipes"

{
  "enabled": false,
  "settings": {}
}

curl -X PATCH -H "Authorization: Bearer $TPC_KEY" -H "Content-Type: application/json" \
     -d '{"enabled": false, "settings": {}}' \
     "https://tpcopier.com/api/v1/hosting/pipes/{pid}"

curl -X DELETE -H "Authorization: Bearer $TPC_KEY" \
     "https://tpcopier.com/api/v1/hosting/pipes/{pid}"

curl -H "Authorization: Bearer $TPC_KEY" \
     "https://tpcopier.com/api/v1/hosting/slots"

{
  "bridge": "mt-copy",
  "slots": 4,
  "months": 1,
  "method": "wallet",
  "accept_no_refund": false
}

curl -X POST -H "Authorization: Bearer $TPC_KEY" -H "Content-Type: application/json" \
     -d '{"bridge": "mt-copy", "slots": 4, "months": 1, "method": "wallet", "accept_no_refund": false}' \
     "https://tpcopier.com/api/v1/hosting/slots"

{
  "auto_renew": false,
  "renew_months": 0,
  "auto_slots": false
}

curl -X PUT -H "Authorization: Bearer $TPC_KEY" -H "Content-Type: application/json" \
     -d '{"auto_renew": false, "renew_months": 0, "auto_slots": false}' \
     "https://tpcopier.com/api/v1/hosting/slots/auto"

{
  "bridge": "mt-copy",
  "slots": 4,
  "months": 1,
  "method": "wallet",
  "accept_no_refund": false
}

curl -X POST -H "Authorization: Bearer $TPC_KEY" -H "Content-Type: application/json" \
     -d '{"bridge": "mt-copy", "slots": 4, "months": 1, "method": "wallet", "accept_no_refund": false}' \
     "https://tpcopier.com/api/v1/hosting/slots/quote"

{
  "count": 1,
  "months": 1,
  "method": "wallet",
  "account_id": 0,
  "accept_no_refund": false
}

curl -X POST -H "Authorization: Bearer $TPC_KEY" -H "Content-Type: application/json" \
     -d '{"count": 1, "months": 1, "method": "wallet", "account_id": 0, "accept_no_refund": false}' \
     "https://tpcopier.com/api/v1/hosting/slots/book"

{
  "account_id": 0,
  "auto_renew": false
}

curl -X PUT -H "Authorization: Bearer $TPC_KEY" -H "Content-Type: application/json" \
     -d '{"account_id": 0, "auto_renew": false}' \
     "https://tpcopier.com/api/v1/hosting/slots/{sid}"

{
  "label": "",
  "password": ""
}

curl -X PATCH -H "Authorization: Bearer $TPC_KEY" -H "Content-Type: application/json" \
     -d '{"label": "", "password": ""}' \
     "https://tpcopier.com/api/v1/hosting/accounts/{aid}"

curl -X DELETE -H "Authorization: Bearer $TPC_KEY" \
     "https://tpcopier.com/api/v1/hosting/accounts/{aid}"

curl -H "Authorization: Bearer $TPC_KEY" \
     "https://tpcopier.com/api/v1/hosting/accounts/{aid}"

{
  "platform": "",
  "login": "",
  "password": "",
  "server": "",
  "label": "",
  "broker": ""
}

curl -X POST -H "Authorization: Bearer $TPC_KEY" -H "Content-Type: application/json" \
     -d '{"platform": "", "login": "", "password": "", "server": "", "label": "", "broker": ""}' \
     "https://tpcopier.com/api/v1/hosting/accounts/{aid}/replace"

curl -H "Authorization: Bearer $TPC_KEY" \
     "https://tpcopier.com/api/v1/hosting/copier/events"

curl -H "Authorization: Bearer $TPC_KEY" \
     "https://tpcopier.com/api/v1/hosting/accounts/{aid}/prices/stream?symbols=..."

{
  "daily_pct": 0,
  "total_pct": 0,
  "action": "",
  "reset": false
}

curl -X PUT -H "Authorization: Bearer $TPC_KEY" -H "Content-Type: application/json" \
     -d '{"daily_pct": 0, "total_pct": 0, "action": "", "reset": false}' \
     "https://tpcopier.com/api/v1/hosting/accounts/{aid}/protection"