# Hkexnews (hkexnews.hk) — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Query CCASS shareholding records from Hong Kong Exchange to find detailed information about who holds shares in a specific stock on any given date. Look up shareholding data by stock code and date to track institutional and investor positions in Hong Kong-listed companies.

**Category:** Finance & Markets | **Website:** [www.hkexnews.hk/sdw/search/searchsdw.aspx](https://www.hkexnews.hk/sdw/search/searchsdw.aspx) | **Docs:** [parse.bot/marketplace/4b00ae0c-a970-4815-9922-47ba3fe8f748/hkexnews-hk-api](https://parse.bot/marketplace/4b00ae0c-a970-4815-9922-47ba3fe8f748/hkexnews-hk-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.paywithlocus.com/api/wrapped/parse-hkexnews-hk-api-4b00ae0c/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### search_ccass_shareholding

Search CCASS shareholding data for a given stock on a specific date. Returns all CCASS participants (market intermediaries and consenting investor participants) holding shares, with their name, address, shareholding quantity, and percentage. Results are sorted by shareholding descending. Only data within the past 12 months is available; if the date falls on a Sunday or Hong Kong public holiday, the preceding business day's data is returned.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `shareholding_date` | string | Yes | Shareholding date in YYYY/MM/DD format (e.g. '2026/07/15'). Must be within the past 12 months. |
| `stock_code` | string | Yes | Hong Kong stock code, up to 5 digits (e.g. '00700'). Leading zeros are added automatically if fewer than 5 digits are provided. |

```bash
curl -X POST https://api.paywithlocus.com/api/wrapped/parse-hkexnews-hk-api-4b00ae0c/search_ccass_shareholding \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"shareholding_date":"<string>","stock_code":"<string>"}'
```