Skip to content

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.

Tags:integrations

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.

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.

“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.

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.

“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.

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.