Moving to your own infrastructure

Keep your code. Own the whole stack.

Hosted trading APIs are a quick way to start. As a fleet grows, many teams want the terminals, the credentials and the risk limits on servers they control. PerkBridge keeps the REST experience you already know and runs it on your infrastructure, so moving is mostly a new base URL, a new token and a few field names.

WHAT YOU NEED BEFORE YOU START ✓ One Ubuntu 24.04 server for the control plane ✓ One or more Ubuntu 24.04 servers for terminals (they can be the same server) ✓ Your MT5 broker demo logins ✓ Access to your bot’s configuration Early access supports broker demo accounts only. How to prepare your servers →

Why teams move

The same API, with everything inside your boundary.

Moving is usually driven by growth: more accounts, stricter clients or investors, and a wish to control every part of the setup.

Full credential custodyBroker passwords are entered in your own dashboard and sealed to the server that uses them. They never leave your infrastructure.
Limits next to the terminalEvery account has its own risk limits, enforced on the server before each order, even if the dashboard is unreachable.
Safe retries by designSend the same client_order_id again and you get the original order back, never a duplicate.
Your compliance boundaryData stays in your network, with roles for your team and an audit log of every privileged action.
Scale on your termsAdd servers as you grow and run several accounts on each, on the hardware and in the regions you choose.
A familiar REST shapeMarket and pending orders, positions, quotes, bars and history through one REST API, documented in OpenAPI 3.

The same order, side by side

A market buy.

On the left, a generic hosted API call, simplified. On the right, the real PerkBridge request from the Trading API reference. The API also places limit, stop and stop-limit orders with time in force, and can modify and cancel them. Stop loss and take profit work on pending orders but not yet on MT5 market orders. DirectConnect, an opt-in low-latency order path, is coming next.

Your current callTODAY
POST https://api.provider.example/accounts/{id}/trade
Authorization: Bearer $API_TOKEN

{
  "action": "BUY",
  "symbol": "EURUSD",
  "volume": 0.1
}
With PerkBridgeON YOUR SERVERS
POST https://control.example.com/v1/trading/
     accounts/{account_id}/orders
Authorization: Bearer $TRADING_TOKEN

{
  "client_order_id": "ea42-0007",
  "symbol": "EURUSD",
  "side": "buy",
  "volume": "0.10"
}
Your own idclient_order_id is required and makes every retry safe.
Decimals as stringsVolumes and prices are strings, so nothing is lost to rounding.
202 means queuedThe order passed every check. Read its status from the order or its timeline.
422 means refusedA risk limit or other check said no, and nothing was sent to the broker.
Open the full API reference with Python, MQL5 and curl examples →

Migration path

Run both side by side, then switch.

Nothing has to move in one go. Bring one account across, run it in parallel on demo, and switch the rest when you are happy.

  1. 1Install the control plane →Run the installer on an Ubuntu 24.04 server. It sets up the Docker Compose stack with automatic HTTPS.
  2. 2Add a trading server →Enter its address in the dashboard. The host key is verified and the agent is installed for you.
  3. 3Bring one account across →Pick the platform, find the broker server by name, enter the demo login, and set the account’s risk limits.
  4. 4Point your bot at it →Issue a trading token, change the base URL and field names, and run it next to the old setup.
  5. 5Move the rest →Bring the remaining accounts across at your pace. As good practice after any move, rotate each broker password.

Good to know

A hosted API may still suit you better if you need:

Real-money accounts todayReal-money accounts are planned and not supported yet. Early access works with broker demo accounts only.
MetaTrader 4MT5 is the only connector today and cTrader is coming soon. MT4 is under consideration. See connectors
Failover to a standby serverManual and automatic switching to a standby server are included. See the roadmap
No servers of your ownPerkBridge runs on servers you control. We do not host it for you.

Try one account first.

Ask for a private sandbox and we will help you bring a demo account across on a call.