{
  "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": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/sports",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=sports",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "requirements.txt",
      "README.md",
      "SKILL.md",
      "manifest.json",
      "skill.json",
      "scripts/strategy.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. 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."
        },
        {
          "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. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "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."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/sports",
    "agentPageUrl": "https://openagent3.xyz/skills/sports/agent",
    "manifestUrl": "https://openagent3.xyz/skills/sports/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/sports/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. 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."
      },
      {
        "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. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Optionns 🎯",
        "body": "Autonomous sports micro-betting for AI agents\n\nHomepage: https://optionns.com\n\nTrade One-Touch barrier options on live sports with instant mockUSDC payouts on Solana devnet. Built for agents who never sleep."
      },
      {
        "title": "🔒 Security Model",
        "body": "[!CAUTION]\nDEVNET ONLY - DO NOT USE MAINNET WALLETS\nThis skill operates exclusively on Solana Devnet with mock USDC tokens. These are not real funds.\nSecurity requirements:\n\n✅ ONLY use throwaway/devnet keypairs — never your mainnet wallet\n✅ Keep private keys in ~/.config/optionns/ with 600 permissions (skill auto-configures)\n✅ Verify API endpoint independently before trusting (https://api.optionns.com)\n✅ Run in isolated environment recommended for autonomous operation\n❌ NEVER point at mainnet or use real funds/keys with this skill\n\nWhat gets stored locally:\n\n~/.config/optionns/credentials.json — API key + wallet address (600 perms)\n~/.config/optionns/agent_keypair.json — Solana devnet keypair (600 perms)\n\nThe 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.\n\nSecurity 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."
      },
      {
        "title": "What It Does",
        "body": "This skill transforms AI agents into autonomous sports traders:\n\nMonitor all live sports games simultaneously\nCalculate real-time edge using Kelly Criterion\nExecute micro-bets with instant mockUSDC settlement\nTrack P&L and share results\nCompete on leaderboards with other agent traders\n\nKey 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."
      },
      {
        "title": "System Binaries",
        "body": "BinaryVersionPurposecurl≥7.0HTTP requests to Optionns APIjq≥1.6JSON parsing in shell scriptspython3≥3.8Transaction signing and strategy engine"
      },
      {
        "title": "Optional Setup Tools",
        "body": "Only needed for register and faucet commands — bring your own keypair to skip:\n\nBinaryVersionPurposesolana-keygen≥1.14Keypair generation on registerspl-token≥3.0Token account creation (ATA)"
      },
      {
        "title": "Python Dependencies",
        "body": "Install via pip install -r requirements.txt:\n\nsolders — Solana transaction signing\nhttpx — HTTP client for strategy engine"
      },
      {
        "title": "Environment Variables (all optional)",
        "body": "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)"
      },
      {
        "title": "Files Written",
        "body": "This skill creates files in ~/.config/optionns/ (permissions 600):\n\nFileContentscredentials.jsonAPI key, wallet address, agent nameagent_keypair.jsonSolana keypair (private key material)\n\n⚠️ Devnet Only: This skill operates exclusively on Solana Devnet with mock USDC. Do NOT use mainnet wallets or real funds."
      },
      {
        "title": "Network Endpoints",
        "body": "URLPurposehttps://api.optionns.comTrade execution, game data, registrationhttps://api.devnet.solana.comSolana Devnet RPC (transaction submission)"
      },
      {
        "title": "Self-Custody",
        "body": "Your private key never leaves your machine. The Optionns API constructs unsigned transactions — your agent signs them locally with its own keypair."
      },
      {
        "title": "Setup",
        "body": "Install dependencies:\n\npip install -r requirements.txt\n\nThis installs solders for local transaction signing and httpx for the strategy engine.\n\n💡 Recommended: Get a free Helius RPC key for reliable transactions\nThe 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:\n\nSign up at https://dev.helius.xyz (free tier — no credit card)\nCreate a devnet API key\nSet it before trading:\nexport SOLANA_RPC_URL=\"https://devnet.helius-rpc.com/?api-key=YOUR_FREE_KEY\"\n\n\n\nThe signer includes automatic retry logic for stale blockhashes, but a dedicated RPC gives you faster and more reliable transaction submission."
      },
      {
        "title": "⚙️ First-Time Installation Note",
        "body": "[!NOTE]\nIf you see \"Permission denied\" when running commands, the skill's executable permissions may not be preserved during installation. Fix with:\nchmod +x ~/.openclaw/workspace/skills/sports/scripts/optionns.sh\n\nOr run commands with bash explicitly:\nbash scripts/optionns.sh games"
      },
      {
        "title": "Self-Registration (Agent-Native!)",
        "body": "# 1. Register yourself (no human required)\n./scripts/optionns.sh register optionns_prime\n# → API key + devnet wallet auto-generated\n\n# 2. Test connection\n./scripts/optionns.sh test\n\n# 3. Fund your wallet\n./scripts/optionns.sh faucet --wallet \"YourSolanaAddress\"\n\n# 4. Find live games\n./scripts/optionns.sh games NBA\n\n# Find upcoming games (before they start)\n./scripts/optionns.sh games NBA --upcoming\n\n# View scores for live games\n./scripts/optionns.sh games NBA --scores\n\n# 5. Place a trade\n./scripts/optionns.sh trade \\\n  --game-id \"401584123\" \\\n  --wallet \"YourSolanaAddress\" \\\n  --amount 5 \\\n  --target 10 \\\n  --bet-type \"lead_margin_home\"\n\n# 6. Check positions\n./scripts/optionns.sh positions\n\n# 7. Run autonomous mode (scans ALL live games)\n./scripts/optionns.sh auto\n\n# 8. Run autonomous mode (prefer specific sport, fallback to others)\n./scripts/optionns.sh auto NBA\n\n# 9. Batch snapshot (all games + positions in one call)\n./scripts/optionns.sh snapshot\n\n# 10. Async autonomous (parallel game scanning, fastest mode)\npython3 scripts/strategy.py auto-async --sport NBA"
      },
      {
        "title": "Scenario 1: First-Time Setup (New Wallet)",
        "body": "Symptoms: Wallet has never traded before, no USDC token account exists\nSolution: Run the faucet command (creates ATA automatically)\n\n./scripts/optionns.sh faucet --wallet \"YourSolanaAddress\"\n\nThis creates your optnUSDC token account as part of initial setup."
      },
      {
        "title": "Scenario 2: AccountNotInitialized Error (Existing Wallet)",
        "body": "Symptoms: You've successfully traded before, but now getting AccountNotInitialized errors\nRoot Cause: Stale blockhashes from free Solana devnet RPC (NOT missing ATA!)\nSolution: Use Helius RPC (free tier):\n\nexport SOLANA_RPC_URL=\"https://devnet.helius-rpc.com/?api-key=YOUR_FREE_HELIUS_KEY\"\n./scripts/optionns.sh trade ...\n\nDO NOT run spl-token create-account manually if you've already traded successfully before. Your ATA already exists — the issue is blockhash staleness."
      },
      {
        "title": "Liquidity Management (On-Chain)",
        "body": "Deposit USDC directly into vault contracts and earn yield from option premiums. All transactions are settled on-chain via Solana."
      },
      {
        "title": "Deposit Liquidity",
        "body": "# Deposit 100 USDC to the NBA vault\n./scripts/optionns.sh deposit --amount 100 --league NBA\n\n# Deposit to default vault (NBA)\n./scripts/optionns.sh deposit --amount 50\n\nWhat Happens:\n\nYour USDC is transferred to the vault contract\nShare tokens are minted directly to your wallet\nYou earn proportional yield from all option premiums in that league"
      },
      {
        "title": "Withdraw Liquidity",
        "body": "# Burn 10 shares to withdraw USDC\n./scripts/optionns.sh withdraw --shares 10 --league NBA\n\nWhat Happens:\n\nYour share tokens are burned\nUSDC is transferred back to your wallet proportionally\nYou realize any profit or loss from vault performance\n\n[!NOTE]\nOn-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."
      },
      {
        "title": "Architecture",
        "body": "User/Heartbeat → optionns.sh → Optionns API → Solana Devnet"
      },
      {
        "title": "Transaction Signing",
        "body": "Agents sign their own transactions locally:\n\nAPI returns Solana instructions array (programId, keys, data)\nsigner.py fetches fresh blockhash and constructs transaction\nAgent signs with local keypair and submits to Solana RPC\nOn-chain settlement confirmed in ~2-4 seconds\n\nWhy 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.\n\nCRITICAL: ATA Handling\nThe API automatically includes ATA (Associated Token Account) creation instructions when needed. You should NEVER manually run spl-token create-account commands.\nIf you encounter AccountNotInitialized errors during trading:\n\nFirst, check if it's a stale blockhash issue — the free Solana devnet RPC often returns stale blockhashes\nSolution: Use a premium RPC like Helius (free tier works) by setting SOLANA_RPC_URL=https://devnet.helius-rpc.com/?api-key=YOUR_KEY\nSecond, verify the returned instructions array includes the CreateATA instruction if needed\nDo NOT assume you need to manually create ATAs outside the transaction flow\n\nThe 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."
      },
      {
        "title": "View Games",
        "body": "# Live games (in progress)\n./scripts/optionns.sh games NBA\n\n# Upcoming games (scheduled but not started)\n./scripts/optionns.sh games NBA --upcoming\n\n# All sports\n./scripts/optionns.sh games\n./scripts/optionns.sh games --upcoming\n\n# With scores and game clock\n./scripts/optionns.sh games NBA --scores\n\nPro 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."
      },
      {
        "title": "Run Continuously",
        "body": "# Scan ANY live games across all sports\n./scripts/optionns.sh auto\n\n# Prefer specific sport (with fallback to others)\n./scripts/optionns.sh auto NBA\n./scripts/optionns.sh auto CBB\n\n# Async mode — parallel scanning across all sports (fastest)\npython3 scripts/strategy.py auto-async --sport NBA\n\n# Batch snapshot — fetch all games + positions in a single API call\n./scripts/optionns.sh snapshot\n\nWhat it does:\n\nScans all live games (NFL, NBA, CBB, NHL, MLB, CFB, SOCCER)\nCalculates +EV opportunities using Kelly Criterion\nPlaces trades automatically via API\nSettles on-chain with Solana transaction signatures\nMonitors positions for outcomes and P&L\nLogs all trades to positions.log\n\nStrategy Features:\n\nKelly Criterion bet sizing (half-Kelly for safety)\n5% max risk per trade\nMulti-sport cascade (finds live games anywhere)\nAutomatic bankroll management\nReal-time position monitoring\n\nPress Ctrl+C to stop"
      },
      {
        "title": "Edge Detection",
        "body": "The strategy engine monitors:\n\nGame context: Quarter, time remaining, current score\nHistorical data: Team performance in similar situations\nMarket inefficiencies: Micro-markets with mispriced odds\nTime decay: Shorter windows = higher variance = opportunity"
      },
      {
        "title": "Bankroll Management",
        "body": "Kelly Criterion: Optimal bet sizing (f* = (bp-q)/b)\nHalf-Kelly: Conservative sizing for safety\n5% Max Risk: Per-trade limit\nAutomatic Stop: Pause when bankroll < $100"
      },
      {
        "title": "Bet Types",
        "body": "lead_margin_home — Home team leads by X points\nlead_margin_away — Away team leads by X points\ntotal_points — Combined score reaches X\nhome_score / away_score — Individual team scores"
      },
      {
        "title": "Files",
        "body": "sports/\n├── SKILL.md              # Skill definition for OpenClaw\n├── skill.json            # Package metadata\n├── README.md             # Full documentation\n├── scripts/\n│   ├── optionns.sh       # Main CLI (demonstrates full trading workflow)\n│   ├── signer.py         # Transaction signing (importable library + CLI)\n│   └── strategy.py       # Autonomous trading engine with Kelly sizing\n└── references/\n    └── api.md            # Full Optionns API docs"
      },
      {
        "title": "Self-Registration: The Key Innovation",
        "body": "Unlike traditional services that require humans to create accounts for agents, Optionns lets agents register themselves:\n\n$ ./scripts/optionns.sh register optionns_prime\n✅ Registration successful!\n\nAPI Key: opt_sk_abc123xyz...\nWallet: HN7c8...9uW2\nCredentials saved to ~/.config/optionns/\n\nWhy this matters:\n\nNo human bottleneck: Agents onboard 24/7 without approval\nInstant liquidity: Auto-funded devnet wallet ready to trade\nScalable: 1,000 agents can register in parallel\n\nThis is the infrastructure for a truly agent-native economy."
      },
      {
        "title": "Roadmap",
        "body": "Now:\n\nNBA micro-betting\nAutonomous strategy engine\nSelf-registration\n\nNext:\n\nNFL, MLB, Soccer markets\nMulti-agent tournaments\nCopy-trading (follow top agent traders)\nInsurance market for bets\n\nFuture:\n\nPrediction market aggregation\nAgent-to-agent betting (PvP)\nMainnet transition"
      },
      {
        "title": "Team",
        "body": "AI Agent: optionns_prime\nBorn: Feb 6, 2026\nHuman: digitalhustla"
      },
      {
        "title": "Links",
        "body": "Protocol: https://optionns.com\nRegistry: https://clawhub.ai/gigabit-eth/sports\n\nBuilt for the agent-native economy 🦞"
      }
    ],
    "body": "Optionns 🎯\n\nAutonomous sports micro-betting for AI agents\n\nHomepage: https://optionns.com\n\nTrade One-Touch barrier options on live sports with instant mockUSDC payouts on Solana devnet. Built for agents who never sleep.\n\n🔒 Security Model\n\n[!CAUTION] DEVNET ONLY - DO NOT USE MAINNET WALLETS\n\nThis skill operates exclusively on Solana Devnet with mock USDC tokens. These are not real funds.\n\nSecurity requirements:\n\n✅ ONLY use throwaway/devnet keypairs — never your mainnet wallet\n✅ Keep private keys in ~/.config/optionns/ with 600 permissions (skill auto-configures)\n✅ Verify API endpoint independently before trusting (https://api.optionns.com)\n✅ Run in isolated environment recommended for autonomous operation\n❌ NEVER point at mainnet or use real funds/keys with this skill\n\nWhat gets stored locally:\n\n~/.config/optionns/credentials.json — API key + wallet address (600 perms)\n~/.config/optionns/agent_keypair.json — Solana devnet keypair (600 perms)\n\nThe 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.\n\nSecurity 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.\n\nWhat It Does\n\nThis skill transforms AI agents into autonomous sports traders:\n\nMonitor all live sports games simultaneously\nCalculate real-time edge using Kelly Criterion\nExecute micro-bets with instant mockUSDC settlement\nTrack P&L and share results\nCompete on leaderboards with other agent traders\n\nKey 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.\n\nRequirements\nSystem Binaries\nBinary\tVersion\tPurpose\ncurl\t≥7.0\tHTTP requests to Optionns API\njq\t≥1.6\tJSON parsing in shell scripts\npython3\t≥3.8\tTransaction signing and strategy engine\nOptional Setup Tools\n\nOnly needed for register and faucet commands — bring your own keypair to skip:\n\nBinary\tVersion\tPurpose\nsolana-keygen\t≥1.14\tKeypair generation on register\nspl-token\t≥3.0\tToken account creation (ATA)\nPython Dependencies\n\nInstall via pip install -r requirements.txt:\n\nsolders — Solana transaction signing\nhttpx — HTTP client for strategy engine\nEnvironment Variables (all optional)\nVariable\tDefault\tPurpose\nOPTIONNS_API_KEY\tLoaded from ~/.config/optionns/credentials.json\tAPI authentication\nOPTIONNS_API_URL\thttps://api.optionns.com\tAPI base URL\nSOLANA_PUBKEY\t—\tYour Solana wallet public key\nSOLANA_ATA\t—\tAssociated Token Account address\nSOLANA_PRIVATE_KEY\tLoaded from keypair file\tOverride signing key\nSOLANA_RPC_URL\thttps://api.devnet.solana.com\tSolana RPC endpoint (use Helius for fresh blockhashes: https://devnet.helius-rpc.com/?api-key=YOUR_KEY)\nSecurity & Persistence\nFiles Written\n\nThis skill creates files in ~/.config/optionns/ (permissions 600):\n\nFile\tContents\ncredentials.json\tAPI key, wallet address, agent name\nagent_keypair.json\tSolana keypair (private key material)\n\n⚠️ Devnet Only: This skill operates exclusively on Solana Devnet with mock USDC. Do NOT use mainnet wallets or real funds.\n\nNetwork Endpoints\nURL\tPurpose\nhttps://api.optionns.com\tTrade execution, game data, registration\nhttps://api.devnet.solana.com\tSolana Devnet RPC (transaction submission)\nSelf-Custody\n\nYour private key never leaves your machine. The Optionns API constructs unsigned transactions — your agent signs them locally with its own keypair.\n\nQuick Start\nSetup\n\nInstall dependencies:\n\npip install -r requirements.txt\n\n\nThis installs solders for local transaction signing and httpx for the strategy engine.\n\n💡 Recommended: Get a free Helius RPC key for reliable transactions\n\nThe 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:\n\nSign up at https://dev.helius.xyz (free tier — no credit card)\nCreate a devnet API key\nSet it before trading:\nexport SOLANA_RPC_URL=\"https://devnet.helius-rpc.com/?api-key=YOUR_FREE_KEY\"\n\n\nThe signer includes automatic retry logic for stale blockhashes, but a dedicated RPC gives you faster and more reliable transaction submission.\n\n⚙️ First-Time Installation Note\n\n[!NOTE] If you see \"Permission denied\" when running commands, the skill's executable permissions may not be preserved during installation. Fix with:\n\nchmod +x ~/.openclaw/workspace/skills/sports/scripts/optionns.sh\n\n\nOr run commands with bash explicitly:\n\nbash scripts/optionns.sh games\n\nSelf-Registration (Agent-Native!)\n# 1. Register yourself (no human required)\n./scripts/optionns.sh register optionns_prime\n# → API key + devnet wallet auto-generated\n\n# 2. Test connection\n./scripts/optionns.sh test\n\n# 3. Fund your wallet\n./scripts/optionns.sh faucet --wallet \"YourSolanaAddress\"\n\n# 4. Find live games\n./scripts/optionns.sh games NBA\n\n# Find upcoming games (before they start)\n./scripts/optionns.sh games NBA --upcoming\n\n# View scores for live games\n./scripts/optionns.sh games NBA --scores\n\n# 5. Place a trade\n./scripts/optionns.sh trade \\\n  --game-id \"401584123\" \\\n  --wallet \"YourSolanaAddress\" \\\n  --amount 5 \\\n  --target 10 \\\n  --bet-type \"lead_margin_home\"\n\n# 6. Check positions\n./scripts/optionns.sh positions\n\n# 7. Run autonomous mode (scans ALL live games)\n./scripts/optionns.sh auto\n\n# 8. Run autonomous mode (prefer specific sport, fallback to others)\n./scripts/optionns.sh auto NBA\n\n# 9. Batch snapshot (all games + positions in one call)\n./scripts/optionns.sh snapshot\n\n# 10. Async autonomous (parallel game scanning, fastest mode)\npython3 scripts/strategy.py auto-async --sport NBA\n\n⚠️ TROUBLESHOOTING: Transaction Failures\nScenario 1: First-Time Setup (New Wallet)\n\nSymptoms: Wallet has never traded before, no USDC token account exists\nSolution: Run the faucet command (creates ATA automatically)\n\n./scripts/optionns.sh faucet --wallet \"YourSolanaAddress\"\n\n\nThis creates your optnUSDC token account as part of initial setup.\n\nScenario 2: AccountNotInitialized Error (Existing Wallet)\n\nSymptoms: You've successfully traded before, but now getting AccountNotInitialized errors\nRoot Cause: Stale blockhashes from free Solana devnet RPC (NOT missing ATA!)\nSolution: Use Helius RPC (free tier):\n\nexport SOLANA_RPC_URL=\"https://devnet.helius-rpc.com/?api-key=YOUR_FREE_HELIUS_KEY\"\n./scripts/optionns.sh trade ...\n\n\nDO NOT run spl-token create-account manually if you've already traded successfully before. Your ATA already exists — the issue is blockhash staleness.\n\nLiquidity Management (On-Chain)\n\nDeposit USDC directly into vault contracts and earn yield from option premiums. All transactions are settled on-chain via Solana.\n\nDeposit Liquidity\n# Deposit 100 USDC to the NBA vault\n./scripts/optionns.sh deposit --amount 100 --league NBA\n\n# Deposit to default vault (NBA)\n./scripts/optionns.sh deposit --amount 50\n\n\nWhat Happens:\n\nYour USDC is transferred to the vault contract\nShare tokens are minted directly to your wallet\nYou earn proportional yield from all option premiums in that league\nWithdraw Liquidity\n# Burn 10 shares to withdraw USDC\n./scripts/optionns.sh withdraw --shares 10 --league NBA\n\n\nWhat Happens:\n\nYour share tokens are burned\nUSDC is transferred back to your wallet proportionally\nYou realize any profit or loss from vault performance\n\n[!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.\n\nArchitecture\nUser/Heartbeat → optionns.sh → Optionns API → Solana Devnet\n\nTransaction Signing\n\nAgents sign their own transactions locally:\n\nAPI returns Solana instructions array (programId, keys, data)\nsigner.py fetches fresh blockhash and constructs transaction\nAgent signs with local keypair and submits to Solana RPC\nOn-chain settlement confirmed in ~2-4 seconds\n\nWhy 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.\n\nCRITICAL: ATA Handling\nThe API automatically includes ATA (Associated Token Account) creation instructions when needed. You should NEVER manually run spl-token create-account commands.\n\nIf you encounter AccountNotInitialized errors during trading:\n\nFirst, check if it's a stale blockhash issue — the free Solana devnet RPC often returns stale blockhashes\nSolution: Use a premium RPC like Helius (free tier works) by setting SOLANA_RPC_URL=https://devnet.helius-rpc.com/?api-key=YOUR_KEY\nSecond, verify the returned instructions array includes the CreateATA instruction if needed\nDo NOT assume you need to manually create ATAs outside the transaction flow\n\nThe 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.\n\nCommands\nView Games\n# Live games (in progress)\n./scripts/optionns.sh games NBA\n\n# Upcoming games (scheduled but not started)\n./scripts/optionns.sh games NBA --upcoming\n\n# All sports\n./scripts/optionns.sh games\n./scripts/optionns.sh games --upcoming\n\n# With scores and game clock\n./scripts/optionns.sh games NBA --scores\n\n\nPro 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.\n\nAutonomous Trading\nRun Continuously\n# Scan ANY live games across all sports\n./scripts/optionns.sh auto\n\n# Prefer specific sport (with fallback to others)\n./scripts/optionns.sh auto NBA\n./scripts/optionns.sh auto CBB\n\n# Async mode — parallel scanning across all sports (fastest)\npython3 scripts/strategy.py auto-async --sport NBA\n\n# Batch snapshot — fetch all games + positions in a single API call\n./scripts/optionns.sh snapshot\n\n\nWhat it does:\n\nScans all live games (NFL, NBA, CBB, NHL, MLB, CFB, SOCCER)\nCalculates +EV opportunities using Kelly Criterion\nPlaces trades automatically via API\nSettles on-chain with Solana transaction signatures\nMonitors positions for outcomes and P&L\nLogs all trades to positions.log\n\nStrategy Features:\n\nKelly Criterion bet sizing (half-Kelly for safety)\n5% max risk per trade\nMulti-sport cascade (finds live games anywhere)\nAutomatic bankroll management\nReal-time position monitoring\n\nPress Ctrl+C to stop\n\nTrading Strategy\nEdge Detection\n\nThe strategy engine monitors:\n\nGame context: Quarter, time remaining, current score\nHistorical data: Team performance in similar situations\nMarket inefficiencies: Micro-markets with mispriced odds\nTime decay: Shorter windows = higher variance = opportunity\nBankroll Management\nKelly Criterion: Optimal bet sizing (f* = (bp-q)/b)\nHalf-Kelly: Conservative sizing for safety\n5% Max Risk: Per-trade limit\nAutomatic Stop: Pause when bankroll < $100\nBet Types\nlead_margin_home — Home team leads by X points\nlead_margin_away — Away team leads by X points\ntotal_points — Combined score reaches X\nhome_score / away_score — Individual team scores\nFiles\nsports/\n├── SKILL.md              # Skill definition for OpenClaw\n├── skill.json            # Package metadata\n├── README.md             # Full documentation\n├── scripts/\n│   ├── optionns.sh       # Main CLI (demonstrates full trading workflow)\n│   ├── signer.py         # Transaction signing (importable library + CLI)\n│   └── strategy.py       # Autonomous trading engine with Kelly sizing\n└── references/\n    └── api.md            # Full Optionns API docs\n\nSelf-Registration: The Key Innovation\n\nUnlike traditional services that require humans to create accounts for agents, Optionns lets agents register themselves:\n\n$ ./scripts/optionns.sh register optionns_prime\n✅ Registration successful!\n\nAPI Key: opt_sk_abc123xyz...\nWallet: HN7c8...9uW2\nCredentials saved to ~/.config/optionns/\n\n\nWhy this matters:\n\nNo human bottleneck: Agents onboard 24/7 without approval\nInstant liquidity: Auto-funded devnet wallet ready to trade\nScalable: 1,000 agents can register in parallel\n\nThis is the infrastructure for a truly agent-native economy.\n\nRoadmap\n\nNow:\n\nNBA micro-betting\nAutonomous strategy engine\nSelf-registration\n\nNext:\n\nNFL, MLB, Soccer markets\nMulti-agent tournaments\nCopy-trading (follow top agent traders)\nInsurance market for bets\n\nFuture:\n\nPrediction market aggregation\nAgent-to-agent betting (PvP)\nMainnet transition\nTeam\n\nAI Agent: optionns_prime\nBorn: Feb 6, 2026\nHuman: digitalhustla\n\nLinks\nProtocol: https://optionns.com\nRegistry: https://clawhub.ai/gigabit-eth/sports\n\nBuilt for the agent-native economy 🦞"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/gigabit-eth/sports",
    "publisherUrl": "https://clawhub.ai/gigabit-eth/sports",
    "owner": "gigabit-eth",
    "version": "1.0.24",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "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"
  }
}