qkt/com.qkt.broker.mt5/MT5Client

MT5Client

class MT5Client(gatewayUrl: String, tzOffsetHours: Int, httpTimeoutMs: Long = 5000, retryAttempts: Int = 3)

Low-level HTTP client for the mt5-gateway service.

One client per MT5Broker. Handles JSON serialization, retries on GETs (POST /order is deliberately not retried — duplicate placement is worse than a surfaced failure), timezone offsets between the venue clock and UTC, and basic error parsing.

Constructors

MT5Client

constructor(gatewayUrl: String, tzOffsetHours: Int, httpTimeoutMs: Long = 5000, retryAttempts: Int = 3)

Types

Companion

object Companion

Functions

cancelOrder

fun cancelOrder(ticket: Long): String

getPendingOrders

fun getPendingOrders(magic: Int? = null): List<MT5PendingOrder>

Fetch the venue's working (pending) orders. Empty list if the gateway doesn't expose /orders (returns 404 → handled by getWithRetry returning null).

getPositions

fun getPositions(magic: Int? = null): List<MT5Position>

getTick

fun getTick(brokerSymbol: String): MT5Tick?

isReady

fun isReady(): Boolean

modifyOrder

fun modifyOrder(ticket: Long, mods: MT5OrderModification): MT5OrderResponse

Modify a working order. Returns the gateway's MT5OrderResponse — successful when MT5OrderResult.retcode is MT5_TRADE_RETCODE_DONE.

placeOrder

fun placeOrder(req: MT5OrderRequest): MT5OrderResponse