clodds 1.2.9 → 1.4.0

package/dist/skills/bundled/backtest/SKILL.md

@@ -0,0 +1,225 @@
+---
+name: backtest
+description: "Test trading strategies on historical data with Monte Carlo simulation"
+emoji: "📈"
+---
+
+# Backtest - Complete API Reference
+
+Validate trading strategies using historical data, walk-forward analysis, and Monte Carlo simulation.
+
+---
+
+## Chat Commands
+
+### Run Backtest
+
+```
+/backtest momentum --from 2024-01-01 --to 2024-12-31
+/backtest mean-reversion --market "Trump 2028" --days 90
+/backtest my-strategy --capital 10000
+```
+
+### Quick Stats
+
+```
+/backtest stats momentum           Show strategy metrics
+/backtest compare momentum arb     Compare two strategies
+/backtest monte-carlo momentum     Run Monte Carlo simulation
+```
+
+### Results
+
+```
+/backtest results                  Show recent results
+/backtest results <id> --detailed  Detailed breakdown
+/backtest export <id>              Export to CSV
+```
+
+---
+
+## TypeScript API Reference
+
+### Create Backtest Engine
+
+```typescript
+import { createBacktestEngine } from 'clodds/backtest';
+
+const backtest = createBacktestEngine({
+  // Data source
+  dataSource: 'polymarket',  // or custom data provider
+
+  // Capital
+  initialCapital: 10000,
+
+  // Fees (Polymarket: 0% on most markets; Kalshi: ~1.2% avg)
+  fees: {
+    maker: 0,       // 0% maker fee (Polymarket most markets)
+    taker: 0,       // 0% taker fee (Polymarket most markets)
+    // For 15-min crypto markets or Kalshi, use: taker: 0.012
+  },
+
+  // Slippage model
+  slippageModel: 'realistic',  // 'none' | 'fixed' | 'realistic'
+  slippageBps: 10,
+});
+```
+
+### Run Basic Backtest
+
+```typescript
+const result = await backtest.run({
+  strategy: 'momentum',
+  startDate: '2024-01-01',
+  endDate: '2024-12-31',
+  parameters: {
+    lookbackPeriod: 14,
+    entryThreshold: 0.02,
+    exitThreshold: 0.01,
+  },
+});
+
+console.log(`Total Return: ${result.totalReturn}%`);
+console.log(`Sharpe Ratio: ${result.sharpeRatio}`);
+console.log(`Max Drawdown: ${result.maxDrawdown}%`);
+console.log(`Win Rate: ${result.winRate}%`);
+console.log(`Profit Factor: ${result.profitFactor}`);
+```
+
+### Walk-Forward Analysis
+
+```typescript
+// Out-of-sample validation
+const wf = await backtest.walkForward({
+  strategy: 'momentum',
+  startDate: '2023-01-01',
+  endDate: '2024-12-31',
+
+  // Train/test split
+  trainPeriod: '6M',
+  testPeriod: '1M',
+  step: '1M',
+
+  // Optimization
+  optimize: ['lookbackPeriod', 'entryThreshold'],
+  optimizationMetric: 'sharpe',
+});
+
+console.log(`In-Sample Sharpe: ${wf.inSampleSharpe}`);
+console.log(`Out-of-Sample Sharpe: ${wf.outOfSampleSharpe}`);
+console.log(`Overfitting Ratio: ${wf.overfitRatio}`);
+```
+
+### Monte Carlo Simulation
+
+```typescript
+// Stress test with randomization
+const mc = await backtest.monteCarlo({
+  strategy: 'momentum',
+  trades: historicalTrades,
+
+  // Simulation settings
+  simulations: 10000,
+  confidenceLevel: 0.95,
+
+  // Randomization
+  shuffleTrades: true,
+  randomizeReturns: true,
+});
+
+console.log(`Expected Return: ${mc.expectedReturn}%`);
+console.log(`95% VaR: ${mc.valueAtRisk}%`);
+console.log(`Worst Case: ${mc.worstCase}%`);
+console.log(`Best Case: ${mc.bestCase}%`);
+console.log(`Probability of Profit: ${mc.probProfit}%`);
+```
+
+### Performance Metrics
+
+```typescript
+const metrics = await backtest.getMetrics(result);
+
+console.log('=== Performance ===');
+console.log(`Total Return: ${metrics.totalReturn}%`);
+console.log(`CAGR: ${metrics.cagr}%`);
+console.log(`Volatility: ${metrics.volatility}%`);
+
+console.log('=== Risk ===');
+console.log(`Sharpe Ratio: ${metrics.sharpeRatio}`);
+console.log(`Sortino Ratio: ${metrics.sortinoRatio}`);
+console.log(`Max Drawdown: ${metrics.maxDrawdown}%`);
+console.log(`Max Drawdown Duration: ${metrics.maxDrawdownDuration} days`);
+
+console.log('=== Trading ===');
+console.log(`Total Trades: ${metrics.totalTrades}`);
+console.log(`Win Rate: ${metrics.winRate}%`);
+console.log(`Profit Factor: ${metrics.profitFactor}`);
+console.log(`Avg Win: ${metrics.avgWin}%`);
+console.log(`Avg Loss: ${metrics.avgLoss}%`);
+console.log(`Expectancy: ${metrics.expectancy}%`);
+```
+
+### Custom Strategy
+
+```typescript
+// Define custom strategy
+const myStrategy = {
+  name: 'my-strategy',
+
+  onData: async (data, context) => {
+    const price = data.price;
+    const sma = data.indicators.sma(20);
+
+    if (price < sma * 0.95 && !context.hasPosition) {
+      return { action: 'buy', size: context.availableCapital * 0.1 };
+    }
+
+    if (price > sma * 1.05 && context.hasPosition) {
+      return { action: 'sell', size: 'all' };
+    }
+
+    return { action: 'hold' };
+  },
+};
+
+const result = await backtest.run({
+  strategy: myStrategy,
+  startDate: '2024-01-01',
+  endDate: '2024-12-31',
+});
+```
+
+---
+
+## Built-in Strategies
+
+| Strategy | Description |
+|----------|-------------|
+| `momentum` | Follow price trends |
+| `mean-reversion` | Buy dips, sell rallies |
+| `arbitrage` | Cross-platform price differences |
+| `breakout` | Enter on range breakouts |
+| `pairs` | Correlated market pairs |
+
+---
+
+## Metrics Explained
+
+| Metric | Good Value | Description |
+|--------|------------|-------------|
+| **Sharpe Ratio** | > 1.0 | Risk-adjusted return |
+| **Sortino Ratio** | > 1.5 | Downside-adjusted return |
+| **Max Drawdown** | < 20% | Worst peak-to-trough |
+| **Win Rate** | > 50% | Winning trades % |
+| **Profit Factor** | > 1.5 | Gross profit / gross loss |
+| **Expectancy** | > 0 | Expected $ per trade |
+
+---
+
+## Best Practices
+
+1. **Use walk-forward** — Avoid overfitting
+2. **Include fees** — Realistic cost modeling
+3. **Test multiple periods** — Don't cherry-pick dates
+4. **Monte Carlo** — Understand variance
+5. **Out-of-sample** — Always validate on unseen data

package/dist/skills/bundled/bags/SKILL.md

@@ -0,0 +1,131 @@
+---
+name: bags
+description: "Bags.fm - Complete Solana token launchpad with creator monetization"
+command: bags
+emoji: "💰"
+gates:
+  envs:
+    - BAGS_API_KEY
+---
+
+# Bags.fm - Complete API Coverage
+
+Bags.fm is a Solana token launchpad and trading platform with creator monetization. Creators earn 1% of all trading volume on their tokens.
+
+## Trading
+
+```
+/bags quote <amount> <from> to <to>    Get swap quote
+/bags swap <amount> <from> to <to>     Execute swap
+```
+
+## Discovery
+
+```
+/bags pools                            List all Bags pools
+/bags trending                         Show trending tokens by volume
+/bags token <mint>                     Full token info (metadata, creators, fees, market data)
+/bags creators <mint>                  Get token creators and fee shares
+/bags lifetime-fees <mint>             Total fees collected for a token
+```
+
+## Fee Claiming
+
+```
+/bags fees [wallet]                    Check claimable fees (all positions)
+/bags claim [wallet]                   Claim all accumulated fees
+/bags claim-events <mint> [--from X] [--to Y]  Get claim history with time filters
+/bags stats <mint>                     Per-claimer statistics
+```
+
+## Token Launch
+
+```
+/bags launch <name> <symbol> <desc> [options]  Launch new token
+/bags launch-info                              Show launch requirements and fees
+```
+
+**Launch Options:**
+- `--image <url>` - Token image URL
+- `--twitter <handle>` - Twitter handle
+- `--website <url>` - Website URL
+- `--telegram <url>` - Telegram URL
+- `--initial <SOL>` - Initial buy amount in SOL
+
+## Fee Share Configuration
+
+```
+/bags fee-config <mint> <wallet:bps>...   Create fee distribution (bps must sum to 10000)
+```
+
+**Examples:**
+```
+/bags fee-config <mint> wallet1:5000 wallet2:5000   # 50/50 split
+/bags fee-config <mint> wallet1:7000 wallet2:3000   # 70/30 split
+```
+
+## Wallet Lookup (Social -> Wallet)
+
+```
+/bags wallet <provider> <username>        Lookup wallet by social handle
+/bags wallets <provider> <user1,user2>    Bulk wallet lookup
+```
+
+**Providers:** twitter, github, kick, tiktok, instagram, onlyfans, solana, apple, google, email, moltbook
+
+## Partner System
+
+```
+/bags partner-config <mint>              Create partner key for referral fees
+/bags partner-claim [wallet]             Claim accumulated partner fees
+/bags partner-stats <partner-key>        View partner statistics
+```
+
+## Examples
+
+```
+# Trading
+/bags quote 1 SOL to USDC
+/bags swap 0.5 SOL to BONK
+
+# Discovery
+/bags trending
+/bags token ABC123...
+
+# Launch a token
+/bags launch "Moon Token" MOON "To the moon!" --twitter moontoken --initial 0.1
+
+# Check and claim fees
+/bags fees
+/bags claim
+
+# Set up 50/50 fee share
+/bags fee-config <mint> wallet1:5000 wallet2:5000
+
+# Lookup wallet by Twitter
+/bags wallet twitter elonmusk
+```
+
+## Configuration
+
+```bash
+export BAGS_API_KEY="your-api-key"           # From dev.bags.fm
+export SOLANA_PRIVATE_KEY="your-private-key" # For signing swaps/launches
+```
+
+## API Reference
+
+- Base URL: `https://public-api-v2.bags.fm/api/v1/`
+- Auth: `x-api-key` header
+- Rate limit: 1000 requests/hour
+- Get your API key at [dev.bags.fm](https://dev.bags.fm)
+
+## Features
+
+- Token launching with 1% creator fees
+- Up to 100 fee claimers per token (with automatic lookup tables)
+- Meteora DAMM v2 pool integration
+- Virtual pool and custom vault fee claiming
+- Partner referral system
+- Social wallet lookup (Twitter, GitHub, Kick, TikTok)
+- Jito bundle support for launches

package/dist/skills/bundled/bankr/SKILL.md

@@ -0,0 +1,114 @@
+---
+name: bankr
+description: "AI-powered crypto trading via natural language through Bankr API"
+command: bankr
+emoji: "🏦"
+gates:
+  envs:
+    - BANKR_API_KEY
+---
+
+# Bankr
+
+Execute crypto trading and DeFi operations using natural language through Bankr's AI agent API.
+
+## Setup
+
+Get your API key from [bankr.bot/api](https://bankr.bot/api) and set:
+
+```bash
+export BANKR_API_KEY=bk_your_key_here
+```
+
+## Commands
+
+```
+/bankr <prompt>              Execute any trading command
+/bankr status <jobId>        Check job status
+/bankr cancel <jobId>        Cancel pending job
+```
+
+## Examples
+
+### Trading
+```
+/bankr Buy $50 of ETH on Base
+/bankr Swap 0.1 ETH for USDC
+/bankr Sell 50% of my PEPE
+/bankr Bridge 100 USDC from Polygon to Base
+```
+
+### Portfolio
+```
+/bankr Show my portfolio
+/bankr What's my ETH balance?
+/bankr Holdings on Base
+```
+
+### Market Research
+```
+/bankr What's the price of Bitcoin?
+/bankr Analyze ETH price
+/bankr Trending tokens on Base
+```
+
+### Transfers
+```
+/bankr Send 0.1 ETH to vitalik.eth
+/bankr Transfer $20 USDC to @friend
+```
+
+### NFTs
+```
+/bankr Show Bored Ape floor price
+/bankr Buy cheapest Pudgy Penguin
+/bankr Show my NFTs
+```
+
+### Polymarket
+```
+/bankr What are the odds Trump wins?
+/bankr Bet $10 on Yes for [market]
+/bankr Show my Polymarket positions
+```
+
+### Leverage (Avantis)
+```
+/bankr Open 5x long on ETH with $100
+/bankr Short BTC 10x with stop loss at $45k
+```
+
+### Automation
+```
+/bankr DCA $100 into ETH weekly
+/bankr Set limit order to buy ETH at $3,000
+/bankr Stop loss for all holdings at -20%
+```
+
+### Token Deployment
+```
+/bankr Deploy a token called BankrFan with symbol BFAN on Base
+/bankr Launch a token called MOON on Solana
+```
+
+### Raw Transactions
+```
+/bankr Submit this transaction: {"to": "0x...", "data": "0x...", "value": "0", "chainId": 8453}
+```
+
+## Supported Chains
+
+| Chain | Native Token | Best For |
+|-------|--------------|----------|
+| Base | ETH | Memecoins, low fees |
+| Polygon | MATIC | Gaming, NFTs |
+| Ethereum | ETH | Blue chips |
+| Solana | SOL | High-speed trading |
+| Unichain | ETH | Newer L2 |
+
+## Tips
+
+- Specify chain for lesser-known tokens: "Buy PEPE on Base"
+- Use Base/Polygon for small amounts (lower gas)
+- Check balance before trades
+- Start small, scale up after testing

package/dist/skills/bundled/betfair/SKILL.md

@@ -0,0 +1,113 @@
+---
+name: betfair
+description: "Betfair Exchange sports betting and trading"
+emoji: "🏇"
+commands:
+  - /bf
+gates:
+  envs:
+    - BETFAIR_APP_KEY
+---
+
+# Betfair Exchange
+
+Full integration with Betfair Exchange, the world's largest sports betting exchange. Trade sports markets using back/lay orders.
+
+## Quick Start
+
+```bash
+# Set credentials
+export BETFAIR_APP_KEY="your-app-key"
+export BETFAIR_SESSION_TOKEN="your-session-token"
+
+# Search markets
+/bf markets football
+
+# Get market prices
+/bf prices 1.234567890
+
+# Place back order (bet FOR outcome)
+/bf back 1.234567890 12345678 2.5 10
+
+# Place lay order (bet AGAINST outcome)
+/bf lay 1.234567890 12345678 2.5 10
+```
+
+## Commands
+
+### Market Data
+
+| Command | Description |
+|---------|-------------|
+| `/bf markets [query]` | Search markets |
+| `/bf market <id>` | Get market details |
+| `/bf prices <marketId>` | Current prices and volumes |
+| `/bf book <marketId> <selectionId>` | Show orderbook |
+
+### Trading
+
+| Command | Description |
+|---------|-------------|
+| `/bf back <marketId> <selectionId> <odds> <stake>` | Place back order |
+| `/bf lay <marketId> <selectionId> <odds> <stake>` | Place lay order |
+| `/bf cancel <marketId> <betId>` | Cancel order |
+| `/bf cancelall [marketId]` | Cancel all orders |
+| `/bf orders [marketId]` | List open orders |
+
+**Examples:**
+```bash
+/bf back 1.234 5678 2.0 10    # Back at 2.0 odds, £10 stake
+/bf lay 1.234 5678 2.1 10     # Lay at 2.1 odds, £10 liability
+/bf cancel 1.234 abc123       # Cancel specific order
+```
+
+### Account
+
+| Command | Description |
+|---------|-------------|
+| `/bf balance` | Check account balance |
+| `/bf positions` | View open positions |
+
+## Configuration
+
+```bash
+# Required
+export BETFAIR_APP_KEY="your-app-key"
+
+# Either session token or username/password
+export BETFAIR_SESSION_TOKEN="your-session-token"
+
+# Or login credentials
+export BETFAIR_USERNAME="your-username"
+export BETFAIR_PASSWORD="your-password"
+```
+
+## Features
+
+- **Back/Lay Trading** - Trade both sides of markets
+- **Live Streaming** - Real-time price updates via WebSocket
+- **Sports Coverage** - Football, tennis, horse racing, politics, and more
+- **Low Fees** - Exchange model with 2-5% commission
+- **Deep Liquidity** - World's largest betting exchange
+
+## Event Types
+
+| Sport | ID | Example Query |
+|-------|-----|---------------|
+| Soccer | 1 | `/bf markets champions league` |
+| Tennis | 2 | `/bf markets wimbledon` |
+| Horse Racing | 7 | `/bf markets ascot` |
+| Politics | 2378961 | `/bf markets election` |
+| Basketball | 7522 | `/bf markets nba` |
+
+## Trading Notes
+
+1. **Odds Format**: Betfair uses decimal odds (2.0 = evens, 3.0 = 2/1)
+2. **Minimum Stake**: Usually £2/€2/$2
+3. **Back vs Lay**: Back = betting FOR, Lay = betting AGAINST
+4. **Liability**: Lay stake = liability / (odds - 1)
+
+## Resources
+
+- [Betfair Exchange](https://www.betfair.com/exchange/)
+- [Betfair API Documentation](https://docs.developer.betfair.com/)

package/dist/skills/bundled/binance-futures/SKILL.md

@@ -0,0 +1,84 @@
+---
+name: binance-futures
+description: Binance Futures trading with DB tracking
+emoji: "🟡"
+commands:
+  - /bf
+gates:
+  envs:
+    - BINANCE_API_KEY
+---
+
+# Binance Futures
+
+Trade perpetual futures on Binance with up to 125x leverage and full database tracking.
+
+## Quick Start
+
+```bash
+# Set credentials
+export BINANCE_API_KEY="your-api-key"
+export BINANCE_API_SECRET="your-api-secret"
+
+# Check balance
+/bf balance
+
+# Open position
+/bf long BTCUSDT 0.01 10x
+
+# View stats
+/bf stats
+```
+
+## Commands
+
+### Account
+
+| Command | Description |
+|---------|-------------|
+| `/bf balance` | Check margin balance |
+| `/bf positions` | View open positions |
+| `/bf orders` | List open orders |
+
+### Trading
+
+| Command | Description |
+|---------|-------------|
+| `/bf long <symbol> <size> [leverage]x` | Open long position |
+| `/bf short <symbol> <size> [leverage]x` | Open short position |
+| `/bf close <symbol>` | Close position |
+| `/bf closeall` | Close all positions |
+| `/bf tp <symbol> <price>` | Set take-profit |
+| `/bf sl <symbol> <price>` | Set stop-loss |
+| `/bf leverage <symbol> <value>` | Set leverage |
+
+### Market Data
+
+| Command | Description |
+|---------|-------------|
+| `/bf price <symbol>` | Get current price |
+| `/bf funding <symbol>` | Check funding rate |
+| `/bf markets [query]` | List markets |
+
+### Database/History
+
+| Command | Description |
+|---------|-------------|
+| `/bf trades [symbol] [limit]` | Trade history from database |
+| `/bf dbstats [symbol] [period]` | Win rate, PnL, profit factor |
+| `/bf dbfunding [symbol]` | Funding payments history |
+| `/bf dbpositions [all]` | Position history |
+
+**Stats periods:** `day`, `week`, `month`
+
+## Examples
+
+```bash
+/bf long BTCUSDT 0.01 10x      # 10x leveraged long
+/bf short ETHUSDT 0.1 20x      # 20x leveraged short
+/bf tp BTCUSDT 105000          # Take profit at $105k
+/bf sl BTCUSDT 95000           # Stop loss at $95k
+/bf close BTCUSDT              # Close BTC position
+/bf trades BTCUSDT 20          # Last 20 BTC trades
+/bf dbstats ETHUSDT week       # ETH stats for past week
+```

package/dist/skills/bundled/binance-futures/index.d.ts

@@ -7,9 +7,6 @@ declare const skill: {
     name: string;
     description: string;
     commands: string[];
-    requires: {
-        env: string[];
-    };
     handle(args: string): Promise<string>;
 };
 export default skill;

package/dist/skills/bundled/binance-futures/index.js

@@ -392,8 +392,7 @@ async function handleDbPositions(showAll) {
 const skill = {
     name: 'binance-futures',
     description: 'Binance Futures trading with DB tracking',
-    commands: ['/bf'],
-    requires: { env: ['BINANCE_API_KEY', 'BINANCE_API_SECRET'] },
+    commands: ['/binance', '/binance-futures'],
     async handle(args) {
         const parts = args.trim().split(/\s+/);
         const cmd = parts[0]?.toLowerCase();