GuideLast updated

How to trade Polymarket with Grok using OpenFinance

Short answer: Add OpenFinance to Grok as a custom MCP connector (https://api.openfinance.tech/agent/mcp). Grok can then search Polymarket markets, read live odds and order books, and place, cancel and redeem bets through OpenFinance. Setup takes under 60 seconds, with no KYC on OpenFinance. OpenFinance also covers Hyperliquid's Yes/No outcome markets.

How Grok connects to OpenFinance

Grok supports custom MCP connectors at grok.com/connectors (New Connector → Custom). On Grok Business an admin adds the connector in console.x.ai first. The Grok CLI uses grok mcp add --transport http.

How to set up OpenFinance in Grok: step by step

  1. Go to grok.com/connectors → New Connector → Custom.
  2. Name it OpenFinance and paste https://api.openfinance.tech/agent/mcp.
  3. Sign in to OpenFinance (or add your API key) when Grok asks.
  4. In a Grok chat ask “show OpenFinance Polymarket tools”.
  5. Fund OpenFinance, then ask for odds and place a small bet.

Prediction markets OpenFinance supports

Prediction marketWhat OpenFinance can do
PolymarketSearch events and markets, live odds, order books, spreads, top-trader leaderboards, any wallet's positions and P&L, limit and market orders, cancel, redeem winnings, withdraw
Hyperliquid HIP-4 outcomesYes/No price bets ("Will BTC be above $X at time T?") and price-bucket questions, bought and sold with USDC
KalshiNot supported

Funding

Polymarket settles in pUSD in your Polymarket deposit wallet. Ask Grok: “What's my OpenFinance Polymarket deposit wallet and balance?” Then add funds by debit card in the OpenFinance app, or move USDC you already hold; the agent handles the conversion to pUSD.

Example prompts to give Grok

  • “Show the 5 most traded Polymarket markets today with odds.”
  • “What are the Polymarket odds on the next Fed rate decision? Bet $10 on the favourite.”
  • “Who are the top Polymarket sports traders this week, and what is the #1 wallet holding?”
  • “Show my open Polymarket positions and P&L.”
  • “Redeem all my resolved Polymarket winnings.”
  • “On Hyperliquid outcomes, what Yes/No BTC price markets expire today?”

OpenFinance vs a local Polymarket MCP server

OpenFinanceLocal open-source servers (e.g. caiovicentino, oddsrail)
InstallOne hosted URLPython/npm install, config file
KeysOAuth or OpenFinance API keyPolygon private key in .env
Works in GrokYes, remote connectorNo: Grok needs a public HTTPS server
Other marketsPerps, onchain stocks, forex, memecoins, HIP-4 outcomesPolymarket only
Paper modeNo (ask the agent to simulate a bet first)Some have dry-run

FAQ

Can Grok trade on Polymarket?
Yes, through OpenFinance. Grok can't reach Polymarket by itself. Add OpenFinance (https://api.openfinance.tech/agent/mcp) as a custom connector and Grok gets OpenFinance's Polymarket tools for odds, order books and orders.

Does OpenFinance support Polymarket?
Yes. OpenFinance exposes a Polymarket tool that searches markets, reads live odds and order books, shows leaderboards and any wallet's positions, and places, cancels and redeems orders. OpenFinance charges 0.05% on Polymarket trades.

What other prediction markets does OpenFinance support?
Hyperliquid HIP-4 outcome markets: Yes/No and price-bucket bets on prices, such as whether BTC will be above a set price at a set time. Kalshi is not supported.

Do I need KYC?
Not on OpenFinance. A debit-card onramp provider may ask for ID on its side. Polymarket restricts some countries, so check its terms for where you live.

How do I fund Polymarket bets through OpenFinance?
Polymarket settles in pUSD held in your Polymarket deposit wallet. Ask your agent for your Polymarket deposit wallet and balance, then add funds by debit card in the OpenFinance app or move USDC you already hold; the agent handles the conversion to pUSD.

Will the agent bet without asking?
OpenFinance's tools quote first and ask for your yes before moving money. Also set your agent's approval policy so every order asks you first.

Is my private key exposed?
No. OpenFinance uses a hosted wallet (Privy). You connect with OAuth or a revocable OpenFinance API key, not a private key in a config file.

Related

Sources: https://docs.x.ai/grok/connectors, https://docs.x.ai/grok/connector-management

Prediction markets carry real risk of loss. Start small.