{
"openapi": "3.0.1",
"info": {
"title": "Watch Arbitrage Tracker — Rolex/Patek/AP × 13 Marketplaces",
"description": "Cross-platform Patek/Rolex/AP arbitrage. Tracks 13 marketplaces: Chrono24, WatchBox, Bob's, Watchfinder, European Watch, Watches of Switzerland, Watch Club, Spliedt, A Collected Man, Analog:Shift, Bachmann & Scher, Yahoo Japan + Hodinkee. Telegram alerts on cross-country spreads. Pay-Per-Event.",
"version": "0.1",
"x-build-id": "UL8UOEaaGa1x7KgvV"
},
"servers": [
{
"url": "https://api.apify.com/v2"
}
],
"paths": {
"/acts/kazkn~watch-arbitrage-mcp/run-sync-get-dataset-items": {
"post": {
"operationId": "run-sync-get-dataset-items-kazkn-watch-arbitrage-mcp",
"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/kazkn~watch-arbitrage-mcp/runs": {
"post": {
"operationId": "runs-sync-kazkn-watch-arbitrage-mcp",
"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/kazkn~watch-arbitrage-mcp/run-sync": {
"post": {
"operationId": "run-sync-kazkn-watch-arbitrage-mcp",
"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",
"required": [
"references",
"alert_channel"
],
"properties": {
"references": {
"title": "Watch references",
"minItems": 1,
"uniqueItems": true,
"type": "array",
"description": "Precise reference numbers give the cleanest arbitrage signals. Examples: 5711/1A-010, 116500LN, 124060, 15500ST.OO.1220ST.04.
Brand is auto-detected — mix Patek / Rolex / AP freely. Model names like Nautilus or Daytona work too but conflate sub-models with different prices.
Tip: start with 3-5 refs you actually trade, add more later.",
"items": {
"type": "string"
}
},
"spread_sensitivity": {
"title": "Spread threshold (%)",
"minimum": 0.5,
"maximum": 50,
"type": "number",
"description": "Fire an alert when a listing sits below the cross-platform median by at least this %. Decimals work — 4.5 fires at 4.5%.
Guide: 3% = chatty (volume flippers) · 5% = recommended · 8% = selective · 15%+ = once-a-month opportunities.",
"default": 5
},
"alert_channel": {
"title": "Where to receive alerts",
"enum": [
"telegram",
"email",
"both",
"dataset_only"
],
"type": "string",
"description": "Telegram is fastest for time-sensitive flips. Email sends one digest per run. Pick Both for redundancy, or Dataset only if you'd rather poll Apify Console yourself.",
"default": "telegram"
},
"compare_mode": {
"title": "Spread framing",
"enum": [
"cross_platform_global",
"cross_country_pair",
"per_country"
],
"type": "string",
"description": "How the actor frames the arbitrage opportunity in alerts.
Global — one cross-platform median, alert below by your threshold. Country pair — surface country-vs-country gaps (\"JP $148k ↔ US $192k\"); best for dealers who already source globally. Per country — median computed per country (rare).",
"default": "cross_platform_global"
},
"alert_telegram_bot_token": {
"title": "Telegram bot token",
"type": "string",
"description": "One-time setup, 2 min: open @BotFather on Telegram → /newbot → name it → paste the token here. Full guide: https://core.telegram.org/bots#how-do-i-create-a-bot"
},
"alert_telegram_chat_id": {
"title": "Telegram chat ID",
"type": "string",
"description": "Open Telegram → search @userinfobot → tap Start → paste the numeric ID here."
},
"alert_email": {
"title": "Alert email address",
"pattern": "^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$",
"type": "string",
"description": "Email address that receives one digest when arbitrage opportunities are detected. Requires Email digest or Telegram + email above."
},
"filter_conditions": {
"title": "Conditions to include",
"uniqueItems": true,
"type": "array",
"description": "A new 5711 vs a pre-owned 5711 can spread by $30K+. Filtering tightens the signal.
Bobs, Watchfinder UK and European Watch scrape condition reliably. Chrono24, WatchBox and Watches of Switzerland often report unknown — keep it checked if you want full volume.",
"items": {
"type": "string",
"enum": [
"new",
"like-new",
"very-good",
"good",
"fair",
"vintage",
"pre-owned",
"unknown"
],
"enumTitles": [
"🆕 New / Unworn",
"✨ Like new / Mint",
"👍 Very good",
"✅ Good",
"⚠️ Fair",
"🕰️ Vintage (pre-2000)",
"📦 Pre-owned (catch-all)",
"❓ Unknown (not specified)"
]
},
"default": [
"new",
"like-new",
"very-good",
"pre-owned",
"unknown"
]
},
"filter_box_papers": {
"title": "Box & papers status to include",
"uniqueItems": true,
"type": "array",
"description": "A full-set 5711 commands a 20-30% premium vs watch-only. Watchfinder, Bobs and European Watch report this reliably; others may report unknown.",
"items": {
"type": "string",
"enum": [
"full-set",
"box-and-papers",
"papers-only",
"box-only",
"watch-only",
"unknown"
],
"enumTitles": [
"🏆 Full set",
"📦📄 Box + papers",
"📄 Papers only",
"📦 Box only",
"🕰️ Watch only",
"❓ Unknown"
]
},
"default": [
"full-set",
"box-and-papers",
"papers-only",
"unknown"
]
},
"strict_condition_matching": {
"title": "Strict condition matching",
"type": "boolean",
"description": "When on, drop listings where the marketplace didn't report a condition. Pairs well with restricting marketplaces to Bobs + Watchfinder + European Watch.",
"default": false
},
"platforms": {
"title": "Marketplaces to monitor",
"uniqueItems": true,
"type": "array",
"description": "Uncheck a marketplace to skip it. 13 verified pre-owned dealers across US/UK/DE/JP. Yahoo Auctions Japan requires apifyProxyCountry: 'JP' at runtime — Yahoo geo-blocks EEA/UK traffic.",
"items": {
"type": "string",
"enum": [
"chrono24",
"watchbox",
"bobs",
"watchfinder",
"europeanwatch",
"watchesofswitzerland",
"hodinkee",
"watchclub",
"yahoojp",
"spliedt",
"acollectedman",
"analogshift",
"bachmannscher"
],
"enumTitles": [
"🌍 Chrono24",
"🇺🇸 WatchBox / The 1916 Company",
"🇺🇸 Bob's Watches",
"🇬🇧 Watchfinder UK",
"🇺🇸 European Watch Company",
"🇬🇧 Watches of Switzerland",
"🇺🇸 Hodinkee Shop — dormant slot",
"🇬🇧 The Watch Club — London / HK office",
"🇯🇵 Yahoo Auctions Japan (requires non-EEA proxy)",
"🇩🇪 H. Spliedt — Munich/Hamburg/Sylt",
"🇬🇧 A Collected Man — London (premium + archive)",
"🇺🇸 Analog:Shift — NYC vintage + neo-vintage",
"🇩🇪 Bachmann & Scher — Munich pre-owned"
]
},
"default": [
"chrono24",
"watchbox",
"bobs",
"watchfinder",
"europeanwatch",
"watchesofswitzerland"
]
},
"price_ceilings": {
"title": "Per-reference price ceilings (USD)",
"type": "array",
"description": "Override the median anchor with your own target intake price per reference. Format: reference:max_price_usd with no spaces around the colon.
Examples: 5711/1A-010:185000, 116500LN:28000. Leave empty to use the cross-platform median for every ref. Invalid rows are silently skipped.",
"items": {
"type": "string"
},
"default": []
},
"max_listings_per_ref_per_platform": {
"title": "Max listings per ref per platform",
"minimum": 1,
"maximum": 200,
"type": "integer",
"description": "Caps listings per reference per marketplace. Default 10 keeps first runs cheaper; raise only after the economics preflight passes.",
"default": 10
},
"proxyConfiguration": {
"title": "Proxy configuration",
"type": "object",
"description": "Apify Proxy is recommended for reliable scraping across all 6 marketplaces. Residential proxies help avoid blocks on Chrono24 and WatchBox.",
"default": {
"useApifyProxy": 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
}
}
}
}
}
}
}
}
}
}