# Send Polymarket Elon Tweets 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-elon-tweets",
    "name": "Polymarket Elon Tweets",
    "source": "tencent",
    "type": "skill",
    "category": "AI 智能",
    "sourceUrl": "https://clawhub.ai/adlai88/polymarket-elon-tweets",
    "canonicalUrl": "https://clawhub.ai/adlai88/polymarket-elon-tweets",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/polymarket-elon-tweets",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=polymarket-elon-tweets",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "clawhub.json",
      "config.json",
      "elon_tweets.py",
      "scripts/status.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-elon-tweets"
    },
    "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-elon-tweets",
    "downloadUrl": "https://openagent3.xyz/downloads/polymarket-elon-tweets",
    "agentUrl": "https://openagent3.xyz/skills/polymarket-elon-tweets/agent",
    "manifestUrl": "https://openagent3.xyz/skills/polymarket-elon-tweets/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/polymarket-elon-tweets/agent.md"
  }
}
```
## Documentation

### Polymarket Elon Tweet Trader

Trade "Elon Musk # tweets" markets on Polymarket using XTracker post count data.

### When to Use This Skill

Use this skill when the user wants to:

Trade Elon Musk tweet count markets automatically
Set up @noovd-style bucket trading
Check XTracker pace and stats for current tweet events
Monitor and exit existing tweet market positions
Configure bucket spread or entry thresholds

### How the Strategy Works

Polymarket runs weekly "How many tweets will Elon post?" events with range buckets (e.g., 200-219, 220-239, 240-259). Exactly one bucket resolves YES = $1. The strategy:

Get XTracker pace — XTracker tracks Elon's real-time post count and projects the final total
Find center bucket — The bucket containing XTracker's projected pace
Buy adjacent buckets — Buy the center + neighbors (configurable spread)
Check combined cost — Only buy if the sum of bucket prices < $1 (the +EV threshold)
One bucket pays $1 — When the event resolves, one of your buckets pays $1, covering costs

### Setup Flow

When user asks to install or configure this skill:

Install the Simmer SDK
pip install simmer-sdk



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)

Max bucket sum: Combined price threshold (default 90¢)
Max position: Amount per bucket (default $5.00)
Bucket spread: How many neighbors to buy (default 1 = center ± 1)
Exit threshold: When to sell (default 65¢)



Save settings to config.json or environment variables


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

### Configuration

SettingEnv VariableConfig KeyDefaultDescriptionMax bucket sumSIMMER_ELON_MAX_BUCKET_SUMmax_bucket_sum0.90Only buy if cluster prices sum < thisMax positionSIMMER_ELON_MAX_POSITIONmax_position_usd5.00Maximum USD per bucketBucket spreadSIMMER_ELON_BUCKET_SPREADbucket_spread1Neighbors on each side (1 = 3 buckets)Smart sizing %SIMMER_ELON_SIZING_PCTsizing_pct0.05% of balance per tradeMax trades/runSIMMER_ELON_MAX_TRADESmax_trades_per_run6Maximum trades per scan cycleExit thresholdSIMMER_ELON_EXITexit_threshold0.65Sell when bucket price above thisSlippage maxSIMMER_ELON_SLIPPAGE_MAXslippage_max_pct0.05Skip trade if slippage exceeds thisMin positionSIMMER_ELON_MIN_POSITIONmin_position_usd2.00Floor for smart sizing (USD)Data sourceSIMMER_ELON_DATA_SOURCEdata_sourcextrackerData source (xtracker)

Config priority: config.json > environment variables > defaults.

### 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 elon_tweets.py

# Execute real trades
python elon_tweets.py --live

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

# Show XTracker stats only
python elon_tweets.py --stats

# Check positions only
python elon_tweets.py --positions

# View config
python elon_tweets.py --config

# Update config
python elon_tweets.py --set max_position_usd=10.00

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

# Quiet mode — only output on trades/errors (ideal for cron)
python elon_tweets.py --live --quiet

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

### How It Works

Each cycle the script:

Fetches active XTracker trackings for Elon Musk tweet events
Gets real-time stats: current count, projected pace, days remaining
Searches Simmer for matching tweet count markets (auto-imports if missing)
Finds the bucket matching XTracker's pace projection
Evaluates adjacent buckets (center ± spread)
Entry: If sum of cluster prices < max_bucket_sum → BUY each bucket
Exit: Checks open positions, sells if any bucket price > exit_threshold
Safeguards: Checks context for flip-flop warnings, slippage
Tagging: All trades tagged with sdk:elon-tweets for tracking

### Auto-Import

If tweet count markets aren't on Simmer yet, the skill automatically imports them:

Derives the Polymarket event URL from the XTracker tracking title
Uses the SDK import endpoint (supports multi-outcome events)
Imports all outcome buckets as a group
Counts as 1 daily import regardless of bucket count

### Smart Sizing

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

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

### Safeguards

Before trading, the skill checks:

Flip-flop warning: Skips if you've been reversing too much
Slippage: Skips if estimated slippage > 15%
Market status: Skips closed or resolved markets
Extreme prices: Skips buckets priced > 98% or < 2%

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

### Source Tagging

All trades are tagged with source: "sdk:elon-tweets". This means:

Portfolio shows breakdown by strategy
Other skills won't sell your tweet positions
You can track tweet trading P&L separately

### Example Output

🐦 Simmer Elon Tweet Trader
==================================================

⚙️ Configuration:
  Max bucket sum:  $0.90
  Max position:    $5.00
  Bucket spread:   1 (center ± 1 = 3 buckets)
  Exit threshold:  65%
  Data source:     xtracker

📊 XTracker Stats:
  Tracking: Elon Musk # tweets Feb 13 - Feb 20
  Current count: 187 posts
  Pace: 243 projected
  Days remaining: 2.3

🎯 Target cluster: 240-259 (center) + 220-239, 260-279
  240-259: $0.35
  220-239: $0.22
  260-279: $0.18
  Cluster sum: $0.75 (< $0.90 threshold) ✅

  Executing trades...
  ✅ Bought 14.3 shares of 240-259 @ $0.35
  ✅ Bought 22.7 shares of 220-239 @ $0.22
  ✅ Bought 27.8 shares of 260-279 @ $0.18

📊 Summary:
  Events scanned: 2
  Clusters evaluated: 2
  Trades executed: 3
  Exits: 0

### Troubleshooting

"No XTracker trackings found"

XTracker may not have active Elon tweet events
New events usually start on Wednesdays/Thursdays

"Cluster sum $X.XX exceeds threshold"

Buckets are too expensive — edge is too thin
Wait for prices to drop or widen bucket_spread

"No matching Simmer markets found"

Markets may not be imported yet — skill will auto-import on next run
Check that your API key has import capacity (10/day free, 50/day Pro)

"Safeguard blocked: flip-flop warning"

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

"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.1.1
## 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-elon-tweets)
- [Send to Agent page](https://openagent3.xyz/skills/polymarket-elon-tweets/agent)
- [JSON manifest](https://openagent3.xyz/skills/polymarket-elon-tweets/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/polymarket-elon-tweets/agent.md)
- [Download page](https://openagent3.xyz/downloads/polymarket-elon-tweets)