# Match-Trader API Independent and unofficial. Not affiliated with or endorsed by any broker or platform named here. Educational only: nothing here is advice, and nothing here recommends a broker or a trade. This is the markdown version of https://openbrokerapi.com/platforms/match-trader, written from the same records as that page. Risk warning: CFDs and spread bets are complex instruments and come with a high risk of losing money rapidly due to leverage. You can lose money on these products, and each provider publishes its own loss figure under FCA rules. You should consider whether you understand how they work and whether you can afford to take the high risk of losing your money. Automated and API trading can amplify losses through bugs, connectivity failures and runaway orders. Match-Trade's trader-facing REST and WebSocket API for Match-Trader accounts. - Kind: Platform API - Newest reading: 2026-10-12 - Official documentation: [docs.match-trade.com](https://docs.match-trade.com/docs/match-trader-api-documentation/) - Everything recorded for Match-Trader Platform API, as one JSON file: https://openbrokerapi.com/data/platforms/match-trader.json ## Access, authentication and streaming - How you get access: Log in with your Match-Trader credentials and broker ID; availability appears to be controlled by the broker. - Status: verified. Source: [Platform API](https://match-trader.com/technology/platform-api/), checked 2026-09-20. - Who can use it: Traders with an account at a broker that runs Match-Trader. Match-Trade's Platform API page says the API is designed primarily for traders, and that a broker on a server licence can selectively disable its functionality, so whether it works for you is the broker's decision. The page also says Match-Trader is not provided to individuals directly. - Status: verified. Source: [Match-Trader Platform API](https://match-trader.com/platform-api/), checked 2026-10-12. - Demo: Unverified. Match-Trade's Platform API page, re-read 12 Oct 2026, links a Try demo platform at demo.match-trader.com. That is a demo of the platform, and neither that page nor the documentation index says whether the API can be used against it or gives a demo API address. - Status: unverified. Source: [Match-Trader Platform API](https://match-trader.com/platform-api/), checked 2026-10-12. - Authentication: POST email, password and brokerId to /manager/co-login, or manager/login/co/with-token for a one time token. The co-auth cookie has Max-Age 3600 seconds and the refresh cookie rt has Max-Age 31536000 seconds, Secure and HttpOnly; refresh at manager/refresh-token with no body. Trading calls need the Auth-trading-api header taken from tradingAccounts plus the co-auth cookie. - Status: verified. Source: [Match-Trader Platform API PDF (2024)](https://docs.match-trade.com/wp-content/uploads/2024/05/MTR-Match-TraderPlatformAPI.pdf), checked 2026-09-21. - Streaming: Yes: WebSocket with STOMP for real-time market data and account updates. - Status: verified. Source: [Platform API](https://match-trader.com/technology/platform-api/), checked 2026-09-20. - History depth: Get candles and closed positions endpoints exist; no depth or per request limit found in public docs. - Status: verified. Source: [Match-Trade Platform API docs (Theneo)](https://app.theneo.io/match-trade/platform-api), checked 2026-09-22. - Rate limits, as worded: Not published - Status: verified. Source: [Match-Trader Platform API PDF (2024)](https://docs.match-trade.com/wp-content/uploads/2024/05/MTR-Match-TraderPlatformAPI.pdf), checked 2026-09-21. ## Match-Trader API endpoints 17 documented endpoints. [Grouped by what they do](https://openbrokerapi.com/platforms/match-trader/endpoints). - [POST /manager/mtr-login](https://openbrokerapi.com/platforms/match-trader/endpoints/post-mtr-login): Log in with an email, a password and the broker's identifier and receive the tokens the other calls need, with the login's trading accounts. - [GET /manager/platform-details](https://openbrokerapi.com/platforms/match-trader/endpoints/get-platform-details): Read the details of the trading platform: the broker's identifier, the platform's address and the broker's name. - [POST /manager/refresh-token](https://openbrokerapi.com/platforms/match-trader/endpoints/post-refresh-token): Renew the session token without logging in again. The reference says the refresh token travels as a cookie. - [GET /mtr-api/{SYSTEM_UUID}/active-orders](https://openbrokerapi.com/platforms/match-trader/endpoints/get-active-orders): List the pending orders on the trading account that have not yet been executed. - [GET /mtr-api/{SYSTEM_UUID}/balance](https://openbrokerapi.com/platforms/match-trader/endpoints/get-balance): Read the trading account's balance, equity, margin, free margin and profit. - [GET /mtr-api/{SYSTEM_UUID}/candles](https://openbrokerapi.com/platforms/match-trader/endpoints/get-candles): Download historical candles for a symbol at a chosen interval between two times: open, high, low, close and volume. - [POST /mtr-api/{SYSTEM_UUID}/closed-positions](https://openbrokerapi.com/platforms/match-trader/endpoints/post-closed-positions): List the positions closed between two dates, each with its open and close price, volume, commission, swap and profit. The dates go in the body of a POST. - [GET /mtr-api/{SYSTEM_UUID}/effective-instruments](https://openbrokerapi.com/platforms/match-trader/endpoints/get-effective-instruments): List the instruments the logged in user can trade, each with its settings such as trading hours, price precision, volume limits, leverage and swap. - [GET /mtr-api/{SYSTEM_UUID}/open-positions](https://openbrokerapi.com/platforms/match-trader/endpoints/get-open-positions): List every open position on the trading account, with its side, volume, open price, stop loss, take profit and running profit. - [POST /mtr-api/{SYSTEM_UUID}/pending-order/cancel](https://openbrokerapi.com/platforms/match-trader/endpoints/post-pending-order-cancel): Cancel a pending order before it is executed, named by its id with its instrument, side and type. - [POST /mtr-api/{SYSTEM_UUID}/pending-order/create](https://openbrokerapi.com/platforms/match-trader/endpoints/post-pending-order-create): Place a pending order that waits for a price, with a side, a volume, a type and an optional stop loss and take profit. - [POST /mtr-api/{SYSTEM_UUID}/pending-order/edit](https://openbrokerapi.com/platforms/match-trader/endpoints/post-pending-order-edit): Change a pending order: its price, volume, stop loss or take profit. - [POST /mtr-api/{SYSTEM_UUID}/position/close](https://openbrokerapi.com/platforms/match-trader/endpoints/post-position-close): Close an open position, named by its positionId with its instrument, side and volume. - [POST /mtr-api/{SYSTEM_UUID}/position/close-partially](https://openbrokerapi.com/platforms/match-trader/endpoints/post-position-close-partially): Close part of an open position by giving the volume to take off. - [POST /mtr-api/{SYSTEM_UUID}/position/edit](https://openbrokerapi.com/platforms/match-trader/endpoints/post-position-edit): Change the stop loss and take profit of an open position. - [POST /mtr-api/{SYSTEM_UUID}/position/open](https://openbrokerapi.com/platforms/match-trader/endpoints/post-position-open): Open a position in an instrument, on the buy or the sell side, with a volume and an optional stop loss and take profit. - [GET /mtr-api/{SYSTEM_UUID}/quotations](https://openbrokerapi.com/platforms/match-trader/endpoints/get-quotations): Read the latest bid and ask for a symbol, with the day's change, high and low. ## Match-Trader API error codes 3 decoded error codes. [All Match-Trader Platform API errors](https://openbrokerapi.com/errors/match-trader). - [400](https://openbrokerapi.com/errors/match-trader/400): In the Match-Trader Platform API documentation, the Errors section, which it describes as examples of error responses for each status code, lists status 400 but shows no example body and no description for it. - [401 Unauthorized](https://openbrokerapi.com/errors/match-trader/401-unauthorized): In the Match-Trader Platform API documentation, the example of a 401 response has the title "Unauthorized" and the detail "Authorization information is missing or invalid." (the vendor's wording), with the status, the request path and a timestamp. - [410 Gone](https://openbrokerapi.com/errors/match-trader/410-gone): In the Match-Trader Platform API documentation, the example of a 410 response is plain text, not JSON. ## Match-Trader API: questions and answers ### How do I get access to the Match-Trader API? Log in with your Match-Trader credentials and broker ID; availability appears to be controlled by the broker. - Status: verified. Source: [Platform API](https://match-trader.com/technology/platform-api/), checked 2026-09-20. ### Who can use the Match-Trader API? Traders with an account at a broker that runs Match-Trader. - Status: verified. Source: [Match-Trader Platform API](https://match-trader.com/platform-api/), checked 2026-10-12. ### Match-Trader API demo: is there a demo or sandbox? Unverified. Match-Trade's Platform API page, re-read 12 Oct 2026, links a Try demo platform at demo.match-trader.com. - Status: unverified. Source: [Match-Trader Platform API](https://match-trader.com/platform-api/), checked 2026-10-12. ### What are the Match-Trader API rate limits? Not published. - Status: verified. Source: [Match-Trader Platform API PDF (2024)](https://docs.match-trade.com/wp-content/uploads/2024/05/MTR-Match-TraderPlatformAPI.pdf), checked 2026-09-21. ### How does Match-Trader API authentication work? POST email, password and brokerId to /manager/co-login, or manager/login/co/with-token for a one time token. - Status: verified. Source: [Match-Trader Platform API PDF (2024)](https://docs.match-trade.com/wp-content/uploads/2024/05/MTR-Match-TraderPlatformAPI.pdf), checked 2026-09-21. ### Does the Match-Trader API support streaming? Yes: WebSocket with STOMP for real-time market data and account updates. - Status: verified. Source: [Platform API](https://match-trader.com/technology/platform-api/), checked 2026-09-20. ### How much history does the Match-Trader API return? Get candles and closed positions endpoints exist; no depth or per request limit found in public docs. - Status: verified. Source: [Match-Trade Platform API docs (Theneo)](https://app.theneo.io/match-trade/platform-api), checked 2026-09-22. [Match-Trader API questions, each answered in a sentence or two](https://openbrokerapi.com/answers/match-trader). ## Partner programme Not verified. No programme page was opened, which is not evidence that no programme exists. [The Match-Trader (Match-Trade Technologies) partner programme record](https://openbrokerapi.com/partners/match-trader). This site carries no affiliate links. ## Brokers that offer Match-Trader Platform API Unverified: no broker on this register is recorded as offering Match-Trader Platform API. That is a gap in the records, not a finding that none does. ## Licence and how to cite The limit records on this page come from the limits register, which is CC BY 4.0 (https://openbrokerapi.com/data/limits.json). Everything else on it comes from records that are all rights reserved. This file is the page itself, at its own address, in another format, and it is not part of the CC BY 4.0 downloads listed at https://openbrokerapi.com/data. Cite as: Match-Trader API. Broker API Hub, https://openbrokerapi.com/platforms/match-trader, newest check 2026-10-12. Where you rely on a single figure, cite the source and the checked date printed beside it as well. Where this page and a broker's own documentation differ, the documentation wins.