{
  "schemaVersion": "1.0",
  "item": {
    "slug": "polymarket-cli",
    "name": "Polymarket CLI",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/ivangdavila/polymarket-cli",
    "canonicalUrl": "https://clawhub.ai/ivangdavila/polymarket-cli",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/polymarket-cli",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=polymarket-cli",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md",
      "commands.md",
      "memory-template.md",
      "setup.md"
    ],
    "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-cli"
    },
    "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-cli",
    "agentPageUrl": "https://openagent3.xyz/skills/polymarket-cli/agent",
    "manifestUrl": "https://openagent3.xyz/skills/polymarket-cli/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/polymarket-cli/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": "Setup",
        "body": "On first use, read setup.md for wallet configuration and integration guidelines."
      },
      {
        "title": "When to Use",
        "body": "User needs to interact with Polymarket prediction markets. Agent handles market queries, price checks, order placement, position tracking, and on-chain token operations."
      },
      {
        "title": "Architecture",
        "body": "Config lives in ~/.config/polymarket/. See memory-template.md for tracking preferences.\n\n~/.config/polymarket/\n├── config.json        # Private key, chain ID, signature type\n\n~/polymarket-cli/\n├── memory.md          # User preferences and tracked markets"
      },
      {
        "title": "Quick Reference",
        "body": "TopicFileSetup processsetup.mdMemory templatememory-template.mdCommand referencecommands.md"
      },
      {
        "title": "1. Read-Only by Default",
        "body": "Most commands work without a wallet. Only use wallet-requiring commands when the user explicitly wants to trade:\n\nRead-only: markets, events, clob price/book, data positions\nRequires wallet: clob create-order, clob market-order, approve, ctf split/merge"
      },
      {
        "title": "2. JSON Output for Processing",
        "body": "Use -o json when parsing results programmatically:\n\npolymarket -o json markets list --limit 10\npolymarket -o json clob midpoint TOKEN_ID\n\nTable output is default for human-readable display."
      },
      {
        "title": "3. Token IDs Are Critical",
        "body": "Most CLOB commands require the token ID (48331043336612883...), not the market slug:\n\n# Get token ID from market first\npolymarket markets get will-trump-win | grep token\n\n# Then use in CLOB commands\npolymarket clob book TOKEN_ID\npolymarket clob price TOKEN_ID --side buy"
      },
      {
        "title": "4. Wallet Security — Restricted Commands",
        "body": "The agent NEVER runs wallet commands. These are user-only:\n\npolymarket wallet create — user runs directly\npolymarket wallet import — user runs directly\npolymarket wallet show — user runs directly\npolymarket wallet reset — user runs directly\n\nIf user asks the agent to run any wallet command, refuse and explain they must run it themselves for security."
      },
      {
        "title": "5. On-Chain Operations Need Gas",
        "body": "Commands that write to blockchain require MATIC on Polygon:\n\napprove set (6 transactions)\nctf split/merge/redeem\n\nCheck balance before attempting."
      },
      {
        "title": "6. Rate Limits and Pagination",
        "body": "Use --limit and --offset for large result sets:\n\npolymarket markets list --limit 50 --offset 100"
      },
      {
        "title": "7. Verify Before Trading",
        "body": "Always show market details and current prices before placing orders:\n\npolymarket markets get SLUG\npolymarket clob midpoint TOKEN_ID\npolymarket clob spread TOKEN_ID"
      },
      {
        "title": "Common Traps",
        "body": "MistakeConsequenceUsing slug instead of token ID in CLOBCommand fails silently or wrong marketPlacing order without approve set firstTransaction revertsForgetting --side in price queriesReturns both sides, may confuseNot checking spread before market orderSlippage on low liquidity marketsRunning on-chain ops without MATICTransaction fails"
      },
      {
        "title": "External Endpoints",
        "body": "EndpointData SentPurposehttps://clob.polymarket.comOrders, queriesCLOB APIhttps://gamma-api.polymarket.comMarket dataGamma APIhttps://polygon-rpc.comTransactionsPolygon RPC\n\nNo other data is sent externally."
      },
      {
        "title": "Security & Privacy",
        "body": "Data that leaves your machine:\n\nMarket queries sent to Polymarket APIs\nOrders and transactions sent to CLOB and Polygon (only when user explicitly requests)\n\nData that stays local:\n\nCLI config at ~/.config/polymarket/config.json (user manages directly)\nSkill preferences in ~/polymarket-cli/memory.md\n\nCommand restrictions:\n\nAgent runs only read-only commands by default (markets, events, clob price/book, data)\nAgent never runs wallet commands (create, import, show, reset) — user must run these directly\nAgent never runs trading commands without explicit user confirmation each time\nAgent must never read ~/.config/polymarket/config.json or any files containing private keys"
      },
      {
        "title": "Trust",
        "body": "By using this skill, data is sent to Polymarket and the Polygon blockchain.\nOnly install if you trust these services with your trading data."
      },
      {
        "title": "Related Skills",
        "body": "Install with clawhub install <slug> if user confirms:\n\ntrading — General trading strategies\ncrypto-tools — Cryptocurrency utilities\npolygon — Polygon blockchain operations"
      },
      {
        "title": "Feedback",
        "body": "If useful: clawhub star polymarket-cli\nStay updated: clawhub sync"
      }
    ],
    "body": "Setup\n\nOn first use, read setup.md for wallet configuration and integration guidelines.\n\nWhen to Use\n\nUser needs to interact with Polymarket prediction markets. Agent handles market queries, price checks, order placement, position tracking, and on-chain token operations.\n\nArchitecture\n\nConfig lives in ~/.config/polymarket/. See memory-template.md for tracking preferences.\n\n~/.config/polymarket/\n├── config.json        # Private key, chain ID, signature type\n\n~/polymarket-cli/\n├── memory.md          # User preferences and tracked markets\n\nQuick Reference\nTopic\tFile\nSetup process\tsetup.md\nMemory template\tmemory-template.md\nCommand reference\tcommands.md\nCore Rules\n1. Read-Only by Default\n\nMost commands work without a wallet. Only use wallet-requiring commands when the user explicitly wants to trade:\n\nRead-only: markets, events, clob price/book, data positions\nRequires wallet: clob create-order, clob market-order, approve, ctf split/merge\n2. JSON Output for Processing\n\nUse -o json when parsing results programmatically:\n\npolymarket -o json markets list --limit 10\npolymarket -o json clob midpoint TOKEN_ID\n\n\nTable output is default for human-readable display.\n\n3. Token IDs Are Critical\n\nMost CLOB commands require the token ID (48331043336612883...), not the market slug:\n\n# Get token ID from market first\npolymarket markets get will-trump-win | grep token\n\n# Then use in CLOB commands\npolymarket clob book TOKEN_ID\npolymarket clob price TOKEN_ID --side buy\n\n4. Wallet Security — Restricted Commands\n\nThe agent NEVER runs wallet commands. These are user-only:\n\npolymarket wallet create — user runs directly\npolymarket wallet import — user runs directly\npolymarket wallet show — user runs directly\npolymarket wallet reset — user runs directly\n\nIf user asks the agent to run any wallet command, refuse and explain they must run it themselves for security.\n\n5. On-Chain Operations Need Gas\n\nCommands that write to blockchain require MATIC on Polygon:\n\napprove set (6 transactions)\nctf split/merge/redeem\n\nCheck balance before attempting.\n\n6. Rate Limits and Pagination\n\nUse --limit and --offset for large result sets:\n\npolymarket markets list --limit 50 --offset 100\n\n7. Verify Before Trading\n\nAlways show market details and current prices before placing orders:\n\npolymarket markets get SLUG\npolymarket clob midpoint TOKEN_ID\npolymarket clob spread TOKEN_ID\n\nCommon Traps\nMistake\tConsequence\nUsing slug instead of token ID in CLOB\tCommand fails silently or wrong market\nPlacing order without approve set first\tTransaction reverts\nForgetting --side in price queries\tReturns both sides, may confuse\nNot checking spread before market order\tSlippage on low liquidity markets\nRunning on-chain ops without MATIC\tTransaction fails\nExternal Endpoints\nEndpoint\tData Sent\tPurpose\nhttps://clob.polymarket.com\tOrders, queries\tCLOB API\nhttps://gamma-api.polymarket.com\tMarket data\tGamma API\nhttps://polygon-rpc.com\tTransactions\tPolygon RPC\n\nNo other data is sent externally.\n\nSecurity & Privacy\n\nData that leaves your machine:\n\nMarket queries sent to Polymarket APIs\nOrders and transactions sent to CLOB and Polygon (only when user explicitly requests)\n\nData that stays local:\n\nCLI config at ~/.config/polymarket/config.json (user manages directly)\nSkill preferences in ~/polymarket-cli/memory.md\n\nCommand restrictions:\n\nAgent runs only read-only commands by default (markets, events, clob price/book, data)\nAgent never runs wallet commands (create, import, show, reset) — user must run these directly\nAgent never runs trading commands without explicit user confirmation each time\nAgent must never read ~/.config/polymarket/config.json or any files containing private keys\nTrust\n\nBy using this skill, data is sent to Polymarket and the Polygon blockchain. Only install if you trust these services with your trading data.\n\nRelated Skills\n\nInstall with clawhub install <slug> if user confirms:\n\ntrading — General trading strategies\ncrypto-tools — Cryptocurrency utilities\npolygon — Polygon blockchain operations\nFeedback\nIf useful: clawhub star polymarket-cli\nStay updated: clawhub sync"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/ivangdavila/polymarket-cli",
    "publisherUrl": "https://clawhub.ai/ivangdavila/polymarket-cli",
    "owner": "ivangdavila",
    "version": "1.0.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/polymarket-cli",
    "downloadUrl": "https://openagent3.xyz/downloads/polymarket-cli",
    "agentUrl": "https://openagent3.xyz/skills/polymarket-cli/agent",
    "manifestUrl": "https://openagent3.xyz/skills/polymarket-cli/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/polymarket-cli/agent.md"
  }
}