docs

Polymarket Order Node

The Polymarket Order node trades on Polymarket ↗ prediction markets from your workflow: buy or sell outcome shares with market or limit orders, cancel a resting order, or claim resolved winnings. It signs through a Polymarket Wallet credential whose agent key is policy-locked to trading only, so funds can never leave the wallet without your signature.

Polymarket
Polymarket
BUY 5 pUSD • Yes

Configuration

Order
This node requires an active Polymarket Wallet funded with pUSD.

Configuration

FieldDescription
WalletA Polymarket Wallet credential. Defaults to your organization's first active wallet.
SideBUY buys outcome shares, SELL sells shares you hold, CANCEL cancels a resting order, REDEEM claims all resolved winning positions into pUSD (no market or amount needed). Supports the f(x) toggle, so an LLM or Function output can decide the side.
MarketThe outcome to trade. Search by name, paste a polymarket.com URL (event, market, or sports game page), or paste a CLOB token id directly. After picking a market you choose the outcome (e.g. Yes or No).
AmountMarket order: for BUY the pUSD to spend (minimum 1 pUSD), for SELL the number of shares to sell. Limit order: the number of shares to buy or sell (at least the market's minimum order size, usually 5). Supports the f(x) toggle.
Limit priceOptional. A price per share between 0 and 1 (0.45 = 45¢) on the market's tick. Set it to place a limit order; leave it empty for a market order.
Time in forceFOK (fill or kill, the market default): fills the whole amount at the current book or fails. FAK (fill and kill): fills what the book offers and cancels the rest. GTC (good till canceled, the limit default): rests on the book until filled or canceled. GTD (good till date): rests until Expiration.
ExpirationGTD only. An ISO date-time or unix seconds, at least 90 seconds ahead. Setting it on a limit order without a time in force makes it GTD.
Post onlyLimit orders only. The order must rest on the book: if any part would match immediately, Polymarket rejects it instead.
Order IDCANCEL only. The id of the resting order, from an earlier order's orderId or the wallet's open orders.
DescriptionOptional human-readable note.
A market order only reports success once its fill is confirmed. A limit order succeeds once it is on the book (status: "live") or filled in full on arrival (status: "matched"). An order that can't be placed (or exceeds your balance) fails the node with the reason, and a limit order is never turned into a market order.

Limit Orders and Cancels

Set Limit price to rest an order on the book, for example a take-profit: SELL 20 shares at 0.80. It stays open until it fills, until you cancel it, or (with GTD) until its expiration. Funds for an open BUY stay reserved in the wallet. Its id is in order.orderId, and every open order appears in the wallet's open orders and in a PORTFOLIO run's openOrders.

Set Side to CANCEL with that id to pull the order. Canceling signs nothing, so it is free.

Claiming Winnings

Set Side to REDEEM to claim everything the wallet has won. The agent redeems all resolved winning positions in one batch and converts them to pUSD inside the same wallet. When there is nothing to claim, the node succeeds with claimed: 0 and nothing is charged. Winnings can also be claimed manually from the wallet page.

Workflow Examples

Sentiment-Driven Bet

Polymarket probabilities feed an LLM, a Conditional gates the decision, and the order fires through your wallet.

Polymarket
Polymarket Data
US election
Strategy
Claude Sonnet 4.6
Action = buy?
Polymarket
Buy Yes
BUY 5 pUSD

Daily Auto-Claim

A scheduled workflow redeems any resolved winnings every morning, no signature needed.

Start
Schedule
Polymarket
Claim Winnings
REDEEM

Output

A BUY/SELL/CANCEL run outputs an order object, a REDEEM run outputs a redeem object.

PathDescription
{trade.order.success}true if the order was filled, placed on the book, or canceled.
{trade.order.orderId}The CLOB order id.
{trade.order.status}matched (filled), live (a limit order resting on the book, possibly partly filled), or canceled.
{trade.order.side}BUY or SELL.
{trade.order.amount}The amount ordered (pUSD for a market BUY, shares otherwise).
{trade.order.timeInForce}FOK, FAK, GTC or GTD.
{trade.order.limitPrice}The limit price, for a limit order.
{trade.order.shares}Shares filled so far.
{trade.order.transactionHash}The settlement transaction hash.
{trade.order.explorerUrl}Polygonscan link for the settlement.
{trade.redeem.claimed}Number of winning markets redeemed (0 when nothing to claim).
{trade.redeem.titles}The titles of the claimed markets.
{trade.redeem.pUSDReceived}pUSD credited by the claim.
{trade.redeem.explorerUrl}Polygonscan link for the claim transaction.
Replace trade with the edge label connecting this node downstream.

Next Steps