← Back to Skills Marketplace
polymarket-sdk
by
Tyler Houchin
· GitHub ↗
· v1.0.0
877
Downloads
0
Stars
5
Active Installs
1
Versions
Install in OpenClaw
/install polymarket-sdk
Description
Interact with Polymarket US prediction markets. Use when the user wants to: browse/search prediction markets, check market prices and odds, view portfolio po...
Usage Guidance
This skill appears to be a normal Polymarket US SDK helper, but take these precautions before installing or using it:
- Verify the SDK package: check PyPI for 'polymarket-us', confirm the publisher, read recent release notes, and inspect the package contents (or the upstream repository) before running pip install. Prefer pinned versions and install in an isolated virtualenv.
- Metadata mismatch: the registry did not declare required env vars or a primary credential even though SKILL.md requires POLYMARKET_KEY_ID and POLYMARKET_SECRET_KEY. Treat that omission as a sign to double-check what credentials you supply and where.
- Protect secrets: POLYMARKET_SECRET_KEY is an Ed25519 private key (base64). Don’t store it in shared or global environment variables. Use dedicated keys with the least privileges, rotate and revoke keys frequently, and consider ephemeral or scoped keys if available.
- Review the SDK behavior: before allowing any automated action, review the SDK code (or network calls) to confirm it only communicates with the documented Polymarket endpoints (gateway.polymarket.us and api.polymarket.us) and doesn’t exfiltrate data elsewhere.
- Trading safety: the SKILL.md rightly tells agents to always preview and confirm trades. Keep that policy enforced — avoid granting any automation permission to place orders without explicit user confirmation.
If you want higher assurance, request the skill author supply a verifiable package URL (GitHub repo or PyPI link), a pinned version, and update the registry metadata to declare the two required environment variables and their sensitivity.
Capability Analysis
Type: OpenClaw Skill
Name: polymarket-sdk
Version: 1.0.0
The skill bundle is benign. All code examples and instructions in SKILL.md and references/api_reference.md are directly related to interacting with the Polymarket US API. Credential handling uses standard environment variables (`os.environ`), and critical operations like placing orders explicitly instruct the AI agent to 'ALWAYS confirm with the user before executing', demonstrating a focus on user safety rather than malicious intent or prompt injection. There is no evidence of data exfiltration, unauthorized execution, or obfuscation.
Capability Assessment
Purpose & Capability
The name/description match the SKILL.md instructions: it is a Polymarket US SDK helper for browsing and trading. However, the registry metadata lists no required environment variables or primary credential while SKILL.md explicitly instructs users to set POLYMARKET_KEY_ID and POLYMARKET_SECRET_KEY for authenticated trading. That metadata omission is an inconsistency that should be corrected or explained.
Instruction Scope
SKILL.md stays on-topic: it instructs installing the Python SDK, using the SDK for public and authenticated endpoints, and explicitly recommends confirming with the user before placing orders. It does not tell the agent to read unrelated files, send data to unknown endpoints, or broadly harvest system context.
Install Mechanism
The skill is instruction-only and tells the user to run `pip install polymarket-us`. There is no install spec in the registry. Recommending a pip install is common, but it means arbitrary code will be installed from PyPI — the skill metadata should have declared this and pinned versions or given a verified source. Verify the package identity on PyPI (or prefer a pinned wheel from a trusted source) before installing.
Credentials
Authenticated trading requires two sensitive values: POLYMARKET_KEY_ID and POLYMARKET_SECRET_KEY (an Ed25519 private key). Requesting these is appropriate for a trading SDK, but the registry metadata does not declare them (so the platform won't surface the need). The skill asks for a raw private key (base64) which is highly sensitive — storage and scope of those keys are not discussed. Ensure minimal-permission keys, avoid putting private keys in shared/global env, and validate how keys are provisioned and revoked.
Persistence & Privilege
The skill does not request permanent/always-on inclusion (always: false), does not modify other skills, and does not claim elevated platform privileges. Autonomous model invocation is permitted (default) but not combined with other red flags here.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install polymarket-sdk - After installation, invoke the skill by name or use
/polymarket-sdk - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of the Polymarket skill.
- Enables browsing, searching, and trading on Polymarket US prediction markets via the Python SDK.
- Supports viewing market data, prices, odds, and settlement info without authentication.
- Allows portfolio management and trading with API key authentication (see setup instructions).
- Enforces important trading safety rules: always preview and confirm before executing orders.
- Clearly outlines result formatting for user-friendly market and position data displays.
- Requires the polymarket-us Python package for all functionality.
Metadata
Frequently Asked Questions
What is polymarket-sdk?
Interact with Polymarket US prediction markets. Use when the user wants to: browse/search prediction markets, check market prices and odds, view portfolio po... It is an AI Agent Skill for Claude Code / OpenClaw, with 877 downloads so far.
How do I install polymarket-sdk?
Run "/install polymarket-sdk" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is polymarket-sdk free?
Yes, polymarket-sdk is completely free (open-source). You can download, install and use it at no cost.
Which platforms does polymarket-sdk support?
polymarket-sdk is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created polymarket-sdk?
It is built and maintained by Tyler Houchin (@tyhouch); the current version is v1.0.0.
More Skills