Introduction
MoltWave is an autonomous market intelligence platform built on the ClawLayer agent framework. It deploys ElizaOS-powered agents that continuously monitor prediction markets, aggregate sentiment data, and generate structured research reports โ all without human intervention.
What MoltWave Does
Instead of manually scrolling through Kalshi, Polymarket, and Twitter to piece together market narratives, MoltWave agents do it for you. They produce daily briefings, weekly deep dives, real-time edge alerts, and custom research reports that would take a human analyst hours to compile.
Architecture
// MoltWave Pipeline
DATA SOURCES โ Kalshi, Polymarket, Twitter/X, On-chain
โ
INGESTION โ Real-time WebSocket + REST polling
โ
ANALYSIS โ ElizaOS multi-step reasoning agents
โ
GENERATION โ Structured reports (MD, JSON, PDF)
โ
DELIVERY โ Dashboard, Email, API, Webhooks
Key Concepts
Report Agent โ An autonomous ElizaOS agent configured with specific market focus, analysis strategy, and output format. Each agent runs independently and can be customized.
Data Source โ A connection to an external data provider (prediction market, sentiment feed, blockchain). MoltWave normalizes all data into a unified schema.
Template โ A report structure that defines sections, data points, and formatting rules. Templates are composable and extensible.
Quick Start
Get your first MoltWave agent running in under 5 minutes.
1. Install
npm install -g moltwave
2. Initialize
moltwave init
# Creates moltwave.config.json in current directory
# Prompts for API keys: Kalshi, Polymarket, Twitter
3. Configure Your First Agent
{
"agent": {
"name": "macro-daily",
"type": "daily_briefing",
"sources": ["kalshi", "polymarket", "twitter"],
"markets": ["macro", "crypto", "politics"],
"schedule": "0 6 * * *",
"output": {
"format": "markdown",
"delivery": ["dashboard", "webhook"]
}
}
}
4. Launch
moltwave spawn macro-daily
# Output:
โ Agent macro-daily spawned
โ Connected to 3 data sources
โ Next report: 06:00 UTC
โ Dashboard: http://localhost:4040
That's it. Your agent will generate its first daily briefing at 06:00 UTC, accessible via the local dashboard or your configured webhook.
Configuration
MoltWave uses a moltwave.config.json file for all agent and platform configuration.
Full Config Example
{
"version": "1.0",
"wallet": "~/.config/solana/id.json",
"rpc": "https://api.mainnet-beta.solana.com",
"keys": {
"kalshi": "env:KALSHI_API_KEY",
"polymarket": "env:POLY_API_KEY",
"twitter": "env:TWITTER_BEARER"
},
"agents": [...],
"delivery": {
"webhook_url": "https://your-server.com/reports",
"email": "you@example.com"
}
}
Environment Variables
All sensitive keys support the env: prefix to pull from environment variables. Store your keys in a .env file:
KALSHI_API_KEY=your_kalshi_key
POLY_API_KEY=your_polymarket_key
TWITTER_BEARER=your_twitter_bearer_token
Report Agents
Report agents are the core of MoltWave. Each agent is an autonomous ElizaOS instance configured to monitor specific markets, run analysis, and produce structured outputs.
Agent Types
daily_briefing โ Morning intelligence report covering top movers, edge opportunities, and sentiment snapshots. Runs on a cron schedule.
weekly_deepdive โ Comprehensive market analysis with historical comparisons, trend identification, and forward-looking projections.
edge_alert โ Real-time agent that monitors for cross-platform arbitrage, probability divergences, and unusual volume spikes. Triggers immediately.
sentiment_tracker โ Continuously correlates social sentiment with market pricing, flagging significant divergences.
custom โ Build your own agent type with custom analysis pipelines and output formats.
Agent Lifecycle
moltwave spawn <agent-name>
# Start agent
moltwave status
# View all running agents
moltwave logs <agent-name>
# Stream agent logs
moltwave pause <agent-name>
# Pause without killing
moltwave kill <agent-name>
# Stop agent
moltwave report <agent-name>
# Force immediate report
Data Sources
MoltWave supports multiple data sources out of the box, with a plugin system for adding custom sources.
Built-in Sources
kalshi โ CFTC-regulated prediction markets. Access to all active markets, historical data, and order book depth.
polymarket โ Decentralized prediction markets on Polygon. Real-time CLOB data and on-chain settlement tracking.
twitter โ Sentiment analysis via Twitter/X API. Tracks mentions, sentiment scores, and trending topics related to your market watchlist.
onchain โ Solana on-chain data including whale tracking, staking flows, and DeFi protocol metrics.
Adding Custom Sources
// plugins/custom-source.js
export default {
name: "my-source",
connect: async (config) => { ... },
fetch: async (query) => { ... },
normalize: (raw) => ({
market: raw.title,
probability: raw.price,
volume: raw.vol,
timestamp: raw.ts
})
}
Report Templates
Templates define the structure and content of generated reports. MoltWave ships with several built-in templates that can be customized or extended.
Built-in Templates
daily-brief โ Morning intelligence: top movers, edges, sentiment, AI insights. ~2 pages.
weekly-macro โ Full market review with charts, trend analysis, and projections. ~10-24 pages.
edge-alert โ Concise alert format: market, current price, edge detected, confidence, recommended action.
sentiment-report โ Detailed sentiment analysis with correlation heatmaps and divergence tracking.
Custom Templates
{
"name": "my-template",
"sections": [
{ "type": "header", "title": "{{date}} Report" },
{ "type": "top_movers", "count": 10 },
{ "type": "edge_scan", "threshold": 2.0 },
{ "type": "ai_insight", "max_tokens": 500 },
{ "type": "footer" }
]
}
API Reference
MoltWave exposes a REST API for programmatic access to reports, agent management, and market data.
Base URL
https://api.moltwave.xyz/v1
Authentication
// Include in headers
Authorization: Bearer <your_api_key>
Endpoints
GET /reports # List all reports
GET /reports/:id # Get specific report
GET /reports/latest # Get most recent report
POST /reports/generate # Force generate a report
GET /agents # List running agents
POST /agents/spawn # Spawn new agent
POST /agents/:id/kill # Kill agent
GET /markets # Aggregated market data
GET /markets/:id/edges # Edge opportunities
GET /sentiment # Current sentiment data
Example: Fetch Latest Report
const res = await fetch('https://api.moltwave.xyz/v1/reports/latest', {
headers: { Authorization: `Bearer ${API_KEY}` }
});
const report = await res.json();
console.log(report.title, report.generated_at);
Webhooks
MoltWave can push reports and alerts to your server via webhooks. Configure a webhook URL in your config file or via the API.
Webhook Payload
{
"event": "report.generated",
"agent": "macro-daily",
"report": {
"id": "rpt_abc123",
"type": "daily_briefing",
"generated_at": "2026-02-26T06:00:00Z",
"content": "...",
"markets_analyzed": 142,
"edges_found": 3
}
}
Event Types
report.generated โ Fired when any scheduled report is generated.
edge.detected โ Real-time alert when an edge opportunity is found.
agent.error โ Notification when an agent encounters an error.
agent.status โ Periodic heartbeat with agent health metrics.
Custom Strategies
Build custom analysis strategies that define how your agents process and interpret market data.
// strategies/momentum.js
export default {
name: "momentum-detector",
analyze(markets) {
return markets
.filter(m => Math.abs(m.change24h) > 5)
.map(m => ({
market: m.title,
signal: m.change24h > 0 ? "BULLISH_MOMENTUM" : "BEARISH_MOMENTUM",
strength: Math.abs(m.change24h) / 10,
recommendation: this.getAction(m)
}));
},
getAction(market) {
if (market.change24h > 10) return "STRONG_BUY";
if (market.change24h > 5) return "BUY";
if (market.change24h < -10) return "STRONG_SELL";
return "MONITOR";
}
}
SDK
The MoltWave SDK provides a programmatic interface for integrating market intelligence into your own applications.
Installation
npm install @moltwave/sdk
Usage
import { MoltWave } from '@moltwave/sdk';
const mw = new MoltWave({ apiKey: process.env.MW_KEY });
// Get latest report
const report = await mw.reports.latest();
// Stream edge alerts
mw.edges.subscribe((edge) => {
console.log(`Edge found: ${edge.market} โ ${edge.spread}% arb`);
});
// Get sentiment for specific market
const sentiment = await mw.sentiment.get('btc-150k-eoy');
// Spawn agent programmatically
await mw.agents.spawn({
name: "my-agent",
type: "edge_alert",
markets: ["crypto"],
threshold: 2.5
});
