{ "openapi": "3.0.1", "info": { "title": "HKJC Odds Steamers & Drifters", "description": "Tracks real-time Hong Kong Jockey Club (HKJC) horse racing odds movements. Compares current Win and Place odds against persisted snapshots to flag Steamers (shortening odds) and Drifters (lengthening odds).", "version": "0.1", "x-build-id": "qGA1bHO2r7mh8p3BS" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/astronomical_lizard~hkjc-odds-steamers-drifters/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-astronomical_lizard-hkjc-odds-steamers-drifters", "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/astronomical_lizard~hkjc-odds-steamers-drifters/runs": { "post": { "operationId": "runs-sync-astronomical_lizard-hkjc-odds-steamers-drifters", "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/astronomical_lizard~hkjc-odds-steamers-drifters/run-sync": { "post": { "operationId": "run-sync-astronomical_lizard-hkjc-odds-steamers-drifters", "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": { "race_number": { "title": "Race Number", "minimum": 1, "maximum": 11, "type": "integer", "description": "Target race number to analyze (1-11). Leave empty to automatically detect the current or next upcoming race based on the HKJC schedule." }, "venue": { "title": "Venue", "type": "string", "description": "Race venue. Use ST for Sha Tin, HV for Happy Valley, or any HKJC venue code such as S1, S2, S3, H1. Use AUTO to let the actor detect the active meeting.", "default": "AUTO" }, "baseline_minutes_ago": { "title": "Baseline Lookback (minutes)", "minimum": 1, "maximum": 1440, "type": "integer", "description": "How many minutes back to compare current odds against the most recent stored snapshot. A new snapshot is saved on every run.", "default": 15 }, "steamer_threshold_pct": { "title": "Steamer Threshold (%)", "type": "number", "description": "Percentage drop in odds required to flag a STEAMER. Must be negative (e.g. -15 means odds fell 15%% or more).", "default": -15 }, "drifter_threshold_pct": { "title": "Drifter Threshold (%)", "minimum": 0, "type": "number", "description": "Percentage rise in odds required to flag a DRIFTER (e.g. 20 means odds rose 20%% or more).", "default": 20 }, "webhook_url": { "title": "Webhook URL", "type": "string", "description": "Optional HTTP endpoint to POST a JSON payload containing all STEAMER and DRIFTER alerts when thresholds are met." }, "store_name": { "title": "Key-Value Store Name", "pattern": "^[a-zA-Z0-9_-]+$", "minLength": 1, "maxLength": 64, "type": "string", "description": "Name of the Apify key-value store used to persist odds snapshots between runs. Use a unique name if multiple isolated users or strategies share the same Apify account.", "default": "hkjc-odds-snapshots" } } }, "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 } } } } } } } } } }