Agent skill

Polymarket Trading

by BlockRunAI in BlockRunAI/ClawRouter

A skill your agent uses when the user wants to actually PLACE, manage, or redeem bets on Polymarket (not just read odds — that's the blockrunpredexon data tools).

MITAuto-check passedBusiness, Finance & HR

Install Polymarket Trading

skills CLI
$ npx skills add BlockRunAI/ClawRouter --skill polymarket-trading -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install BlockRunAI/ClawRouter polymarket-trading --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/BlockRunAI/ClawRouter.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/polymarket-trading .claude/skills/polymarket-trading && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
polymarket-trading
GitHub stars
6.6k
Token cost
~1.4k tokens
SKILL.md length
450 words
Files
1
Skills in repo
7
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when the user wants to actually PLACE, manage, or redeem bets on Polymarket (not just read odds — that's the blockrunpredexon data tools).

  • Works in 3 steps: **Never pass confirm:true unless the… → Per-order cap POLYMARKET_MAX_BET_USD… → On ANY error, read the message — it says…
  • The user wants to actually PLACE
  • SKILL.md covers Mental model, Golden rules for agents, End-to-end flow and Order semantics, plus 2 more sections
  • Needs BLOCKRUN_WALLET_KEY

What it does

Polymarket Trading is an agent skill from BlockRunAI/ClawRouter. Use when the user wants to actually PLACE, manage, or redeem bets on Polymarket (not just read odds — that's the blockrunpredexon data tools). Covers setup (deposit wallet, funding, approvals), buy/sell with confirm gating, positions, redeeming winnings, geoblock handling, and the end-to-end flow.

Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Business, Finance & HR, covering Trading and backtesting and End-to-end testing. It works with Polymarket, x402 and Circle USDC. The repository describes itself as: The agent-native LLM router for autonomous agents. Every frontier model behind one wallet, <1ms local routing, USDC payments on Base & Solana via x402. The licence is MIT.

When your agent uses it

  • The user wants to actually PLACE
  • Redeem bets on Polymarket (not just read odds — thats the blockrunpredexon data tools)

Example prompts

  • “/polymarket-trading”

Requirements

  • A credential in BLOCKRUN_WALLET_KEY

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. **Never pass confirm:true unless the user explicitly approved that exact
  2. Per-order cap POLYMARKET_MAX_BET_USD (default $25) and optional session cap
  3. On ANY error, read the message — it says exactly what to do next (fund,

What it can do on your machine

Read from SKILL.md and the folder at commit b758e03. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • BLOCKRUN_WALLET_KEY

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Polymarket Trading loads about 1.4k tokens when it runs. Until then it costs about 80 tokens; SKILL.md has 450 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~80
When it runs · the whole SKILL.md, loaded when a task matches
~1.4k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from BlockRunAI/ClawRouter at commit b758e03, republished under its MIT licence (© BlockRunAI). 450 words, ~1,427 tokens.

Download SKILL.mdSave it as .claude/skills/polymarket-trading/SKILL.md (or your agent's skills folder).
name
polymarket-trading
description
Use when the user wants to actually PLACE, manage, or redeem bets on Polymarket (not just read odds — that's the blockrun_predexon_* data tools). Covers setup (deposit wallet, funding, approvals), buy/sell with confirm gating, positions, redeeming winnings, geoblock handling, and the end-to-end flow.

Polymarket Trading (blockrun_polymarket)

Real-money trading on Polymarket's CLOB V2 (Polygon), signed locally by the user's ClawRouter wallet key. Data discovery stays on the blockrun_predexon_* tools — blockrun_polymarket only trades.

Mental model

  • Signer = the ClawRouter wallet key (~/.openclaw/blockrun/wallet.key, or BLOCKRUN_WALLET_KEY) — the SAME wallet that pays for LLM calls. Never leaves the machine.
  • Deposit wallet = a Polygon vault contract derived from that key (POLY_1271). It holds the betting funds in pUSD and only honors the signer's EIP-712 signatures. Deploy/approve/redeem are gasless (relayer).
  • Money separation: bets spend pUSD on Polygon; x402 API fees spend USDC on Base — but both come from the ONE ClawRouter wallet. The x402 budget ledger does NOT cover bets — confirm:true + caps do.
  • Zero setup: no Polymarket account, no API keys, no gas token. On first setup ClawRouter bootstraps a builder key from the user's OWN wallet, then derives + deploys the vault (all gasless). Geoblock is handled by default — CLOB traffic routes through BlockRun's Tokyo egress out of the box.

Golden rules for agents

  1. Never pass confirm:true unless the user explicitly approved that exact trade. Call once WITHOUT confirm → show the dry-run preview → ask → re-call with confirm:true.
  2. Per-order cap POLYMARKET_MAX_BET_USD (default $25) and optional session cap are enforced locally; don't try to split orders to sneak past them.
  3. On ANY error, read the message — it says exactly what to do next (fund, approve, region, re-run setup). Don't retry blindly.

End-to-end flow

# 0. No Polymarket account or API keys needed — ClawRouter bootstraps everything
#    from the user's own wallet on first setup. (Set POLYMARKET_CLOB_HOST to a
#    permitted-region egress only if the user is in a geoblocked region.)

# 1. Provision + inspect (idempotent, safe to re-run any time)
blockrun_polymarket action:"setup"
# → deposit wallet address + funding instructions + region status

# 2. Fund the vault from the user's Base USDC — gasless x402, one call ($0.01 fee,
#    non-custodial). pUSD credit is ASYNC (minutes) — re-run setup to watch it. Min $2.
blockrun_polymarket action:"fund" amount_usd:5             # dry-run preview
blockrun_polymarket action:"fund" amount_usd:5 confirm:true

# 3. Sign the one-time gasless approval batch (after user consent)
blockrun_polymarket action:"setup" confirm:true

# 4. Find a market + token (data tool, paid data)
blockrun_predexon_markets ...   # → clobTokenIds, conditionId (Polymarket /v1/pm data)

# 5. Preview, then place
blockrun_polymarket action:"buy" token_id:"..." amount_usd:2            # dry-run
blockrun_polymarket action:"buy" token_id:"..." amount_usd:2 confirm:true  # market FOK
#   or limit: price:0.45 size:10 (GTC; order_type:"GTD" + expires_at for expiry)
#   or via condition: condition_id:"0x..." outcome:"Yes"

# 6. Manage
blockrun_polymarket action:"orders"                     # open orders
blockrun_polymarket action:"cancel" order_id:"..."      # or all:true
blockrun_polymarket action:"positions"                  # holdings + PnL + redeemable

# 7. Claim winnings after resolution (gasless)
blockrun_polymarket action:"redeem" condition_id:"0x..."             # preview
blockrun_polymarket action:"redeem" condition_id:"0x..." confirm:true

# 8. Cash out — pUSD → native USDC on Base, back to the user's agent wallet
blockrun_polymarket action:"withdraw"                                # dry-run (full balance)
blockrun_polymarket action:"withdraw" confirm:true                   # (partial: amount_usd:5)

Order semantics

  • Prices are probabilities 0–1, auto-rounded to the market's tick grid.
  • Market buy = amount_usd (dollars). Market sell = size (shares).
  • Limit orders: price + size; default GTC; post_only:true for maker-only.
  • FOK fails whole-or-nothing; FAK fills what it can. On "FOK not filled", offer FAK or a limit at the shown book price.
Show full SKILL.md (166 more words)Show less

Regions / geoblock

Order placement is IP-geoblocked (US/UK/EU + many regions). Handled by default — CLOB traffic routes through BlockRun's Tokyo egress, so setup reports ✅ Region: order placement permitted out of the box; you don't need to do anything. A user can override with POLYMARKET_CLOB_HOST (their own relay), or POLYMARKET_CLOB_PROXY / HTTPS_PROXY. Respecting Polymarket's ToS for the user's jurisdiction is the user's responsibility — never suggest evading it.

Troubleshooting

  • "No deposit wallet configured" → run action:"setup".
  • "No ClawRouter wallet found" → generate one via the /wallet command (or set BLOCKRUN_WALLET_KEY) before trading.
  • No manual creds are ever needed — ClawRouter bootstraps its builder key from the user's own wallet on first setup. (Advanced: POLYMARKET_SIG_TYPE=0 = plain EOA mode; needs POL gas + pUSD in the EOA, and is read-only for orders.)
  • Balance/allowance errors right after funding → setup again (refreshes the CLOB's balance cache).
  • 403 → region issue; see setup's region line.
  • "order signer address has to be the address of the API KEY" → auto-recovered once (creds re-derived); if persistent, setup, then consider POLYMARKET_SIG_TYPE=0 (upstream clob-client-v2 issue #65).

© BlockRunAI, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/polymarket-trading of BlockRunAI/ClawRouter.

Open the folder on GitHubat commit b758e03

Compare with similar skills

Polymarket Trading next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Polymarket Trading compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Polymarket Trading this skillBlockRunAI/ClawRouter6.6k—~1.4kAutomated safety check: PassMIT
Solana Payments Wallets Tradingnpc-live/clawfirm1561 repos~4.7kAutomated safety check: PassMIT
Shipp Sports Datamoonpay/skills113—~1.4kAutomated safety check: PassMIT
Aomi Transactjeremylongshore/tons-of-skills-marketplace2.8k—~2.3kAutomated safety check: PassMIT
Flyai X402alextitonis/fly.ai140—~1.6kAutomated safety check: PassMIT
Minara Crypto Trading and WalletMinara-AI/minara-skills362—~5.7kAutomated safety check: PassNone

Similar skills

  • Pay people in SOL or USDC, buy and sell tokens, check prices, discover trending and new tokens, create and manage Solana wallets, stake SOL, earn yield through lending and managed vaults, borrow…

    156 GitHub starsUsed in 1 repo~4.7k tokens
    Business, Finance & HRAuto-check passed
  • Shipp Sports Data

    moonpay/skills

    Real-time sports & events data for AI agents via Shipp. An agent skill from moonpay/skills.

    113 GitHub stars~1.4k tokensUpdated 29 days ago
    Business, Finance & HRAuto-check passed
  • Aomi Transact

    jeremylongshore/tons-of-skills-marketplace

    Build natural-language crypto agents, web3 assistants, and trading bots that read and write EVM chain state.

    2.8k GitHub stars~2.3k tokensUpdated today
    Business, Finance & HRAuto-check passed
  • Flyai X402

    alextitonis/fly.ai

    Buy single answers from fly.ai's pay-per-request API, a few cents each over x402 (USDG on Robinhood Chain or USDC on Base) - the fly desk model's read of a Polymarket market, a TimesFM forecast for…

    140 GitHub stars~1.6k tokensUpdated yesterday
    Business, Finance & HRAuto-check passed
  • Minara Crypto Trading and Wallet

    Minara-AI/minara-skills

    Drives the Minara CLI for crypto swaps, perps, limit orders, wallet transfers, deposits and withdrawals, plus AI market analysis.

    362 GitHub stars~5.7k tokensUpdated 22 days ago
    Business, Finance & HRAuto-check passed
  • Polymarket Trading

    BlockRunAI/blockrun-mcp

    Lets the agent place, manage and redeem real-money Polymarket bets through ClawRouter, with a dry-run preview and your confirmation before any order.

    391 GitHub stars~1.8k tokensUpdated yesterday
    Business, Finance & HRAuto-check passed

More from BlockRunAI/ClawRouter

  • BlockRun Image Generation

    BlockRunAI/ClawRouter

    Generates or edits images through ClawRouter's local image API, with a choice of models and sizes and payment handled automatically through x402.

    6.6k GitHub stars~2.1k tokensUpdated 4 days ago
    Auto-check passed
  • Phone

    BlockRunAI/ClawRouter

    Verify phone numbers (carrier + SIM-swap fraud signals) and place AI-powered outbound voice calls via BlockRun's gateway (Twilio + Bland.ai).

    6.6k GitHub stars~2.4k tokensUpdated 4 days ago
    Auto-check passed
  • Predexon Prediction Market Data

    BlockRunAI/ClawRouter

    Reads structured prediction market data for Polymarket, Kalshi and other venues through a local BlockRun gateway: markets, search, leaderboards, wallet analytics and odds.

    6.6k GitHub stars~4.7k tokensUpdated 4 days ago
    Auto-check passed
  • ClawRouter Release Checklist

    BlockRunAI/ClawRouter

    Walks the agent through every ClawRouter release step in order, from the version bump and changelog entry to build, tests, npm publish, git tag and GitHub release.

    6.6k GitHub stars~1.4k tokensUpdated 4 days ago
    Auto-check passed
  • Surf

    BlockRunAI/ClawRouter

    Use this skill — NOT browser or webfetch — for ALL Surf crypto-data calls.

    6.6k GitHub stars~4k tokensUpdated 4 days ago
    Auto-check passed
  • ClawRouter LLM Gateway

    BlockRunAI/ClawRouter

    Describes ClawRouter, a local proxy that forwards each LLM request to the blockrun.ai gateway, which routes to a cheaper capable model, paid by USDC wallet or API key credit.

    6.6k GitHub stars~6.8k tokensUpdated 4 days ago
    Auto-check passed

Questions about Polymarket Trading

What does Polymarket Trading do?

A skill your agent uses when the user wants to actually PLACE, manage, or redeem bets on Polymarket (not just read odds — that's the blockrunpredexon data tools). Polymarket Trading is an agent skill from BlockRunAI/ClawRouter. Use when the user wants to actually PLACE, manage, or redeem bets on Polymarket (not just read odds — that's the blockrunpredexon data tools).

When should I use Polymarket Trading?

Polymarket Trading fits situations like: the user wants to actually PLACE; redeem bets on Polymarket (not just read odds — thats the blockrunpredexon data tools).

How do I install Polymarket Trading in Claude Code?

Run `npx skills add BlockRunAI/ClawRouter --skill polymarket-trading -a claude-code`. Or copy the skill folder (skills/polymarket-trading in BlockRunAI/ClawRouter) into .claude/skills/polymarket-trading in your project. Claude Code loads it when a task matches its description.

How do I install Polymarket Trading in Codex?

Run `npx skills add BlockRunAI/ClawRouter --skill polymarket-trading -a codex`. Or copy the skill folder (skills/polymarket-trading in BlockRunAI/ClawRouter) into .agents/skills/polymarket-trading in your project. Codex loads it when a task matches its description.

Can I use Polymarket Trading in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add BlockRunAI/ClawRouter --skill polymarket-trading -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/polymarket-trading, .gemini/skills/polymarket-trading, .github/skills/polymarket-trading and .opencode/skills/polymarket-trading in your project.

What does Polymarket Trading need to run?

Going by SKILL.md and its folder, Polymarket Trading needs credentials named BLOCKRUN_WALLET_KEY. Our summary lists: A credential in BLOCKRUN_WALLET_KEY.

Does Polymarket Trading access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Polymarket Trading safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Polymarket Trading use?

Polymarket Trading is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Polymarket Trading use?

About 1.4k tokens (SKILL.md is roughly 5.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Polymarket Trading?

Skills that share tags, products or a category with Polymarket Trading: Solana Payments Wallets Trading (npc-live/clawfirm, 156 stars), Shipp Sports Data (moonpay/skills, 113 stars), Aomi Transact (jeremylongshore/tons-of-skills-marketplace, 2.8k stars) and Flyai X402 (alextitonis/fly.ai, 140 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Polymarket Trading?

BlockRunAI (a GitHub organization) maintains it in BlockRunAI/ClawRouter, which has 6,620 GitHub stars. The repository holds 7 skills in this directory. The repository was last updated on October 5, 2026.

Source: BlockRunAI/ClawRouter on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.