Japan JPX Short Selling Balances — FSA-Mandated Disclosure

Daily short-selling balance disclosure from the Japan Exchange Group (JPX), published under the FSA's Cabinet Office Ordinance on Disclosure of Information Concerning Securities Transactions, Etc. (Article 26). Every short position held in a Japanese-listed security at >=0.5% of shares outstanding must be reported by the holder to the exchange and is published the next business day.

This actor reads JPX's daily Excel disclosure files at https://www.jpx.co.jp/markets/public/short-selling/, parses every row, and returns clean structured records.

---

What you get

Each record returned by the actor contains:

Field	Type	Description
ticker	string	4-digit Japanese securities code (e.g. 7203 for Toyota)
company_name	string	Issuer name (Japanese, e.g. トヨタ自動車　普通株式)
company_name_en	string	Issuer name (English, e.g. Toyota Motor Corporation)
short_holder_name	string	Reporting short holder (e.g. Citadel Equity Fund Ltd, Goldman Sachs International)
short_holder_address	string	Registered address of short holder
discretionary_investment_contractor	string	Counterparty under discretionary investment contract (if any)
investment_fund_name	string	Trust / fund name (where applicable)
short_position_pct_of_outstanding	number	Short position as % of shares outstanding (e.g. 0.96 = 0.96%)
short_position_shares	integer	Number of shares short
short_position_trading_units	integer	Number of trading units short
report_date	string (ISO date)	Calculation date of the position
previous_calculation_date	string (ISO date)	Most recent prior calculation date for the same holder/ticker (if reported)
source_url	string	Source JPX Excel file URL

---

Use cases

• Event-driven trading — monitor short build-ups on TOPIX 500 issuers ahead of earnings, M&A, or capital-markets events. New entries above 1% are watch-list signals.
• Hedge-fund position tracking — filter by short_holder_filter (e.g. "Citadel", "Citron", "Hindenburg", "Goldman") to track specific holders' Japan books.
• Squeeze monitoring — daily backfill builds a per-ticker short-balance time series; spikes + falling float = squeeze setup.
• Cross-border arb — combine with japan-edinet-insider-filings to cross-reference short positions against insider selling for activist-target identification.

---

Example input

{
  "ticker_filter": "1360",
  "short_holder_filter": "",
  "min_short_position_pct": 0.5,
  "date_from": "2026-05-20",
  "date_to": "2026-05-29",
  "max_records": 50
}

Example output (one record)

{
  "ticker": "1360",
  "company_name": "日経平均ベア２倍上場投信　受益証券",
  "company_name_en": "Nikkei225 Bear -2x ETF",
  "short_holder_name": "GOLDMAN SACHS INTERNATIONAL",
  "short_holder_address": "Plumtree Court 25 Shoe Lane London",
  "discretionary_investment_contractor": "",
  "investment_fund_name": "",
  "short_position_pct_of_outstanding": 2.31,
  "short_position_shares": 11961700,
  "short_position_trading_units": 1196170,
  "report_date": "2026-05-29",
  "previous_calculation_date": "2026-05-28",
  "source_url": "https://www.jpx.co.jp/markets/public/short-selling/t13vrt000001emea-att/20260529_Short_Positions.xls"
}

---

Integration — Apify Python client

from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")
run = client.actor("nexgendata/japan-jpx-short-selling-balances").call(run_input={
    "min_short_position_pct": 1.0,
    "date_from": "2026-05-15",
    "date_to": "2026-05-29",
    "max_records": 500,
})
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item["ticker"], item["short_holder_name"], item["short_position_pct_of_outstanding"])

Integration — cURL

curl -X POST "https://api.apify.com/v2/acts/nexgendata~japan-jpx-short-selling-balances/run-sync-get-dataset-items?token=YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"ticker_filter":"7203","date_from":"2026-05-01","date_to":"2026-05-29","max_records":100}'

Integration — MCP (Model Context Protocol)

Use this actor inside any MCP-capable LLM client (Claude Desktop, Cursor, OpenAI agents) by configuring NexGenData's MCP server. The actor exposes a japan-jpx-short-selling-balances tool with the same input schema; the LLM can then answer questions like "which hedge funds are short Toyota right now?" against live JPX data.

---

Legal & data source notes

• Source-of-record: JPX (Japan Exchange Group), the parent of Tokyo Stock Exchange, Osaka Exchange, and the Tokyo Commodity Exchange.
• Legal mandate: Cabinet Office Ordinance on Disclosure of Information Concerning Securities Transactions, Etc. (有価証券の取引等の規制に関する内閣府令) Article 26, enforced by the Financial Services Agency (FSA).
• Disclosure threshold: Only positions at >=0.5% of shares outstanding are reported. Smaller positions are not disclosed.
• Frequency: Daily, published the next business day at JST morning.
• Retention: JPX retains roughly the most recent 30 business days on the landing index — older dates are removed by JPX and are not retrievable from this endpoint.
• No PII: Disclosure contains entity-level reporting (institutional fund / firm), not individual data.
• User-Agent: This actor identifies itself politely per Japanese open-data convention with a contact endpoint, and throttles at 1 request/sec to JPX.

---

FAQ

Q: Why does my run return zero results? A: Most commonly: (1) date_from is older than ~30 business days — JPX rotates daily files off the index and older ones are no longer downloadable; (2) min_short_position_pct is set above the largest disclosed short of the day; (3) ticker_filter or short_holder_filter matches nothing in the requested window. Widen date_from and lower min_short_position_pct.

Q: How does this differ from japan-edinet-insider-filings? A: EDINET captures issuer disclosures (financial statements, large-shareholder reports, insider-sale reports). JPX short balance captures short-seller positions (who is short what, at what size). Both are FSA-mandated but cover different sides of the disclosure regime — pair them for full positioning intelligence.

Q: Are positions below 0.5% available? A: No. The 0.5% threshold is the FSA reporting floor under Cabinet Office Ordinance Article 26. Sub-threshold positions are not collected by JPX and are not retrievable from any public source.

Q: How fresh is the data? A: JPX publishes the prior business day's balance file each morning (JST). Run this actor any time after ~09:00 JST to get the prior-day file.

Q: Why are some company_name_en fields blank? A: JPX populates the English name for most listed securities, but some recently-listed names and trust units default to Japanese-only. The Japanese name in company_name is always present.

Q: What does previous_calculation_date mean? A: When a short holder updates their position (e.g. from 1.5% to 1.8%), JPX records both the new calculation date and the prior one. This lets you compute position deltas day-over-day without sourcing prior files.

---

日本語の説明

このアクターは、日本取引所グループ（JPX） が金融庁の「有価証券の取引等の規制に関する内閣府令」第26条に基づき毎営業日公表している空売り残高情報を取得します。

データソース: https://www.jpx.co.jp/markets/public/short-selling/

取得できる主な項目

• 銘柄コード — 4桁の証券コード（例：7203 = トヨタ自動車）
• 銘柄名（日本語／英語）
• 空売り残高報告者 — ヘッジファンド名、外資系証券会社名など
• 空売り残高割合 — 発行済株式数に対する空売り残高の比率（％）
• 空売り残高数量 — 株数
• 報告日（計算年月日）

主な利用シーン

1. イベント駆動型投資戦略 — 決算発表前のTOPIX500銘柄に対する空売り残高の急増を監視
2. 特定ファンドのポジション追跡 — short_holder_filter でCitadel、Goldman、Barclays等の特定ファンドの空売り残高を追跡
3. ショートスクイーズの早期発見 — 銘柄ごとの空売り残高の時系列推移を取得し、踏み上げ相場の予兆を検出
4. アクティビスト分析 — japan-edinet-insider-filings と組み合わせて、空売り対象企業のインサイダー取引と内閣府令第26条の報告内容を照合

重要なキーワード

• 空売り残高 — Short selling positions outstanding
• 銘柄 — Stock / security
• 報告日 — Reporting date
• 発行済株式数 — Shares outstanding
• 金融庁 — Financial Services Agency (FSA)
• 内閣府令 — Cabinet Office Ordinance

注意事項

• 残高割合が 0.5%以上 のもののみが報告対象です（内閣府令第26条の閾値）。
• JPXは直近 約30営業日分 のみをインデックスページで公開しており、それ以前のデータは取得できません。
• 当アクターは日本のオープンデータ慣行に従い、識別可能なBot User-Agent で1秒間隔のレート制限を設けて公正にアクセスしています。

---

Related Actors

• japan-edinet-insider-filings — EDINET filings (large-shareholder reports, insider sales, business reports) for the same Japanese listed universe. Pair with this actor to combine issuer-side disclosures (EDINET) with short-seller positioning (this actor).
• tse-japan-stock-screener — Tokyo Stock Exchange equity screener with market cap, sector, and price filters. Use to identify the universe of TOPIX 500 / Prime / Standard / Growth tickers before pulling their short balances.

---

Operated by NexGenData. Reach out at hello@thenextgennexus.com for custom pulls, MCP integration, or data-licensing arrangements.