Portfolio Investments (FIPI/LIPI)

Retrieve portfolio investment data for foreign and local investors including buy/sell volumes and values across sectors.

GET/3.0/portfolio-investments

Description

This endpoint returns portfolio investment data for Foreign Institutional Portfolio Investors (FIPI) and Local Institutional Portfolio Investors (LIPI). The data includes buy and sell volumes, values, and net positions aggregated by investor type, sector, and date. Data can be filtered by date and investor type.

Request

Authentication

• Type: Bearer Token
• Required: Yes

Parameters

Name	Type	Required	Description	Example
type	string	No	Investor type filter. Use local for LIPI, foreign for FIPI	local
date	string	Yes	Specific date filter (format: YYYY-MM-DD)	2025-05-08

Response

Success Response (200)

{
  "status": "ok",
  "message": "",
  "data": [
    {
      "date": "2025-05-08",
      "market": "KSE",
      "client": "LIPI",
      "sector": "COMMERCIAL_BANKS",
      "sector_code": "COMMERCIAL_BANKS",
      "buy_vol": 750000,
      "buy_val": 206250000.00,
      "sell_vol": 250000,
      "sell_val": 68750000.00,
      "net_vol": 500000,
      "net_val": 137500000.00,
      "usd": 471232.88,
      "is_foreign": false
    },
    {
      "date": "2025-05-08",
      "market": "KSE",
      "client": "FIPI",
      "sector": "COMMERCIAL_BANKS",
      "sector_code": "COMMERCIAL_BANKS",
      "buy_vol": 350000,
      "buy_val": 96250000.00,
      "sell_vol": 100000,
      "sell_val": 27500000.00,
      "net_vol": 250000,
      "net_val": 68750000.00,
      "usd": 235616.44,
      "is_foreign": true
    }
  ]
}

Response Fields

Field	Type	Description
date	string	Date of the record (YYYY-MM-DD)
market	string	Market code (e.g., KSE)
client	string	Investor type: LIPI (Local) or FIPI (Foreign)
sector	string	Sector name
sector_code	string	Sector classification code
buy_vol	number	Total buy volume for the period
buy_val	number	Total buy value in PKR
sell_vol	number	Total sell volume for the period
sell_val	number	Total sell value in PKR
net_vol	number	Net volume (buy - sell)
net_val	number	Net value in PKR (buy - sell)
usd	number	Net value in USD
is_foreign	boolean	True for FIPI, False for LIPI

Error Responses

For detailed Common Error responses, see the Error Handling.

Missing Parameters (200)

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

Invalid Type (200)

{
    "status": "error",
    "message": "invalid_type"
}

Invalid Date Format (200)

{
    "status": "error",
    "message": "invalid_date"
}

Examples

Get Portfolio Investments

curl -X GET "https://csapis.com/3.0/portfolio-investments?date=2025-12-11&type=local" \
  -H "Authorization: Bearer YOUR_API_TOKEN"

Use Cases

• Investor Tracking: Monitor foreign and local investor portfolio activities
• Sector Analysis: Analyze portfolio investments by sector
• Fund Flow Analysis: Track net buy/sell flows by investor type
• Market Sentiment: Gauge investor sentiment through portfolio investments
• Investment Research: Analyze institutional investor trends and patterns