# Send Polymarket Weather Trader 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": "polymarket-weather-trader",
    "name": "Polymarket Weather Trader",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/adlai88/polymarket-weather-trader",
    "canonicalUrl": "https://clawhub.ai/adlai88/polymarket-weather-trader",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/polymarket-weather-trader",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=polymarket-weather-trader",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "clawhub.json",
      "config.json",
      "scripts/status.py",
      "weather_trader.py"
    ],
    "downloadMode": "redirect",
    "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-weather-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."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/polymarket-weather-trader",
    "downloadUrl": "https://openagent3.xyz/downloads/polymarket-weather-trader",
    "agentUrl": "https://openagent3.xyz/skills/polymarket-weather-trader/agent",
    "manifestUrl": "https://openagent3.xyz/skills/polymarket-weather-trader/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/polymarket-weather-trader/agent.md"
  }
}
```
## Documentation

### Polymarket Weather Trader

Trade temperature markets on Polymarket using NOAA forecast data.

This is a template. The default signal is NOAA temperature forecasts — remix it with other weather APIs, different forecast models, or additional market types (precipitation, wind, etc.). The skill handles all the plumbing (market discovery, NOAA parsing, trade execution, safeguards). Your agent provides the alpha.

### When to Use This Skill

Use this skill when the user wants to:

Trade weather markets automatically
Set up gopfan2-style temperature trading
Buy low on weather predictions
Check their weather trading positions
Configure trading thresholds or locations

### What's New in v1.14.0

Fixed env var names to match autotune registry (old names still work as aliases):

SIMMER_WEATHER_ENTRY → SIMMER_WEATHER_ENTRY_THRESHOLD
SIMMER_WEATHER_EXIT → SIMMER_WEATHER_EXIT_THRESHOLD
SIMMER_WEATHER_MAX_POSITION → SIMMER_WEATHER_MAX_POSITION_USD
SIMMER_WEATHER_MAX_TRADES → SIMMER_WEATHER_MAX_TRADES_PER_RUN


New tunable: SIMMER_WEATHER_SLIPPAGE_MAX — adjustable slippage safeguard (default 15%). Set higher for research mode on illiquid markets.
New tunable: SIMMER_WEATHER_MIN_LIQUIDITY — skip markets with liquidity below this USD threshold (default 0 = disabled). Pre-filters thin markets before execution.
SIMMER_WEATHER_LOCATIONS and SIMMER_WEATHER_BINARY_ONLY now exposed as autotune tunables.

### v1.13.0

Binary Only Mode: New SIMMER_WEATHER_BINARY_ONLY config to skip range-bucket events (e.g., "NYC 34-35°F") and only trade binary yes/no weather markets

### v1.2.0

Max Trades Per Run: New SIMMER_WEATHER_MAX_TRADES config to limit trades per scan cycle (default: 5)

### v1.1.1

Status Script: New scripts/status.py for quick balance and position checks
API Reference: Added Quick Commands section with API endpoints

### v1.1.0

Source Tagging: All trades tagged with sdk:weather for portfolio tracking
Smart Sizing: Position sizing based on available balance (--smart-sizing)
Context Safeguards: Checks for flip-flop warnings, slippage, time decay
Price Trend Detection: Detects recent price drops for stronger signals

### Setup Flow

When user asks to install or configure this skill:

Ask for Simmer API key

They can get it from simmer.markets/dashboard → SDK tab
Store in environment as SIMMER_API_KEY



Ask for wallet private key (required for live trading)

This is the private key for their Polymarket wallet (the wallet that holds USDC)
Store in environment as WALLET_PRIVATE_KEY
The SDK uses this to sign orders client-side automatically — no manual signing needed



Ask about settings (or confirm defaults)

Entry threshold: When to buy (default 15¢)
Exit threshold: When to sell (default 45¢)
Max position: Amount per trade (default $2.00)
Locations: Which cities to trade (default NYC)



Save settings to environment variables


Set up cron (disabled by default — user must enable scheduling)

### Configuration

SettingEnvironment VariableDefaultDescriptionEntry thresholdSIMMER_WEATHER_ENTRY_THRESHOLD0.15Buy when price below thisExit thresholdSIMMER_WEATHER_EXIT_THRESHOLD0.45Sell when price above thisMax positionSIMMER_WEATHER_MAX_POSITION_USD2.00Maximum USD per tradeMax trades/runSIMMER_WEATHER_MAX_TRADES_PER_RUN5Maximum trades per scan cycleLocationsSIMMER_WEATHER_LOCATIONSNYCComma-separated cities (NYC, Chicago, Seattle, Atlanta, Dallas, Miami)Binary onlySIMMER_WEATHER_BINARY_ONLYfalseSkip range-bucket events (e.g., "34-35°F"), only trade binary yes/no marketsSmart sizing %SIMMER_WEATHER_SIZING_PCT0.05% of balance per tradeSlippage maxSIMMER_WEATHER_SLIPPAGE_MAX0.15Skip trades with slippage above this (0.15 = 15%)Min liquiditySIMMER_WEATHER_MIN_LIQUIDITY0Skip markets with liquidity below this USD amount (0 = disabled)

Legacy env var aliases (still accepted for backwards compatibility): SIMMER_WEATHER_ENTRY, SIMMER_WEATHER_EXIT, SIMMER_WEATHER_MAX_POSITION, SIMMER_WEATHER_MAX_TRADES

Supported locations: NYC, Chicago, Seattle, Atlanta, Dallas, Miami

### Quick Commands

# Check account balance and positions
python scripts/status.py

# Detailed position list
python scripts/status.py --positions

API Reference:

Base URL: https://api.simmer.markets
Auth: Authorization: Bearer $SIMMER_API_KEY
Portfolio: GET /api/sdk/portfolio
Positions: GET /api/sdk/positions

### Running the Skill

# Dry run (default — shows opportunities, no trades)
python weather_trader.py

# Execute real trades
python weather_trader.py --live

# With smart position sizing (uses portfolio balance)
python weather_trader.py --live --smart-sizing

# Check positions only
python weather_trader.py --positions

# View config
python weather_trader.py --config

# Disable safeguards (not recommended)
python weather_trader.py --no-safeguards

# Disable trend detection
python weather_trader.py --no-trends

# Quiet mode — only output on trades/errors (ideal for high-frequency runs)
python weather_trader.py --live --quiet

# Combine: frequent scanning, minimal noise
python weather_trader.py --live --smart-sizing --quiet

### How It Works

Each cycle the script:

Fetches active weather markets from Simmer API
Groups markets by event (each temperature day is one event)
Parses event names to get location and date
Fetches NOAA forecast for that location/date
Finds the temperature bucket that matches the forecast
Safeguards: Checks context for flip-flop warnings, slippage, time decay
Trend Detection: Looks for recent price drops (stronger buy signal)
Entry: If bucket price < threshold and safeguards pass → BUY
Exit: Checks open positions, sells if price > exit threshold
Tagging: All trades tagged with sdk:weather for tracking

### Smart Sizing

With --smart-sizing, position size is calculated as:

5% of available USDC balance (configurable via SIMMER_WEATHER_SIZING_PCT)
Capped at max position setting ($2.00 default)
Falls back to fixed size if portfolio unavailable

This prevents over-deployment and scales with your account size.

### Safeguards

Before trading, the skill checks:

Flip-flop warning: Skips if you've been reversing too much
Slippage: Skips if estimated slippage > 15%
Time decay: Skips if market resolves in < 2 hours
Market status: Skips if market already resolved

Disable with --no-safeguards (not recommended).

### Source Tagging

All trades are tagged with source: "sdk:weather". This means:

Portfolio shows breakdown by strategy
Copytrading skill won't sell your weather positions
You can track weather P&L separately

### Example Output

🌤️ Simmer Weather Trading Skill
==================================================

⚙️ Configuration:
  Entry threshold: 15% (buy below this)
  Exit threshold:  45% (sell above this)
  Max position:    $2.00
  Locations:       NYC
  Smart sizing:    ✓ Enabled
  Safeguards:      ✓ Enabled
  Trend detection: ✓ Enabled

💰 Portfolio:
  Balance: $150.00
  Exposure: $45.00
  Positions: 8

📍 NYC 2026-01-28 (high temp)
  NOAA forecast: 34°F
  Matching bucket: 34-35°F @ $0.12
  💡 Smart sizing: $2.00 (capped at max position)
  ✅ Below threshold ($0.15) - BUY opportunity! 📉 (dropped 15% in 24h)
  Executing trade...
  ✅ Bought 62.5 shares @ $0.12

📊 Summary:
  Events scanned: 12
  Entry opportunities: 1
  Trades executed: 1

### Troubleshooting

"Safeguard blocked: Severe flip-flop warning"

You've been changing direction too much on this market
Wait before trading again

"Slippage too high"

Market is illiquid, reduce position size or skip

"Resolves in Xh - too soon"

Market resolving soon, risk is elevated

"No weather markets found"

Weather markets may not be active (seasonal)

"External wallet requires a pre-signed order"

WALLET_PRIVATE_KEY is not set in the environment
The SDK signs orders automatically when this env var is present — no manual signing code needed
Fix: export WALLET_PRIVATE_KEY=0x<your-polymarket-wallet-private-key>
Do NOT attempt to sign orders manually or modify the skill code — the SDK handles it

"Balance shows $0 but I have USDC on Polygon"

Polymarket uses USDC.e (bridged USDC, contract 0x2791Bca1f2de4661ED88A30C99A7a9449Aa84174) — not native USDC
If you bridged USDC to Polygon recently, you likely received native USDC
Swap native USDC to USDC.e, then retry

"API key invalid"

Get new key from simmer.markets/dashboard → SDK tab
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: adlai88
- Version: 1.15.0
## 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-04-30T16:55:25.780Z
- Expires at: 2026-05-07T16:55:25.780Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/polymarket-weather-trader)
- [Send to Agent page](https://openagent3.xyz/skills/polymarket-weather-trader/agent)
- [JSON manifest](https://openagent3.xyz/skills/polymarket-weather-trader/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/polymarket-weather-trader/agent.md)
- [Download page](https://openagent3.xyz/downloads/polymarket-weather-trader)