Insider by Company

Retrieve insider transactions filtered by company symbol.

GET/3.0/insider/symbol

Description

This endpoint returns insider trading transactions for a specific company, allowing analysis of insider activity for individual stocks.

Request

Authentication

• Type: Bearer Token
• Required: Yes

Parameters

Name	Type	Required	Description	Example
symbol	string	Yes	Stock symbol to filter insider transactions	UBL
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",
    "offset": 0,
    "count": 50,
    "total": 463,
    "data": [
        {
            "id": "25556",
            "date": "2025-05-22",
            "type": "buy",
            "notice_id": "254405",
            "notice_date": "2025-05-27",
            "symbol": "UBL",
            "company_name": "United Bank Limited",
            "name": "Imran Sarwar",
            "description": "Senior Management",
            "price": 516.52,
            "shares": 850,
            "share_type": "CDC",
            "market": "Ready"
        },
        {
            "id": "25100",
            "date": "2025-04-22",
            "type": "buy",
            "notice_id": "252067",
            "notice_date": "2025-04-24",
            "symbol": "UBL",
            "company_name": "United Bank Limited",
            "name": "Irfan Masood",
            "description": "Executive",
            "price": 548.95,
            "shares": 540,
            "share_type": "CDC",
            "market": "Ready"
        }
    ]
}

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 `symbol` provided"
}

Examples

Get Insider Transactions for UBL

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

Use Cases

• Company Analysis: Track insider activity for specific companies
• Insider Concentration: Identify major insider stakeholders
• Buying/Selling Signals: Analyze insider sentiment for specific stocks
• Corporate Governance: Monitor executive and director trading
• Valuation Signals: Use insider buying as valuation signal