{
  "schemaVersion": "1.0",
  "item": {
    "slug": "polymarket-auto-trader",
    "name": "Polymarket Auto-Trader",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/srikanthbellary/polymarket-auto-trader",
    "canonicalUrl": "https://clawhub.ai/srikanthbellary/polymarket-auto-trader",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/polymarket-auto-trader",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=polymarket-auto-trader",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md",
      "references/contract-addresses.md",
      "references/polymarket-api.md",
      "scripts/approve_contracts.py",
      "scripts/pnl_tracker.py",
      "scripts/run_trade.py"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/polymarket-auto-trader"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/polymarket-auto-trader",
    "agentPageUrl": "https://openagent3.xyz/skills/polymarket-auto-trader/agent",
    "manifestUrl": "https://openagent3.xyz/skills/polymarket-auto-trader/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/polymarket-auto-trader/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Polymarket Auto-Trader",
        "body": "Fully autonomous prediction market trading agent for Polymarket. Evaluates markets using LLM probability estimation, sizes positions with Kelly criterion, and executes trades via the Polymarket CLOB API from a non-US VPS."
      },
      {
        "title": "Prerequisites",
        "body": "Non-US VPS — Polymarket blocks US IPs. Use DigitalOcean Amsterdam, Hetzner EU, etc.\nPolygon wallet with USDC.e (bridged USDC, NOT native USDC)\nMATIC for gas (~0.1 MATIC sufficient for hundreds of trades)\nAnthropic API key (uses Haiku at ~$0.001/evaluation)"
      },
      {
        "title": "1. VPS Environment",
        "body": "SSH into your non-US VPS and run:\n\npython3 {baseDir}/scripts/setup_vps.sh\n\nOr manually:\n\napt update && apt install -y python3 python3-venv\npython3 -m venv /opt/trader\n/opt/trader/bin/pip install py-clob-client python-dotenv web3 requests"
      },
      {
        "title": "2. Configuration",
        "body": "Create /opt/trader/app/.env:\n\nPRIVATE_KEY=<your-polygon-wallet-private-key>\nLLM_API_KEY=<your-anthropic-api-key>"
      },
      {
        "title": "3. Blockchain Approvals",
        "body": "Before trading, approve USDC.e and CTF tokens for Polymarket contracts. Run:\n\npython3 {baseDir}/scripts/approve_contracts.py\n\nRequired approvals (6 total):\n\nUSDC.e → CTF Exchange, Neg Risk Exchange, Neg Risk Adapter\nCTF → CTF Exchange, Neg Risk Exchange, Neg Risk Adapter"
      },
      {
        "title": "4. Deploy Trading Script",
        "body": "cp {baseDir}/scripts/run_trade.py /opt/trader/app/\ncp {baseDir}/scripts/pnl_tracker.py /opt/trader/app/"
      },
      {
        "title": "5. Cron Automation",
        "body": "crontab -e\n# Add: */10 * * * * cd /opt/trader/app && /opt/trader/bin/python3 run_trade.py >> cron.log 2>&1"
      },
      {
        "title": "How It Works",
        "body": "Market Scan — Fetches active markets from Gamma API, filters by liquidity and time horizon\nLLM Evaluation — Asks Claude Haiku to estimate true probability for each market\nEdge Detection — Compares LLM fair value vs market price (min 5% edge threshold)\nKelly Sizing — Half-Kelly criterion with 25% max position size cap\nOrder Execution — Places limit orders via CLOB API with GTC (good-till-cancelled)\nDedup — Tracks all trades in trades.jsonl, skips already-traded markets\nBudget Control — Tracks LLM inference costs separately from trading capital"
      },
      {
        "title": "Trading Parameters",
        "body": "Configurable in run_trade.py:\n\nEDGE_THRESHOLD — Minimum edge to trade (default: 0.05 = 5%)\nMIN_SHARES — Minimum order size (Polymarket requires ≥5 shares)\nBankroll allocation: 80% usable, 25% max per trade, 30% cap per single position\nMarket horizon: Prioritizes markets ending within 30 days"
      },
      {
        "title": "Monitoring",
        "body": "Check P&L anytime:\n\npython3 /opt/trader/app/pnl_tracker.py\n\nCheck recent activity:\n\ntail -50 /opt/trader/app/cron.log"
      },
      {
        "title": "Key Technical Details",
        "body": "Wallet type: EOA (signature_type=0), NOT proxy wallet\nToken: USDC.e (0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174), not native USDC\nNeg-risk markets (elections, sports leagues) require USDC.e approval for Neg Risk Adapter (0xd91E80cF2E7be2e162c6513ceD06f1dD0dA35296)\nUS geoblock — All API calls must originate from non-US IP. VPN insufficient; use actual non-US VPS."
      },
      {
        "title": "Cost",
        "body": "LLM inference: ~$0.001 per market evaluation (Haiku)\nTypical cycle (40 evals): ~$0.04\nGas: negligible on Polygon (~$0.001 per trade)"
      },
      {
        "title": "⚠️ Security Considerations",
        "body": "Use a DEDICATED wallet with minimal funds. Never use your main wallet's private key. Create a fresh wallet and fund it only with what you're willing to risk.\nPRIVATE_KEY is stored on disk in .env. Harden your VPS: strict file permissions (chmod 600 .env), no shared access, firewall, SSH keys only.\nMAX_UINT approvals are standard in DeFi but grant broad spending rights. The approved contracts are official Polymarket contracts. Review addresses in references/contract-addresses.md before running.\nTest with tiny amounts first ($5-10) before scaling up.\nMonitor actively — check cron.log and run pnl_tracker.py regularly.\nLLM_API_KEY billing — each cycle costs ~$0.04 (Haiku). Set billing alerts on your Anthropic account.\nThis is autonomous trading software. Bugs or market conditions can cause losses. Use at your own risk."
      },
      {
        "title": "References",
        "body": "See references/polymarket-api.md for full CLOB API documentation\nSee references/contract-addresses.md for all Polygon contract addresses"
      }
    ],
    "body": "Polymarket Auto-Trader\n\nFully autonomous prediction market trading agent for Polymarket. Evaluates markets using LLM probability estimation, sizes positions with Kelly criterion, and executes trades via the Polymarket CLOB API from a non-US VPS.\n\nPrerequisites\nNon-US VPS — Polymarket blocks US IPs. Use DigitalOcean Amsterdam, Hetzner EU, etc.\nPolygon wallet with USDC.e (bridged USDC, NOT native USDC)\nMATIC for gas (~0.1 MATIC sufficient for hundreds of trades)\nAnthropic API key (uses Haiku at ~$0.001/evaluation)\nSetup\n1. VPS Environment\n\nSSH into your non-US VPS and run:\n\npython3 {baseDir}/scripts/setup_vps.sh\n\n\nOr manually:\n\napt update && apt install -y python3 python3-venv\npython3 -m venv /opt/trader\n/opt/trader/bin/pip install py-clob-client python-dotenv web3 requests\n\n2. Configuration\n\nCreate /opt/trader/app/.env:\n\nPRIVATE_KEY=<your-polygon-wallet-private-key>\nLLM_API_KEY=<your-anthropic-api-key>\n\n3. Blockchain Approvals\n\nBefore trading, approve USDC.e and CTF tokens for Polymarket contracts. Run:\n\npython3 {baseDir}/scripts/approve_contracts.py\n\n\nRequired approvals (6 total):\n\nUSDC.e → CTF Exchange, Neg Risk Exchange, Neg Risk Adapter\nCTF → CTF Exchange, Neg Risk Exchange, Neg Risk Adapter\n4. Deploy Trading Script\ncp {baseDir}/scripts/run_trade.py /opt/trader/app/\ncp {baseDir}/scripts/pnl_tracker.py /opt/trader/app/\n\n5. Cron Automation\ncrontab -e\n# Add: */10 * * * * cd /opt/trader/app && /opt/trader/bin/python3 run_trade.py >> cron.log 2>&1\n\nHow It Works\nMarket Scan — Fetches active markets from Gamma API, filters by liquidity and time horizon\nLLM Evaluation — Asks Claude Haiku to estimate true probability for each market\nEdge Detection — Compares LLM fair value vs market price (min 5% edge threshold)\nKelly Sizing — Half-Kelly criterion with 25% max position size cap\nOrder Execution — Places limit orders via CLOB API with GTC (good-till-cancelled)\nDedup — Tracks all trades in trades.jsonl, skips already-traded markets\nBudget Control — Tracks LLM inference costs separately from trading capital\nTrading Parameters\n\nConfigurable in run_trade.py:\n\nEDGE_THRESHOLD — Minimum edge to trade (default: 0.05 = 5%)\nMIN_SHARES — Minimum order size (Polymarket requires ≥5 shares)\nBankroll allocation: 80% usable, 25% max per trade, 30% cap per single position\nMarket horizon: Prioritizes markets ending within 30 days\nMonitoring\n\nCheck P&L anytime:\n\npython3 /opt/trader/app/pnl_tracker.py\n\n\nCheck recent activity:\n\ntail -50 /opt/trader/app/cron.log\n\nKey Technical Details\nWallet type: EOA (signature_type=0), NOT proxy wallet\nToken: USDC.e (0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174), not native USDC\nNeg-risk markets (elections, sports leagues) require USDC.e approval for Neg Risk Adapter (0xd91E80cF2E7be2e162c6513ceD06f1dD0dA35296)\nUS geoblock — All API calls must originate from non-US IP. VPN insufficient; use actual non-US VPS.\nCost\nLLM inference: ~$0.001 per market evaluation (Haiku)\nTypical cycle (40 evals): ~$0.04\nGas: negligible on Polygon (~$0.001 per trade)\n⚠️ Security Considerations\nUse a DEDICATED wallet with minimal funds. Never use your main wallet's private key. Create a fresh wallet and fund it only with what you're willing to risk.\nPRIVATE_KEY is stored on disk in .env. Harden your VPS: strict file permissions (chmod 600 .env), no shared access, firewall, SSH keys only.\nMAX_UINT approvals are standard in DeFi but grant broad spending rights. The approved contracts are official Polymarket contracts. Review addresses in references/contract-addresses.md before running.\nTest with tiny amounts first ($5-10) before scaling up.\nMonitor actively — check cron.log and run pnl_tracker.py regularly.\nLLM_API_KEY billing — each cycle costs ~$0.04 (Haiku). Set billing alerts on your Anthropic account.\nThis is autonomous trading software. Bugs or market conditions can cause losses. Use at your own risk.\nReferences\nSee references/polymarket-api.md for full CLOB API documentation\nSee references/contract-addresses.md for all Polygon contract addresses"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/srikanthbellary/polymarket-auto-trader",
    "publisherUrl": "https://clawhub.ai/srikanthbellary/polymarket-auto-trader",
    "owner": "srikanthbellary",
    "version": "1.0.1",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/polymarket-auto-trader",
    "downloadUrl": "https://openagent3.xyz/downloads/polymarket-auto-trader",
    "agentUrl": "https://openagent3.xyz/skills/polymarket-auto-trader/agent",
    "manifestUrl": "https://openagent3.xyz/skills/polymarket-auto-trader/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/polymarket-auto-trader/agent.md"
  }
}