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-status
```

### Example with curl
```
curl -H "Authorization: Bearer vt_YOUR_KEY" https://vibetrader-mcp-289016366682.us-central1.run.app/api/bots
```

## MCP Tools (Alternative)

If your agent supports MCP protocol, these tools are available via the MCP server:

| Tool | Description |
|------|-------------|
| `authenticate` | Connect with your API key (auto-uses env var if set) |
| `create_bot` | Create a trading bot from natural language (use `prompt` param) |
| `list_bots` | List all your bots with status |
| `get_bot` | Get detailed bot info and strategy |
| `start_bot` | Start a paused bot |
| `pause_bot` | Pause a running bot |
| `delete_bot` | Delete a bot |
| `get_portfolio` | View positions and balance |
| `get_positions` | View current open positions |
| `get_account_summary` | Get account balance and buying power |
| `place_order` | Place a buy/sell order |
| `close_position` | Close an existing position |
| `get_quote` | Get stock/ETF/crypto quotes |
| `get_trade_history` | See recent trades |
| `run_backtest` | Backtest a bot's strategy |
| `get_market_status` | Check if markets are open |

## Example Prompts

### Create Trading Bots
- "Create a momentum bot that buys TSLA when RSI crosses below 30 and sells above 70"
- "Make an NVDA bot with a 5% trailing stop loss"
- "Create a crypto scalping bot for BTC/USD on the 5-minute chart"
- "Build an iron condor bot for SPY when IV rank is above 50"

### Manage Your Bots
- "Show me all my bots and how they're performing"
- "Pause my AAPL momentum bot"
- "What trades did my bots make today?"
- "Delete all my paused bots"

### Portfolio Management
- "What's my current portfolio value?"
- "Show my open positions with P&L"
- "Buy $500 worth of NVDA"
- "Close my TSLA position"

### Market Research
- "What's the current price of Apple stock?"
- "Get the options chain for SPY expiring this Friday"
- "Is the market open right now?"

### Backtesting
- "Backtest my RSI bot on the last 30 days"
- "How would a moving average crossover strategy have performed on QQQ?"

## Trading Modes

- **Paper Trading** (default): Practice with virtual money, no risk
- **Live Trading**: Real money trades via Alpaca brokerage

Switch modes with: "Switch to live trading mode" or "Use paper trading"

## MCP Server

This skill connects to the VibeTrader MCP server at:
```
https://vibetrader-mcp-289016366682.us-central1.run.app/mcp
```

## Support

- Website: [vibetrader.markets](https://vibetrader.markets)
- Documentation: [vibetrader.markets/docs](https://vibetrader.markets/docs)

---

## 中文说明

# VibeTrader —— AI 交易机器人

使用自然语言创建和管理 AI 驱动的交易机器人。通过自动化策略交易股票、ETF、加密货币和期权。

## 你能做什么

### 🤖 机器人管理
- **从自然语言创建机器人**："Create a bot that buys AAPL when RSI drops below 30"
- **列出、启动、暂停、删除**你的机器人
- **查看机器人表现**和交易历史
- **在上线前回测策略**

### 📊 投资组合与交易
- **查看持仓**和账户余额
- **获取股票、ETF 和加密货币的实时报价**
- **下达手动订单**（买入/卖出）
- **在纸面交易和实盘交易之间切换**

### 📈 市场数据
- 股票和 ETF 报价
- 带希腊字母（Greeks）的期权链
- 市场状态检查

## 设置

1. **获取你的 API 密钥**，从 [vibetrader.markets/settings](https://vibetrader.markets/settings)

2. **在你的 OpenClaw 配置（`~/.openclaw/openclaw.json`）中设置环境变量**：

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

或在你的 shell 中导出：
```bash
export VIBETRADER_API_KEY="vt_your_api_key_here"
```

## REST API 端点

**基础 URL：** `https://vibetrader-mcp-289016366682.us-central1.run.app`

**认证：** 每个请求都包含请求头 `Authorization: Bearer YOUR_API_KEY`。

### 健康检查
```
GET /api/health
```

### 列出所有机器人
```
GET /api/bots
GET /api/bots?mode=paper
GET /api/bots?mode=live
```

### 获取特定机器人
```
GET /api/bot?id=BOT_ID
```

### 获取投资组合（账户 + 持仓）
```
GET /api/portfolio?mode=paper
GET /api/portfolio?mode=live
```

### 仅获取持仓
```
GET /api/positions?mode=paper
```

### 获取账户摘要
```
GET /api/account?mode=paper
```

### 获取股票报价
```
GET /api/quote?symbol=AAPL
GET /api/quote?symbol=TSLA
```

### 获取近期交易
```
GET /api/trades?mode=paper&limit=20
```

### 检查市场状态
```
GET /api/market-status
```

### curl 示例
```
curl -H "Authorization: Bearer vt_YOUR_KEY" https://vibetrader-mcp-289016366682.us-central1.run.app/api/bots
```

## MCP 工具（替代方案）

如果你的代理支持 MCP 协议，可通过 MCP 服务器使用以下工具：

| 工具 | 说明 |
|------|------|
| `authenticate` | 使用你的 API 密钥连接（若已设置则自动使用环境变量） |
| `create_bot` | 从自然语言创建交易机器人（使用 `prompt` 参数） |
| `list_bots` | 列出你所有机器人及其状态 |
| `get_bot` | 获取机器人的详细信息和策略 |
| `start_bot` | 启动一个已暂停的机器人 |
| `pause_bot` | 暂停一个运行中的机器人 |
| `delete_bot` | 删除一个机器人 |
| `get_portfolio` | 查看持仓和余额 |
| `get_positions` | 查看当前未平仓持仓 |
| `get_account_summary` | 获取账户余额和购买力 |
| `place_order` | 下达买入/卖出订单 |
| `close_position` | 平掉一个现有持仓 |
| `get_quote` | 获取股票/ETF/加密货币报价 |
| `get_trade_history` | 查看近期交易 |
| `run_backtest` | 回测某个机器人的策略 |
| `get_market_status` | 检查市场是否开放 |

## 示例提示词

### 创建交易机器人
- "Create a momentum bot that buys TSLA when RSI crosses below 30 and sells above 70"
- "Make an NVDA bot with a 5% trailing stop loss"
- "Create a crypto scalping bot for BTC/USD on the 5-minute chart"
- "Build an iron condor bot for SPY when IV rank is above 50"

### 管理你的机器人
- "Show me all my bots and how they're performing"
- "Pause my AAPL momentum bot"
- "What trades did my bots make today?"
- "Delete all my paused bots"

### 投资组合管理
- "What's my current portfolio value?"
- "Show my open positions with P&L"
- "Buy $500 worth of NVDA"
- "Close my TSLA position"

### 市场研究
- "What's the current price of Apple stock?"
- "Get the options chain for SPY expiring this Friday"
- "Is the market open right now?"

### 回测
- "Backtest my RSI bot on the last 30 days"
- "How would a moving average crossover strategy have performed on QQQ?"

## 交易模式

- **纸面交易**（默认）：用虚拟资金练习，无风险
- **实盘交易**：通过 Alpaca 券商进行真实资金交易

切换模式："Switch to live trading mode" 或 "Use paper trading"

## MCP 服务器

此技能连接到位于以下地址的 VibeTrader MCP 服务器：
```
https://vibetrader-mcp-289016366682.us-central1.run.app/mcp
```

## 支持

- 网站：[vibetrader.markets](https://vibetrader.markets)
- 文档：[vibetrader.markets/docs](https://vibetrader.markets/docs)