GuideLast updated

How to trade Polymarket with Muse using OpenFinance

Short answer: Add OpenFinance to Muse as a custom MCP connector (https://api.openfinance.tech/agent/mcp). Muse 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 Muse connects to OpenFinance

Muse connects from Meta's cloud, so it needs a public HTTPS MCP server, and OpenFinance is one. Ask Muse in a chat to create a custom connector, or use Settings → Connectors. Keys go into Muse's secure credentials prompt, never the chat. Custom connectors work in the Muse app, on the web and in WhatsApp.

How to set up OpenFinance in Muse: step by step

  1. Open Muse (app, web or WhatsApp) and start a chat.
  2. Paste: “Create a Custom Connector named OpenFinance. Transport: remote streamable HTTP. URL: https://api.openfinance.tech/agent/mcp. Auth: OAuth or API key in the x-api-key header.”
  3. Sign in to OpenFinance, or paste your OpenFinance API key into Muse's secure credentials prompt.
  4. Say “list the OpenFinance Polymarket tools” to test, then set the connector's approval policy so every bet asks you first.
  5. Fund your OpenFinance Polymarket balance, then ask Muse 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 Muse: “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 Muse

  • “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 MuseYes, remote connectorNo: Muse 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 Muse trade on Polymarket?
Yes, through OpenFinance. Muse can't reach Polymarket by itself. Add OpenFinance (https://api.openfinance.tech/agent/mcp) as a custom connector and Muse 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://www.meta.com/help/artificial-intelligence/1687253048996149/, https://platform.muse.ai/terms

Prediction markets carry real risk of loss. Start small.