polymarket-client 0.1.0b1__tar.gz

polymarket_client-0.1.0b1/.claude/CLAUDE.md

@@ -0,0 +1,3 @@
+# Project Context
+
+@./AGENTS.md

polymarket_client-0.1.0b1/.editorconfig

@@ -0,0 +1,11 @@
+root = true
+
+[*]
+charset = utf-8
+end_of_line = lf
+insert_final_newline = true
+indent_style = space
+indent_size = 2
+
+[*.py]
+indent_size = 4

polymarket_client-0.1.0b1/.env.example

@@ -0,0 +1,20 @@
+# Copy this file to .env for local integration tests.
+# Use disposable test credentials only. Never commit real secrets.
+
+POLYMARKET_RUN_METERED_TESTS=0
+POLYMARKET_PRIVATE_KEY=0xYOUR_TEST_PRIVATE_KEY
+POLYMARKET_DEPOSIT_WALLET=0xYOUR_TEST_WALLET
+POLYMARKET_PROXY_PRIVATE_KEY=0xYOUR_PROXY_PRIVATE_KEY
+POLYMARKET_PROXY_WALLET=0xYOUR_PROXY_WALLET
+POLYMARKET_SAFE_PRIVATE_KEY=0xYOUR_SAFE_PRIVATE_KEY
+POLYMARKET_SAFE_WALLET=0xYOUR_SAFE_WALLET
+POLYMARKET_TEST_API_KEY=
+POLYMARKET_TEST_API_SECRET=
+POLYMARKET_TEST_API_PASSPHRASE=
+POLYMARKET_BUILDER_CODE=0xYOUR_BUILDER_CODE_BYTES32
+POLYMARKET_BUILDER_API_KEY=YOUR_BUILDER_API_KEY
+POLYMARKET_BUILDER_SECRET=YOUR_BUILDER_SECRET
+POLYMARKET_BUILDER_PASSPHRASE=YOUR_BUILDER_PASSPHRASE
+POLYMARKET_RELAYER_API_KEY=YOUR_RELAYER_API_KEY
+POLYMARKET_RELAYER_API_KEY_ADDRESS=YOUR_RELAYER_API_KEY_ADDRESS
+POLYMARKET_TEST_CONDITION_ID=0xYOUR_TEST_CONDITION_ID_BYTES32

polymarket_client-0.1.0b1/.gitignore

@@ -0,0 +1,16 @@
+.DS_Store
+.env
+.env.*
+!.env.example
+.venv/
+__pycache__/
+*.py[cod]
+*.egg-info/
+.pytest_cache/
+.ruff_cache/
+.coverage
+coverage.xml
+htmlcov/
+dist/
+build/
+site/

polymarket_client-0.1.0b1/.python-version

@@ -0,0 +1 @@
+3.11

polymarket_client-0.1.0b1/.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "0.1.0-b1"
+}

polymarket_client-0.1.0b1/CHANGELOG.md

@@ -0,0 +1,5 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+This project uses Conventional Commits and release-please for release automation.

polymarket_client-0.1.0b1/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Polymarket
+
+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_client-0.1.0b1/PKG-INFO

@@ -0,0 +1,168 @@
+Metadata-Version: 2.4
+Name: polymarket-client
+Version: 0.1.0b1
+Summary: Official Python client for Polymarket
+Project-URL: Homepage, https://polymarket.com
+Project-URL: Documentation, https://docs.polymarket.com
+Project-URL: Repository, https://github.com/Polymarket/py-sdk
+Project-URL: Issues, https://github.com/Polymarket/py-sdk/issues
+Author-email: Polymarket Engineering <engineering@polymarket.com>
+Maintainer-email: Polymarket Engineering <engineering@polymarket.com>
+License: MIT
+License-File: LICENSE
+Keywords: client,polymarket,prediction-markets,trading,web3
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Operating System :: OS Independent
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Classifier: Typing :: Typed
+Requires-Python: >=3.11
+Requires-Dist: eth-abi<6,>=5
+Requires-Dist: eth-account<1,>=0.13
+Requires-Dist: eth-utils<6,>=4
+Requires-Dist: httpx[http2]<1,>=0.27
+Requires-Dist: pydantic<3,>=2
+Requires-Dist: websockets<16,>=13
+Description-Content-Type: text/markdown
+
+# Polymarket Python SDK
+
+Official Python SDK for Polymarket.
+
+The SDK gives Python developers one coherent, workflow-oriented interface for building on Polymarket, starting with public data access and expanding toward authenticated account, trading, builder attribution, and relayer-backed workflows.
+
+## Installation
+
+```bash
+uv add polymarket-client
+```
+
+or:
+
+```bash
+pip install polymarket-client
+```
+
+## Usage
+
+Synchronous client:
+
+```python
+from polymarket import Market, PublicClient
+
+with PublicClient() as client:
+    market: Market = client.get_market(url="https://polymarket.com/event/example-market")
+```
+
+Asynchronous client:
+
+```python
+import asyncio
+
+from polymarket import AsyncPublicClient, Market
+
+
+async def main() -> None:
+    async with AsyncPublicClient() as client:
+        market: Market = await client.get_market(
+            url="https://polymarket.com/event/example-market"
+        )
+
+
+asyncio.run(main())
+```
+
+## API Design
+
+See [SDK Direction](docs/sdk-direction.md) for public API design principles and developer-experience decisions.
+
+## Development
+
+Install dependencies:
+
+```bash
+make sync
+```
+
+Run checks:
+
+```bash
+make check
+```
+
+Build package artifacts:
+
+```bash
+make build
+```
+
+The `Makefile` is a thin convenience wrapper around `uv`. Running the underlying commands directly is also fine.
+
+## Testing
+
+Unit tests run by default:
+
+```bash
+make test
+```
+
+Run unit tests in watch mode:
+
+```bash
+make test-watch
+```
+
+This runs the tests once immediately, then reruns them when Python files change.
+
+Integration tests are opt-in:
+
+```bash
+make test-integration
+```
+
+Integration tests can load local secrets from a gitignored `.env` copied from `.env.example`:
+
+```bash
+cp .env.example .env
+```
+
+See `.env.example` for the supported local and CI secret names.
+
+Tests that require credentials should use the `require_env` fixture so they skip when secrets are unavailable:
+
+```python
+import pytest
+
+
+@pytest.mark.integration
+def test_authenticated_flow(require_env):
+    private_key = require_env("POLYMARKET_PRIVATE_KEY")
+    builder_api_key = require_env("POLYMARKET_BUILDER_API_KEY")
+
+    assert private_key
+    assert builder_api_key
+```
+
+The SDK does not load `.env` files at runtime. The integration test fixture loads `.env` only for tests that request credentials, and existing environment variables take precedence over local `.env` values.
+
+Tests that place orders, spend funds, or mutate live state must also use `@pytest.mark.metered`. Metered tests are skipped unless `POLYMARKET_RUN_METERED_TESTS=1` is set:
+
+```python
+import pytest
+
+
+@pytest.mark.integration
+@pytest.mark.metered
+def test_order_lifecycle(require_env):
+    private_key = require_env("POLYMARKET_PRIVATE_KEY")
+
+    assert private_key
+```
+
+```bash
+POLYMARKET_RUN_METERED_TESTS=1 make test-integration
+```

polymarket_client-0.1.0b1/README.md

@@ -0,0 +1,137 @@
+# Polymarket Python SDK
+
+Official Python SDK for Polymarket.
+
+The SDK gives Python developers one coherent, workflow-oriented interface for building on Polymarket, starting with public data access and expanding toward authenticated account, trading, builder attribution, and relayer-backed workflows.
+
+## Installation
+
+```bash
+uv add polymarket-client
+```
+
+or:
+
+```bash
+pip install polymarket-client
+```
+
+## Usage
+
+Synchronous client:
+
+```python
+from polymarket import Market, PublicClient
+
+with PublicClient() as client:
+    market: Market = client.get_market(url="https://polymarket.com/event/example-market")
+```
+
+Asynchronous client:
+
+```python
+import asyncio
+
+from polymarket import AsyncPublicClient, Market
+
+
+async def main() -> None:
+    async with AsyncPublicClient() as client:
+        market: Market = await client.get_market(
+            url="https://polymarket.com/event/example-market"
+        )
+
+
+asyncio.run(main())
+```
+
+## API Design
+
+See [SDK Direction](docs/sdk-direction.md) for public API design principles and developer-experience decisions.
+
+## Development
+
+Install dependencies:
+
+```bash
+make sync
+```
+
+Run checks:
+
+```bash
+make check
+```
+
+Build package artifacts:
+
+```bash
+make build
+```
+
+The `Makefile` is a thin convenience wrapper around `uv`. Running the underlying commands directly is also fine.
+
+## Testing
+
+Unit tests run by default:
+
+```bash
+make test
+```
+
+Run unit tests in watch mode:
+
+```bash
+make test-watch
+```
+
+This runs the tests once immediately, then reruns them when Python files change.
+
+Integration tests are opt-in:
+
+```bash
+make test-integration
+```
+
+Integration tests can load local secrets from a gitignored `.env` copied from `.env.example`:
+
+```bash
+cp .env.example .env
+```
+
+See `.env.example` for the supported local and CI secret names.
+
+Tests that require credentials should use the `require_env` fixture so they skip when secrets are unavailable:
+
+```python
+import pytest
+
+
+@pytest.mark.integration
+def test_authenticated_flow(require_env):
+    private_key = require_env("POLYMARKET_PRIVATE_KEY")
+    builder_api_key = require_env("POLYMARKET_BUILDER_API_KEY")
+
+    assert private_key
+    assert builder_api_key
+```
+
+The SDK does not load `.env` files at runtime. The integration test fixture loads `.env` only for tests that request credentials, and existing environment variables take precedence over local `.env` values.
+
+Tests that place orders, spend funds, or mutate live state must also use `@pytest.mark.metered`. Metered tests are skipped unless `POLYMARKET_RUN_METERED_TESTS=1` is set:
+
+```python
+import pytest
+
+
+@pytest.mark.integration
+@pytest.mark.metered
+def test_order_lifecycle(require_env):
+    private_key = require_env("POLYMARKET_PRIVATE_KEY")
+
+    assert private_key
+```
+
+```bash
+POLYMARKET_RUN_METERED_TESTS=1 make test-integration
+```

polymarket_client-0.1.0b1/pyproject.toml

@@ -0,0 +1,104 @@
+[build-system]
+requires = ["hatchling>=1.26"]
+build-backend = "hatchling.build"
+
+[project]
+name = "polymarket-client"
+version = "0.1.0b1"
+description = "Official Python client for Polymarket"
+readme = "README.md"
+requires-python = ">=3.11"
+license = { text = "MIT" }
+authors = [
+  { name = "Polymarket Engineering", email = "engineering@polymarket.com" },
+]
+maintainers = [
+  { name = "Polymarket Engineering", email = "engineering@polymarket.com" },
+]
+keywords = ["polymarket", "prediction-markets", "client", "trading", "web3"]
+classifiers = [
+  "Development Status :: 4 - Beta",
+  "Intended Audience :: Developers",
+  "License :: OSI Approved :: MIT License",
+  "Operating System :: OS Independent",
+  "Programming Language :: Python :: 3",
+  "Programming Language :: Python :: 3.11",
+  "Programming Language :: Python :: 3.12",
+  "Programming Language :: Python :: 3.13",
+  "Typing :: Typed",
+]
+dependencies = [
+  "eth-abi>=5,<6",
+  "eth-account>=0.13,<1",
+  "eth-utils>=4,<6",
+  "httpx[http2]>=0.27,<1",
+  "pydantic>=2,<3",
+  "websockets>=13,<16",
+]
+
+[project.urls]
+Homepage = "https://polymarket.com"
+Documentation = "https://docs.polymarket.com"
+Repository = "https://github.com/Polymarket/py-sdk"
+Issues = "https://github.com/Polymarket/py-sdk/issues"
+
+[dependency-groups]
+dev = [
+  "pytest>=8,<9",
+  "pytest-cov>=6,<7",
+  "respx>=0.22,<1",
+  "ruff>=0.11,<1",
+  "pyright>=1.1,<2",
+  "pytest-watcher>=0.6.3",
+  "python-dotenv>=1.2.2",
+]
+
+[tool.hatch.build]
+exclude = [
+  "/.github",
+  "/.vscode",
+  "/dist",
+  "/docs",
+  "/tests",
+  "/AGENTS.md",
+  "/CONTRIBUTING.md",
+  "/release-please-config.json",
+  "/Makefile",
+]
+
+[tool.hatch.build.targets.wheel]
+packages = ["src/polymarket"]
+
+[tool.pytest.ini_options]
+testpaths = ["tests"]
+addopts = "--strict-markers"
+markers = [
+  "integration: tests that call live Polymarket services or require credentials",
+  "metered: integration tests that require explicit opt-in because they may place orders, spend funds, or mutate live state",
+]
+
+[tool.ruff]
+line-length = 100
+target-version = "py311"
+src = ["src", "tests"]
+
+[tool.ruff.lint]
+select = [
+  "E",
+  "F",
+  "I",
+  "UP",
+  "B",
+  "SIM",
+]
+
+[tool.ruff.format]
+quote-style = "double"
+indent-style = "space"
+
+[tool.pyright]
+include = ["src", "tests"]
+pythonVersion = "3.11"
+typeCheckingMode = "strict"
+venvPath = "."
+venv = ".venv"