Skip to main content

Insiders by Date Range

Retrieve insider transactions within a specified date range.

GET/3.0/insider/date-range

Description​

This endpoint returns insider trading transactions filtered by a date range, allowing historical analysis of insider activity over specific periods.

Request​

Authentication​

  • Type: Bearer Token
  • Required: Yes

Parameters​

NameTypeRequiredDescriptionExample
fromstringYesStart date (format: YYYY-MM-DD)2024-01-01
tostringYesEnd date (format: YYYY-MM-DD)2024-12-31
notice_idstringNoFilter by notice IDPSX-2024-12-009

Response​

Success Response (200)​

{
  "status": "ok",
  "message": "",
  "count": 4,
  "offset": 0,
  "total": 42,
  "data": [
    {
      "id": "67a8b12c3d4e5f6g7h8i9j2a",
      "date": "2024-12-09",
      "type": "Buy",
      "uin": "12345",
      "notice_id": "PSX-2024-12-009",
      "notice_date": "2024-12-09T15:30:00+05:00",
      "symbol": "UBL",
      "company_name": "United Bank Limited",
      "name": "Muhammad Jawaid Iqbal",
      "description": "Purchase of ordinary shares",
      "price": 410.50,
      "shares": 50000,
      "share_type": "Ordinary",
      "market": "PSX"
    }
  ]
}

Response Fields​

Same as Latest Insider Transactions. See Latest Insider Transactions documentation for field descriptions.

Error Responses​

For detailed Common Error responses, see the Error Handling.

Examples​

Get Insider Transactions for December 2024​

curl -X GET "https://csapis.com/3.0/insider/date-range?from=2024-12-01&to=2024-12-31" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Use Cases​

  • Trend Analysis: Analyze insider activity trends over time periods
  • Historical Review: Review insider transactions for specific periods
  • Seasonal Analysis: Identify seasonal patterns in insider trading
  • Event Analysis: Analyze insider activity around corporate events
  • Period Comparison: Compare insider activity across different time periods