# Send Simmer X402 to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- 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.
## Suggested prompts
### New install

```text
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.
```
### Upgrade existing

```text
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.
```
## Machine-readable fields
```json
{
  "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": {
    "downloadUrl": "/downloads/simmer-x402",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=simmer-x402",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "clawhub.json",
      "config.json",
      "requirements.txt",
      "x402_cli.py"
    ],
    "downloadMode": "redirect",
    "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."
      ]
    }
  },
  "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"
  }
}
```
## Documentation

### x402 Payments

Pay for x402-gated APIs using USDC on Base. This skill enables agents to autonomously make crypto payments when accessing paid web resources.

### When to Use This Skill

Use this skill when:

A skill or agent needs to fetch data from an x402-gated API (e.g., Kaito mindshare)
You encounter HTTP 402 Payment Required responses
You need to check your Base wallet balance (USDC + ETH)
You want to pay for Simmer premium endpoints beyond free tier rate limits

### Setup

Set your wallet private key
export EVM_PRIVATE_KEY=0x...your_private_key...

Falls 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.


Fund with USDC on Base

Send USDC to your wallet address on Base network
x402 payments on Base are fully gasless — you only need USDC, no ETH



Install dependencies
pip install x402[httpx,evm]

### Quick Commands

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

### Check balance

python x402_cli.py balance

x402 Wallet Balance
==============================
Address: 0x1234...5678
Network: Base Mainnet

USDC:  $42.50
ETH:   0.000000 ETH

### Fetch free endpoint (no payment needed)

python x402_cli.py fetch "https://api.kaito.ai/api/v1/tokens" --json

### Fetch Kaito mindshare data ($0.02/data point via x402)

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

### Fetch Kaito sentiment data ($0.02/data point via x402)

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

### Ask AlphaKek knowledge engine ($0.01 via x402)

python x402_cli.py fetch "https://api.alphakek.ai/x402/knowledge/ask" \\
  --method POST --body '{"question": "What is the current sentiment on BTC?", "search_mode": "fast"}' --json

### Fetch CoinGecko price data ($0.01 via x402)

python x402_cli.py fetch "https://pro-api.coingecko.com/api/v3/x402/simple/price?ids=bitcoin&vs_currencies=usd" --json

### Fetch Simmer premium endpoint

python x402_cli.py fetch "https://x402.simmer.markets/api/sdk/context/market-123" \\
  --header "Authorization: Bearer sk_live_..." --json

### Quicknode RPC — blockchain calls without API keys

# Get ETH balance on Ethereum mainnet
python x402_cli.py rpc ethereum-mainnet eth_getBalance 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 latest

# Get latest block on Polygon
python x402_cli.py rpc polygon-mainnet eth_blockNumber

# Get token balance on Base
python x402_cli.py rpc base-mainnet eth_call '{"to":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","data":"0x70a08231000000000000000000000000YOUR_ADDRESS"}' latest

Quicknode x402 supports 55+ networks (Ethereum, Polygon, Base, Arbitrum, Solana, Bitcoin, and more). $10 buys 1M RPC credits — each successful call costs 1 credit.

### Supported x402 Providers

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)

Kaito API docs: https://github.com/MetaSearch-IO/KaitoX402APIDocs
Quicknode x402 docs: https://x402.quicknode.com/llms.txt

### Configuration

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

Or set via config.json in the skill directory:

{
  "max_payment_usd": 10.00,
  "network": "mainnet"
}

### How It Works

Skill makes HTTP request to the target URL
If server returns 200 — done, no payment needed
If server returns 402 Payment Required — x402 SDK reads payment requirements
SDK signs a USDC transfer authorization on Base (no gas needed)
SDK retries request with payment signature
Server verifies payment, returns gated content

All payment handling is automatic via the official Coinbase x402 Python SDK.

### For Other Skills

Other skills can import x402 functions directly:

from skills.x402.x402_cli import x402_fetch

# Returns parsed JSON response
data = await x402_fetch("https://api.kaito.ai/api/payg/mindshare?token=BTC")

### Security

Uses the official Coinbase x402 Python SDK for payment signing
Private key never leaves your machine
Max payment safety cap prevents accidental overspend
Dry-run mode to preview payments before executing

Private key safety:

Store your key in a .env file, never pass it inline in shell history
Ensure .env is in your .gitignore — never commit private keys to git
Use a dedicated hot wallet with limited funds, not your main wallet
Rotate the key immediately if you suspect it was exposed

### Troubleshooting

"EVM_PRIVATE_KEY not set"

Set your wallet private key: export EVM_PRIVATE_KEY=0x...

"Insufficient USDC balance"

Fund your wallet with USDC on Base network
Run python x402_cli.py balance to check

"Payment exceeds max limit"

Increase limit: --max 50 or set X402_MAX_PAYMENT_USD=50

"Unsupported network in payment options"

Ensure you have USDC on Base. Some providers may offer other chains but this skill uses Base only.
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: adlai88
- Version: 1.0.5
## Source health
- Status: healthy
- Source download looks usable.
- Yavira can redirect you to the upstream package for this source.
- Health scope: source
- Reason: direct_download_ok
- Checked at: 2026-05-07T17:22:31.273Z
- Expires at: 2026-05-14T17:22:31.273Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/simmer-x402)
- [Send to Agent page](https://openagent3.xyz/skills/simmer-x402/agent)
- [JSON manifest](https://openagent3.xyz/skills/simmer-x402/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/simmer-x402/agent.md)
- [Download page](https://openagent3.xyz/downloads/simmer-x402)