polymarket-cli 0.2.0__tar.gz

polymarket_cli-0.2.0/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ra1nty
+
+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.

polymarket_cli-0.2.0/PKG-INFO

@@ -0,0 +1,96 @@
+Metadata-Version: 2.4
+Name: polymarket-cli
+Version: 0.2.0
+Summary: Production-oriented read-only CLI wrapper around Polymarket public Gamma + CLOB APIs
+Author: ra1nty
+License-Expression: MIT
+License-File: LICENSE
+Classifier: Development Status :: 5 - Production/Stable
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Topic :: Utilities
+Requires-Python: >=3.11
+Project-URL: Homepage, https://github.com/ra1nty/polymarket-cli
+Project-URL: Repository, https://github.com/ra1nty/polymarket-cli
+Project-URL: Issues, https://github.com/ra1nty/polymarket-cli/issues
+Description-Content-Type: text/markdown
+
+# polymarket-cli
+
+Read-only CLI for public Polymarket Gamma, CLOB, and Data API lookups.
+
+This package stays intentionally narrow: public, unauthenticated reads only. It does not place orders, manage wallets, sign anything, or depend on private APIs.
+
+The published Pypi package is `polymarket-cli`. 
+
+## What It Covers
+
+- Market discovery via `search` and `list`
+- Market detail lookup via `market`
+- Order book and spot pricing via `book`, `midpoint`, and `price`
+- Recent public trades via `trades`
+- Public token price history via `history`
+
+## Install
+
+```bash
+uv tool install polymarket-cli
+polymarket-cli --help
+```
+
+For one-off execution:
+
+```bash
+uvx polymarket-cli --help
+```
+
+If your `uv` tool bin directory is not on `PATH`, either run `uv tool update-shell` or call the binary directly from `$(uv tool dir --bin)`.
+
+## Agent Skill Installation
+
+Install the packaged skill with `npx skills`:
+
+### OpenClaw
+
+```bash
+npx skills add ra1nty/polymarket-cli -a openclaw
+```
+
+### Claude Code
+
+```bash
+npx skills add ra1nty/polymarket-cli -a claude-code
+```
+
+After installation, use the public command surface in agent prompts and automation:
+
+```bash
+polymarket-cli search bitcoin --limit 5
+polymarket-cli market --slug <market-slug> --json
+```
+
+## Usage
+
+```bash
+polymarket-cli search bitcoin --limit 5
+polymarket-cli list --active-only --sort volume24hr --limit 20
+polymarket-cli market --slug btc-updown-5m-1774165800
+polymarket-cli book --slug btc-updown-5m-1774165800 --outcome Down
+polymarket-cli price --slug btc-updown-5m-1774165800
+polymarket-cli history --slug btc-updown-5m-1774165800 --window 6h --format summary --json
+polymarket-cli trades --slug btc-updown-5m-1774165800 --limit 20
+```
+
+Useful flags:
+
+- `--json` is available on every command.
+- `--hydrate` resolves search/list rows to full market detail before local ranking or filtering.
+- `--with-odds` implies hydration and includes current outcome prices.
+- `--with-market` implies hydration and embeds the resolved market payload in JSON output.
+- Market selectors are explicit: `--slug`, `--id`, `--token-id`, `--condition-id`.
+
+Supported history intervals: `max`, `all`, `1m`, `1h`, `6h`, `1d`, `1w`.

polymarket_cli-0.2.0/README.md

@@ -0,0 +1,75 @@
+# polymarket-cli
+
+Read-only CLI for public Polymarket Gamma, CLOB, and Data API lookups.
+
+This package stays intentionally narrow: public, unauthenticated reads only. It does not place orders, manage wallets, sign anything, or depend on private APIs.
+
+The published Pypi package is `polymarket-cli`. 
+
+## What It Covers
+
+- Market discovery via `search` and `list`
+- Market detail lookup via `market`
+- Order book and spot pricing via `book`, `midpoint`, and `price`
+- Recent public trades via `trades`
+- Public token price history via `history`
+
+## Install
+
+```bash
+uv tool install polymarket-cli
+polymarket-cli --help
+```
+
+For one-off execution:
+
+```bash
+uvx polymarket-cli --help
+```
+
+If your `uv` tool bin directory is not on `PATH`, either run `uv tool update-shell` or call the binary directly from `$(uv tool dir --bin)`.
+
+## Agent Skill Installation
+
+Install the packaged skill with `npx skills`:
+
+### OpenClaw
+
+```bash
+npx skills add ra1nty/polymarket-cli -a openclaw
+```
+
+### Claude Code
+
+```bash
+npx skills add ra1nty/polymarket-cli -a claude-code
+```
+
+After installation, use the public command surface in agent prompts and automation:
+
+```bash
+polymarket-cli search bitcoin --limit 5
+polymarket-cli market --slug <market-slug> --json
+```
+
+## Usage
+
+```bash
+polymarket-cli search bitcoin --limit 5
+polymarket-cli list --active-only --sort volume24hr --limit 20
+polymarket-cli market --slug btc-updown-5m-1774165800
+polymarket-cli book --slug btc-updown-5m-1774165800 --outcome Down
+polymarket-cli price --slug btc-updown-5m-1774165800
+polymarket-cli history --slug btc-updown-5m-1774165800 --window 6h --format summary --json
+polymarket-cli trades --slug btc-updown-5m-1774165800 --limit 20
+```
+
+Useful flags:
+
+- `--json` is available on every command.
+- `--hydrate` resolves search/list rows to full market detail before local ranking or filtering.
+- `--with-odds` implies hydration and includes current outcome prices.
+- `--with-market` implies hydration and embeds the resolved market payload in JSON output.
+- Market selectors are explicit: `--slug`, `--id`, `--token-id`, `--condition-id`.
+
+Supported history intervals: `max`, `all`, `1m`, `1h`, `6h`, `1d`, `1w`.

polymarket_cli-0.2.0/polymarket_cli/__init__.py

@@ -0,0 +1,2 @@
+__all__ = ["__version__"]
+__version__ = "0.2.0"

polymarket_cli-0.2.0/polymarket_cli/__main__.py

@@ -0,0 +1,4 @@
+from .cli import main
+
+if __name__ == "__main__":
+    raise SystemExit(main())