{ "openapi": "3.1.0", "info": { "title": "Match-Trader Platform API (independent, unofficial description by Broker API Hub)", "version": "2026-10-12", "description": "An independent, unofficial description of the Match-Trader Platform API, built by Broker API Hub from Match-Trader Platform API's public documentation. It is not Match-Trader Platform API's own specification, and Broker API Hub is not affiliated with or endorsed by Match-Trader Platform API.\n\nIt is generated from 17 endpoint records. Every operation carries x-source, the page it was read on, and x-checked, the date that page was last checked. No operation here is recorded as conflicting or unverified. An operation this file does not list is not recorded here, which is not evidence that it does not exist.\n\nSecurity schemes are only the authentication headers the endpoint records list. How a credential is obtained and how long it lasts is on https://openbrokerapi.com/platforms/match-trader.\n\nResponse schemas: none is recorded.\n\n9 operations carry a mock reply as an example under the default response. Its values are invented.\n\nWhere this file and Match-Trader Platform API's own documentation differ, the documentation wins. Educational only. Nothing here is advice.", "x-independent": true, "x-licence": "All rights reserved. Given for reference. Not part of the CC BY 4.0 downloads.", "x-cite": "Broker API Hub, Match-Trader Platform API OpenAPI description, openbrokerapi.com/specs/match-trader.json, newest check 2026-10-12", "x-generated": "2026-10-12", "x-generated-basis": "The newest checked date among the endpoint records in this file. It is not the date the file was built.", "x-page": "https://openbrokerapi.com/platforms/match-trader", "x-base-addresses": { "broker": "Varies by broker. The Platform API reference gives no address for a broker's own platform. Its Get Platform Details call returns a platformUrl", "sandbox": "https://mtr-demo-prod.match-trader.com" }, "x-base-addresses-note": "The base addresses exactly as the platform record words them. Only an entry that is a plain address is listed under servers. A platform API is hosted for each broker or firm that offers it, so where the record holds no plain address the base address is the one your own broker gives you." }, "externalDocs": { "description": "Match-Trader Platform API's own documentation", "url": "https://docs.match-trade.com/docs/match-trader-api-documentation/" }, "servers": [ { "url": "https://mtr-demo-prod.match-trader.com", "description": "Recorded on the Match-Trader Platform API record as \"sandbox\"." } ], "tags": [ { "name": "Authentication" }, { "name": "Data" }, { "name": "Order" }, { "name": "Position" } ], "paths": { "/manager/mtr-login": { "post": { "operationId": "post-mtr-login", "summary": "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.", "description": "Read on 12 Oct 2026 in Match-Trade's Platform API reference, which the Match-Trade documentation site links to and which is published at app.theneo.io. The method, path, parameters and required marks are the reference's own. The reference gives one base address, a sandbox at https://mtr-demo-prod.match-trader.com, and none for a broker's own platform. The reference says the token lasts 15 minutes and should be renewed through the refresh call, after 15 minutes or on the first 401, which it says keeps renewals to four an hour at most. The reply lists email, token, tradingAccounts, selectedTradingAccount, accountInfo, accessMode, tfaProperties and tfaConfig. Each trading account carries a tradingApiToken, sent afterwards in the Auth-trading-api header, and a tradingAccountToken with a token and an expiration. No mock reply is recorded.", "tags": [ "Authentication" ], "externalDocs": { "description": "Match-Trader Platform API's own reference for this operation", "url": "https://app.theneo.io/match-trade/platform-api/login" }, "parameters": [ { "name": "Content-Type", "in": "header", "required": true, "description": "Marked required. The example value is application/json.", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "email": { "type": "string", "description": "The user's email. Marked required. Read it from your own environment." }, "password": { "type": "string", "description": "The user's password. Marked required. Read it from your own environment. Never type it into this site." }, "brokerId": { "type": "string", "description": "The broker's identifier on the server. Marked required. The reference says brokerId and partnerId are the same identifier and that the Get Platform Details call returns it." } }, "required": [ "email", "password", "brokerId" ] } } } }, "x-source": "https://app.theneo.io/match-trade/platform-api/login", "x-checked": "2026-10-12", "x-page": "https://openbrokerapi.com/platforms/match-trader/endpoints/post-mtr-login" } }, "/manager/platform-details": { "get": { "operationId": "get-platform-details", "summary": "Read the details of the trading platform: the broker's identifier, the platform's address and the broker's name.", "description": "Read on 12 Oct 2026 in Match-Trade's Platform API reference, which the Match-Trade documentation site links to and which is published at app.theneo.io. The method, path, parameters and required marks are the reference's own. The reference gives one base address, a sandbox at https://mtr-demo-prod.match-trader.com, and none for a broker's own platform. The reference describes the platform as the one associated with the authenticated user and lists only the Accept header. The reply carries partnerId, platformUrl and brokerName, and the reference says partnerId and brokerId are the same identifier. The mock reply uses those names with invented values.", "tags": [ "Authentication" ], "externalDocs": { "description": "Match-Trader Platform API's own reference for this operation", "url": "https://app.theneo.io/match-trade/platform-api/get-platform-details" }, "parameters": [ { "name": "Accept", "in": "header", "required": true, "description": "Marked required. The example value is application/json.", "schema": { "type": "string" } } ], "responses": { "default": { "description": "A mock reply held on this site's record. The values are invented and the record holds no status code for it.", "content": { "application/json": { "example": { "_mock": true, "partnerId": "0", "platformUrl": "https://platform.example", "brokerName": "Mock Broker" } } } } }, "x-source": "https://app.theneo.io/match-trade/platform-api/get-platform-details", "x-checked": "2026-10-12", "x-page": "https://openbrokerapi.com/platforms/match-trader/endpoints/get-platform-details" } }, "/manager/refresh-token": { "post": { "operationId": "post-refresh-token", "summary": "Renew the session token without logging in again. The reference says the refresh token travels as a cookie.", "description": "Read on 12 Oct 2026 in Match-Trade's Platform API reference, which the Match-Trade documentation site links to and which is published at app.theneo.io. The method, path, parameters and required marks are the reference's own. The reference gives one base address, a sandbox at https://mtr-demo-prod.match-trader.com, and none for a broker's own platform. The reference lists two headers without a required mark and no body, and its example request sends no cookie header, although its text says the refresh token is included as a cookie. It lists no fields for the 200 reply. No mock reply is recorded.", "tags": [ "Authentication" ], "externalDocs": { "description": "Match-Trader Platform API's own reference for this operation", "url": "https://app.theneo.io/match-trade/platform-api/refresh-token" }, "parameters": [ { "name": "Accept", "in": "header", "x-required-unmarked": true, "description": "Example value application/json.", "schema": { "type": "string" } }, { "name": "Content-Type", "in": "header", "x-required-unmarked": true, "description": "Example value application/json.", "schema": { "type": "string" } } ], "x-source": "https://app.theneo.io/match-trade/platform-api/refresh-token", "x-checked": "2026-10-12", "x-page": "https://openbrokerapi.com/platforms/match-trader/endpoints/post-refresh-token" } }, "/mtr-api/{SYSTEM_UUID}/active-orders": { "get": { "operationId": "get-active-orders", "summary": "List the pending orders on the trading account that have not yet been executed.", "description": "Read on 12 Oct 2026 in Match-Trade's Platform API reference, which the Match-Trade documentation site links to and which is published at app.theneo.io. This call sits in a section the page loads only when it is opened, so its content was read from the data the page itself requests for that section. The method, path, parameters and required marks are the reference's own. The reference gives one base address, a sandbox at https://mtr-demo-prod.match-trader.com, and none for a broker's own platform. The reference writes the address with the bare word SYSTEM_UUID where the trading system's identifier goes, and its text calls the value systemUUID. This record writes it as a path parameter. Each entry of orders carries id, symbol, alias, volume, type, creationTime, activationPrice, side, stopLoss, takeProfit and comment. No mock reply is recorded.", "tags": [ "Order" ], "externalDocs": { "description": "Match-Trader Platform API's own reference for this operation", "url": "https://app.theneo.io/match-trade/platform-api/get-active-orders" }, "parameters": [ { "name": "SYSTEM_UUID", "in": "path", "required": true, "description": "The identifier of the trading system the account is on. The reference does not say where to read it. The login reply carries a system object with a uuid under each trading account's offer.", "schema": { "type": "string" } }, { "name": "Cookie", "in": "header", "required": true, "description": "Marked required, with the example value co-auth={token}. The login section says the token field of the login reply is passed as a cookie, and the Market Watch section describes this header as tradingAccountToken.token.", "schema": { "type": "string" } }, { "name": "Content-Type", "in": "header", "required": true, "description": "Marked required. The example value is application/json.", "schema": { "type": "string" } } ], "security": [ { "Auth-trading-api": [] } ], "x-source": "https://app.theneo.io/match-trade/platform-api/get-active-orders", "x-checked": "2026-10-12", "x-page": "https://openbrokerapi.com/platforms/match-trader/endpoints/get-active-orders" } }, "/mtr-api/{SYSTEM_UUID}/balance": { "get": { "operationId": "get-balance", "summary": "Read the trading account's balance, equity, margin, free margin and profit.", "description": "Read on 12 Oct 2026 in Match-Trade's Platform API reference, which the Match-Trade documentation site links to and which is published at app.theneo.io. This call sits in a section the page loads only when it is opened, so its content was read from the data the page itself requests for that section. The method, path, parameters and required marks are the reference's own. The reference gives one base address, a sandbox at https://mtr-demo-prod.match-trader.com, and none for a broker's own platform. The reference writes the address with the bare word SYSTEM_UUID where the trading system's identifier goes, and its text calls the value systemUUID. This record writes it as a path parameter. The reference gives the money fields of the reply as strings and currencyPrecision as a number. The mock reply uses its field names with invented values.", "tags": [ "Data" ], "externalDocs": { "description": "Match-Trader Platform API's own reference for this operation", "url": "https://app.theneo.io/match-trade/platform-api/get-balance" }, "parameters": [ { "name": "SYSTEM_UUID", "in": "path", "required": true, "description": "The identifier of the trading system the account is on. The reference does not say where to read it. The login reply carries a system object with a uuid under each trading account's offer.", "schema": { "type": "string" } }, { "name": "Accept", "in": "header", "required": true, "description": "Marked required. The example value is application/json.", "schema": { "type": "string" } }, { "name": "Cookie", "in": "header", "required": true, "description": "Marked required, with the example value co-auth={token}. The login section says the token field of the login reply is passed as a cookie, and the Market Watch section describes this header as tradingAccountToken.token.", "schema": { "type": "string" } } ], "responses": { "default": { "description": "A mock reply held on this site's record. The values are invented and the record holds no status code for it.", "content": { "application/json": { "example": { "_mock": true, "balance": "10000.00", "equity": "10000.00", "freeMargin": "10000.00", "marginLevel": "0", "credit": "0.00", "currency": "USD", "margin": "0.00", "profit": "0.00", "netProfit": "0.00", "currencyPrecision": 2 } } } } }, "security": [ { "Auth-trading-api": [] } ], "x-source": "https://app.theneo.io/match-trade/platform-api/get-balance", "x-checked": "2026-10-12", "x-page": "https://openbrokerapi.com/platforms/match-trader/endpoints/get-balance" } }, "/mtr-api/{SYSTEM_UUID}/candles": { "get": { "operationId": "get-candles", "summary": "Download historical candles for a symbol at a chosen interval between two times: open, high, low, close and volume.", "description": "Read on 12 Oct 2026 in Match-Trade's Platform API reference, which the Match-Trade documentation site links to and which is published at app.theneo.io. This call sits in a section the page loads only when it is opened, so its content was read from the data the page itself requests for that section. The method, path, parameters and required marks are the reference's own. The reference gives one base address, a sandbox at https://mtr-demo-prod.match-trader.com, and none for a broker's own platform. The reference writes the address with the bare word SYSTEM_UUID where the trading system's identifier goes, and its text calls the value systemUUID. This record writes it as a path parameter. The reference marks the headers as required and gives the four query parameters without a mark, each with an example value. The mock reply uses its field names with invented values.", "tags": [ "Data" ], "externalDocs": { "description": "Match-Trader Platform API's own reference for this operation", "url": "https://app.theneo.io/match-trade/platform-api/get-candles" }, "parameters": [ { "name": "SYSTEM_UUID", "in": "path", "required": true, "description": "The identifier of the trading system the account is on. The reference does not say where to read it. The login reply carries a system object with a uuid under each trading account's offer.", "schema": { "type": "string" } }, { "name": "Accept", "in": "header", "required": true, "description": "Marked required. The example value is application/json.", "schema": { "type": "string" } }, { "name": "Cookie", "in": "header", "required": true, "description": "Marked required, with the example value co-auth={token}. The login section says the token field of the login reply is passed as a cookie, and the Market Watch section describes this header as tradingAccountToken.token.", "schema": { "type": "string" } }, { "name": "symbol", "in": "query", "x-required-unmarked": true, "description": "The symbol. Example value EURUSD.", "schema": { "type": "string" } }, { "name": "interval", "in": "query", "x-required-unmarked": true, "description": "The candle size. Example value M15. The reference lists no other values.", "schema": { "type": "string" } }, { "name": "from", "in": "query", "x-required-unmarked": true, "description": "Start of the range. Example value 2025-07-15T00:00:00Z.", "schema": { "type": "string" } }, { "name": "to", "in": "query", "x-required-unmarked": true, "description": "End of the range. Example value 2025-07-15T00:15:00Z.", "schema": { "type": "string" } } ], "responses": { "default": { "description": "A mock reply held on this site's record. The values are invented and the record holds no status code for it.", "content": { "application/json": { "example": { "_mock": true, "symbol": "EURUSD", "interval": "M15", "candles": [ { "time": 1767225600000, "open": 1.1, "high": 1.2, "low": 1, "close": 1.15, "volume": 100 } ] } } } } }, "security": [ { "Auth-trading-api": [] } ], "x-source": "https://app.theneo.io/match-trade/platform-api/get-candles", "x-checked": "2026-10-12", "x-page": "https://openbrokerapi.com/platforms/match-trader/endpoints/get-candles" } }, "/mtr-api/{SYSTEM_UUID}/closed-positions": { "post": { "operationId": "post-closed-positions", "summary": "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.", "description": "Read on 12 Oct 2026 in Match-Trade's Platform API reference, which the Match-Trade documentation site links to and which is published at app.theneo.io. This call sits in a section the page loads only when it is opened, so its content was read from the data the page itself requests for that section. The method, path, parameters and required marks are the reference's own. The reference gives one base address, a sandbox at https://mtr-demo-prod.match-trader.com, and none for a broker's own platform. The reference writes the address with the bare word SYSTEM_UUID where the trading system's identifier goes, and its text calls the value systemUUID. This record writes it as a path parameter. Each entry of operations carries id, uid, symbol, alias, side, volume, openTime, openPrice, time, closePrice, stopLoss, takeProfit, commission, swap, profit, netProfit, closingOrderID and closeReason, which the reference gives as strings. No mock reply is recorded.", "tags": [ "Position" ], "externalDocs": { "description": "Match-Trader Platform API's own reference for this operation", "url": "https://app.theneo.io/match-trade/platform-api/get-closed-positions" }, "parameters": [ { "name": "SYSTEM_UUID", "in": "path", "required": true, "description": "The identifier of the trading system the account is on. The reference does not say where to read it. The login reply carries a system object with a uuid under each trading account's offer.", "schema": { "type": "string" } }, { "name": "Content-Type", "in": "header", "required": true, "description": "Marked required. The example value is application/json.", "schema": { "type": "string" } }, { "name": "Cookie", "in": "header", "required": true, "description": "Marked required, with the example value co-auth={token}. The login section says the token field of the login reply is passed as a cookie, and the Market Watch section describes this header as tradingAccountToken.token.", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "from": { "type": "string", "description": "Start date. Marked required. Example value 2024-06-18T12:34:19.287Z." }, "to": { "type": "string", "description": "End date. Marked required. Example value 2024-07-18T12:34:19.287Z." } }, "required": [ "from", "to" ] } } } }, "security": [ { "Auth-trading-api": [] } ], "x-source": "https://app.theneo.io/match-trade/platform-api/get-closed-positions", "x-checked": "2026-10-12", "x-page": "https://openbrokerapi.com/platforms/match-trader/endpoints/post-closed-positions" } }, "/mtr-api/{SYSTEM_UUID}/effective-instruments": { "get": { "operationId": "get-effective-instruments", "summary": "List the instruments the logged in user can trade, each with its settings such as trading hours, price precision, volume limits, leverage and swap.", "description": "Read on 12 Oct 2026 in Match-Trade's Platform API reference, which the Match-Trade documentation site links to and which is published at app.theneo.io. This call sits in a section the page loads only when it is opened, so its content was read from the data the page itself requests for that section. The method, path, parameters and required marks are the reference's own. The reference gives one base address, a sandbox at https://mtr-demo-prod.match-trader.com, and none for a broker's own platform. The reference writes the address with the bare word SYSTEM_UUID where the trading system's identifier goes, and its text calls the value systemUUID. This record writes it as a path parameter. The reply fields the reference lists include symbol, alias, type, baseCurrency, quoteCurrency, pricePrecision, leverage, stopsLevel, freezeLevel, swapType, sessionOpen and tradingHours, whose entries give a day number with opening and closing hours, minutes and seconds. No mock reply is recorded.", "tags": [ "Data" ], "externalDocs": { "description": "Match-Trader Platform API's own reference for this operation", "url": "https://app.theneo.io/match-trade/platform-api/get-symbols" }, "parameters": [ { "name": "SYSTEM_UUID", "in": "path", "required": true, "description": "The identifier of the trading system the account is on. The reference does not say where to read it. The login reply carries a system object with a uuid under each trading account's offer.", "schema": { "type": "string" } }, { "name": "Accept", "in": "header", "required": true, "description": "Marked required. The example value is application/json.", "schema": { "type": "string" } }, { "name": "Cookie", "in": "header", "required": true, "description": "Marked required, with the example value co-auth={token}. The login section says the token field of the login reply is passed as a cookie, and the Market Watch section describes this header as tradingAccountToken.token.", "schema": { "type": "string" } } ], "security": [ { "Auth-trading-api": [] } ], "x-source": "https://app.theneo.io/match-trade/platform-api/get-symbols", "x-checked": "2026-10-12", "x-page": "https://openbrokerapi.com/platforms/match-trader/endpoints/get-effective-instruments" } }, "/mtr-api/{SYSTEM_UUID}/open-positions": { "get": { "operationId": "get-open-positions", "summary": "List every open position on the trading account, with its side, volume, open price, stop loss, take profit and running profit.", "description": "Read on 12 Oct 2026 in Match-Trade's Platform API reference, which the Match-Trade documentation site links to and which is published at app.theneo.io. This call sits in a section the page loads only when it is opened, so its content was read from the data the page itself requests for that section. The method, path, parameters and required marks are the reference's own. The reference gives one base address, a sandbox at https://mtr-demo-prod.match-trader.com, and none for a broker's own platform. The reference writes the address with the bare word SYSTEM_UUID where the trading system's identifier goes, and its text calls the value systemUUID. This record writes it as a path parameter. Each entry of positions carries id, symbol, alias, volume, side, openTime, openTimeMillis, openPrice, stopLoss, takeProfit, trailingDistance, swap, profit, netProfit, currentPrice and commission. No mock reply is recorded.", "tags": [ "Position" ], "externalDocs": { "description": "Match-Trader Platform API's own reference for this operation", "url": "https://app.theneo.io/match-trade/platform-api/get-opened-positions" }, "parameters": [ { "name": "SYSTEM_UUID", "in": "path", "required": true, "description": "The identifier of the trading system the account is on. The reference does not say where to read it. The login reply carries a system object with a uuid under each trading account's offer.", "schema": { "type": "string" } }, { "name": "Cookie", "in": "header", "required": true, "description": "Marked required, with the example value co-auth={token}. The login section says the token field of the login reply is passed as a cookie, and the Market Watch section describes this header as tradingAccountToken.token.", "schema": { "type": "string" } } ], "security": [ { "Auth-trading-api": [] } ], "x-source": "https://app.theneo.io/match-trade/platform-api/get-opened-positions", "x-checked": "2026-10-12", "x-page": "https://openbrokerapi.com/platforms/match-trader/endpoints/get-open-positions" } }, "/mtr-api/{SYSTEM_UUID}/pending-order/cancel": { "post": { "operationId": "post-pending-order-cancel", "summary": "Cancel a pending order before it is executed, named by its id with its instrument, side and type.", "description": "Read on 12 Oct 2026 in Match-Trade's Platform API reference, which the Match-Trade documentation site links to and which is published at app.theneo.io. This call sits in a section the page loads only when it is opened, so its content was read from the data the page itself requests for that section. The method, path, parameters and required marks are the reference's own. The reference gives one base address, a sandbox at https://mtr-demo-prod.match-trader.com, and none for a broker's own platform. The reference writes the address with the bare word SYSTEM_UUID where the trading system's identifier goes, and its text calls the value systemUUID. This record writes it as a path parameter. The reference marks the headers as required and gives the body fields without a mark, so it does not say whether id, instrument, orderSide and type must be sent. The reply carries status, nativeCode, errorMessage and orderId. The mock reply uses those names with invented values.", "tags": [ "Order" ], "externalDocs": { "description": "Match-Trader Platform API's own reference for this operation", "url": "https://app.theneo.io/match-trade/platform-api/cancel-pending-order" }, "parameters": [ { "name": "SYSTEM_UUID", "in": "path", "required": true, "description": "The identifier of the trading system the account is on. The reference does not say where to read it. The login reply carries a system object with a uuid under each trading account's offer.", "schema": { "type": "string" } }, { "name": "Cookie", "in": "header", "required": true, "description": "Marked required, with the example value co-auth={token}. The login section says the token field of the login reply is passed as a cookie, and the Market Watch section describes this header as tradingAccountToken.token.", "schema": { "type": "string" } }, { "name": "Content-Type", "in": "header", "required": true, "description": "Marked required. The example value is application/json.", "schema": { "type": "string" } } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "description": "The identifier of the order.", "x-required-unmarked": true }, "instrument": { "type": "string", "description": "The symbol.", "x-required-unmarked": true }, "orderSide": { "type": "string", "description": "BUY or SELL.", "x-required-unmarked": true }, "type": { "type": "string", "description": "The order type. Example value LIMIT.", "x-required-unmarked": true }, "isMobile": { "type": "boolean", "description": "Example value false.", "x-required-unmarked": true } }, "x-required-unmarked": [ "id", "instrument", "orderSide", "type", "isMobile" ] } } } }, "responses": { "default": { "description": "A mock reply held on this site's record. The values are invented and the record holds no status code for it.", "content": { "application/json": { "example": { "_mock": true, "status": "OK", "nativeCode": "", "errorMessage": "", "orderId": "MOCK1" } } } } }, "security": [ { "Auth-trading-api": [] } ], "x-source": "https://app.theneo.io/match-trade/platform-api/cancel-pending-order", "x-checked": "2026-10-12", "x-page": "https://openbrokerapi.com/platforms/match-trader/endpoints/post-pending-order-cancel" } }, "/mtr-api/{SYSTEM_UUID}/pending-order/create": { "post": { "operationId": "post-pending-order-create", "summary": "Place a pending order that waits for a price, with a side, a volume, a type and an optional stop loss and take profit.", "description": "Read on 12 Oct 2026 in Match-Trade's Platform API reference, which the Match-Trade documentation site links to and which is published at app.theneo.io. This call sits in a section the page loads only when it is opened, so its content was read from the data the page itself requests for that section. The method, path, parameters and required marks are the reference's own. The reference gives one base address, a sandbox at https://mtr-demo-prod.match-trader.com, and none for a broker's own platform. The reference writes the address with the bare word SYSTEM_UUID where the trading system's identifier goes, and its text calls the value systemUUID. This record writes it as a path parameter. The reference marks the headers as required and gives the body fields without a mark, so it does not say whether instrument, orderSide, volume, price and type must be sent. The reply carries status, nativeCode, errorMessage and orderId. The mock reply uses those names with invented values.", "tags": [ "Order" ], "externalDocs": { "description": "Match-Trader Platform API's own reference for this operation", "url": "https://app.theneo.io/match-trade/platform-api/create-pending-order" }, "parameters": [ { "name": "SYSTEM_UUID", "in": "path", "required": true, "description": "The identifier of the trading system the account is on. The reference does not say where to read it. The login reply carries a system object with a uuid under each trading account's offer.", "schema": { "type": "string" } }, { "name": "Cookie", "in": "header", "required": true, "description": "Marked required, with the example value co-auth={token}. The login section says the token field of the login reply is passed as a cookie, and the Market Watch section describes this header as tradingAccountToken.token.", "schema": { "type": "string" } }, { "name": "Content-Type", "in": "header", "required": true, "description": "Marked required. The example value is application/json.", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "instrument": { "type": "string", "description": "The symbol.", "x-required-unmarked": true }, "orderSide": { "type": "string", "description": "BUY or SELL.", "x-required-unmarked": true }, "volume": { "type": "number", "description": "The order's volume.", "x-required-unmarked": true }, "price": { "type": "number", "description": "The price the order waits for.", "x-required-unmarked": true }, "type": { "type": "string", "description": "The order type. Example value LIMIT. The reference lists no other values.", "x-required-unmarked": true }, "slPrice": { "type": "number", "description": "Stop loss price. The reference says it cannot be null and that 0 is sent when none is wanted, which is why it is recorded as required." }, "tpPrice": { "type": "number", "description": "Take profit price. The reference says it cannot be null and that 0 is sent when none is wanted, which is why it is recorded as required." }, "isMobile": { "type": "boolean", "description": "Example value false.", "x-required-unmarked": true } }, "required": [ "slPrice", "tpPrice" ], "x-required-unmarked": [ "instrument", "orderSide", "volume", "price", "type", "isMobile" ] } } } }, "responses": { "default": { "description": "A mock reply held on this site's record. The values are invented and the record holds no status code for it.", "content": { "application/json": { "example": { "_mock": true, "status": "OK", "nativeCode": "", "errorMessage": "", "orderId": "MOCK1" } } } } }, "security": [ { "Auth-trading-api": [] } ], "x-source": "https://app.theneo.io/match-trade/platform-api/create-pending-order", "x-checked": "2026-10-12", "x-page": "https://openbrokerapi.com/platforms/match-trader/endpoints/post-pending-order-create" } }, "/mtr-api/{SYSTEM_UUID}/pending-order/edit": { "post": { "operationId": "post-pending-order-edit", "summary": "Change a pending order: its price, volume, stop loss or take profit.", "description": "Read on 12 Oct 2026 in Match-Trade's Platform API reference, which the Match-Trade documentation site links to and which is published at app.theneo.io. This call sits in a section the page loads only when it is opened, so its content was read from the data the page itself requests for that section. The method, path, parameters and required marks are the reference's own. The reference gives one base address, a sandbox at https://mtr-demo-prod.match-trader.com, and none for a broker's own platform. The reference writes the address with the bare word SYSTEM_UUID where the trading system's identifier goes, and its text calls the value systemUUID. This record writes it as a path parameter. The reference marks the headers as required and gives the body fields without a mark, so it does not say whether id, instrument, orderSide, type and volume must be sent. The price field is named priceOrder here and price in the call that creates the order. The reference lists no reply fields for this call. No mock reply is recorded.", "tags": [ "Order" ], "externalDocs": { "description": "Match-Trader Platform API's own reference for this operation", "url": "https://app.theneo.io/match-trade/platform-api/edit-pending-order" }, "parameters": [ { "name": "SYSTEM_UUID", "in": "path", "required": true, "description": "The identifier of the trading system the account is on. The reference does not say where to read it. The login reply carries a system object with a uuid under each trading account's offer.", "schema": { "type": "string" } }, { "name": "Cookie", "in": "header", "required": true, "description": "Marked required, with the example value co-auth={token}. The login section says the token field of the login reply is passed as a cookie, and the Market Watch section describes this header as tradingAccountToken.token.", "schema": { "type": "string" } }, { "name": "Content-Type", "in": "header", "required": true, "description": "Marked required. The example value is application/json.", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "description": "The identifier of the order.", "x-required-unmarked": true }, "instrument": { "type": "string", "description": "The symbol.", "x-required-unmarked": true }, "orderSide": { "type": "string", "description": "BUY or SELL.", "x-required-unmarked": true }, "type": { "type": "string", "description": "The order type. Example value LIMIT.", "x-required-unmarked": true }, "volume": { "type": "number", "description": "The order's volume.", "x-required-unmarked": true }, "priceOrder": { "type": "number", "description": "The order's price. The reference says it cannot be null, which is why it is recorded as required." }, "slPrice": { "type": "number", "description": "Stop loss price. The reference says it cannot be null and that 0 is sent when none is wanted, which is why it is recorded as required." }, "tpPrice": { "type": "number", "description": "Take profit price. The reference says it cannot be null and that 0 is sent when none is wanted, which is why it is recorded as required." }, "isMobile": { "type": "boolean", "description": "Example value false.", "x-required-unmarked": true } }, "required": [ "priceOrder", "slPrice", "tpPrice" ], "x-required-unmarked": [ "id", "instrument", "orderSide", "type", "volume", "isMobile" ] } } } }, "security": [ { "Auth-trading-api": [] } ], "x-source": "https://app.theneo.io/match-trade/platform-api/edit-pending-order", "x-checked": "2026-10-12", "x-page": "https://openbrokerapi.com/platforms/match-trader/endpoints/post-pending-order-edit" } }, "/mtr-api/{SYSTEM_UUID}/position/close": { "post": { "operationId": "post-position-close", "summary": "Close an open position, named by its positionId with its instrument, side and volume.", "description": "Read on 12 Oct 2026 in Match-Trade's Platform API reference, which the Match-Trade documentation site links to and which is published at app.theneo.io. This call sits in a section the page loads only when it is opened, so its content was read from the data the page itself requests for that section. The method, path, parameters and required marks are the reference's own. The reference gives one base address, a sandbox at https://mtr-demo-prod.match-trader.com, and none for a broker's own platform. The reference writes the address with the bare word SYSTEM_UUID where the trading system's identifier goes, and its text calls the value systemUUID. This record writes it as a path parameter. The reference marks the headers as required and gives the body fields without a mark, so it does not say whether positionId, instrument, orderSide and volume must be sent. The reply carries status, nativeCode, errorMessage and orderId. The mock reply uses those names with invented values.", "tags": [ "Position" ], "externalDocs": { "description": "Match-Trader Platform API's own reference for this operation", "url": "https://app.theneo.io/match-trade/platform-api/close-positions" }, "parameters": [ { "name": "SYSTEM_UUID", "in": "path", "required": true, "description": "The identifier of the trading system the account is on. The reference does not say where to read it. The login reply carries a system object with a uuid under each trading account's offer.", "schema": { "type": "string" } }, { "name": "Content-Type", "in": "header", "required": true, "description": "Marked required. The example value is application/json.", "schema": { "type": "string" } }, { "name": "Cookie", "in": "header", "required": true, "description": "Marked required, with the example value co-auth={token}. The login section says the token field of the login reply is passed as a cookie, and the Market Watch section describes this header as tradingAccountToken.token.", "schema": { "type": "string" } } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "positionId": { "type": "string", "description": "The identifier of the position.", "x-required-unmarked": true }, "instrument": { "type": "string", "description": "The symbol.", "x-required-unmarked": true }, "orderSide": { "type": "string", "description": "BUY or SELL.", "x-required-unmarked": true }, "volume": { "type": "string", "description": "The volume to close. The reference types it as a string here, with the example value 0.01.", "x-required-unmarked": true } }, "x-required-unmarked": [ "positionId", "instrument", "orderSide", "volume" ] } } } }, "responses": { "default": { "description": "A mock reply held on this site's record. The values are invented and the record holds no status code for it.", "content": { "application/json": { "example": { "_mock": true, "status": "OK", "nativeCode": "", "errorMessage": "", "orderId": "MOCK1" } } } } }, "security": [ { "Auth-trading-api": [] } ], "x-source": "https://app.theneo.io/match-trade/platform-api/close-positions", "x-checked": "2026-10-12", "x-page": "https://openbrokerapi.com/platforms/match-trader/endpoints/post-position-close" } }, "/mtr-api/{SYSTEM_UUID}/position/close-partially": { "post": { "operationId": "post-position-close-partially", "summary": "Close part of an open position by giving the volume to take off.", "description": "Read on 12 Oct 2026 in Match-Trade's Platform API reference, which the Match-Trade documentation site links to and which is published at app.theneo.io. This call sits in a section the page loads only when it is opened, so its content was read from the data the page itself requests for that section. The method, path, parameters and required marks are the reference's own. The reference gives one base address, a sandbox at https://mtr-demo-prod.match-trader.com, and none for a broker's own platform. The reference writes the address with the bare word SYSTEM_UUID where the trading system's identifier goes, and its text calls the value systemUUID. This record writes it as a path parameter. The reference marks the headers as required and gives the body fields without a mark, so it does not say whether positionId, volume, instrument and orderSide must be sent. The reply carries status, nativeCode, errorMessage and orderId. The mock reply uses those names with invented values.", "tags": [ "Position" ], "externalDocs": { "description": "Match-Trader Platform API's own reference for this operation", "url": "https://app.theneo.io/match-trade/platform-api/partial-close" }, "parameters": [ { "name": "SYSTEM_UUID", "in": "path", "required": true, "description": "The identifier of the trading system the account is on. The reference does not say where to read it. The login reply carries a system object with a uuid under each trading account's offer.", "schema": { "type": "string" } }, { "name": "Cookie", "in": "header", "required": true, "description": "Marked required, with the example value co-auth={token}. The login section says the token field of the login reply is passed as a cookie, and the Market Watch section describes this header as tradingAccountToken.token.", "schema": { "type": "string" } }, { "name": "Content-Type", "in": "header", "required": true, "description": "Marked required. The example value is application/json.", "schema": { "type": "string" } } ], "requestBody": { "required": false, "content": { "application/json": { "schema": { "type": "object", "properties": { "positionId": { "type": "string", "description": "The identifier of the position.", "x-required-unmarked": true }, "volume": { "type": "number", "description": "The volume to close.", "x-required-unmarked": true }, "instrument": { "type": "string", "description": "The symbol.", "x-required-unmarked": true }, "orderSide": { "type": "string", "description": "BUY or SELL.", "x-required-unmarked": true }, "isMobile": { "type": "boolean", "description": "Example value false.", "x-required-unmarked": true } }, "x-required-unmarked": [ "positionId", "volume", "instrument", "orderSide", "isMobile" ] } } } }, "responses": { "default": { "description": "A mock reply held on this site's record. The values are invented and the record holds no status code for it.", "content": { "application/json": { "example": { "_mock": true, "status": "OK", "nativeCode": "", "errorMessage": "", "orderId": "MOCK1" } } } } }, "security": [ { "Auth-trading-api": [] } ], "x-source": "https://app.theneo.io/match-trade/platform-api/partial-close", "x-checked": "2026-10-12", "x-page": "https://openbrokerapi.com/platforms/match-trader/endpoints/post-position-close-partially" } }, "/mtr-api/{SYSTEM_UUID}/position/edit": { "post": { "operationId": "post-position-edit", "summary": "Change the stop loss and take profit of an open position.", "description": "Read on 12 Oct 2026 in Match-Trade's Platform API reference, which the Match-Trade documentation site links to and which is published at app.theneo.io. This call sits in a section the page loads only when it is opened, so its content was read from the data the page itself requests for that section. The method, path, parameters and required marks are the reference's own. The reference gives one base address, a sandbox at https://mtr-demo-prod.match-trader.com, and none for a broker's own platform. The reference writes the address with the bare word SYSTEM_UUID where the trading system's identifier goes, and its text calls the value systemUUID. This record writes it as a path parameter. The reference marks the headers as required and gives the body fields without a mark, so it does not say whether id, instrument, orderSide and volume must be sent. The body field is named id, while the reference's text calls it orderId. The reply carries status, nativeCode, errorMessage and orderId. The mock reply uses those names with invented values.", "tags": [ "Position" ], "externalDocs": { "description": "Match-Trader Platform API's own reference for this operation", "url": "https://app.theneo.io/match-trade/platform-api/edit-position" }, "parameters": [ { "name": "SYSTEM_UUID", "in": "path", "required": true, "description": "The identifier of the trading system the account is on. The reference does not say where to read it. The login reply carries a system object with a uuid under each trading account's offer.", "schema": { "type": "string" } }, { "name": "Cookie", "in": "header", "required": true, "description": "Marked required, with the example value co-auth={token}. The login section says the token field of the login reply is passed as a cookie, and the Market Watch section describes this header as tradingAccountToken.token.", "schema": { "type": "string" } }, { "name": "Content-Type", "in": "header", "required": true, "description": "Marked required. The example value is application/json.", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "id": { "type": "string", "description": "The identifier of the position.", "x-required-unmarked": true }, "instrument": { "type": "string", "description": "The symbol.", "x-required-unmarked": true }, "orderSide": { "type": "string", "description": "BUY or SELL.", "x-required-unmarked": true }, "volume": { "type": "number", "description": "The position's volume.", "x-required-unmarked": true }, "slPrice": { "type": "number", "description": "New stop loss price. The reference says it cannot be null and that 0 is sent when none is wanted, which is why it is recorded as required." }, "tpPrice": { "type": "number", "description": "New take profit price. The reference says it cannot be null and that 0 is sent when none is wanted, which is why it is recorded as required." }, "isMobile": { "type": "boolean", "description": "Example value false.", "x-required-unmarked": true } }, "required": [ "slPrice", "tpPrice" ], "x-required-unmarked": [ "id", "instrument", "orderSide", "volume", "isMobile" ] } } } }, "responses": { "default": { "description": "A mock reply held on this site's record. The values are invented and the record holds no status code for it.", "content": { "application/json": { "example": { "_mock": true, "status": "OK", "nativeCode": "", "errorMessage": "", "orderId": "MOCK1" } } } } }, "security": [ { "Auth-trading-api": [] } ], "x-source": "https://app.theneo.io/match-trade/platform-api/edit-position", "x-checked": "2026-10-12", "x-page": "https://openbrokerapi.com/platforms/match-trader/endpoints/post-position-edit" } }, "/mtr-api/{SYSTEM_UUID}/position/open": { "post": { "operationId": "post-position-open", "summary": "Open a position in an instrument, on the buy or the sell side, with a volume and an optional stop loss and take profit.", "description": "Read on 12 Oct 2026 in Match-Trade's Platform API reference, which the Match-Trade documentation site links to and which is published at app.theneo.io. This call sits in a section the page loads only when it is opened, so its content was read from the data the page itself requests for that section. The method, path, parameters and required marks are the reference's own. The reference gives one base address, a sandbox at https://mtr-demo-prod.match-trader.com, and none for a broker's own platform. The reference writes the address with the bare word SYSTEM_UUID where the trading system's identifier goes, and its text calls the value systemUUID. This record writes it as a path parameter. The reference marks the headers as required and gives the body fields without a mark, so it does not say whether instrument, orderSide and volume must be sent. The reply carries status, nativeCode, errorMessage and orderId. The mock reply uses those names with invented values.", "tags": [ "Position" ], "externalDocs": { "description": "Match-Trader Platform API's own reference for this operation", "url": "https://app.theneo.io/match-trade/platform-api/open-position" }, "parameters": [ { "name": "SYSTEM_UUID", "in": "path", "required": true, "description": "The identifier of the trading system the account is on. The reference does not say where to read it. The login reply carries a system object with a uuid under each trading account's offer.", "schema": { "type": "string" } }, { "name": "Cookie", "in": "header", "required": true, "description": "Marked required, with the example value co-auth={token}. The login section says the token field of the login reply is passed as a cookie, and the Market Watch section describes this header as tradingAccountToken.token.", "schema": { "type": "string" } }, { "name": "Content-Type", "in": "header", "required": true, "description": "Marked required. The example value is application/json.", "schema": { "type": "string" } } ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "properties": { "instrument": { "type": "string", "description": "The symbol. Example value EURUSD.", "x-required-unmarked": true }, "orderSide": { "type": "string", "description": "BUY or SELL.", "x-required-unmarked": true }, "volume": { "type": "number", "description": "The size in lots. Example value 0.01.", "x-required-unmarked": true }, "slPrice": { "type": "number", "description": "Stop loss price. The reference says it cannot be null and that 0 is sent when none is wanted, which is why it is recorded as required." }, "tpPrice": { "type": "number", "description": "Take profit price. The reference says it cannot be null and that 0 is sent when none is wanted, which is why it is recorded as required." }, "isMobile": { "type": "boolean", "description": "Example value false.", "x-required-unmarked": true } }, "required": [ "slPrice", "tpPrice" ], "x-required-unmarked": [ "instrument", "orderSide", "volume", "isMobile" ] } } } }, "responses": { "default": { "description": "A mock reply held on this site's record. The values are invented and the record holds no status code for it.", "content": { "application/json": { "example": { "_mock": true, "status": "OK", "nativeCode": "", "errorMessage": "", "orderId": "MOCK1" } } } } }, "security": [ { "Auth-trading-api": [] } ], "x-source": "https://app.theneo.io/match-trade/platform-api/open-position", "x-checked": "2026-10-12", "x-page": "https://openbrokerapi.com/platforms/match-trader/endpoints/post-position-open" } }, "/mtr-api/{SYSTEM_UUID}/quotations": { "get": { "operationId": "get-quotations", "summary": "Read the latest bid and ask for a symbol, with the day's change, high and low.", "description": "Read on 12 Oct 2026 in Match-Trade's Platform API reference, which the Match-Trade documentation site links to and which is published at app.theneo.io. This call sits in a section the page loads only when it is opened, so its content was read from the data the page itself requests for that section. The method, path, parameters and required marks are the reference's own. The reference gives one base address, a sandbox at https://mtr-demo-prod.match-trader.com, and none for a broker's own platform. The reference writes the address with the bare word SYSTEM_UUID where the trading system's identifier goes, and its text calls the value systemUUID. This record writes it as a path parameter. The reply is a list, so no mock object is shown. Each entry carries symbol, alias, bid, ask, change, high, low, timestampSec and timestampMs. The reference gives the prices as strings and the two timestamps as numbers.", "tags": [ "Data" ], "externalDocs": { "description": "Match-Trader Platform API's own reference for this operation", "url": "https://app.theneo.io/match-trade/platform-api/market-watch" }, "parameters": [ { "name": "SYSTEM_UUID", "in": "path", "required": true, "description": "The identifier of the trading system the account is on. The reference does not say where to read it. The login reply carries a system object with a uuid under each trading account's offer.", "schema": { "type": "string" } }, { "name": "Cookie", "in": "header", "required": true, "description": "Marked required, with the example value co-auth={token}. The login section says the token field of the login reply is passed as a cookie, and the Market Watch section describes this header as tradingAccountToken.token.", "schema": { "type": "string" } }, { "name": "symbols", "in": "query", "required": true, "description": "The symbol to quote. Marked required.", "schema": { "type": "string" } } ], "security": [ { "Auth-trading-api": [] } ], "x-source": "https://app.theneo.io/match-trade/platform-api/market-watch", "x-checked": "2026-10-12", "x-page": "https://openbrokerapi.com/platforms/match-trader/endpoints/get-quotations" } } }, "components": { "securitySchemes": { "Auth-trading-api": { "type": "apiKey", "in": "header", "name": "Auth-trading-api", "description": "A header the Match-Trader Platform API endpoint records list on requests. Read its value from your own environment. Never paste it into a web page or a chat." } } } }