Insiders by Type

Retrieve insider transactions filtered by transaction type (Buy or Sell).

GET/3.0/insider/type

Description

This endpoint returns insider trading transactions filtered by transaction type, allowing analysis of insider buying and selling activity separately.

Request

Authentication

• Type: Bearer Token
• Required: Yes

Parameters

Name	Type	Required	Description	Example
type	string	Yes	Transaction type. See Available Types for valid values.	buy
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

Available Types

Type	Description
buy	Buy
sell	Sell
gift-in	Gift (In)
gift-out	Gift (Out)
bonus	Bonus
right	Right
ral-in	RAL (In)
ral-out	RAL (Out)
conversion-of-loan	Conversion of Loan
conversion-of-pres-shares	Conversion of Preference Shares
merger	Merger
other-than-right	Other than Right
ofs-by-person	OFS by Person
ipo	IPO
esos	ESOS
inheritance-in	Inheritance (In)
inheritance-out	Inheritance (Out)
repo-in	Repo (In)
repo-out	Repo (Out)
split-in	Split (In)
split-out	Split (Out)
other-in	Other (In)
other-out	Other (Out)

Response

Success Response (200)

{
  "status": "ok",
  "message": "",
  "data": [
    {
      "id": "67a8b12c3d4e5f6a7b8c9d3a",
      "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"
    },
    {
      "id": "67a8b12c3d4e5f6a7b8c9d3b",
      "date": "2024-12-07",
      "type": "Buy",
      "notice_id": "PSX-2024-12-007",
      "notice_date": "2024-12-07T10:45:00+05:00",
      "symbol": "LUCK",
      "company_name": "Lucky Cement Limited",
      "name": "Khalid Siraj Subhani",
      "description": "Purchase of ordinary shares",
      "price": 850.00,
      "shares": 25000,
      "share_type": "Ordinary",
      "market": "PSX"
    },
    {
      "id": "67a8b12c3d4e5f6a7b8c9d3c",
      "date": "2024-12-05",
      "type": "Buy",
      "notice_id": "PSX-2024-12-005",
      "notice_date": "2024-12-05T09:00:00+05:00",
      "symbol": "HBL",
      "company_name": "Habib Bank Limited",
      "name": "Wasim Akhtar",
      "description": "Purchase of ordinary shares",
      "price": 345.00,
      "shares": 150000,
      "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	Share type
market	string	Market

Error Responses

For detailed Common Error responses, see the Error Handling.

Missing Parameters

{
    "status": "error",
    "message": "no `type` provided"
}

Examples

Get All Insider Buy Transactions

curl -X GET "https://csapis.com/3.0/insider/type?type=buy" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Use Cases

• Sentiment Analysis: Separate buy and sell signals for trend analysis
• Insider Confidence: Use insider buying as market confidence indicator
• Risk Assessment: Monitor insider selling as potential red flag
• Market Timing: Analyze insider activity patterns for timing insights
• Aggregated Analysis: Compare buy vs sell volume for overall sentiment