Latest Insider Transactions

Retrieve the latest insider trading transactions and activities.

GET/3.0/insider

Description

This endpoint returns the most recent insider trading transactions, including purchases and sales by company insiders. Useful for tracking insider activity and market sentiment indicators.

Request

Authentication

• Type: Bearer Token
• Required: Yes

Parameters

Name	Type	Required	Description	Example
next	string	No	Pagination cursor (base64 encoded) for next page	MTU7NTs1MDI=

Response

Success Response (200)

{
  "status": "ok",
  "message": "",
  "count": 5,
  "offset": 0,
  "total": 147,
  "next": "MTU7NTs1MDI=",
  "data": [
    {
      "id": "67a8b12c3d4e5f6g7h8i9j0k",
      "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"
    },
    {
      "id": "67a8b12c3d4e5f6g7h8i9j0l",
      "date": "2024-12-08",
      "type": "Sell",
      "uin": "12346",
      "notice_id": "PSX-2024-12-008",
      "notice_date": "2024-12-08T14:15:00+05:00",
      "symbol": "MCB",
      "company_name": "MCB Bank Limited",
      "name": "Arif Habib",
      "description": "Sale of ordinary shares",
      "price": 465.00,
      "shares": 100000,
      "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)
uin	string	Unique Insider Number
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.

Examples

Get Latest Insider Transactions

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

Use Cases

• Insider Tracking: Monitor insider buying and selling activity
• Sentiment Analysis: Use insider transactions as market sentiment indicators
• Compliance Monitoring: Track insider activity for regulatory compliance
• Research Data: Analyze insider activity patterns and trends
• Market Intelligence: Identify potential insider perspectives on company value