Headway Broker API integration services (MT4 / MT5 / OpenFinance)

A live forex account is a structured data store

Every Headway live account holds time-series data that finance, tax and reporting teams routinely need: open positions, closed trades with timestamps to the millisecond, swap and commission charges, deposits, withdrawals, and KYC profile fields. Pulling that into a warehouse stops traders from manually exporting MT4 statements every month.

Multi-platform, single trader

The same Headway account shows up in MT4, MT5, the proprietary mobile app, and the Copytrade interface. Users see four windows; integrators see one consistent ledger. Our integration consolidates those surfaces so downstream consumers receive a unified event stream rather than four partial ones.

Copy-trading creates a second data layer

Headway Copytrade — launched as a flexible, transparent service — exposes leader strategy histories, instruments, and drawdown. That is high-value data for performance dashboards, fund reporting, and tax allocation across followers. Most retail traders cannot extract it without an API layer.

Source-code drop

• OpenAPI / Swagger spec covering login, accounts, history, positions, deposits, copy trading
• Reference implementation in Python (FastAPI) and Node.js (Fastify); Go SDK available on request
• Auth flow report: OAuth-style token exchange, MT4/MT5 manager API binding, 2FA handling
• Polling and webhook examples plus retry/back-off logic
• Postman collection, integration tests, and a sandbox harness against a Headway demo account

Pay-per-call hosted API

• Hosted endpoints behind your tenant key — no upfront fee
• Rate-limited, audited access with per-call billing
• Built-in caching for symbol metadata to cut latency on chart-heavy use cases
• Consent and audit log retention for compliance reviews

Documentation set

• Field-level dictionary for every endpoint (currency, leverage, swap-type, lot-size unit)
• Sequence diagrams for the most-used flows
• Sample responses captured against Cent, Standard, and Pro account types
• Runbook for handling FSCA, POPIA, and FICA data requests

1. Tax & statement export for active retail traders

Context: a Headway client trades 500+ tickets per quarter and needs a clean ledger for their accountant. We hook the closed-trade history endpoint, normalize swap/commission into separate columns, and emit a quarterly Excel and PDF that mirrors what tax authorities (e.g. SARS in South Africa or HMRC abroad) accept. Underlying calls map to the MT4/MT5 history range plus the deposits/withdrawals query.

2. Multi-broker portfolio dashboard

Context: a wealth-tech app aggregates positions across Headway, Exness, FOREX.com, and IG. We expose a normalized positions endpoint with consistent fields (instrument, side, volume, avg_price, unrealized_pnl) so the dashboard does not branch per broker. OpenFinance-style consent tokens scope the connection to read-only access.

3. Copy-trading performance analytics

Context: a content site ranks Headway Copytrade leaders. We periodically pull each public strategy's equity curve, drawdown, traded instruments, and follower count, store snapshots, and compute risk-adjusted metrics (Sharpe, Sortino, max DD). The output feeds league tables and email digests.

4. Margin and risk webhooks for prop teams

Context: a prop firm seats 30 traders on individual Headway accounts. Each account emits webhooks for new open positions and margin-level changes, which a central risk engine consumes to enforce per-trader exposure rules and trigger automated reduce-only actions when limits breach.

5. Deposit reconciliation for B2B affiliates

Context: an introducing broker tracks rebates per referred client. A nightly job calls the deposits endpoint, joins on referral codes, computes commissions, and posts journal entries into the affiliate's accounting system — replacing a manual CSV export from the partner portal.

Login & token exchange

POST /api/v1/headway/auth/login
Content-Type: application/json

{
  "login": "10293847",
  "password": "<encrypted>",
  "server": "Headway-Live",
  "totp": "612430"
}

200 OK
{
  "access_token": "eyJhbGci...",
  "refresh_token": "...",
  "expires_in": 3600,
  "account_type": "Pro",
  "leverage": "1:unlimited"
}

Closed-trade history (statement export)

GET /api/v1/headway/history?from=2026-01-01&to=2026-03-31&format=json
Authorization: Bearer <ACCESS_TOKEN>

200 OK
{
  "account": "10293847",
  "currency": "USD",
  "items": [
    {
      "ticket": 87213441,
      "symbol": "XAUUSD",
      "side": "buy",
      "volume": 0.50,
      "open_time": "2026-02-12T08:14:23.112Z",
      "close_time": "2026-02-12T15:42:09.882Z",
      "open_price": 2034.10,
      "close_price": 2049.85,
      "swap": -1.42,
      "commission": -3.50,
      "profit": 782.58
    }
  ],
  "next_page": null
}

Webhook: position event

POST https://your-app/webhooks/headway
X-Headway-Event: position.opened
X-Headway-Signature: t=1714291200,v1=...

{
  "account": "10293847",
  "ticket": 87213999,
  "symbol": "EURUSD",
  "side": "sell",
  "volume": 1.20,
  "open_price": 1.0712,
  "stop_loss": 1.0760,
  "take_profit": 1.0640,
  "leverage": 500,
  "ts": "2026-04-28T09:01:11Z"
}

// Verify HMAC, then route to risk engine.
// Reply 2xx within 5s or we re-deliver with exponential backoff.

Compliance & privacy

Headway is operated by JAROCEL (PTY) LTD under FSCA license 52108 in South Africa. Any data integration that we build follows three layers of regulation: (1) FSCA conduct rules for the broker side; (2) POPIA (Protection of Personal Information Act, South Africa) for personal data minimization, lawful processing, and cross-border transfer notices; and (3) FICA (Financial Intelligence Centre Act) for AML/KYC retention. For EU-resident traders, GDPR equivalence and lawful basis (typically explicit consent or contract) apply. We log access, store consent records per account, and ship a runbook your DPO can use to respond to subject-access and erasure requests.

Data flow / architecture

• Client app / MT4/MT5 terminal — origin of authenticated sessions and ticket events
• Ingestion API gateway — token validation, rate limits, audit logging
• Normalization layer — maps raw broker payloads to a canonical schema (positions, deals, transfers)
• Storage — Postgres for ledger data, object storage for monthly statement PDFs, Redis for tick caches
• Consumer surfaces — REST/GraphQL for dashboards, webhooks for risk engines, batch CSV/Excel for accounting

Market positioning & user profile

Headway, founded in 2022 and based in East London, South Africa, primarily targets active retail traders in emerging markets — Africa, the Middle East, South-East Asia, and parts of Latin America — who want low entry barriers (Cent accounts from $1) plus access to MT4/MT5 muscle. Its 470+ instruments tilt toward forex, gold, oil, and US equity CFDs, and the recent Copytrade launch broadens the audience to passive investors who follow leader strategies rather than self-direct. Mobile usage is dominant: the proprietary Android app and iOS Trading App are the main entry points, with desktop MT4/MT5 reserved for power users and EA developers.

Modules we typically ship together

• Authentication & 2FA-aware session management
• Account, balance, and leverage sync
• Open and closed trade history with paging and date filters
• Deposits, withdrawals, and internal transfers
• Symbol catalog & tick/aggregated price snapshots
• Copytrade strategy and follower data
• Webhook fanout for position and margin events
• Statement export to Excel, CSV, JSON, and PDF

Exness

Operates the Exness Terminal and Trade App plus MT4/MT5 access. Holds balance, position, and order data very similar in shape to Headway, so the same canonical schema typically covers both with minor field-mapping work.

FOREX.com

A US/UK-anchored brand with a proprietary mobile app. Account holders generate detailed ticket history that integrators export for tax, fund reporting, and multi-broker P&L roll-ups.

IG Trading

Long-standing UK broker offering an extensive REST and streaming API. Users who hold both IG and Headway accounts often need a unified positions feed across CFD product lines.

Saxo Trader

Saxo's OpenAPI is one of the most documented in the industry. Aggregator dashboards that already speak Saxo OpenAPI can extend coverage to Headway via the same canonical-schema pattern we ship.

CMC Markets (NextGeneration)

NextGeneration's chart and sentiment layer pairs well with Headway's trade history when traders want a single performance dashboard across both venues.

Capital.com

Cyprus-based broker with 9,000+ instruments and a public REST/WebSocket API. Useful reference design when building broker-agnostic integrations that include Headway.

Fusion Markets (cTrader)

cTrader-first broker. The cTrader Open API differs from MT4/MT5 manager APIs, but the canonical position/history schema bridges Headway and Fusion in a single downstream model.

eToro

Best known for social and copy trading. Compares directly with Headway Copytrade — clients running both often need consolidated leader/follower analytics.

XM

Multi-region MT4/MT5 broker with a wide instrument catalog. Customer profiles overlap heavily with Headway's Cent and Standard accounts, making unified statement exports a recurring ask.

FBS

Mobile-first with cent and demo account types similar to Headway. Integration scope (login, history, deposits) maps almost one-to-one onto the contract we deliver for Headway.

About us

We are an independent technical studio focused on App interface integration, OpenData / OpenFinance / OpenBanking pipelines, and authorized API delivery. The team has years of hands-on experience in mobile applications and fintech: protocol analysis, interface refactoring, third-party API integration, automated data scripting, and interface documentation. We have shipped integrations across financial and banking apps, e-commerce and retail, hotel and mobility, and social/OTT — Headway-style trading apps fall squarely in our wheelhouse because the core primitives (login, ledger, statement, webhook) are the same patterns we ship every week.

• Two engagement models — source-code delivery from $300 (pay after delivery upon satisfaction) or pay-per-call API billing on our hosted endpoints
• Compliant, lawful interface implementations aligned with local privacy and financial regulation
• Android + iOS coverage, with runnable API source, OpenAPI docs, and a test plan in every package
• Custom Python / Node.js / Go SDKs, Postman collections, and CI-ready integration tests
• End-to-end pipeline: protocol analysis → build → validation → compliance review

Contact

Tell us the target app (Headway Broker, in this case) and your specific data needs — trade history, balance sync, copy-trading feed, webhooks, or a combination — and we will reply with scope, timeline, and a fixed quote.

Open contact page

Engagement workflow

1. Scope confirmation: which Headway data (history, positions, copytrade, webhooks) and which downstream system
2. Protocol analysis & API design — typically 2–5 business days
3. Build and internal validation against a demo Cent account — 3–8 business days
4. Documentation, sample payloads, and integration tests — 1–2 business days
5. First delivery in 5–15 business days; broker-side approvals and 2FA enrollment can extend timelines

FAQ

What do you need from me?

How long does delivery take?

How do you handle compliance?

Do you support both demo and live Headway accounts?