← 返回 Skills 市场
vamzi

Alpaca Trading

作者 vamzi · GitHub ↗ · v1.0.0
cross-platform ⚠ suspicious
2098
总下载
3
收藏
6
当前安装
1
版本数
在 OpenClaw 中安装
/install alpaca
功能描述
Trade stocks and crypto via Alpaca API. Use for market data (quotes, bars, news), placing orders (market, limit, stop), checking positions, portfolio management, and account info. Supports both paper and live trading. Use when user asks about stock prices, wants to buy/sell securities, check portfolio, or manage trades.
使用说明 (SKILL.md)

Alpaca Trading Skill

Trade stocks and crypto programmatically via Alpaca's API.

Setup

Requires API credentials stored in environment or config:

# Set environment variables
export ALPACA_API_KEY="your-api-key"
export ALPACA_SECRET_KEY="your-secret-key"
export ALPACA_PAPER="true"  # "true" for paper, "false" for live

Or store in ~/.openclaw/credentials/alpaca.json:

{
  "apiKey": "your-api-key",
  "secretKey": "your-secret-key",
  "paper": true
}

Quick Reference

Get Quote

python3 scripts/alpaca_cli.py quote AAPL
python3 scripts/alpaca_cli.py quote AAPL,TSLA,NVDA

Get Bars (Historical Data)

python3 scripts/alpaca_cli.py bars AAPL --timeframe 1Day --limit 10
python3 scripts/alpaca_cli.py bars AAPL --timeframe 1Hour --start 2026-02-01

Check Account

python3 scripts/alpaca_cli.py account

List Positions

python3 scripts/alpaca_cli.py positions

Place Orders

# Market order
python3 scripts/alpaca_cli.py order buy AAPL 10

# Limit order
python3 scripts/alpaca_cli.py order buy AAPL 10 --limit 150.00

# Stop order
python3 scripts/alpaca_cli.py order sell TSLA 5 --stop 200.00

# Stop-limit order
python3 scripts/alpaca_cli.py order sell TSLA 5 --stop 200.00 --limit 195.00

# Skip price validation (use with caution)
python3 scripts/alpaca_cli.py order buy AAPL 10 --limit 999.00 --force

Order Guardrails:

  1. Symbol validation — Rejects invalid/unknown tickers
  2. Buying power check — Blocks orders exceeding available funds, shows max shares
  3. Duplicate detection — Warns if you have open orders for same symbol/side
  4. Price validation — Warns if limit price is worse than market
  5. Market hours check — Detects pre-market, after-hours, and closed sessions
    • Pre-market (4:00 AM - 9:30 AM ET): Option to place pre-market order
    • After-hours (4:00 PM - 8:00 PM ET): Option to place after-hours order
    • Closed: Warns order will queue until market open
  6. Cost confirmation — Shows total cost and requires confirmation

Use --force to skip all confirmation prompts (use with caution).

List Orders

python3 scripts/alpaca_cli.py orders
python3 scripts/alpaca_cli.py orders --status open
python3 scripts/alpaca_cli.py orders --status closed --limit 20

Cancel Order

python3 scripts/alpaca_cli.py cancel ORDER_ID
python3 scripts/alpaca_cli.py cancel all  # Cancel all open orders

Get News

python3 scripts/alpaca_cli.py news AAPL
python3 scripts/alpaca_cli.py news AAPL,TSLA --limit 5

Watchlist

python3 scripts/alpaca_cli.py watchlist list
python3 scripts/alpaca_cli.py watchlist create "Tech Stocks" AAPL,MSFT,GOOGL
python3 scripts/alpaca_cli.py watchlist add WATCHLIST_ID NVDA
python3 scripts/alpaca_cli.py watchlist delete WATCHLIST_ID

Stream Live Data (Websocket)

# Stream trades (default)
python3 scripts/alpaca_cli.py stream AAPL

# Stream quotes
python3 scripts/alpaca_cli.py stream AAPL,TSLA --type quotes

# Stream bars (1-min)
python3 scripts/alpaca_cli.py stream NVDA --type bars

# Stream all data types
python3 scripts/alpaca_cli.py stream AAPL --type all

Press Ctrl+C to stop streaming.

Price Alerts

# Add alert - notify when INTU drops below $399
python3 scripts/alpaca_cli.py alert add --symbol INTU --price 399 --condition below

# Add alert - notify when AAPL goes above $300
python3 scripts/alpaca_cli.py alert add --symbol AAPL --price 300 --condition above

# List active alerts
python3 scripts/alpaca_cli.py alert list

# Check alerts (used by cron)
python3 scripts/alpaca_cli.py alert check

# Remove an alert
python3 scripts/alpaca_cli.py alert remove --alert_id ABC123

# Clear all alerts
python3 scripts/alpaca_cli.py alert clear

Alerts are stored in ~/.openclaw/data/alpaca-alerts.json.

Script Location

All commands use: scripts/alpaca_cli.py (relative to this skill directory)

API Reference

See references/api.md for detailed API documentation and response formats.

Safety Notes

  • Always confirm with user before placing real trades
  • Paper trading (ALPACA_PAPER=true) recommended for testing
  • Check buying power before large orders
  • Verify order details before submission
安全使用建议
This skill appears to implement a real Alpaca CLI, but several inconsistencies mean you should not install it blindly. Before installing: (1) Confirm the source/author (homepage unknown) and review the full script yourself. (2) Expect to provide sensitive Alpaca credentials (ALPACA_API_KEY and ALPACA_SECRET_KEY); do not store live keys until you trust the code. (3) The package lacks an install spec — install alpaca-py in a safe environment (virtualenv) and test with ALPACA_PAPER=true (paper trading) first. (4) Ask the publisher to update registry metadata to declare required env vars and dependency requirements. (5) Because the agent can invoke skills autonomously, consider disabling autonomous invocation or requiring explicit confirmation before any real trade (avoid using --force) until you fully trust the skill.
功能分析
Type: OpenClaw Skill Name: alpaca Version: 1.0.0 The OpenClaw Alpaca skill is benign. It is designed to interact with the Alpaca API for trading and market data, which is its stated purpose. The `SKILL.md` provides clear instructions and emphasizes safety with 'Order Guardrails' and 'Safety Notes' for the AI agent, showing no signs of prompt injection. The `alpaca_cli.py` script securely loads credentials from environment variables or `~/.openclaw/credentials/alpaca.json`, stores alerts in `~/.openclaw/data/alpaca-alerts.json`, and implements robust input validation and user confirmation steps before executing sensitive actions like placing orders. There is no evidence of data exfiltration, malicious execution, persistence, or obfuscation.
能力评估
ℹ Purpose & Capability
The name/description (Alpaca trading: quotes, orders, positions, streaming) align with the included CLI implementation. The code uses Alpaca endpoints and provides expected features (orders, checks, streaming, alerts).
✓ Instruction Scope
SKILL.md and the CLI instruct only on trading-related actions and where credentials/alerts are stored (~/.openclaw/credentials/alpaca.json and ~/.openclaw/data/alpaca-alerts.json). There are no instructions to read unrelated system files or send data to unknown endpoints — network calls are to Alpaca.
⚠ Install Mechanism
There is no install spec even though the shipped script imports alpaca-py and will exit if it's not installed. The skill does not document installing dependencies in SKILL.md (the script prints a pip suggestion at runtime). Missing an explicit, trustworthy install mechanism and dependency declaration is a packaging/operational risk.
⚠ Credentials
SKILL.md requires ALPACA_API_KEY, ALPACA_SECRET_KEY and ALPACA_PAPER (or a credentials file), but the registry metadata lists no required environment variables / primary credential. The skill legitimately needs API credentials, but the registry omission is an incoherence that hides the need for sensitive keys.
✓ Persistence & Privilege
The skill does not request always:true and does not modify other skills. It will store alerts and optionally a credentials file under the user's home directory (~/.openclaw). Note: autonomous invocation is enabled by default — for a trading skill this increases risk because it could place orders; ensure confirmations and prefer paper trading during testing.
如何使用
  1. 确保已安装 OpenClaw（本地或 Docker 部署）
  2. 在对话框中输入安装命令：/install alpaca
  3. 安装完成后，直接呼叫该 Skill 的名称或使用 /alpaca 触发
  4. 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.0.0
Initial release: quotes, orders, positions, watchlists, streaming, alerts, guardrails
元数据
Slug alpaca
版本 1.0.0
许可证 —
累计安装 6
当前安装数 6
历史版本数 1
常见问题

Alpaca Trading 是什么？

Trade stocks and crypto via Alpaca API. Use for market data (quotes, bars, news), placing orders (market, limit, stop), checking positions, portfolio management, and account info. Supports both paper and live trading. Use when user asks about stock prices, wants to buy/sell securities, check portfolio, or manage trades. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 2098 次。

如何安装 Alpaca Trading？

在 OpenClaw 或 Claude Code 对话框中运行命令「/install alpaca」即可一键安装，无需额外配置。

Alpaca Trading 是免费的吗？

是的，Alpaca Trading 完全免费（开源免费），可自由下载、安装和使用。

Alpaca Trading 支持哪些平台？

Alpaca Trading 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。

谁开发了 Alpaca Trading？

由 vamzi（@vamzi）开发并维护，当前版本 v1.0.0。

推荐 Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463283 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259410 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200423 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191113 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190156 · by oswalpalash

💬 留言讨论