Connect OpenClaw to Polymarket
Let an OpenClaw agent search Polymarket US markets, read order books, track positions and preview orders, with no credentials handed to the agent.
Polymarket is the prediction market where people trade on the outcome of real events: elections, economic releases, sports, court rulings, product launches. Traders, analysts and researchers use it as much for the prices as for the trading, because a market price is a live probability estimate. Keeping up with it is manual work: finding the right market among thousands, checking the order book before quoting a number, reconciling open orders and positions, and pulling settlement details after an event resolves.
With Claworc’s External Connections, an OpenClaw agent can work inside
your Polymarket account on your behalf. The Composio toolkit connects to Polymarket US, the
CFTC-compliant product for verified United States users, so you need a Polymarket US
account and API credentials. You add those once, Composio holds them, and the agent gets an
auto-generated claworc-polymarket_us skill that tells it which Polymarket tools exist and
how to call them. The agent never sees the credentials themselves.
Tools available to OpenClaw agents
Section titled “Tools available to OpenClaw agents”Composio’s Polymarket US toolkit exposes 44 actions, split between public market data and authenticated account actions. In practice an OpenClaw agent leans on a handful of capabilities:
- Search markets and events — natural-language search to find the right market among thousands before anything else.
- Read market details — full details for one market, including the current pricing needed before quoting or previewing an order.
- Check the order book — the best bid and offer, or the full public book when you need depth and slippage context.
- Track positions and balances — your positions across markets and your buying power, balances and reserved funds.
- Preview an order — validate an order and see the calculated result without submitting it; the toolkit recommends this before any live order.
- Place and cancel orders — submit one live order, or cancel an open order. Both are real, money-moving actions.
- Read settlement details — resolution and settlement information for a closed market.
Every action goes through a small broker running next to the agent, so the agent only needs to describe what it wants done in plain language and let the skill handle the rest. Because some of these actions place or cancel orders, it is worth being deliberate about what you ask the agent to do on its own and what you want it to preview and confirm first.
Use cases
Section titled “Use cases”Market watch
Section titled “Market watch”“Find every open market about the September Fed decision and give me the current yes price and the spread for each.” The agent searches for matching markets, pulls each market’s best bid and offer, and returns a compact table. Ask it to repeat this every hour and post only when a price moves more than a few points.
Portfolio check
Section titled “Portfolio check”At the end of the day, ask for a summary of your positions, open orders and available balance. The agent pulls your positions, open orders and balances, marks each position against the current book, and tells you what resolved today from the settlement details.
Preview before you trade
Section titled “Preview before you trade”“If I buy 200 yes shares in this market at the current ask, what does that cost and how far into the book does it go?” The agent reads the order book, previews the order, and shows you the calculated cost and fill. You decide whether to tell it to submit.
Get started
Section titled “Get started”Connecting Polymarket takes three steps: an admin adds a Composio API key to Claworc’s
settings, you open the instance’s Settings tab, click + Add connection, pick
Polymarket US and enter the API credentials from your Polymarket US developer settings.
The claworc-polymarket_us skill appears in the instance a moment later. The full
walkthrough, including the exact Composio permissions the key needs, is in the
External Connections documentation.