{
  "openapi": "3.0.1",
  "info": {
    "title": "Polymarket Sports Odds API & +EV Edge Finder",
    "description": "Live Polymarket sports odds as JSON (NFL, MLB, NBA, NHL, soccer, UFC, esports): price, bid/ask, volume, teams, start time. Games-only and next-48h filters, no key needed. Add a free The Odds API key for +EV edges vs Pinnacle no-vig lines with Kelly size.",
    "version": "0.1",
    "x-build-id": "USrAzdJ2rbvfONcIq"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/bigdavidson~polymarket-sports-odds-divergence/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-bigdavidson-polymarket-sports-odds-divergence",
        "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/bigdavidson~polymarket-sports-odds-divergence/runs": {
      "post": {
        "operationId": "runs-sync-bigdavidson-polymarket-sports-odds-divergence",
        "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/bigdavidson~polymarket-sports-odds-divergence/run-sync": {
      "post": {
        "operationId": "run-sync-bigdavidson-polymarket-sports-odds-divergence",
        "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": {
          "mode": {
            "title": "Mode",
            "enum": [
              "scan",
              "divergence"
            ],
            "type": "string",
            "description": "scan = pull live Polymarket sports markets as clean records. divergence = scan upcoming games (soonest first), then match game-level markets against sportsbook h2h lines via your The Odds API key and emit edge signals on top.",
            "default": "scan"
          },
          "scope": {
            "title": "Scope",
            "type": "string",
            "description": "games = individual games/matches only (moneyline, spreads, totals and props of each game). all = everything under Polymarket's Sports tag, including futures and outrights (league winners, MVPs, season win totals).",
            "default": "all"
          },
          "sports": {
            "title": "Sports",
            "type": "array",
            "description": "Sports or leagues to keep, e.g. [\"nfl\"], [\"nba\", \"mlb\"] or [\"all\"] (all also keeps unclassified markets). Sports: nba, wnba, nfl, mlb, nhl, soccer, tennis, ufc, boxing, cricket, f1, golf, esports; basketball, baseball, hockey = all their leagues. Leagues: epl, ucl, uel, lal, bun, sea, fl1, mls, fifwc, kbo, npb, cpbl, khl, shl, ahl, euroleague, cbb, ncaab, cfb, atp, wta, ipl, cs2, lol, val, dota2. Full names (premier league, la liga, mma, formula 1) also work; any case.",
            "default": [
              "all"
            ],
            "items": {
              "type": "string"
            }
          },
          "hoursAhead": {
            "title": "Starting within (hours)",
            "type": "number",
            "description": "Only events that have not started yet and start within this many hours, soonest first. Events without a start time (most futures) drop out; a race or tournament outright that starts inside the window stays unless Scope is games. 0 = no time window. Max 336 (14 days); larger values are capped.",
            "default": 0
          },
          "query": {
            "title": "Text search (optional)",
            "type": "string",
            "description": "Keep only markets whose question, event title, teams or league contain words starting with these terms (case- and accent-insensitive; \"yank\" finds Yankees, \"nets\" does not match Hornets). \"lakers celtics\" = both words; \"yankees, dodgers\" = either. Applied before Max markets, so the cap counts matches only."
          },
          "minVolume": {
            "title": "Min volume (USD)",
            "minimum": 0,
            "type": "number",
            "description": "Keep only markets with at least this much total traded volume (USD). 0 = no filter.",
            "default": 0
          },
          "minLiquidity": {
            "title": "Min liquidity (USD)",
            "minimum": 0,
            "type": "number",
            "description": "Keep only markets with at least this much posted liquidity (USD). Note: Gamma liquidity is total deposited liquidity, not depth at the current price. 0 = no filter.",
            "default": 0
          },
          "maxMarkets": {
            "title": "Max markets",
            "minimum": 1,
            "maximum": 2000,
            "type": "integer",
            "description": "Hard cap on market records returned (all filters apply first). Each market row costs $0.001, so 100 = $0.10 and 200 = $0.20 (plus $0.005 per run). AI agents: use 20-50.",
            "default": 200
          },
          "compactOutput": {
            "title": "Compact output",
            "type": "boolean",
            "description": "Smaller rows for AI agents and LLM context: drops condition_id, outcome_token_ids, outcome_labels and every null field. Same price per row.",
            "default": false
          },
          "oddsApiKey": {
            "title": "The Odds API key (divergence mode only)",
            "type": "string",
            "description": "Your own key from the-odds-api.com — the free tier (500 credits/month) covers daily divergence runs. Each run makes one odds call per active matching league (soccer spans up to 8 leagues; tennis/cricket one per live tournament), 1 credit each with up to 10 books. Used only for this run's requests, never stored or logged. Without it, divergence mode degrades to scan output with a warning."
          },
          "signalsOnly": {
            "title": "Signals only",
            "type": "boolean",
            "description": "Return only divergence signals ($0.02 each): market rows are scanned for matching but not saved or charged. Turns on divergence mode. Needs oddsApiKey — without it the run stops at once with a free explanatory row and charges nothing.",
            "default": false
          },
          "books": {
            "title": "Bookmakers",
            "type": "array",
            "description": "The Odds API bookmaker keys to compare against (pinnacle = the sharp-money baseline). One signal per market per book. Empty = pinnacle. Enter all to compare every bookmaker in the regions below instead (one signal and charge per book, often 20-40x more).",
            "default": [
              "pinnacle"
            ],
            "items": {
              "type": "string"
            }
          },
          "minEdgePct": {
            "title": "Min edge %",
            "minimum": 0,
            "maximum": 50,
            "type": "number",
            "description": "Only emit divergence signals with at least this edge, in percentage points (no-vig fair probability minus Polymarket price, x100).",
            "default": 3
          },
          "regions": {
            "title": "Odds API regions (only with Bookmakers = all)",
            "type": "string",
            "description": "Comma-separated The Odds API regions (us, us2, uk, eu, au). Used ONLY when Bookmakers is all: when you name bookmakers (the default, pinnacle), The Odds API ignores regions and the run logs a warning if you changed this. Each region costs 1 credit per odds call, and every bookmaker in them can produce its own signal.",
            "default": "us,eu"
          }
        }
      },
      "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
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}