Skip to main content

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​

NameTypeRequiredDescriptionExample
typestringYesTransaction type filter (Buy/Sell)Buy

Response​

Success Response (200)​

{
  "status": "ok",
  "message": "",
  "data": [
    {
      "id": "67a8b12c3d4e5f6g7h8i9j3a",
      "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": "67a8b12c3d4e5f6g7h8i9j3b",
      "date": "2024-12-07",
      "type": "Buy",
      "uin": "12347",
      "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": "67a8b12c3d4e5f6g7h8i9j3c",
      "date": "2024-12-05",
      "type": "Buy",
      "uin": "12348",
      "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​

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 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