Platform API

## Sections
• [Introduction](https://app.theneo.io/match-trade/platform-api/introduction.md): The Platform API provides comprehensive access to the core functionalities of our trading platform, allowing users to execute and manage trades, access market data, and perform all actions on the platform directly through code. This API is designed to empower developers and traders by offering programmatic control over trading operations, enabling the automation of tasks, integration with other systems, and the development of custom trading solutions. The API is RESTful and uses standard HTTP methods, making it straightforward to integrate into your existing workflows. Whether you’re automating trading strategies, building custom dashboards, or enhancing your trading systems, the Platform API provides the flexibility and power you need to achieve your goals efficiently. The request limit is 500 requests/minute.
• [Register](https://app.theneo.io/match-trade/platform-api/register.md): This API request is designed to create a new user account within the trading platform. By sending a POST request to the provided endpoint, you can register a user with specific credentials and associate them with a particular trading offer and partner. When executing this request, you must provide key details such as the offerId that your broker provided, which links the new account to a specific trading offer, the user's email , and the password for authentication. Additionally, the partnerId helps categorize the user under a specific partner, ensuring proper organization within the system is also taken from the broker or by the Get Platform Details endpoint. This endpoint is essential for onboarding new users, allowing them to quickly and efficiently access the trading platform under predefined conditions. Ensure that all required fields are accurately populated to avoid errors during the account creation process.
• [Login](https://app.theneo.io/match-trade/platform-api/login.md): This API request logs a user into the platform and returns authentication tokens. The token is valid for 15 minutes and should be refreshed afterwards. Tokens should be refreshed via the /refresh-token endpoint either after 15 minutes from login or upon receiving the first 401 Unauthorised response. This limits token refresh requests to a maximum of four per hour. Upon a successful login, the response JSON contains critical information for subsequent API requests. Below is a breakdown of the key elements and how to use them: Key Elements: tradingApiToken : This token is required to authenticate further actions with the trading API. Use this token in the header Auth-trading-api for all subsequent trading-related API requests. token : This token is used as a cookie in subsequent requests to maintain the session state. This token is passed as a Cookie in further API requests to maintain session authenticity.
• [Refresh token](https://app.theneo.io/match-trade/platform-api/refresh-token.md): The Refresh Token request is used to renew an authentication token to maintain a user session without needing to log in again. By sending a POST request, users can obtain a new token, ensuring continued access to the platform without interruption, especially when the token is nearing expiration. The refresh token is included as a cookie to facilitate this process.
• [Login with one time token](https://app.theneo.io/match-trade/platform-api/login-with-one-time-token.md): The Login with One-Time Token request allows users to log in using a token obtained from the Register request. Instead of traditional credentials, this method uses a single-use token for authentication. By sending a POST request with the token in the payload, users can securely log in to the platform. This method is typically used when a temporary or quick login process is required.
• [Get Platform Details](https://app.theneo.io/match-trade/platform-api/get-platform-details.md): The endpoint returns details about the trading platform associated with the authenticated user.
• [Market Watch](https://app.theneo.io/match-trade/platform-api/data/market-watch.md): The Market Watch request retrieves the latest price of a specific trading symbol by sending a GET request. The request requires the systemUUID , the tradingApiToken , and the tradingAccountToken (obtained from the login response) for secure access. By specifying the symbol in the query parameter, the API returns real-time market quotations for that symbol, allowing users to monitor current prices and make trading decisions.
• [Get Balance](https://app.theneo.io/match-trade/platform-api/data/get-balance.md): This request retrieves the user's current account balance on the Match-Trader platform. By sending a GET request to the balance endpoint with the required systemUUID , tradingApiToken , and tradingAccountToken , the API provides real-time information about the user's available funds. The response includes details such as the total balance, equity, and any reserved margin, allowing users to monitor their account's financial status.
• [Get Symbols](https://app.theneo.io/match-trade/platform-api/data/get-symbols.md): This endpoint returns a list of all trading instruments available to the authenticated user, including detailed instrument settings such as symbol, trading hours, precision, volume limits, leverage, swap and more.
• [Get Candles](https://app.theneo.io/match-trade/platform-api/data/get-candles.md): This endpoint retrieves historical candlestick data for a specified trading symbol within a given time range and interval, returning open, high, low, close prices and volume for each candle.
• [Position](https://app.theneo.io/match-trade/platform-api/position.md): In the Position section, you will find comprehensive information about the various positions held within the system. This section allows you to view, manage, and interact with trading positions efficiently. Here, you can explore details of opened positions, modify them, and initiate actions such as closing or partially closing positions. It serves as a central hub for managing positions throughout their lifecycle, from creation to closure. A Position refers to a financial stake in a market instrument that a trader opens to speculate on price movements. Users can open positions based on their market analysis, and each position reflects the user’s exposure to an asset at a specific time.
  • [Get opened positions](https://app.theneo.io/match-trade/platform-api/position/get-opened-positions.md): This request retrieves all currently open trading positions, sends a GET request to the open-positions endpoint using the systemUUID , tradingApiToken , and tradingAccountToken for authentication. The response provides details of each open position, including the position ID, trading symbol (e.g., "EURUSD"), volume, side (BUY/SELL), open price, stop-loss, take-profit levels, current price, and profit/loss information. This is essential for monitoring active trades and managing open positions.
  • [Open position](https://app.theneo.io/match-trade/platform-api/position/open-position.md): This request is used to open a new trading position. By sending a POST request with details such as the trading instrument (e.g., "EURUSD"), the order side (BUY or SELL), and the volume (lot size), the API places a new order. Optional parameters like stop-loss ( slPrice ) and take-profit ( tpPrice ) can also be set (for positions without SL or TP you need to provide 0 value for those fields). The request requires the systemUUID , tradingApiToken , and tradingAccountToken for authentication. Upon success, the response returns a status of "OK" and the orderId for the newly opened position.
  • [Edit position](https://app.theneo.io/match-trade/platform-api/position/edit-position.md): This request allows you to modify an existing trading position. By providing the instrument (e.g., "EURUSD"), orderId , and details such as the orderSide , volume , and new stop-loss ( slPrice ) and take-profit ( tpPrice ) values, you can adjust the parameters of an open position. Authentication is handled with the tradingApiToken and tradingAccountToken . A successful response indicates that the position was updated, with a status of "OK" and the updated orderId .
  • [Partial Close](https://app.theneo.io/match-trade/platform-api/position/partial-close.md): This request is used to partially close an existing trading position on the platform. By providing the positionId , the volume to close, and details like the instrument (e.g., "EURUSD") and order side (BUY or SELL), you can reduce the size of an open position. Authentication is managed via the systemUUID , tradingApiToken , and tradingAccountToken .
  • [Close positions](https://app.theneo.io/match-trade/platform-api/position/close-positions.md): This request is used to close an existing trading position on the platform. By providing the positionId , trading instrument (e.g., "EURUSD"), the order side (BUY or SELL), and the volume to close, the API will process the position closure. Authentication is handled via the systemUUID , tradingApiToken , and tradingAccountToken . A successful response will return a status of "OK" , confirming that the position has been closed successfully.
  • [Get closed positions](https://app.theneo.io/match-trade/platform-api/position/get-closed-positions.md): This request retrieves the user's closed positions for a specific data range on the platform. By sending a POST request to the closed-positions endpoint with the required systemUUID , data range from and to tradingApiToken , and tradingAccountToken , the API provides information about the user's closed positions. The response includes details such as the total time of opening position, open price, symbol, volume, time of closing position, profit, and more, allowing users to monitor their closed positions.
• [Order](https://app.theneo.io/match-trade/platform-api/order.md): In the Order section, you will find detailed information and tools to manage various trading orders within the system. This section allows you to create, monitor, modify, and cancel pending orders, providing full control over your order management process. The Order section acts as a centralized hub for handling all aspects of order activity. An Order represents an instruction to buy or sell a financial asset at specific conditions, such as price and quantity. Users can place pending orders, which remain open until the market conditions are met or the order is manually canceled.
  • [Get active orders](https://app.theneo.io/match-trade/platform-api/order/get-active-orders.md): The Get Active Orders request retrieves all currently active orders on the platform. By sending a GET request, this API call returns a list of open orders that have not yet been executed. The request requires authentication via the tradingApiToken and tradingAccountToken , ensuring secure access to the user's trading data. This is useful for monitoring pending orders and managing trading strategies.
  • [Create pending order](https://app.theneo.io/match-trade/platform-api/order/create-pending-order.md): The Create Pending Order request allows users to set up a pending order on the Match-Trader platform for a specific instrument. By specifying parameters such as the trading instrument (e.g., "EURUSD"), the order side (BUY or SELL), the volume, and the desired price, the API creates a pending order that will execute once market conditions are met. Additional options like stop-loss ( slPrice ) and take-profit ( tpPrice ) can also be included. The request requires authentication via the tradingApiToken and tradingAccountToken for secure order placement.
  • [Edit pending order](https://app.theneo.io/match-trade/platform-api/order/edit-pending-order.md): The Edit Pending Order request allows users to modify the details of an existing pending order on the Match-Trader platform. By sending a POST request with the orderId and updated parameters such as the trading instrument (e.g., "EURUSD"), order side (BUY or SELL), volume, stop-loss ( slPrice ), take-profit ( tpPrice ), and order price, users can adjust their pending orders. Authentication is handled through the tradingApiToken and tradingAccountToken to ensure secure order management.
  • [Cancel pending order](https://app.theneo.io/match-trade/platform-api/order/cancel-pending-order.md): The Cancel Pending Order request cancels an existing pending order on the Match-Trader platform. By providing the order's unique ID ( id ), instrument (e.g., "EURUSD"), order side (BUY or SELL), and order type (e.g., "LIMIT"), users can cancel a pending order before it is executed. The request requires authentication via the tradingApiToken and tradingAccountToken to securely process the cancellation. This allows traders to manage and withdraw pending orders as needed.
• [Errors](https://app.theneo.io/match-trade/platform-api/errors.md): In this section, you can find examples of error responses for each status code. Successful responses are available in the relevant sections of this documentation.