{ "openapi": "3.0.1", "info": { "title": "Japan EDINET Insider Filings Tracker", "description": "Japan FSA EDINET filings: large-shareholder reports (大量保有報告書, 5% rule), change reports (変更報告書), treasury-share repurchase reports. Canonical insider-flow disclosures under Japan's Financial Instruments and Exchange Act. Bloomberg Japan terminal alternative.", "version": "0.0", "x-build-id": "PH7LGNBePD80N9lMb" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/nexgendata~japan-edinet-insider-filings/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-nexgendata-japan-edinet-insider-filings", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/nexgendata~japan-edinet-insider-filings/runs": { "post": { "operationId": "runs-sync-nexgendata-japan-edinet-insider-filings", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/nexgendata~japan-edinet-insider-filings/run-sync": { "post": { "operationId": "run-sync-nexgendata-japan-edinet-insider-filings", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "apiKey": { "title": "EDINET API subscription key", "type": "string", "description": "Free Japan FSA EDINET API v2 subscription key. Register at https://api.edinet-fsa.go.jp/ (email + phone, no credit card). Required — EDINET v2 closed the unauthenticated endpoint in 2023 and all requests now need a key. Pass via this input field for one-off runs, OR set the EDINET_API_KEY environment variable on your Apify task for scheduled runs. Rate limit: ~3 requests/second per key, generous enough for any institutional workflow. The key is never logged or persisted by this actor." }, "date_from": { "title": "Date from (YYYY-MM-DD)", "type": "string", "description": "Filing-date lower bound (inclusive). EDINET retains roughly 5 years of filings. For breaking insider-flow surveillance use a 7-30 day window; for backtesting M&A / takeover events use a 90-365 day window. Leave blank to default to 30 days before today (UTC). EDINET accepts roughly 50-200 filings/day on weekdays and zero on weekends/Japanese public holidays.", "default": "" }, "date_to": { "title": "Date to (YYYY-MM-DD)", "type": "string", "description": "Filing-date upper bound (inclusive). Leave blank to default to today (UTC). Maximum window is 365 days — for longer-horizon studies, paginate by running multiple windowed jobs.", "default": "" }, "doc_type": { "title": "Document type", "enum": [ "large_shareholder", "large_shareholder_change", "treasury_buyback", "officer_trade", "all" ], "type": "string", "description": "Which EDINET filing categories to sweep. `large_shareholder` covers 大量保有報告書 (initial 5% Schedule 13D / 13G equivalent) AND 変更報告書 (≥1% holdings change update) — the canonical Japanese insider / activist-investor signal. `large_shareholder_change` returns ONLY 変更報告書 (movement filings). `treasury_buyback` returns 自己株券買付状況報告書 (the company's own repurchase activity — a leading bullish signal historically). `officer_trade` is the catch-all for director/officer-shareholding disclosures embedded in annual / quarterly reports (noisier, larger volume). `all` returns large_shareholder + treasury_buyback combined — the institutional default.", "default": "all" }, "filer_name": { "title": "Filer name filter (optional, Japanese or English substring)", "type": "string", "description": "Optional case-insensitive substring match on the filer name. EDINET stores filer names primarily in Japanese (filerName), with English transliteration in filerNameEn when available. Examples: 'ブラックロック' or 'BlackRock', '野村' or 'Nomura', 'バリュー・パートナーズ' or 'Value Partners'. Useful for tracking specific activist funds (Murakami Fund / 村上ファンド, Oasis Management, Dalton Investments, Effissimo, ValueAct Capital).", "default": "" }, "issuer_ticker": { "title": "Issuer TSE ticker filter (optional, 4-digit code)", "type": "string", "description": "Optional 4-digit Tokyo Stock Exchange securities code (e.g. '7203' for Toyota, '6758' for Sony, '9984' for SoftBank Group, '7974' for Nintendo). Accepts suffix-tagged forms too ('7203.T', 'TYO:7203'). Leave blank to scan all issuers — useful for activist-fund flow analysis where you don't know the target in advance. EDINET surfaces the issuer's TSE code in 5% rule filings via the `secCode` field (5-digit format with check digit '0').", "default": "" }, "max_filings": { "title": "Max filings returned", "minimum": 1, "maximum": 2000, "type": "integer", "description": "Hard cap on dataset rows pushed. Each row is one EDINET filing. A 7-day large-shareholder scan typically returns 60-150 rows across the whole TSE; a 30-day all-doctype scan returns 400-1500. Cap accordingly — at the proposed institutional pricing of $0.15/filing, $30 buys roughly 200 filings.", "default": 100 }, "enrich_xbrl": { "title": "Enrich with XBRL holding %", "type": "boolean", "description": "When true (default), the actor downloads the XBRL filing instance for each 350/360 (large-shareholder) row and extracts the post-filing holdings %, total shares held, and change vs previous filing. Each XBRL download is ~50-300KB and adds ~1.5s per filing (EDINET rate limit). Disable for fast metadata-only scans when you don't need precise holding ratios.", "default": true }, "proxyConfiguration": { "title": "Proxy configuration (optional)", "type": "object", "description": "Optional. EDINET API v2 is normally reachable from any IP — Japan FSA does not geofence the public API. Enable Apify proxy only if you see HTTP 429 / 503 errors during peak TSE open or after a major activist disclosure event. RESIDENTIAL with country=JP is the most robust setting; DATACENTER works for low-volume scans.", "default": { "useApifyProxy": false } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } }