Skip to main content

Margin Trade System (MTS)

Retrieve margin trading system data including open positions, margin releases, and weighted averages for margin-enabled securities.

GET/3.0/margin-trade-system

Description

This endpoint returns Margin Trade System (MTS) data, which includes open margin positions, current release volumes, weighted average prices, and margin utilization metrics for securities enabled for margin trading. The data tracks positions held in margin accounts and daily margin system activities.

Request

Authentication

  • Type: Bearer Token
  • Required: Yes

Parameters

NameTypeRequiredDescriptionExample
fromstringYesStart date for filtering data (format: YYYY-MM-DD). Required parameter.2025-07-18
tostringYesEnd date for filtering data (format: YYYY-MM-DD). Required parameter.2025-07-18
symbolstringNoStock symbol filter to get data for a specific security.UBL

Response

Success Response (200)

{
"status": "ok",
"message": "",
"data": [
{
"date": "2022-12-30",
"symbol": "ANL",
"name": "AZGARD NINE LIMITED",
"ovbr": 1164500,
"oar": 7018318.75,
"adj": -3614.95,
"crvol": 15000,
"cramt": 91206.1,
"cvol": 248500,
"came": 1521933.8,
"wave": 18.94,
"novol": 1398000,
"nomad": 8452661.4,
"pct": 0.23,
"cat": "B"
},
{
"date": "2022-12-30",
"symbol": "ASTL",
"name": "AMRELI STEELS LIMITED",
"ovbr": 1464000,
"oar": 21493313.8,
"adj": -10720.15,
"crvol": 28000,
"cramt": 414720,
"cvol": 418000,
"came": 6333595,
"wave": 18.6,
"novol": 1854000,
"nomad": 27422908.95,
"pct": 0.74,
"cat": "B"
}
]
}

Response Fields

FieldTypeDescription
datestringDate of the margin trading system record (YYYY-MM-DD)
symbolstringStock symbol of the security
namestringFull name of the company/security
ovbrnumberOpen volume before release
oarnumberOpen amount before release
adjnumberAdjustment to open positions
crvolnumberCurrent release volume
cramtnumberCurrent release amount
cvolnumberCurrent volume in margin accounts
camenumberCurrent amount in margin accounts
wavenumberWeighted average price
novolnumberNet open volume
nomadnumberNet open amount
pctnumberPercentage of margin utilization
catstringCategory of security (A, B, etc.)

Error Responses

For detailed Common Error responses, see the Error Handling.

No Date Range Provided

{
"status": "error",
"message": "no_date_provided"
}

Examples

Get MTS Data for Specific Symbol

curl -X GET "https://csapis.com/3.0/margin-trade-system?from=2025-07-18&to=2025-07-18&symbol=UBL" \
-H "Authorization: Bearer YOUR_API_TOKEN"

Use Cases

  • Margin Position Tracking: Monitor open margin positions and utilization rates
  • Margin Release Analysis: Track daily margin releases and adjustments
  • Risk Management: Monitor weighted average prices and margin utilization percentages
  • Trading Analysis: Analyze margin trading activity and trends
  • Compliance Reporting: Generate margin trading system reports for regulatory compliance