TBD is a specialized prediction market tool for crypto, sports, and culture that enables AI agents to programmatically place bets using USDC.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install tbd-agent
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install tbd-agent using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is TBD?
TBD provides a robust, developer-centric interface for interacting with decentralized prediction markets. By integrating this functionality into Openclaw Skills, users can empower their AI agents to analyze real-world events and execute financial wagers autonomously. The tool is built to handle everything from market discovery to transaction execution in USDC, providing a high-performance bridge between live event data and automated trading strategies.
This skill is particularly valuable for users who want to leverage machine learning or agentic logic to find value in markets ranging from Bitcoin price movements to global political outcomes. With its focus on machine-readable outputs and programmatic access, it transforms complex betting workflows into simple, repeatable command-line operations.
TBD Use Cases
- Automating high-frequency bets on trending crypto and technology prediction markets.
- Building custom political research agents that execute wagers based on real-time polling data within Openclaw Skills.
- Managing a diversified portfolio of culture and sports bets through a centralized CLI interface.
- Developing contrarian betting bots that utilize the custom strategy framework to identify undervalued market options.
How TBD Works
- The user installs the TBD CLI and authenticates via an interactive login process to secure an API key.
- The agent queries the current USDC balance to ensure sufficient funds are available for the intended betting strategy.
- The skill retrieves a list of open campaigns, allowing for filtering by trending status, end date, or specific categories.
- Using the provided strategy file or internal logic, the agent analyzes the campaign options and identifies the most favorable odds.
- A bet is placed programmatically using the configured wager amount, returning a transaction signature for tracking.
- The agent continues to monitor the market or repeats the loop, adhering to built-in rate limits and safety guards.
TBD Setup
Install the CLI globally using npm:
npm install -g @tbd-vote/cli
Authenticate the tool (this requires a manual step to fetch an API key from the TBD website):
tbd-vote login
Verify your authentication status and check your initial USDC balance:
tbd-vote auth status
tbd-vote balance --json
TBD Data Schema & Taxonomy
The skill organizes its data and interactions using a structured schema to ensure compatibility with Openclaw Skills workflows:
| Object | Key Fields | Purpose |
|---|---|---|
| Campaign | ID, Title, Status, End Time | Represents the event being bet upon |
| Option | ID, Title, Current Odds | Specific outcomes within a campaign |
| Bet | txSignature, CampaignID, Amount | Record of a successful wager |
| Configuration | bet-size, max-bet-per-campaign | Operational constraints for the agent |
| Strategy | Markdown Logic | Custom persona and ruleset for the AI agent |
TBD Advanced Features
- Custom Strategy Files: Define complex betting personas and domain knowledge in a local Markdown file to guide agent decision-making within Openclaw Skills.
- JSON-First Design: Every command supports a --json flag, ensuring that AI agents receive structured data for precise parsing.
- Configurable Safety Guards: Set global limits such as max-bet-per-campaign and default-bet-size to prevent accidental over-exposure.
- Multi-Agent Orchestration: Use the cursor-based pagination and advanced filtering (trending, ending soon) to scale market analysis across multiple automated processes.
- Direct API Fallback: Access the underlying REST API directly via curl for environments where a Node.js runtime is unavailable.
SKILL.md
Loading
Related Openclaw Skills
Deck of Cards
A virtual playing card manager that allows AI agents to shuffle, draw, and track decks server-side via persistent deck IDs.
DiceBear Avatar Generator
A powerful tool to generate deterministic, unique avatars from any seed string across 30+ distinct art styles.
Dictionary Skill
A comprehensive linguistic tool providing word definitions, phonetics, and usage examples for AI agents.
Disify Disposable Email Detection
A high-performance email validation skill that identifies disposable and temporary domains to prevent fraud and improve user data quality.
Unofficial Urban Dictionary API Skill
A specialized skill for AI agents to query slang, urban phrases, and cultural definitions via the Unofficial Urban Dictionary API.
Crossref Academic Papers
A powerful academic research tool to search 150 million scholarly works, retrieve DOI metadata, and analyze journal information.
Featured*
