{ "openapi": "3.0.1", "info": { "title": "Taiwan Government Bond Yields, Curve & Issuance (TPEx)", "description": "Taiwan central government bond data from the TPEx bond zone: daily benchmark yields for the five on-the-run tenors, coupon-bearing and zero-coupon yield curves, per-bond average yields, and the full issuance master. Staleness of every carried-forward quote is stated, not hidden.", "version": "0.1", "x-build-id": "fnXymGQc7wy6WJqJE" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/chamarix~taiwan-government-bonds/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-chamarix-taiwan-government-bonds", "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-government-bonds/runs": { "post": { "operationId": "runs-sync-chamarix-taiwan-government-bonds", "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-government-bonds/run-sync": { "post": { "operationId": "run-sync-chamarix-taiwan-government-bonds", "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": { "datasets": { "title": "Datasets", "type": "array", "description": "Which of the exchange's tables to publish. benchmarkYields is the daily headline: the five on-the-run government bonds. yieldCurve is the coupon-bearing treasury curve, zeroCouponCurve the fitted spot curve (Cubic B-Spline and Svensson, ~62 tenors each), and both come from one download. bondYields is the volume-weighted yield of every bond quoted on the Electronic Bond Trading System — about 1,450 lines a session before the government-only filter. issuance is the outstanding-bond master and is a snapshot, so it ignores the date range.", "items": { "type": "string", "enum": [ "benchmarkYields", "yieldCurve", "zeroCouponCurve", "bondYields", "issuance" ], "enumTitles": [ "benchmarkYields — 指標公債日行情 (5 rows a session)", "yieldCurve — 公債殖利率曲線 (5 points a session)", "zeroCouponCurve — 零息殖利率曲線 ZCYC (~124 points a session)", "bondYields — 等殖成交各期次債券殖利率 (~1,450 a session)", "issuance — 公債發行資料 (snapshot, ~197 bonds)" ] }, "default": [ "benchmarkYields", "yieldCurve" ] }, "startDate": { "title": "Start date (YYYY-MM-DD)", "pattern": "^(|\\d{4}[-/]?\\d{2}[-/]?\\d{2})$", "type": "string", "description": "First session to fetch. Leave both dates empty for the latest published session. The Electronic Bond Trading System archive starts 2005-01-03; the yield curve files start 2006-01-02.", "default": "" }, "endDate": { "title": "End date (YYYY-MM-DD)", "pattern": "^(|\\d{4}[-/]?\\d{2}[-/]?\\d{2})$", "type": "string", "description": "Last session to fetch, inclusive. One stored file is downloaded per dataset per session, so a long range over bondYields is the expensive combination; 400 downloads is the ceiling for a run.", "default": "" }, "governmentOnly": { "title": "Government bonds only", "type": "boolean", "description": "The Electronic Bond Trading System quotes corporate, financial and international paper in the same table as government debt. With this on, bondYields keeps only the central government (A) and municipal (H) series. It does not affect the other datasets, which are government-only at source.", "default": true }, "maxStalenessDays": { "title": "Maximum staleness in days", "minimum": 0, "type": "integer", "description": "A published average yield is carried forward from the last session the bond actually traded, which the exchange prints as 最近成交日 — so a 30-year benchmark can quote a yield struck three months earlier. Set a number of days to drop rows whose yield is older than that; 0 keeps everything and leaves the judgement to you, using the staleness_days field.", "default": 0 }, "crossCheck": { "title": "Reconcile the official files against each other", "type": "boolean", "description": "The benchmark table, the curve file and the all-bonds table are published separately and must agree on the same bond's yield and price; the printed change in basis points must equal the day-over-day difference; and coupon and maturity must match the issuance master, which reaches the Actor over a different API entirely. With this on, all of it is checked and the result written to the log. Costs one extra request when bondYields is selected without issuance.", "default": true } } }, "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 } } } } } } } } } }