kashrock 0.1.0__tar.gz

kashrock-0.1.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 KashRock Inc.
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

kashrock-0.1.0/PKG-INFO

@@ -0,0 +1,67 @@
+Metadata-Version: 2.4
+Name: kashrock
+Version: 0.1.0
+Summary: Official Python SDK for the KashRock esports API — props, odds, matches, and scores.
+Author-email: KashRock <ovitalszn@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://www.kashrock.com
+Project-URL: Documentation, https://www.kashrock.com/docs
+Project-URL: API, https://kashrock.up.railway.app
+Project-URL: Repository, https://github.com/ovitalszn-cyber/kashrock-python
+Keywords: esports,api,cs2,valorant,dota,props,odds
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Internet :: WWW/HTTP
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx<0.29,>=0.26
+Dynamic: license-file
+
+# KashRock Python SDK
+
+Official Python client for the [KashRock esports API](https://www.kashrock.com).
+
+Props, odds, matches, live scores, and history — one key, normalized IDs.
+
+## Install
+
+```bash
+pip install kashrock
+```
+
+## Four lines to a live prop
+
+```python
+from kashrock import KashRock
+
+kr = KashRock("YOUR_API_KEY")
+print(kr.props("cs2")["props"][0])
+```
+
+Get a free Sandbox key at [kashrock.com/pricing](https://www.kashrock.com/pricing). Docs: [kashrock.com/docs](https://www.kashrock.com/docs).
+
+`KASHROCK_API_KEY` works if you do not want the key in code.
+
+## What you can call
+
+```python
+kr.me()
+kr.props("cs2", book="prizepicks", limit=20)
+kr.lines("cs2")
+kr.matches("cs2", status="upcoming")
+kr.live_games("cs2")
+kr.gamelogs("cs2", "zywoo")
+kr.history_tape(market_key="kr_mk_…")
+```
+
+Same paths as the HTTP API and the [KashRock MCP](https://www.kashrock.com/mcp). Stacks are not included.
+
+Sandbox keys are CS2 props only. Hobby+ unlocks the rest of the board. Builder+ unlocks matches, live, gamelogs, and history.
+
+## License
+
+MIT

kashrock-0.1.0/README.md

@@ -0,0 +1,44 @@
+# KashRock Python SDK
+
+Official Python client for the [KashRock esports API](https://www.kashrock.com).
+
+Props, odds, matches, live scores, and history — one key, normalized IDs.
+
+## Install
+
+```bash
+pip install kashrock
+```
+
+## Four lines to a live prop
+
+```python
+from kashrock import KashRock
+
+kr = KashRock("YOUR_API_KEY")
+print(kr.props("cs2")["props"][0])
+```
+
+Get a free Sandbox key at [kashrock.com/pricing](https://www.kashrock.com/pricing). Docs: [kashrock.com/docs](https://www.kashrock.com/docs).
+
+`KASHROCK_API_KEY` works if you do not want the key in code.
+
+## What you can call
+
+```python
+kr.me()
+kr.props("cs2", book="prizepicks", limit=20)
+kr.lines("cs2")
+kr.matches("cs2", status="upcoming")
+kr.live_games("cs2")
+kr.gamelogs("cs2", "zywoo")
+kr.history_tape(market_key="kr_mk_…")
+```
+
+Same paths as the HTTP API and the [KashRock MCP](https://www.kashrock.com/mcp). Stacks are not included.
+
+Sandbox keys are CS2 props only. Hobby+ unlocks the rest of the board. Builder+ unlocks matches, live, gamelogs, and history.
+
+## License
+
+MIT

kashrock-0.1.0/pyproject.toml

@@ -0,0 +1,31 @@
+[build-system]
+requires = ["setuptools>=69"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "kashrock"
+version = "0.1.0"
+description = "Official Python SDK for the KashRock esports API — props, odds, matches, and scores."
+readme = "README.md"
+license = "MIT"
+requires-python = ">=3.10"
+authors = [{ name = "KashRock", email = "ovitalszn@gmail.com" }]
+keywords = ["esports", "api", "cs2", "valorant", "dota", "props", "odds"]
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Topic :: Internet :: WWW/HTTP",
+]
+dependencies = ["httpx>=0.26,<0.29"]
+
+[project.urls]
+Homepage = "https://www.kashrock.com"
+Documentation = "https://www.kashrock.com/docs"
+API = "https://kashrock.up.railway.app"
+Repository = "https://github.com/ovitalszn-cyber/kashrock-python"
+
+[tool.setuptools.packages.find]
+where = ["src"]

kashrock-0.1.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

kashrock-0.1.0/src/kashrock/__init__.py

@@ -0,0 +1,15 @@
+from kashrock.client import KashRock
+from kashrock.errors import (
+    KashRockAuthError,
+    KashRockError,
+    KashRockPlanError,
+    KashRockRateLimitError,
+)
+
+__all__ = [
+    "KashRock",
+    "KashRockAuthError",
+    "KashRockError",
+    "KashRockPlanError",
+    "KashRockRateLimitError",
+]

kashrock-0.1.0/src/kashrock/_http.py

@@ -0,0 +1,75 @@
+from __future__ import annotations
+
+import json
+from typing import Any, Mapping, Optional
+from urllib.parse import urlencode
+
+import httpx
+
+from kashrock.errors import (
+    KashRockAuthError,
+    KashRockError,
+    KashRockPlanError,
+    KashRockRateLimitError,
+)
+
+DEFAULT_BASE = "https://kashrock.up.railway.app"
+
+
+def _detail(body: Any) -> str:
+    if isinstance(body, dict):
+        detail = body.get("detail")
+        if isinstance(detail, str):
+            return detail
+        if detail is not None:
+            return json.dumps(detail)
+    if isinstance(body, str):
+        return body
+    return json.dumps(body)
+
+
+def raise_for_status(status: int, body: Any) -> None:
+    text = _detail(body)
+    if status in (401, 403) and "plan" in text.lower():
+        raise KashRockPlanError(text, status=status, body=body)
+    if status in (401, 403):
+        raise KashRockAuthError(text, status=status, body=body)
+    if status == 429:
+        raise KashRockRateLimitError(text, status=status, body=body)
+    raise KashRockError(text, status=status, body=body)
+
+
+def clean_params(params: Optional[Mapping[str, Any]]) -> dict[str, Any]:
+    out: dict[str, Any] = {}
+    for key, value in (params or {}).items():
+        if value is None or value == "":
+            continue
+        if isinstance(value, bool):
+            out[key] = "true" if value else "false"
+        else:
+            out[key] = value
+    return out
+
+
+class Http:
+    def __init__(self, api_key: str, *, base_url: str = DEFAULT_BASE, timeout: float = 60.0) -> None:
+        self.api_key = api_key
+        self.base_url = base_url.rstrip("/")
+        self.timeout = timeout
+
+    def get(self, path: str, params: Optional[Mapping[str, Any]] = None) -> Any:
+        query = clean_params(params)
+        suffix = f"?{urlencode(query)}" if query else ""
+        url = f"{self.base_url}{path}{suffix}"
+        response = httpx.get(
+            url,
+            headers={"X-API-Key": self.api_key},
+            timeout=self.timeout,
+        )
+        try:
+            body = response.json()
+        except json.JSONDecodeError:
+            body = {"detail": response.text[:500]}
+        if response.status_code >= 400:
+            raise_for_status(response.status_code, body)
+        return body

kashrock-0.1.0/src/kashrock/client.py

@@ -0,0 +1,135 @@
+from __future__ import annotations
+
+import os
+from typing import Any, Optional
+
+from kashrock._http import DEFAULT_BASE, Http
+from kashrock.errors import KashRockAuthError
+
+
+class KashRock:
+    """Thin client for https://kashrock.up.railway.app."""
+
+    def __init__(
+        self,
+        api_key: Optional[str] = None,
+        *,
+        base_url: str = DEFAULT_BASE,
+        timeout: float = 60.0,
+    ) -> None:
+        key = api_key or os.environ.get("KASHROCK_API_KEY", "")
+        if not key:
+            raise KashRockAuthError(
+                "Pass an API key or set KASHROCK_API_KEY. Get one at https://www.kashrock.com/pricing",
+                status=401,
+            )
+        self._http = Http(key, base_url=base_url, timeout=timeout)
+
+    def _get(self, path: str, **params: Any) -> Any:
+        return self._http.get(path, params)
+
+    def _sport(self, sport: str, suffix: str, **params: Any) -> Any:
+        return self._get(f"/v6/esports/{sport}/{suffix}", **params)
+
+    def me(self) -> Any:
+        return self._get("/v6/me")
+
+    def books(self) -> Any:
+        return self._get("/v6/books")
+
+    def props(self, sport: str, **params: Any) -> Any:
+        return self._sport(sport, "props", **params)
+
+    def player_props(self, sport: str, **params: Any) -> Any:
+        return self._sport(sport, "player-props", **params)
+
+    def media(self, sport: str, **params: Any) -> Any:
+        return self._sport(sport, "media", **params)
+
+    def lines(self, sport: str, **params: Any) -> Any:
+        return self._sport(sport, "lines", **params)
+
+    def gaps(self, sport: str, **params: Any) -> Any:
+        return self._sport(sport, "gaps", **params)
+
+    def coverage(self, sport: str, **params: Any) -> Any:
+        params.setdefault("include_props", False)
+        return self.props(sport, **params)
+
+    def rankings(self, sport: str, **params: Any) -> Any:
+        return self._sport(sport, "rankings", **params)
+
+    def search_players(self, sport: str, q: str, **params: Any) -> Any:
+        return self._sport(sport, "players/search", q=q, **params)
+
+    def player(self, sport: str, player_id: str, **params: Any) -> Any:
+        return self._sport(sport, f"players/{player_id}", **params)
+
+    def player_stats(self, sport: str, player_id: str, **params: Any) -> Any:
+        return self._sport(sport, f"players/{player_id}/stats", **params)
+
+    def player_stats_full(self, sport: str, player_id: str, **params: Any) -> Any:
+        return self._sport(sport, f"players/{player_id}/stats/full", **params)
+
+    def gamelogs(self, sport: str, player: str, **params: Any) -> Any:
+        return self._sport(sport, f"players/{player}/gamelogs", **params)
+
+    def matches(self, sport: str, **params: Any) -> Any:
+        return self._sport(sport, "matches", **params)
+
+    def match(self, sport: str, kr_match_id: str, **params: Any) -> Any:
+        return self._sport(sport, f"matches/id/{kr_match_id}", **params)
+
+    def search_matches(self, sport: str, **params: Any) -> Any:
+        return self._sport(sport, "matches/search", **params)
+
+    def team_matches(self, sport: str, team: str, **params: Any) -> Any:
+        return self._sport(sport, f"teams/{team}/matches", **params)
+
+    def streams(self, sport: str, **params: Any) -> Any:
+        return self._sport(sport, "streams", **params)
+
+    def live_games(self, sport: str, **params: Any) -> Any:
+        return self._sport(sport, "live/games", **params)
+
+    def live_boxscore(self, sport: str, game_id: str, **params: Any) -> Any:
+        return self._sport(sport, f"live/{game_id}/boxscore", **params)
+
+    def live_frames(self, sport: str, game_id: str, **params: Any) -> Any:
+        return self._sport(sport, f"live/{game_id}/frames", **params)
+
+    def live_events(self, sport: str, game_id: str, **params: Any) -> Any:
+        return self._sport(sport, f"live/{game_id}/events", **params)
+
+    def boxscore(self, sport: str, match_slug: str, **params: Any) -> Any:
+        return self._sport(sport, f"matches/{match_slug}/boxscore", **params)
+
+    def boxscores(self, sport: str, **params: Any) -> Any:
+        return self._sport(sport, "boxscores", **params)
+
+    def results(self, sport: str, **params: Any) -> Any:
+        return self._sport(sport, "results", **params)
+
+    def history_tape(self, **params: Any) -> Any:
+        return self._get("/v6/esports/history/contract", **params)
+
+    def team_h2h(self, sport: str, **params: Any) -> Any:
+        return self._sport(sport, "teams/h2h", **params)
+
+    def research_board(self, **params: Any) -> Any:
+        return self._get("/v6/esports/research/board", **params)
+
+    def research_board_tapes(self, **params: Any) -> Any:
+        return self._get("/v6/esports/research/board-tapes", **params)
+
+    def research_player(self, **params: Any) -> Any:
+        return self._get("/v6/esports/research/player", **params)
+
+    def match_prep(self, match_slug: str, sport: str = "cs2", **params: Any) -> Any:
+        return self._sport(sport, f"matches/{match_slug}/prep", **params)
+
+    def player_board(self, match_slug: str, sport: str = "cs2", **params: Any) -> Any:
+        return self._sport(sport, f"matches/{match_slug}/player-board", **params)
+
+    def tournament_maps(self, match_slug: str, sport: str = "cs2", **params: Any) -> Any:
+        return self._sport(sport, f"matches/{match_slug}/tournament-maps", **params)

kashrock-0.1.0/src/kashrock/errors.py

@@ -0,0 +1,38 @@
+from __future__ import annotations
+
+from typing import Any, Optional
+
+
+class KashRockError(Exception):
+    def __init__(
+        self,
+        message: str,
+        *,
+        status: Optional[int] = None,
+        body: Any = None,
+    ) -> None:
+        super().__init__(message)
+        self.message = message
+        self.status = status
+        self.body = body
+
+
+class KashRockAuthError(KashRockError):
+    pass
+
+
+class KashRockPlanError(KashRockError):
+    def __init__(
+        self,
+        message: str,
+        *,
+        status: Optional[int] = None,
+        body: Any = None,
+        upgrade_url: str = "https://www.kashrock.com/pricing",
+    ) -> None:
+        super().__init__(message, status=status, body=body)
+        self.upgrade_url = upgrade_url
+
+
+class KashRockRateLimitError(KashRockError):
+    pass

kashrock-0.1.0/src/kashrock.egg-info/PKG-INFO

@@ -0,0 +1,67 @@
+Metadata-Version: 2.4
+Name: kashrock
+Version: 0.1.0
+Summary: Official Python SDK for the KashRock esports API — props, odds, matches, and scores.
+Author-email: KashRock <ovitalszn@gmail.com>
+License-Expression: MIT
+Project-URL: Homepage, https://www.kashrock.com
+Project-URL: Documentation, https://www.kashrock.com/docs
+Project-URL: API, https://kashrock.up.railway.app
+Project-URL: Repository, https://github.com/ovitalszn-cyber/kashrock-python
+Keywords: esports,api,cs2,valorant,dota,props,odds
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Internet :: WWW/HTTP
+Requires-Python: >=3.10
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: httpx<0.29,>=0.26
+Dynamic: license-file
+
+# KashRock Python SDK
+
+Official Python client for the [KashRock esports API](https://www.kashrock.com).
+
+Props, odds, matches, live scores, and history — one key, normalized IDs.
+
+## Install
+
+```bash
+pip install kashrock
+```
+
+## Four lines to a live prop
+
+```python
+from kashrock import KashRock
+
+kr = KashRock("YOUR_API_KEY")
+print(kr.props("cs2")["props"][0])
+```
+
+Get a free Sandbox key at [kashrock.com/pricing](https://www.kashrock.com/pricing). Docs: [kashrock.com/docs](https://www.kashrock.com/docs).
+
+`KASHROCK_API_KEY` works if you do not want the key in code.
+
+## What you can call
+
+```python
+kr.me()
+kr.props("cs2", book="prizepicks", limit=20)
+kr.lines("cs2")
+kr.matches("cs2", status="upcoming")
+kr.live_games("cs2")
+kr.gamelogs("cs2", "zywoo")
+kr.history_tape(market_key="kr_mk_…")
+```
+
+Same paths as the HTTP API and the [KashRock MCP](https://www.kashrock.com/mcp). Stacks are not included.
+
+Sandbox keys are CS2 props only. Hobby+ unlocks the rest of the board. Builder+ unlocks matches, live, gamelogs, and history.
+
+## License
+
+MIT

kashrock-0.1.0/src/kashrock.egg-info/SOURCES.txt

@@ -0,0 +1,13 @@
+LICENSE
+README.md
+pyproject.toml
+src/kashrock/__init__.py
+src/kashrock/_http.py
+src/kashrock/client.py
+src/kashrock/errors.py
+src/kashrock/py.typed
+src/kashrock.egg-info/PKG-INFO
+src/kashrock.egg-info/SOURCES.txt
+src/kashrock.egg-info/dependency_links.txt
+src/kashrock.egg-info/requires.txt
+src/kashrock.egg-info/top_level.txt

kashrock-0.1.0/src/kashrock.egg-info/dependency_links.txt

@@ -0,0 +1 @@
+

kashrock-0.1.0/src/kashrock.egg-info/requires.txt

@@ -0,0 +1 @@
+httpx<0.29,>=0.26

kashrock-0.1.0/src/kashrock.egg-info/top_level.txt

@@ -0,0 +1 @@
+kashrock