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
| Name | Type | Required | Description | Example |
|---|---|---|---|---|
from | string | Yes | Start date for filtering data (format: YYYY-MM-DD). Required parameter. | 2025-07-18 |
to | string | Yes | End date for filtering data (format: YYYY-MM-DD). Required parameter. | 2025-07-18 |
symbol | string | No | Stock 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
| Field | Type | Description |
|---|---|---|
date | string | Date of the margin trading system record (YYYY-MM-DD) |
symbol | string | Stock symbol of the security |
name | string | Full name of the company/security |
ovbr | number | Open volume before release |
oar | number | Open amount before release |
adj | number | Adjustment to open positions |
crvol | number | Current release volume |
cramt | number | Current release amount |
cvol | number | Current volume in margin accounts |
came | number | Current amount in margin accounts |
wave | number | Weighted average price |
novol | number | Net open volume |
nomad | number | Net open amount |
pct | number | Percentage of margin utilization |
cat | string | Category 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