{ "openapi": "3.0.1", "info": { "title": "Taiwan IPO Subscription & Auction — 公開申購抽籤與競價拍賣 API", "description": "Every Taiwan IPO ballot since 2006 and every competitive auction since 2016, as JSON. Draw date, subscription window, offer price, lot size, valid applications and the resulting allocation odds, beside the auction that set the price — reserve, bids, and the weighted average award.", "version": "0.1", "x-build-id": "bvsS2w9zHizrEZm67" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/chamarix~taiwan-ipo-subscription/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-chamarix-taiwan-ipo-subscription", "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/chamarix~taiwan-ipo-subscription/runs": { "post": { "operationId": "runs-sync-chamarix-taiwan-ipo-subscription", "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/chamarix~taiwan-ipo-subscription/run-sync": { "post": { "operationId": "run-sync-chamarix-taiwan-ipo-subscription", "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": { "startYear": { "title": "First year (YYYY)", "pattern": "^(|\\d{4})$", "type": "string", "description": "Leave both years empty for the current year, which is where every upcoming ballot lives. The exchange's date parameter selects a whole calendar year, so a year is the smallest unit there is — and the whole archive is only 32 requests. The ballot table begins in 2006 and the auction table in 2016; an earlier year simply starts there.", "default": "" }, "endYear": { "title": "Last year (YYYY)", "pattern": "^(|\\d{4})$", "type": "string", "description": "Inclusive. Defaults to the current year. One request per report per year.", "default": "" }, "includeSubscriptions": { "title": "Include the retail subscription ballot", "type": "boolean", "description": "The 公開申購公告-抽籤日程表 table: every offering a retail investor could ballot for since 2006-10-12, with the draw date, the subscription window, the strike price, the lot size, how many valid applications arrived and the odds that produced. Covers TWSE, TPEx, the Innovation Board and central government bonds in one table.", "default": true }, "includeAuctions": { "title": "Include the competitive auction", "type": "boolean", "description": "The 競價拍賣公告-投標日程表 table, back to 2016-01-13: the institutional auction that sets the price the ballot is then struck at. Reserve price, bidding window, lots offered, per-bidder cap, margin, and once it is held the lowest, highest and weighted-average accepted bid.", "default": true }, "onlyUpcoming": { "title": "Only offerings that have not happened yet", "type": "boolean", "description": "Keeps ballots whose draw date and auctions whose opening date are today or later, and that have not been cancelled. This is the whole of the retail use case — what can still be applied for — and with the default year range it is two requests.", "default": false }, "codes": { "title": "Security codes", "type": "array", "description": "Keep only these securities, e.g. 2330 for a listed company, 84223 for a convertible bond or A151AO for a government bond tranche. Leave empty for everything. Filtering happens after the fetch, because the exchange only serves whole years.", "default": [], "items": { "type": "string" } }, "useApifyProxy": { "title": "Route requests through Apify Proxy", "type": "boolean", "description": "Worth turning on only for the full 2006-to-now backfill. TWSE's firewall refuses by address and, once tripped, refuses every report for that address for minutes at a time; with this on, requests take a different exit address each time they are refused. Off by default because any ordinary range is a handful of requests.", "default": 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 }, "PROXY_UNBLOCKER_UNITS": { "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 }, "PROXY_UNBLOCKER_UNITS": { "type": "integer", "example": 0 } } } } } } } } } }