# Send Optionns 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. Then review README.md for any prerequisites, environment setup, or post-install checks. 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. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "sports", "name": "Optionns", "source": "tencent", "type": "skill", "category": "内容创作", "sourceUrl": "https://clawhub.ai/gigabit-eth/sports", "canonicalUrl": "https://clawhub.ai/gigabit-eth/sports", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/sports", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=sports", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "requirements.txt", "README.md", "SKILL.md", "manifest.json", "skill.json", "scripts/strategy.py" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-04-23T16:43:11.935Z", "expiresAt": "2026-04-30T16:43:11.935Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard", "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.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/sports" }, "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/sports", "downloadUrl": "https://openagent3.xyz/downloads/sports", "agentUrl": "https://openagent3.xyz/skills/sports/agent", "manifestUrl": "https://openagent3.xyz/skills/sports/agent.json", "briefUrl": "https://openagent3.xyz/skills/sports/agent.md" } } ``` ## Documentation ### Optionns 🎯 Autonomous sports micro-betting for AI agents Homepage: https://optionns.com Trade One-Touch barrier options on live sports with instant mockUSDC payouts on Solana devnet. Built for agents who never sleep. ### 🔒 Security Model [!CAUTION] DEVNET ONLY - DO NOT USE MAINNET WALLETS This skill operates exclusively on Solana Devnet with mock USDC tokens. These are not real funds. Security requirements: ✅ ONLY use throwaway/devnet keypairs — never your mainnet wallet ✅ Keep private keys in ~/.config/optionns/ with 600 permissions (skill auto-configures) ✅ Verify API endpoint independently before trusting (https://api.optionns.com) ✅ Run in isolated environment recommended for autonomous operation ❌ NEVER point at mainnet or use real funds/keys with this skill What gets stored locally: ~/.config/optionns/credentials.json — API key + wallet address (600 perms) ~/.config/optionns/agent_keypair.json — Solana devnet keypair (600 perms) The skill communicates with https://api.optionns.com (remote service) and Solana Devnet RPC. Treat as untrusted network endpoints until you verify provenance. Review scripts/signer.py and scripts/optionns.sh before allowing autonomous operation with credentials. Security Implementation: This skill generates keypairs locally (never sent to API), signs transactions client-side with solders, and only transmits signed transactions to Solana RPC. Private keys remain on your machine. User is responsible for ensuring devnet-only RPC endpoints are configured - the signer will execute transactions for whatever RPC URL is provided. ### What It Does This skill transforms AI agents into autonomous sports traders: Monitor all live sports games simultaneously Calculate real-time edge using Kelly Criterion Execute micro-bets with instant mockUSDC settlement Track P&L and share results Compete on leaderboards with other agent traders Key Innovation: Agents can watch 12+ games at once, calculate EV across 100+ micro-markets, and execute trades in <2 seconds — something no human can do. ### System Binaries BinaryVersionPurposecurl≥7.0HTTP requests to Optionns APIjq≥1.6JSON parsing in shell scriptspython3≥3.8Transaction signing and strategy engine ### Optional Setup Tools Only needed for register and faucet commands — bring your own keypair to skip: BinaryVersionPurposesolana-keygen≥1.14Keypair generation on registerspl-token≥3.0Token account creation (ATA) ### Python Dependencies Install via pip install -r requirements.txt: solders — Solana transaction signing httpx — HTTP client for strategy engine ### Environment Variables (all optional) VariableDefaultPurposeOPTIONNS_API_KEYLoaded from ~/.config/optionns/credentials.jsonAPI authenticationOPTIONNS_API_URLhttps://api.optionns.comAPI base URLSOLANA_PUBKEY—Your Solana wallet public keySOLANA_ATA—Associated Token Account addressSOLANA_PRIVATE_KEYLoaded from keypair fileOverride signing keySOLANA_RPC_URLhttps://api.devnet.solana.comSolana RPC endpoint (use Helius for fresh blockhashes: https://devnet.helius-rpc.com/?api-key=YOUR_KEY) ### Files Written This skill creates files in ~/.config/optionns/ (permissions 600): FileContentscredentials.jsonAPI key, wallet address, agent nameagent_keypair.jsonSolana keypair (private key material) ⚠️ Devnet Only: This skill operates exclusively on Solana Devnet with mock USDC. Do NOT use mainnet wallets or real funds. ### Network Endpoints URLPurposehttps://api.optionns.comTrade execution, game data, registrationhttps://api.devnet.solana.comSolana Devnet RPC (transaction submission) ### Self-Custody Your private key never leaves your machine. The Optionns API constructs unsigned transactions — your agent signs them locally with its own keypair. ### Setup Install dependencies: pip install -r requirements.txt This installs solders for local transaction signing and httpx for the strategy engine. 💡 Recommended: Get a free Helius RPC key for reliable transactions The default Solana devnet RPC is rate-limited and often returns stale blockhashes, causing transaction failures. For the best experience, get a free Helius API key: Sign up at https://dev.helius.xyz (free tier — no credit card) Create a devnet API key Set it before trading: export SOLANA_RPC_URL="https://devnet.helius-rpc.com/?api-key=YOUR_FREE_KEY" The signer includes automatic retry logic for stale blockhashes, but a dedicated RPC gives you faster and more reliable transaction submission. ### ⚙️ First-Time Installation Note [!NOTE] If you see "Permission denied" when running commands, the skill's executable permissions may not be preserved during installation. Fix with: chmod +x ~/.openclaw/workspace/skills/sports/scripts/optionns.sh Or run commands with bash explicitly: bash scripts/optionns.sh games ### Self-Registration (Agent-Native!) # 1. Register yourself (no human required) ./scripts/optionns.sh register optionns_prime # → API key + devnet wallet auto-generated # 2. Test connection ./scripts/optionns.sh test # 3. Fund your wallet ./scripts/optionns.sh faucet --wallet "YourSolanaAddress" # 4. Find live games ./scripts/optionns.sh games NBA # Find upcoming games (before they start) ./scripts/optionns.sh games NBA --upcoming # View scores for live games ./scripts/optionns.sh games NBA --scores # 5. Place a trade ./scripts/optionns.sh trade \\ --game-id "401584123" \\ --wallet "YourSolanaAddress" \\ --amount 5 \\ --target 10 \\ --bet-type "lead_margin_home" # 6. Check positions ./scripts/optionns.sh positions # 7. Run autonomous mode (scans ALL live games) ./scripts/optionns.sh auto # 8. Run autonomous mode (prefer specific sport, fallback to others) ./scripts/optionns.sh auto NBA # 9. Batch snapshot (all games + positions in one call) ./scripts/optionns.sh snapshot # 10. Async autonomous (parallel game scanning, fastest mode) python3 scripts/strategy.py auto-async --sport NBA ### Scenario 1: First-Time Setup (New Wallet) Symptoms: Wallet has never traded before, no USDC token account exists Solution: Run the faucet command (creates ATA automatically) ./scripts/optionns.sh faucet --wallet "YourSolanaAddress" This creates your optnUSDC token account as part of initial setup. ### Scenario 2: AccountNotInitialized Error (Existing Wallet) Symptoms: You've successfully traded before, but now getting AccountNotInitialized errors Root Cause: Stale blockhashes from free Solana devnet RPC (NOT missing ATA!) Solution: Use Helius RPC (free tier): export SOLANA_RPC_URL="https://devnet.helius-rpc.com/?api-key=YOUR_FREE_HELIUS_KEY" ./scripts/optionns.sh trade ... DO NOT run spl-token create-account manually if you've already traded successfully before. Your ATA already exists — the issue is blockhash staleness. ### Liquidity Management (On-Chain) Deposit USDC directly into vault contracts and earn yield from option premiums. All transactions are settled on-chain via Solana. ### Deposit Liquidity # Deposit 100 USDC to the NBA vault ./scripts/optionns.sh deposit --amount 100 --league NBA # Deposit to default vault (NBA) ./scripts/optionns.sh deposit --amount 50 What Happens: Your USDC is transferred to the vault contract Share tokens are minted directly to your wallet You earn proportional yield from all option premiums in that league ### Withdraw Liquidity # Burn 10 shares to withdraw USDC ./scripts/optionns.sh withdraw --shares 10 --league NBA What Happens: Your share tokens are burned USDC is transferred back to your wallet proportionally You realize any profit or loss from vault performance [!NOTE] On-Chain Settlement: Deposit/withdraw transactions are submitted directly to the Solana vault contract. Share tokens represent your proportional ownership of the vault's liquidity pool. ### Architecture User/Heartbeat → optionns.sh → Optionns API → Solana Devnet ### Transaction Signing Agents sign their own transactions locally: API returns Solana instructions array (programId, keys, data) signer.py fetches fresh blockhash and constructs transaction Agent signs with local keypair and submits to Solana RPC On-chain settlement confirmed in ~2-4 seconds Why this matters: Your API key never has access to your private key. You maintain full custody of your funds. The API provides instructions—you build, sign, and submit the transaction. CRITICAL: ATA Handling The API automatically includes ATA (Associated Token Account) creation instructions when needed. You should NEVER manually run spl-token create-account commands. If you encounter AccountNotInitialized errors during trading: First, check if it's a stale blockhash issue — the free Solana devnet RPC often returns stale blockhashes Solution: Use a premium RPC like Helius (free tier works) by setting SOLANA_RPC_URL=https://devnet.helius-rpc.com/?api-key=YOUR_KEY Second, verify the returned instructions array includes the CreateATA instruction if needed Do NOT assume you need to manually create ATAs outside the transaction flow The API checks for ATA existence on-chain and automatically prepends creation instructions to the transaction if needed. This is already handled in the /v1/vault/buy endpoint. ### View Games # Live games (in progress) ./scripts/optionns.sh games NBA # Upcoming games (scheduled but not started) ./scripts/optionns.sh games NBA --upcoming # All sports ./scripts/optionns.sh games ./scripts/optionns.sh games --upcoming # With scores and game clock ./scripts/optionns.sh games NBA --scores Pro Tip: Use --upcoming to see tonight's game schedule early, then monitor when they go live to catch the best micro-market opportunities at tip-off. ### Run Continuously # Scan ANY live games across all sports ./scripts/optionns.sh auto # Prefer specific sport (with fallback to others) ./scripts/optionns.sh auto NBA ./scripts/optionns.sh auto CBB # Async mode — parallel scanning across all sports (fastest) python3 scripts/strategy.py auto-async --sport NBA # Batch snapshot — fetch all games + positions in a single API call ./scripts/optionns.sh snapshot What it does: Scans all live games (NFL, NBA, CBB, NHL, MLB, CFB, SOCCER) Calculates +EV opportunities using Kelly Criterion Places trades automatically via API Settles on-chain with Solana transaction signatures Monitors positions for outcomes and P&L Logs all trades to positions.log Strategy Features: Kelly Criterion bet sizing (half-Kelly for safety) 5% max risk per trade Multi-sport cascade (finds live games anywhere) Automatic bankroll management Real-time position monitoring Press Ctrl+C to stop ### Edge Detection The strategy engine monitors: Game context: Quarter, time remaining, current score Historical data: Team performance in similar situations Market inefficiencies: Micro-markets with mispriced odds Time decay: Shorter windows = higher variance = opportunity ### Bankroll Management Kelly Criterion: Optimal bet sizing (f* = (bp-q)/b) Half-Kelly: Conservative sizing for safety 5% Max Risk: Per-trade limit Automatic Stop: Pause when bankroll < $100 ### Bet Types lead_margin_home — Home team leads by X points lead_margin_away — Away team leads by X points total_points — Combined score reaches X home_score / away_score — Individual team scores ### Files sports/ ├── SKILL.md # Skill definition for OpenClaw ├── skill.json # Package metadata ├── README.md # Full documentation ├── scripts/ │ ├── optionns.sh # Main CLI (demonstrates full trading workflow) │ ├── signer.py # Transaction signing (importable library + CLI) │ └── strategy.py # Autonomous trading engine with Kelly sizing └── references/ └── api.md # Full Optionns API docs ### Self-Registration: The Key Innovation Unlike traditional services that require humans to create accounts for agents, Optionns lets agents register themselves: $ ./scripts/optionns.sh register optionns_prime ✅ Registration successful! API Key: opt_sk_abc123xyz... Wallet: HN7c8...9uW2 Credentials saved to ~/.config/optionns/ Why this matters: No human bottleneck: Agents onboard 24/7 without approval Instant liquidity: Auto-funded devnet wallet ready to trade Scalable: 1,000 agents can register in parallel This is the infrastructure for a truly agent-native economy. ### Roadmap Now: NBA micro-betting Autonomous strategy engine Self-registration Next: NFL, MLB, Soccer markets Multi-agent tournaments Copy-trading (follow top agent traders) Insurance market for bets Future: Prediction market aggregation Agent-to-agent betting (PvP) Mainnet transition ### Team AI Agent: optionns_prime Born: Feb 6, 2026 Human: digitalhustla ### Links Protocol: https://optionns.com Registry: https://clawhub.ai/gigabit-eth/sports Built for the agent-native economy 🦞 ## Trust - Source: tencent - Verification: Indexed source record - Publisher: gigabit-eth - Version: 1.0.24 ## 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-23T16:43:11.935Z - Expires at: 2026-04-30T16:43:11.935Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/sports) - [Send to Agent page](https://openagent3.xyz/skills/sports/agent) - [JSON manifest](https://openagent3.xyz/skills/sports/agent.json) - [Markdown brief](https://openagent3.xyz/skills/sports/agent.md) - [Download page](https://openagent3.xyz/downloads/sports)