skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
starchild-ai-agent/official-skills76 installs

alpaca

Alpaca brokerage — US stocks & ETFs. Account, positions, orders, quotes, history, and order placement (paper + live). Use when the user wants to check or trade a US-stock account on Alpaca (e.g. "Alpaca buying power", "buy 1 AAPL on Alpaca paper", "my Alpaca positions"). Cloud API, runs directly in the container.

How do I install this agent skill?

npx skills add https://github.com/starchild-ai-agent/official-skills --skill alpaca
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    The alpaca skill is a secure and standard integration for interacting with the Alpaca brokerage. It uses the official Alpaca Python SDK, follows best practices for secret management by using environment variables, and includes built-in safety mechanisms to prevent accidental live trading.

  • Socketpass

    No alerts

  • Snykwarn

    Risk: MEDIUM · 1 issue

What does this agent skill do?

What this is

☁️ Cloud broker — Alpaca exposes a public REST API, so this runs directly in the Starchild container, no local gateway needed. US equities and ETFs.

Paper and live are fully separated: different key pairs, different hosts (paper-api.alpaca.markets vs api.alpaca.markets). A paper key physically cannot touch the live account. Live order placement additionally requires the --confirm-live flag.

Get your API keys

  1. Sign up at alpaca.markets (US brokerage; paper trading is free and needs no funding).
  2. Paper keys: log in → switch to Paper Trading (toggle top-left) → Home → "API Keys" panel → Generate New Keys. Copy the Key ID and Secret Key (secret shown once).
  3. Live keys (optional, real money): switch to Live Trading → same API Keys panel → generate. These are a different pair from paper.
  4. Market data: the free IEX feed works out of the box. SIP (full-market) needs a paid data subscription.

Configure (.env)

Request via secure input — never paste keys in chat. Variables:

VariableRequiredNotes
ALPACA_API_KEYyes (paper)paper Key ID
ALPACA_SECRET_KEYyes (paper)paper Secret
ALPACA_LIVE_API_KEYonly for livelive Key ID
ALPACA_LIVE_SECRET_KEYonly for livelive Secret
ALPACA_FEEDnoiex (default) or sip

Usage

pip install alpaca-py (first run). All commands print JSON. Default profile is paper.

python skills/alpaca/scripts/alpaca_cli.py status
python skills/alpaca/scripts/alpaca_cli.py account
python skills/alpaca/scripts/alpaca_cli.py positions
python skills/alpaca/scripts/alpaca_cli.py orders [--executions]
python skills/alpaca/scripts/alpaca_cli.py quote --symbol AAPL
python skills/alpaca/scripts/alpaca_cli.py history --symbol AAPL --period 1d --limit 90
# place (paper): qty OR notional, market OR limit
python skills/alpaca/scripts/alpaca_cli.py place --symbol AAPL --side buy --qty 1 --type market
python skills/alpaca/scripts/alpaca_cli.py place --symbol AAPL --side buy --notional 500 --type limit --limit-price 180
python skills/alpaca/scripts/alpaca_cli.py cancel --order-id <id>
# live: must add --profile live AND --confirm-live
python skills/alpaca/scripts/alpaca_cli.py --profile live --confirm-live place --symbol AAPL --side buy --qty 1

Periods: 1m 5m 15m 30m 1h 1d 1w 1M. Alpaca supports fractional --notional (dollar amount) orders.

Gotchas

  • status is the health check — it reports SDK install state, key presence, and pings the account. Run it first.
  • Free IEX data can be sparse/delayed off-hours; use sip only if the account has the paid feed.
  • Live trading is real money. The --confirm-live gate is intentional; never auto-add it.

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/starchild-ai-agent/official-skills/alpaca">View alpaca on skillZs</a>