🎯 Zigma Oracle - Moltbot Skill

Prediction market intelligence via chat with $ZIGMA token gating

Features

• Alpha Signals: Get top trading signals with edge analysis (tier-gated)
• Market Analysis: Deep dive into specific prediction markets
• Portfolio Tracking: Track markets and get alerts
• Wallet Analysis: Analyze Polymarket trader performance (tier-gated)
• Arbitrage Scanner: Find price discrepancies across markets (PRO/Whale only)
• Wallet Connection: Connect your wallet for premium features

Installation

npm install zigma-oracle

Usage

Basic Commands

# Connect your wallet for premium features
zigma connect 0x1234...

# Get top 5 signals
zigma alpha

# Get 10 signals with 5% edge minimum
zigma alpha --limit 10 --minEdge 5

# Analyze a market
zigma analyze "Will ETH hit $5k?"

# Track a market
zigma track "Will BTC hit $100k?"

# View portfolio
zigma portfolio

# Analyze a wallet
zigma wallet 0x1234...

# Scan for arbitrage (PRO/Whale only)
zigma arb

Token Gating

Tiers

| Feature | Free | Basic (100 $ZIGMA) | Pro (1000 $ZIGMA) | Whale (10k $ZIGMA) | |---------|------|-------------------|-------------------|-------------------| | Signals per day | 3 | 15 | Unlimited | Unlimited | | Heartbeat alerts | ❌ | ✅ (hourly) | ✅ (15 min) | ✅ (real-time) | | Arbitrage scanner | ❌ | ❌ | ✅ | ✅ | | Wallet analysis | 1/day | 5/day | Unlimited | Unlimited | | Custom tracking | 1 | 5 | 25 | Unlimited | | Exit signals | ❌ | ❌ | ✅ | ✅ | | API access | ❌ | ❌ | ❌ | ✅ | | Signal priority | Edge only | Edge + Confidence | Edge + Confidence + Liquidity | All factors |

Connecting Your Wallet

zigma connect 0x1234567890123456789012345678901234567890

This will:

• Check your $ZIGMA token balance
• Determine your tier
• Unlock premium features
• Track your daily usage

Daily Limits

Each tier has daily usage limits:

• Free: 3 signals/day, 1 wallet analysis/day, 1 tracked market
• Basic: 15 signals/day, 5 wallet analyses/day, 5 tracked markets
• Pro: Unlimited signals/wallet analyses, 25 tracked markets
• Whale: Unlimited everything + API access

Configuration

Set environment variables:

ZIGMA_API_URL=https://api.zigma.pro
ZIGMA_API_KEY=your_api_key

Development

# Install dependencies
npm install

# Build
npm run build

# Watch mode
npm run build:watch

# Test
npm test

# Lint
npm run lint

Testing

# Run all tests
npm test

# Run with coverage
npm test -- --coverage

License

MIT

📱 Commands

| Command | Description | Example | |---------|-------------|---------| | zigma alpha | Get top trading signals | zigma alpha --minEdge 5 | | zigma analyze [market] | Analyze a specific market | zigma analyze trump-2024 | | zigma track [market] | Track a market for alerts | zigma track fed-rate-cut | | zigma portfolio | View tracked markets | zigma portfolio | | zigma wallet [address] | Analyze a trader | zigma wallet 0x123... | | zigma arb | Scan for arbitrage | zigma arb |

🛠 Installation

Prerequisites

• Moltbot v0.50.0+
• Node.js 20+
• Zigma API access (or self-hosted Zigma instance)

Quick Install

# Navigate to your Moltbot skills directory
cd ~/.moltbot/skills

# Clone the skill
git clone https://github.com/zigma-oracle/moltbot-skill zigma-oracle

# Install dependencies
cd zigma-oracle && npm install

# Build
npm run build

Configuration

Add to your .env:

# Required
ZIGMA_API_URL=https://api.zigma.pro
ZIGMA_API_KEY=your_api_key_here

# Optional - for premium features
ZIGMA_WALLET=0x...  # Your wallet for token-gated features

Enable the Skill

In your Moltbot config or via chat:

hey moltbot, enable the zigma-oracle skill

💬 Usage Examples

Get Trading Signals

You: zigma alpha

🎯 Top 3 Zigma Signals
Updated: 2:34 PM

1. 📈 BUY YES 🔥
> Will ETH hit $5k before June 2025?

• Market: 42% → Zigma: 58%
• Edge: +16.0% | Conf: 82%
• Kelly: 4.2% | Liq: $245k ✅

2. 📉 BUY NO ✅
> Biden wins 2024 election?

• Market: 12% → Zigma: 4%
• Edge: +8.0% | Conf: 78%
• Kelly: 2.1% | Liq: $1.2M ✅

---
Reply with a number to track.

Analyze a Market

You: zigma analyze https://polymarket.com/event/fed-rate-cut-march

🎯 Market Analysis

Will the Fed cut rates in March 2025?

📊 Probabilities
• Zigma Fair Value: 67.2%
• Confidence: 85%
• Edge: +5.2%

📝 Recommendation: BUY YES

💡 Analysis:
Recent Fed minutes indicate dovish pivot. Inflation trending 
down to 2.3%. Labor market cooling. 3 FOMC members have 
signaled openness to cuts...

📰 Recent News:
• Fed Chair signals patience on rates (Reuters)
• December CPI comes in below expectations (WSJ)

Proactive Alerts

🔔 Zigma Alert: Strong Signal

🔥 STRONG TRADE detected!

📈 BUY YES: "Will SpaceX Starship reach orbit in 2025?"
• Edge: +12.3% (Zigma: 78% vs Market: 66%)
• Confidence: 88% | Tier: STRONG_TRADE
• Kelly suggests: 5.1% of bankroll

Reply "zigma track starship-orbit" to follow this market

🎟 Token Gating (Optional)

Hold $ZIGMA tokens for premium features:

| Tier | Tokens Required | Features | |------|-----------------|----------| | Free | 0 | 3 signals/day, basic analysis | | Basic | 100 $ZIGMA | 15 signals/day, hourly alerts | | Pro | 1000 $ZIGMA | Unlimited, 15-min alerts, arbitrage | | Whale | 10000 $ZIGMA | Real-time alerts, API access |

🔧 Self-Hosting Zigma Backend

Don't want to use the hosted API? Run your own:

# Clone Zigma backend
git clone https://github.com/zigma-oracle/zigma-backend
cd zigma-backend

# Install and configure
npm install
cp .env.example .env
# Edit .env with your API keys (Polymarket, OpenAI/Anthropic, etc.)

# Run
npm start

Then point your skill to http://localhost:3001.

📊 How It Works

┌─────────────────────────────────────────────────────────┐
│                    YOUR MESSAGE                         │
│              "zigma alpha --minEdge 5"                  │
└───────────────────────┬─────────────────────────────────┘
                        │
                        ▼
┌─────────────────────────────────────────────────────────┐
│                   MOLTBOT                               │
│           (Routes to Zigma Skill)                       │
└───────────────────────┬─────────────────────────────────┘
                        │
                        ▼
┌─────────────────────────────────────────────────────────┐
│               ZIGMA ORACLE API                          │
├─────────────────────────────────────────────────────────┤
│  1. Fetch live Polymarket data                         │
│  2. Run LLM analysis (news, orderbook, sentiment)      │
│  3. Calculate edge vs market odds                       │
│  4. Apply Kelly criterion for position sizing          │
│  5. Filter by confidence & liquidity thresholds        │
└───────────────────────┬─────────────────────────────────┘
                        │
                        ▼
┌─────────────────────────────────────────────────────────┐
│              FORMATTED RESPONSE                         │
│        (Signals, analysis, recommendations)             │
└─────────────────────────────────────────────────────────┘

🤝 Contributing

PRs welcome! See CONTRIBUTING.md.

Development

# Clone
git clone https://github.com/zigma-oracle/moltbot-skill
cd moltbot-skill

# Install
npm install

# Dev mode (watches for changes)
npm run dev

# Test
npm test

📜 License

MIT - see LICENSE

🔗 Links

• Zigma Website
• Zigma Twitter
• Moltbot Discord
• $ZIGMA Token

Built with 🦀 by the Zigma team

Not financial advice. Prediction markets involve risk. Always DYOR.