vincentpolymarketPolymarket prediction market trading for agents. Use this skill when users want to create a Polymarket wallet, browse markets, place bets, manage positions,...
Install via ClawdBot CLI:
clawdbot install glitch003/vincentpolymarketUse this skill to create a Polymarket wallet for your agent and trade on prediction markets. Browse markets, place bets, track positions, and manage orders — all without exposing private keys to the agent. Wallets use Gnosis Safe on Polygon with gasless trading through Polymarket's relayer.
The agent never sees the private key. All operations are executed server-side. The agent receives a scoped API key that can only perform actions permitted by the wallet owner's policies. The private key never leaves the Vincent server.
This skill is designed for autonomous agent trading with human oversight via server-side controls. Understanding this model is important:
No environment variables are required because this skill uses agent-first onboarding: the agent creates its own Polymarket wallet at runtime by calling the Vincent API, which returns a scoped API key. There is no pre-existing credential to configure. The agent generates and stores its own API key during wallet creation — no secrets need to exist before the skill runs. The config paths where the agent persists the returned API key (~/.openclaw/credentials/agentwallet/ or ./agentwallet/) are declared in this skill's metadata.
The agent's API key is not a private key. It is a scoped Bearer token that can only execute actions within the policies set by the wallet owner. The Vincent server enforces all policies server-side — the agent cannot bypass them regardless of what it sends. If a trade violates a policy, the server rejects it. If a trade requires approval, the server holds it and notifies the wallet owner via Telegram for out-of-band human approval.
Model invocation is intentionally enabled. The purpose of this skill is to give AI agents autonomous Polymarket trading capabilities. The agent is expected to invoke trading actions (browse markets, place bets, manage positions) on its own, within the boundaries the human operator defines. The human controls what the agent can do through policies (spending limits, approval thresholds) — not by gating individual invocations. The agent persists its scoped API key to the declared config paths so it can resume trading across sessions; this is expected behavior for an autonomous trading agent. The stored key is scoped and policy-constrained — even if another process reads it, it can only perform actions the wallet owner's policies allow, and the owner can revoke it instantly.
All API calls go exclusively to heyvincent.ai over HTTPS/TLS. No other endpoints, services, or external hosts are contacted. The agent does not read, collect, or transmit any data beyond what is needed for Polymarket wallet operations.
Key lifecycle:
POST /api/secrets to create a wallet. The API returns a scoped API key and a claim URL.https://heyvincent.ai.All API requests require a Bearer token (the scoped API key returned when creating a wallet). This key is not a private key — it is a server-enforced, policy-scoped credential that the wallet owner can revoke at any time.
Store the API key locally after wallet creation in one of the declared config paths. If you're an OpenClaw instance, store and retrieve it from ~/.openclaw/credentials/agentwallet/. Otherwise, store it in your current working directory at agentwallet/. These paths are declared in this skill's metadata so the host environment can audit and manage credential storage.
Authorization: Bearer <API_KEY>Create a new Polymarket wallet for your agent. This generates a private key server-side (the agent never sees it), creates a Gnosis Safe on Polygon, and returns a scoped API key for the agent plus a claim URL for the wallet owner.
curl -X POST "https://heyvincent.ai/api/secrets" \
-H "Content-Type: application/json" \
-d '{
"type": "POLYMARKET_WALLET",
"memo": "My prediction market wallet"
}'Response includes:
apiKey -- a scoped API key; store this securely and use it as the Bearer token for all future requestsclaimUrl -- share with the user to claim ownership and set policieswalletAddress -- the EOA address (Safe is deployed lazily on first use)After creating, tell the user:
"Here is your wallet claim URL:
Important: After creation, the wallet has no funds. The user must send USDC.e (bridged USDC) on Polygon to the Safe address before placing bets.
curl -X GET "https://heyvincent.ai/api/skills/polymarket/balance" \
-H "Authorization: Bearer <API_KEY>"Returns:
walletAddress -- the Safe address (deployed on first call if needed)collateral.balance -- USDC.e balance available for tradingcollateral.allowance -- approved amount for Polymarket contractsNote: The first balance call triggers Safe deployment and collateral approval (gasless via relayer). This may take 30-60 seconds.
Before placing bets, the user must send USDC.e to the Safe address:
/balance endpoint0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174) on Polygon to that addressDo not send native USDC (0x3c499c542cEF5E3811e1192ce70d8cC03d5c3359). Polymarket only accepts bridged USDC.e.
# Search markets by keyword (recommended)
curl -X GET "https://heyvincent.ai/api/skills/polymarket/markets?query=bitcoin&limit=20" \
-H "Authorization: Bearer <API_KEY>"
# Get all active markets (paginated)
curl -X GET "https://heyvincent.ai/api/skills/polymarket/markets?active=true&limit=50" \
-H "Authorization: Bearer <API_KEY>"
# Get specific market by condition ID
curl -X GET "https://heyvincent.ai/api/skills/polymarket/market/<CONDITION_ID>" \
-H "Authorization: Bearer <API_KEY>"Market response includes:
question: The market questionoutcomes: Array like ["Yes", "No"] or ["Team A", "Team B"]outcomePrices: Current prices for each outcometokenIds: Array of token IDs for each outcome - use these for placing betsacceptingOrders: Whether the market is open for tradingclosed: Whether the market has resolvedImportant: Always use the tokenIds array from the market response. Each outcome has a corresponding token ID at the same index. For a "Yes/No" market:
tokenIds[0] = "Yes" token IDtokenIds[1] = "No" token IDcurl -X GET "https://heyvincent.ai/api/skills/polymarket/orderbook/<TOKEN_ID>" \
-H "Authorization: Bearer <API_KEY>"Returns bids and asks with prices and sizes. Use this to determine current market prices before placing orders.
curl -X POST "https://heyvincent.ai/api/skills/polymarket/bet" \
-H "Authorization: Bearer <API_KEY>" \
-H "Content-Type: application/json" \
-d '{
"tokenId": "<OUTCOME_TOKEN_ID>",
"side": "BUY",
"amount": 5,
"price": 0.55
}'Parameters:
tokenId: The outcome token ID (from market data or order book)side: "BUY" or "SELL"amount: For BUY orders, USD amount to spend. For SELL orders, number of shares to sell.price: Limit price (0.01 to 0.99). Optional -- omit for market order.BUY orders:
amount is the USD you want to spend (e.g., 5 = $5)amount / price shares (e.g., $5 at 0.50 = 10 shares)SELL orders:
amount is the number of shares to sellamount * price USDImportant timing: After a BUY fills, wait a few seconds before selling. Shares need time to settle on-chain.
If a trade violates a policy, the server returns an error explaining which policy was triggered. If a trade requires human approval (based on the approval threshold policy), the server returns status: "pending_approval" and the wallet owner receives a Telegram notification to approve or deny.
# Get open orders
curl -X GET "https://heyvincent.ai/api/skills/polymarket/positions" \
-H "Authorization: Bearer <API_KEY>"
# Get trade history
curl -X GET "https://heyvincent.ai/api/skills/polymarket/trades" \
-H "Authorization: Bearer <API_KEY>"# Cancel specific order
curl -X DELETE "https://heyvincent.ai/api/skills/polymarket/orders/<ORDER_ID>" \
-H "Authorization: Bearer <API_KEY>"
# Cancel all open orders
curl -X DELETE "https://heyvincent.ai/api/skills/polymarket/orders" \
-H "Authorization: Bearer <API_KEY>"The wallet owner controls what the agent can do by setting policies via the claim URL at https://heyvincent.ai. All policies are enforced server-side by the Vincent API — the agent cannot bypass or modify them. If a trade violates a policy, the API rejects it. If a trade triggers an approval threshold, the API holds it and sends the wallet owner a Telegram notification for out-of-band human approval.
| Policy | What it does |
| --------------------------- | ---------------------------------------------------------------- |
| Spending limit (per tx) | Max USD value per transaction |
| Spending limit (daily) | Max USD value per rolling 24 hours |
| Spending limit (weekly) | Max USD value per rolling 7 days |
| Require approval | Every transaction needs human approval via Telegram |
| Approval threshold | Transactions above a USD amount need human approval via Telegram |
Before the wallet is claimed, the agent can operate without policy restrictions. This is by design: agent-first onboarding allows the agent to begin trading immediately. Once the human operator claims the wallet via the claim URL, they can add any combination of policies to constrain the agent's behavior. The wallet owner can also revoke the agent's API key entirely at any time.
If the agent loses its API key, the wallet owner can generate a re-link token from the frontend. The agent then exchanges this token for a new scoped API key.
How it works:
https://heyvincent.aicurl -X POST "https://heyvincent.ai/api/secrets/relink" \
-H "Content-Type: application/json" \
-d '{
"relinkToken": "<TOKEN_FROM_USER>",
"apiKeyName": "Re-linked API Key"
}'Response includes:
secret -- the wallet metadata (id, type, address, chainId, etc.)apiKey.key -- the new scoped API key to use as Bearer token for all future requestsImportant: Re-link tokens are one-time use and expire after 10 minutes. No authentication is required on this endpoint -- the token itself is the authorization.
If a user tells you they have a re-link token, use this endpoint to regain access to the wallet. Store the returned API key and use it for all subsequent requests.
POST /api/secrets {"type": "POLYMARKET_WALLET", "memo": "Betting wallet"}
GET /api/skills/polymarket/balance
# Returns walletAddress -- give this to user to fund
# Search by keyword - returns only active, tradeable markets
GET /api/skills/polymarket/markets?query=bitcoin&active=trueResponse example:
{
"markets": [
{
"question": "Will Bitcoin hit $100k by end of 2025?",
"outcomes": ["Yes", "No"],
"outcomePrices": ["0.65", "0.35"],
"tokenIds": ["123456...", "789012..."],
"acceptingOrders": true
}
]
}
# Use the tokenId from the market response
GET /api/skills/polymarket/orderbook/123456...
# Note the bid/ask prices
# tokenId must be from the tokenIds array, NOT the conditionId
POST /api/skills/polymarket/bet
{"tokenId": "123456...", "side": "BUY", "amount": 5, "price": 0.55}
POST /api/skills/polymarket/bet
{"tokenId": "123456...", "side": "SELL", "amount": 9.09, "price": 0.54}~/.openclaw/credentials/agentwallet/.json . Otherwise, store it in your current working directory at agentwallet/.json .~/.openclaw/credentials/agentwallet/. Otherwise, search in ./agentwallet/.https://heyvincent.ai.status: "pending_approval". The wallet owner will receive a Telegram notification to approve or deny.Common Errors:
"No orderbook exists for the requested token id" - The market is closed or you're using the wrong ID. Make sure:acceptingOrders: truetokenId from the tokenIds array, not the conditionIdGenerated Mar 1, 2026
A hedge fund uses this skill to deploy AI agents for automated trading on Polymarket prediction markets, leveraging real-time market data to place bets on crypto price movements and regulatory outcomes. Agents autonomously manage positions within predefined risk limits set by fund managers, enabling scalable, 24/7 trading without manual intervention. This reduces human error and allows rapid response to market shifts while maintaining oversight through server-side policy controls.
Political campaigns employ this skill to let AI agents trade on prediction markets related to election outcomes, policy decisions, and public sentiment, providing data-driven insights for strategic planning. Agents autonomously place bets based on polling data and news trends, helping campaigns gauge probabilities and allocate resources effectively. Human operators set approval thresholds for high-stakes bets, ensuring oversight while benefiting from automated market intelligence.
Corporations integrate this skill into their risk management systems, using AI agents to trade on prediction markets for events like supply chain disruptions, regulatory changes, or competitor actions. Agents autonomously place bets to hedge against potential losses, providing a financial buffer and real-time risk indicators. Policies limit spending and require approvals for large trades, allowing companies to mitigate risks without exposing private keys or manual trading efforts.
Media companies utilize this skill to deploy AI agents on Polymarket for predicting box office results, streaming viewership trends, or award show outcomes, informing content production and marketing strategies. Agents autonomously browse markets and place bets based on historical data and social media signals, offering actionable forecasts. Operators set spending caps and review trades via Telegram notifications, ensuring controlled, data-backed decision-making in a dynamic industry.
Universities and research institutions use this skill to enable AI agents for experimental trading on prediction markets, studying market behavior, decision-making algorithms, or economic theories in real-world settings. Agents autonomously execute trades within predefined budgets, collecting data on market efficiency and agent performance. Researchers oversee activities through server-side policies, allowing safe, scalable experiments without compromising security or requiring manual execution.
Offer tiered subscription plans for accessing the Vincent API, with pricing based on features like transaction volume, number of agents, or advanced policy controls. Revenue is generated from monthly or annual fees paid by businesses and individual users for autonomous trading capabilities. This model ensures recurring income while scaling with user adoption, supported by dedicated customer service and regular updates to the skill.
Generate revenue by taking a small percentage of each trade executed through the skill, either as a flat fee per transaction or a share of profits from successful bets. This aligns incentives with users' trading success, encouraging high-volume usage while providing a scalable income stream. Partnerships with Polymarket or other platforms could enhance fee structures, making it attractive for active traders and institutional clients.
Sell enterprise licenses to large organizations for customized deployments, including white-label solutions, integration with existing systems, and dedicated support. Revenue comes from one-time licensing fees and ongoing maintenance contracts, targeting sectors like finance, politics, and corporate risk management. This model leverages the skill's security and autonomy features to address specific business needs, driving high-value deals and long-term client relationships.
💬 Integration Tip
Ensure the agent stores its scoped API key in the declared config paths (e.g., ~/.openclaw/credentials/agentwallet/) for persistence across sessions, and remind users to fund the wallet with USDC.e on Polygon before trading to avoid failed transactions.
Analyze stocks and cryptocurrencies using Yahoo Finance data. Supports portfolio management, watchlists with alerts, dividend analysis, 8-dimension stock scoring, viral trend detection (Hot Scanner), and rumor/early signal detection. Use for stock analysis, portfolio tracking, earnings reactions, crypto monitoring, trending stocks, or finding rumors before they hit mainstream.
Get stock prices, quotes, fundamentals, earnings, options, dividends, and analyst ratings using Yahoo Finance. Uses yfinance library - no API key required.
Yahoo Finance (yfinance) powered stock analysis skill: quotes, fundamentals, ASCII trends, high-resolution charts (RSI/MACD/BB/VWAP/ATR), plus optional web a...
Become an autonomous prediction market trader on Polymarket with AI-powered analysis and a performance-backed token on Base. Trade real markets, build a track record, and let the buyback flywheel run.
Get cryptocurrency token price and generate candlestick charts via CoinGecko API or Hyperliquid API. Use when user asks for token price, crypto price, price chart, or cryptocurrency market data.
Trade and monitor Hyperliquid perpetual futures. Check balances, view positions with P&L, place/cancel orders, execute market trades. Use when the user asks about Hyperliquid trading, portfolio status, crypto positions, or wants to execute trades on Hyperliquid.