List available prediction markets on Polymarket, sorted by volume. Returns market question, current prices for Yes/No outcomes, token IDs, volume, liquidity, and Polymarket URL.

Get detailed information about a specific prediction market including token IDs, current prices, description, liquidity, and market status.

Provide one of: condition_id, slug, or a full Polymarket URL (e.g. https://polymarket.com/event/btc-updown-15m-1770647400).

Get the order book for a specific token showing current bids and asks with prices and sizes.

Get the USDC balance and allowance for the configured wallet on Polymarket.

Get real positions (token holdings) for the configured wallet from Polymarket Data API.

Returns actual token balances with P&L, not just open orders.

Parameters:

• redeemable: Filter to only show redeemable (resolved) positions (default: false)

• market: Filter by condition ID (optional)

• limit: Max results 1-500 (default: 100)

Response includes:

• token_id, condition_id, outcome, size, avg_price, current_price

• pnl (cash P&L), pnl_percent

• redeemable/mergeable flags

• market title, slug, end_date

Trigger a refresh of the USDC allowance for trading on Polymarket.

Use this when orders fail due to insufficient allowance. This tells the CLOB server to re-check and update the on-chain allowance state.

Fetch recent news headlines for a topic via Google News RSS. Useful for understanding current events and market context when analyzing prediction markets. No API key required.

Get recent executed trades for the configured wallet.

Place a limit order on Polymarket. CAUTION: This executes a real trade with real funds. Price must be between 0 and 1, size in shares.

Place a market order on Polymarket for immediate execution.

CAUTION: This executes a REAL trade with REAL funds at market price!

Parameters:

• token_id: The token to trade

• side: "BUY" or "SELL"

• amount: For BUY — USD amount to spend. For SELL — number of shares to sell.

• order_type: "FOK" (Fill or Kill, default) or "FAK" (Fill and Kill — allows partial fills)

Examples:

• BUY $10 worth of Yes tokens: side="BUY", amount="10"

• SELL 5 shares at market: side="SELL", amount="5"

Cancel an existing order on Polymarket.