vibetrader

# VibeTrader - AI Trading Bots

Create and manage AI-powered trading bots using natural language. Trade stocks, ETFs, crypto, and options with automated strategies.

## What You Can Do

### 🤖 Bot Management
- **Create bots** from natural language: "Create a bot that buys AAPL when RSI drops below 30"
- **List, start, pause, delete** your bots
- **View bot performance** and trade history
- **Backtest strategies** before going live

### 📊 Portfolio & Trading
- **View positions** and account balance
- **Get real-time quotes** for stocks, ETFs, and crypto
- **Place manual orders** (buy/sell)
- **Switch between paper and live trading**

### 📈 Market Data
- Stock and ETF quotes
- Options chains with Greeks
- Market status checks

## Setup

1. **Get your API key** from [vibetrader.markets/settings](https://vibetrader.markets/settings)

2. **Set the environment variable** in your OpenClaw config (`~/.openclaw/openclaw.json`):

```json
{
  "skills": {
    "entries": {
      "vibetrader": {
        "env": {
          "VIBETRADER_API_KEY": "vt_your_api_key_here"
        }
      }
    }
  }
}
```

Or export it in your shell:
```bash
export VIBETRADER_API_KEY="vt_your_api_key_here"
```

## REST API Endpoints

**Base URL:** `https://vibetrader-mcp-289016366682.us-central1.run.app`

**Authentication:** Include header `Authorization: Bearer YOUR_API_KEY` with every request.

### Health Check
```
GET /api/health
```

### List All Bots
```
GET /api/bots
GET /api/bots?mode=paper
GET /api/bots?mode=live
```

### Get Specific Bot
```
GET /api/bot?id=BOT_ID
```

### Get Portfolio (Account + Positions)
```
GET /api/portfolio?mode=paper
GET /api/portfolio?mode=live
```

### Get Positions Only
```
GET /api/positions?mode=paper
```

### Get Account Summary
```
GET /api/account?mode=paper
```

### Get Stock Quote
```
GET /api/quote?symbol=AAPL
GET /api/quote?symbol=TSLA
```

### Get Recent Trades
```
GET /api/trades?mode=paper&limit=20
```

### Check Market Status
```
GET /api/market-statu...

# VibeTrader Skill for OpenClaw

Create and manage AI-powered trading bots directly from WhatsApp, Telegram, Slack, Discord, or any other OpenClaw channel.

## Installation

### Via ClawHub (Recommended)

```bash
clawhub install vibetrader
```

### Manual Installation

Copy this folder to your OpenClaw skills directory:

```bash
cp -r openclaw-skill ~/.openclaw/skills/vibetrader
```

## Configuration

1. **Get your API key** from [vibetrader.markets/settings](https://vibetrader.markets/settings)

2. **Add to your OpenClaw config** (`~/.openclaw/openclaw.json`):

```json
{
  "skills": {
    "entries": {
      "vibetrader": {
        "env": {
          "VIBETRADER_API_KEY": "vt_your_api_key_here"
        }
      }
    }
  }
}
```

3. **Restart OpenClaw** to pick up the new skill

## Usage Examples

Once installed, just chat naturally with your OpenClaw assistant:

### Create Bots
> "Create a trading bot that buys AAPL when RSI drops below 30"

> "Make an NVDA momentum bot with a 5% trailing stop"

> "Build a crypto scalping bot for BTC/USD"

### Manage Portfolio
> "What's my portfolio value?"

> "Show my open positions"

> "Buy $500 of TSLA"

### Monitor Bots
> "Show me all my bots"

> "Pause my AAPL bot"

> "How did my bots perform today?"

### Market Data
> "What's the current price of Apple?"

> "Is the market open?"

## Features

- 🤖 **Natural Language Bot Creation** - Describe your strategy, AI builds the bot
- 📊 **Portfolio Tracking** - Real-time positions and P&L
- 📈 **Live & Paper Trading** - Practice risk-free or trade for real
- ⏱️ **Backtesting** - Test strategies on historical data
- 🔔 **Multi-Channel** - Manage from WhatsApp, Telegram, Slack, etc.

## Links

- **Website**: https://vibetrader.markets
- **Get API Key**: https://vibetrader.markets/settings
- **Documentation**: https://vibetrader.markets/docs

## License

MIT