{
  "schemaVersion": "1.0",
  "item": {
    "slug": "simmer-x402",
    "name": "Simmer X402",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/adlai88/simmer-x402",
    "canonicalUrl": "https://clawhub.ai/adlai88/simmer-x402",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/simmer-x402",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=simmer-x402",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md",
      "clawhub.json",
      "config.json",
      "requirements.txt",
      "x402_cli.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-05-07T17:22:31.273Z",
      "expiresAt": "2026-05-14T17:22:31.273Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report",
        "contentDisposition": "attachment; filename=\"afrexai-annual-report-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/simmer-x402"
    },
    "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/simmer-x402",
    "agentPageUrl": "https://openagent3.xyz/skills/simmer-x402/agent",
    "manifestUrl": "https://openagent3.xyz/skills/simmer-x402/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/simmer-x402/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": "x402 Payments",
        "body": "Pay for x402-gated APIs using USDC on Base. This skill enables agents to autonomously make crypto payments when accessing paid web resources."
      },
      {
        "title": "When to Use This Skill",
        "body": "Use this skill when:\n\nA skill or agent needs to fetch data from an x402-gated API (e.g., Kaito mindshare)\nYou encounter HTTP 402 Payment Required responses\nYou need to check your Base wallet balance (USDC + ETH)\nYou want to pay for Simmer premium endpoints beyond free tier rate limits"
      },
      {
        "title": "Setup",
        "body": "Set your wallet private key\nexport EVM_PRIVATE_KEY=0x...your_private_key...\n\nFalls back to WALLET_PRIVATE_KEY if EVM_PRIVATE_KEY is not set (same key Simmer/Polymarket users already have). Your EVM address works on all chains — Polygon for trading, Base for x402 payments.\n\n\nFund with USDC on Base\n\nSend USDC to your wallet address on Base network\nx402 payments on Base are fully gasless — you only need USDC, no ETH\n\n\n\nInstall dependencies\npip install x402[httpx,evm]"
      },
      {
        "title": "Quick Commands",
        "body": "CommandDescriptionpython x402_cli.py balanceCheck USDC and ETH balances on Basepython x402_cli.py fetch <url>Fetch URL with automatic x402 paymentpython x402_cli.py fetch <url> --jsonSame but output raw JSON onlypython x402_cli.py fetch <url> --dry-runShow payment info without payingpython x402_cli.py fetch <url> --max 5.00Override max payment limitpython x402_cli.py rpc <network> <method> [params...]Make RPC call via Quicknode x402"
      },
      {
        "title": "Check balance",
        "body": "python x402_cli.py balance\n\nx402 Wallet Balance\n==============================\nAddress: 0x1234...5678\nNetwork: Base Mainnet\n\nUSDC:  $42.50\nETH:   0.000000 ETH"
      },
      {
        "title": "Fetch free endpoint (no payment needed)",
        "body": "python x402_cli.py fetch \"https://api.kaito.ai/api/v1/tokens\" --json"
      },
      {
        "title": "Fetch Kaito mindshare data ($0.02/data point via x402)",
        "body": "python x402_cli.py fetch \"https://api.kaito.ai/api/payg/mindshare?token=BTC&start_date=2026-02-13&end_date=2026-02-14\" --json"
      },
      {
        "title": "Fetch Kaito sentiment data ($0.02/data point via x402)",
        "body": "python x402_cli.py fetch \"https://api.kaito.ai/api/payg/sentiment?token=BTC&start_date=2026-02-13&end_date=2026-02-14\" --json"
      },
      {
        "title": "Ask AlphaKek knowledge engine ($0.01 via x402)",
        "body": "python x402_cli.py fetch \"https://api.alphakek.ai/x402/knowledge/ask\" \\\n  --method POST --body '{\"question\": \"What is the current sentiment on BTC?\", \"search_mode\": \"fast\"}' --json"
      },
      {
        "title": "Fetch CoinGecko price data ($0.01 via x402)",
        "body": "python x402_cli.py fetch \"https://pro-api.coingecko.com/api/v3/x402/simple/price?ids=bitcoin&vs_currencies=usd\" --json"
      },
      {
        "title": "Fetch Simmer premium endpoint",
        "body": "python x402_cli.py fetch \"https://x402.simmer.markets/api/sdk/context/market-123\" \\\n  --header \"Authorization: Bearer sk_live_...\" --json"
      },
      {
        "title": "Quicknode RPC — blockchain calls without API keys",
        "body": "# Get ETH balance on Ethereum mainnet\npython x402_cli.py rpc ethereum-mainnet eth_getBalance 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 latest\n\n# Get latest block on Polygon\npython x402_cli.py rpc polygon-mainnet eth_blockNumber\n\n# Get token balance on Base\npython x402_cli.py rpc base-mainnet eth_call '{\"to\":\"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913\",\"data\":\"0x70a08231000000000000000000000000YOUR_ADDRESS\"}' latest\n\nQuicknode x402 supports 55+ networks (Ethereum, Polygon, Base, Arbitrum, Solana, Bitcoin, and more). $10 buys 1M RPC credits — each successful call costs 1 credit."
      },
      {
        "title": "Supported x402 Providers",
        "body": "ProviderEndpointPriceDescriptionKaito/api/payg/mindshare$0.02/data pointToken mindshare time seriesKaito/api/payg/sentiment$0.02/data pointToken sentiment time seriesKaito/api/payg/narrative_mindshare$0.02/data pointNarrative mindshare time seriesKaito/api/payg/smart_followers$0.20/requestSmart follower metricsAlphaKek/x402/knowledge/ask$0.01/requestAI knowledge engine (POST, search_mode: fast/deep/ultrafast)CoinGecko/api/v3/x402/simple/price$0.01/requestToken price dataSimmer/api/sdk/context/:id$0.005/requestMarket context (rate limit bypass)Simmer/api/sdk/briefing$0.005/requestPortfolio briefing (rate limit bypass)Simmer/api/sdk/markets/import$0.005/requestMarket import (daily quota bypass)Quicknode/:network (55+ networks)$10/1M creditsPay-per-request RPC access (no API key needed)\n\nKaito API docs: https://github.com/MetaSearch-IO/KaitoX402APIDocs\nQuicknode x402 docs: https://x402.quicknode.com/llms.txt"
      },
      {
        "title": "Configuration",
        "body": "SettingEnvironment VariableDefaultDescriptionWallet keyEVM_PRIVATE_KEY(required)Hex-encoded private key (falls back to WALLET_PRIVATE_KEY)Max paymentX402_MAX_PAYMENT_USD10.00Safety cap per requestNetworkX402_NETWORKmainnetmainnet or testnet\n\nOr set via config.json in the skill directory:\n\n{\n  \"max_payment_usd\": 10.00,\n  \"network\": \"mainnet\"\n}"
      },
      {
        "title": "How It Works",
        "body": "Skill makes HTTP request to the target URL\nIf server returns 200 — done, no payment needed\nIf server returns 402 Payment Required — x402 SDK reads payment requirements\nSDK signs a USDC transfer authorization on Base (no gas needed)\nSDK retries request with payment signature\nServer verifies payment, returns gated content\n\nAll payment handling is automatic via the official Coinbase x402 Python SDK."
      },
      {
        "title": "For Other Skills",
        "body": "Other skills can import x402 functions directly:\n\nfrom skills.x402.x402_cli import x402_fetch\n\n# Returns parsed JSON response\ndata = await x402_fetch(\"https://api.kaito.ai/api/payg/mindshare?token=BTC\")"
      },
      {
        "title": "Security",
        "body": "Uses the official Coinbase x402 Python SDK for payment signing\nPrivate key never leaves your machine\nMax payment safety cap prevents accidental overspend\nDry-run mode to preview payments before executing\n\nPrivate key safety:\n\nStore your key in a .env file, never pass it inline in shell history\nEnsure .env is in your .gitignore — never commit private keys to git\nUse a dedicated hot wallet with limited funds, not your main wallet\nRotate the key immediately if you suspect it was exposed"
      },
      {
        "title": "Troubleshooting",
        "body": "\"EVM_PRIVATE_KEY not set\"\n\nSet your wallet private key: export EVM_PRIVATE_KEY=0x...\n\n\"Insufficient USDC balance\"\n\nFund your wallet with USDC on Base network\nRun python x402_cli.py balance to check\n\n\"Payment exceeds max limit\"\n\nIncrease limit: --max 50 or set X402_MAX_PAYMENT_USD=50\n\n\"Unsupported network in payment options\"\n\nEnsure you have USDC on Base. Some providers may offer other chains but this skill uses Base only."
      }
    ],
    "body": "x402 Payments\n\nPay for x402-gated APIs using USDC on Base. This skill enables agents to autonomously make crypto payments when accessing paid web resources.\n\nWhen to Use This Skill\n\nUse this skill when:\n\nA skill or agent needs to fetch data from an x402-gated API (e.g., Kaito mindshare)\nYou encounter HTTP 402 Payment Required responses\nYou need to check your Base wallet balance (USDC + ETH)\nYou want to pay for Simmer premium endpoints beyond free tier rate limits\nSetup\n\nSet your wallet private key\n\nexport EVM_PRIVATE_KEY=0x...your_private_key...\n\n\nFalls back to WALLET_PRIVATE_KEY if EVM_PRIVATE_KEY is not set (same key Simmer/Polymarket users already have). Your EVM address works on all chains — Polygon for trading, Base for x402 payments.\n\nFund with USDC on Base\n\nSend USDC to your wallet address on Base network\nx402 payments on Base are fully gasless — you only need USDC, no ETH\n\nInstall dependencies\n\npip install x402[httpx,evm]\n\nQuick Commands\nCommand\tDescription\npython x402_cli.py balance\tCheck USDC and ETH balances on Base\npython x402_cli.py fetch <url>\tFetch URL with automatic x402 payment\npython x402_cli.py fetch <url> --json\tSame but output raw JSON only\npython x402_cli.py fetch <url> --dry-run\tShow payment info without paying\npython x402_cli.py fetch <url> --max 5.00\tOverride max payment limit\npython x402_cli.py rpc <network> <method> [params...]\tMake RPC call via Quicknode x402\nExamples\nCheck balance\npython x402_cli.py balance\n\nx402 Wallet Balance\n==============================\nAddress: 0x1234...5678\nNetwork: Base Mainnet\n\nUSDC:  $42.50\nETH:   0.000000 ETH\n\nFetch free endpoint (no payment needed)\npython x402_cli.py fetch \"https://api.kaito.ai/api/v1/tokens\" --json\n\nFetch Kaito mindshare data ($0.02/data point via x402)\npython x402_cli.py fetch \"https://api.kaito.ai/api/payg/mindshare?token=BTC&start_date=2026-02-13&end_date=2026-02-14\" --json\n\nFetch Kaito sentiment data ($0.02/data point via x402)\npython x402_cli.py fetch \"https://api.kaito.ai/api/payg/sentiment?token=BTC&start_date=2026-02-13&end_date=2026-02-14\" --json\n\nAsk AlphaKek knowledge engine ($0.01 via x402)\npython x402_cli.py fetch \"https://api.alphakek.ai/x402/knowledge/ask\" \\\n  --method POST --body '{\"question\": \"What is the current sentiment on BTC?\", \"search_mode\": \"fast\"}' --json\n\nFetch CoinGecko price data ($0.01 via x402)\npython x402_cli.py fetch \"https://pro-api.coingecko.com/api/v3/x402/simple/price?ids=bitcoin&vs_currencies=usd\" --json\n\nFetch Simmer premium endpoint\npython x402_cli.py fetch \"https://x402.simmer.markets/api/sdk/context/market-123\" \\\n  --header \"Authorization: Bearer sk_live_...\" --json\n\nQuicknode RPC — blockchain calls without API keys\n# Get ETH balance on Ethereum mainnet\npython x402_cli.py rpc ethereum-mainnet eth_getBalance 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 latest\n\n# Get latest block on Polygon\npython x402_cli.py rpc polygon-mainnet eth_blockNumber\n\n# Get token balance on Base\npython x402_cli.py rpc base-mainnet eth_call '{\"to\":\"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913\",\"data\":\"0x70a08231000000000000000000000000YOUR_ADDRESS\"}' latest\n\n\nQuicknode x402 supports 55+ networks (Ethereum, Polygon, Base, Arbitrum, Solana, Bitcoin, and more). $10 buys 1M RPC credits — each successful call costs 1 credit.\n\nSupported x402 Providers\nProvider\tEndpoint\tPrice\tDescription\nKaito\t/api/payg/mindshare\t$0.02/data point\tToken mindshare time series\nKaito\t/api/payg/sentiment\t$0.02/data point\tToken sentiment time series\nKaito\t/api/payg/narrative_mindshare\t$0.02/data point\tNarrative mindshare time series\nKaito\t/api/payg/smart_followers\t$0.20/request\tSmart follower metrics\nAlphaKek\t/x402/knowledge/ask\t$0.01/request\tAI knowledge engine (POST, search_mode: fast/deep/ultrafast)\nCoinGecko\t/api/v3/x402/simple/price\t$0.01/request\tToken price data\nSimmer\t/api/sdk/context/:id\t$0.005/request\tMarket context (rate limit bypass)\nSimmer\t/api/sdk/briefing\t$0.005/request\tPortfolio briefing (rate limit bypass)\nSimmer\t/api/sdk/markets/import\t$0.005/request\tMarket import (daily quota bypass)\nQuicknode\t/:network (55+ networks)\t$10/1M credits\tPay-per-request RPC access (no API key needed)\n\nKaito API docs: https://github.com/MetaSearch-IO/KaitoX402APIDocs Quicknode x402 docs: https://x402.quicknode.com/llms.txt\n\nConfiguration\nSetting\tEnvironment Variable\tDefault\tDescription\nWallet key\tEVM_PRIVATE_KEY\t(required)\tHex-encoded private key (falls back to WALLET_PRIVATE_KEY)\nMax payment\tX402_MAX_PAYMENT_USD\t10.00\tSafety cap per request\nNetwork\tX402_NETWORK\tmainnet\tmainnet or testnet\n\nOr set via config.json in the skill directory:\n\n{\n  \"max_payment_usd\": 10.00,\n  \"network\": \"mainnet\"\n}\n\nHow It Works\nSkill makes HTTP request to the target URL\nIf server returns 200 — done, no payment needed\nIf server returns 402 Payment Required — x402 SDK reads payment requirements\nSDK signs a USDC transfer authorization on Base (no gas needed)\nSDK retries request with payment signature\nServer verifies payment, returns gated content\n\nAll payment handling is automatic via the official Coinbase x402 Python SDK.\n\nFor Other Skills\n\nOther skills can import x402 functions directly:\n\nfrom skills.x402.x402_cli import x402_fetch\n\n# Returns parsed JSON response\ndata = await x402_fetch(\"https://api.kaito.ai/api/payg/mindshare?token=BTC\")\n\nSecurity\nUses the official Coinbase x402 Python SDK for payment signing\nPrivate key never leaves your machine\nMax payment safety cap prevents accidental overspend\nDry-run mode to preview payments before executing\n\nPrivate key safety:\n\nStore your key in a .env file, never pass it inline in shell history\nEnsure .env is in your .gitignore — never commit private keys to git\nUse a dedicated hot wallet with limited funds, not your main wallet\nRotate the key immediately if you suspect it was exposed\nTroubleshooting\n\n\"EVM_PRIVATE_KEY not set\"\n\nSet your wallet private key: export EVM_PRIVATE_KEY=0x...\n\n\"Insufficient USDC balance\"\n\nFund your wallet with USDC on Base network\nRun python x402_cli.py balance to check\n\n\"Payment exceeds max limit\"\n\nIncrease limit: --max 50 or set X402_MAX_PAYMENT_USD=50\n\n\"Unsupported network in payment options\"\n\nEnsure you have USDC on Base. Some providers may offer other chains but this skill uses Base only."
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/adlai88/simmer-x402",
    "publisherUrl": "https://clawhub.ai/adlai88/simmer-x402",
    "owner": "adlai88",
    "version": "1.0.5",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/simmer-x402",
    "downloadUrl": "https://openagent3.xyz/downloads/simmer-x402",
    "agentUrl": "https://openagent3.xyz/skills/simmer-x402/agent",
    "manifestUrl": "https://openagent3.xyz/skills/simmer-x402/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/simmer-x402/agent.md"
  }
}