Follow the market
Get prices, order books, recent trades and charts. Ask for a market by its symbol, like BTC or ETH.
Connect your AI agent to Polymarket Perpetuals. Ask it to check prices, review your positions or place an order, all from the same conversation.
MARKET DATA · TRADING · ACCOUNT HISTORYAdd this address to your MCP client. You can start using public market data straight away.
https://api.mcp.polyperpetuals.xyz/mcpMCP lets your agent use Polymarket tools directly. You can ask for a market update, work through a trade or check how your account is doing.
Get prices, order books, recent trades and charts. Ask for a market by its symbol, like BTC or ETH.
Place market and limit orders, add stop losses and take profits, or change and cancel open orders.
See balances, open positions, fills, fees and funding. Review recent trades and their PnL.
Preview order size and margin, compare leverage settings or calculate a position size from your entry and stop.
Try these prompts in your connected LLM or AI agent. The replies below are illustrative, with sample prices and balances. Actual responses depend on live data, your account and your client’s chart support.
What is the current price of BTC?
BTC’s mark price is $60,000. The best bid is $59,999 and the best ask is $60,001. These Polymarket quotes were updated at 14:32 UTC; your execution price may differ.
Show the BTC chart for the last 24 hours.
Here are BTC’s hourly candles for the last 24 hours, with UTC timestamps. The period’s high is $61,200 and its low is $59,400. Would you like a shorter interval or a different range?
Show my BTC position and its PnL.
You’re long 0.01 BTC at an entry price of $59,000. At the current mark of $60,000, your unrealized PnL is +$10, before fees and funding. This is an open position, so the PnL can still change.
Preview a $600 BTC limit buy at $60,000 with a stop 2% below entry. Don’t submit it yet.
That’s $600 of notional, or 0.01 BTC, with a stop trigger at $58,800. The price move to the stop represents a $12 loss before fees and slippage. Entry-bracket protection activates only after a full entry fill. I’ll check size and margin requirements before preparing anything to sign. No order has been submitted.
Prepare to close half my BTC position.
You’re long 0.01 BTC. I’ve prepared a reduce-only market sell for 0.005 BTC, leaving 0.005 BTC if fully filled. It needs your wallet signature before submission. After execution, I’ll check the fills and whether your existing stops still match the remaining position.
Sell all my BTC orders.
Do you want to cancel your pending BTC orders or close your open BTC position? Those are separate actions. I haven’t changed either.
{
"mcpServers": {
"polyperpetuals": {
"url": "https://api.mcp.polyperpetuals.xyz/mcp"
}
}
}Open your agent’s MCP settings and add the server URL, or copy the JSON into its configuration. Once connected, ask for the current BTC price to try it out.
Account access needs a registered Polymarket trading session. Connect a wallet integration that supports EIP-712 signing, then ask your agent to set up the session. It can then read your positions and prepare orders for that account.
For account reads, add your registered session address and exchange read secret as HTTP headers in your client’s credential settings. Replace the placeholders below with the values returned during session registration.
{
"mcpServers": {
"polyperpetuals": {
"url": "https://api.mcp.polyperpetuals.xyz/mcp",
"headers": {
"polymarket-proxy": "<REGISTERED_SESSION_ADDRESS>",
"polymarket-secret": "<EXCHANGE_READ_SECRET>"
}
}
}
}Your client needs to support custom HTTP headers for account reads. Public market tools work without them.
Create a trading session with perps_prepare_session. The owner wallet signs the returned CreateProxy message, and perps_submit_signature registers it. Store the returned account credentials in your client’s credential settings.
To place an order, call a perps_prepare_* tool, sign its EIP-712 data with the registered trading signer, then pass the action ID and signature to perps_submit_signature. Read orders, fills and positions for the result. Use perps_operation_status to look up a submission.
The agent handles strategy timing and repeated tasks. The MCP provides the tools and records its activity; it does not run trading loops.
Session documentation Trading documentationPolymarket Perpetuals uses pUSD on Polygon. The MCP can prepare deposits, withdrawals and supported token conversions. The minimum Perps deposit is 10 pUSD.
For native USDC on Polygon, ask your agent for a bridge quote to pUSD. It checks supported assets, prepares the transfer and tracks the amount received. You can then deposit the pUSD into Perps.
After withdrawing from Perps, you can convert pUSD back to native USDC through the bridge. Quotes include the current minimum, costs and expiry.
USDC.e uses a separate wrapper. The MCP also supports wrapping USDC.e into pUSD and unwrapping pUSD back into USDC.e on Polygon.
The bridge tools are perps_bridge_supported_asset, perps_quote_bridge, perps_prepare_bridge_deposit and perps_prepare_bridge_withdrawal. Track transfers with perps_bridge_status and check receipts with perps_verify_bridge_receipt.
For Deposit Wallets, Safes and Poly Proxies, use perps_relayer_capabilities to check availability, then perps_prepare_relayer to build the request. The owner wallet signs it, and perps_submit_relayer_signature sends it through Polymarket’s relayer. Sponsorship depends on the configured relayer access and quota. Regular wallets send transactions directly using Polygon gas.