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

Name	Type	Required	Description	Example
date_from	string	Yes	Start date (format: YYYY-MM-DD)	2024-01-01
date_to	string	Yes	End date (format: YYYY-MM-DD)	2024-12-31
offset	integer	No	Pagination offset for results. Defaults to 0.	0
count	integer	No	Number of records to return per page. Defaults to 50.	25

Response

Success Response (200)

{
  "status": "ok",
  "message": "",
  "count": 4,
  "offset": 0,
  "total": 42,
  "data": [
    {
      "id": "67a8b12c3d4e5f6g7h8i9j2a",
      "date": "2024-12-09",
      "type": "Buy",
      "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

Field	Type	Description
id	string	Unique transaction identifier
date	string	Transaction date (YYYY-MM-DD format)
type	string	Transaction type (Buy/Sell)
notice_id	string	PSX notice ID reference
notice_date	string (ISO 8601)	PSX notice publication date
symbol	string	Stock symbol
company_name	string	Company name
name	string	Insider's name
description	string	Transaction description
price	float	Transaction price per share
shares	integer	Number of shares transacted
share_type	string	Type of shares (Ordinary/Preference)
market	string	Market code (PSX)

Error Responses

For detailed Common Error responses, see the Error Handling.

Missing Parameters

{
    "status": "error",
    "message": "no `date_from` and `date_to` provided"
}

Examples

Get Insider Transactions for December 2024

curl -X GET "https://csapis.com/3.0/insider/date-range?date_from=2024-12-01&date_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