Communitygithub.com

lacymorrow/openclaw-알파카-트레이딩-스킬

apcacli 명령줄 도구를 사용하여 Alpaca 거래 API로 거래를 실행하고, 시장을 분석하며, 포트폴리오를 관리합니다. 사용자가 주식, ETF, 옵션, 암호화폐 거래, 시장 데이터 확인, 포지션 조회, 주문 관리, 포트폴리오 분석을 원할 때 사용합니다. 또한 '매수', '매도', '거래', '시장 데이터', '주가', '포트폴리오', '계좌 잔고', 'alpaca trading'을 언급할 때도 사용합니다.

openclaw-알파카-트레이딩-스킬란 무엇인가요?

이 스킬은 Rust 기반 CLI 도구인 `apcacli`를 통해 Alpaca 거래 플랫폼과 상호작용하는 방법을 제공합니다. 주식, ETF, 옵션, 암호화폐 거래, 포트폴리오 관리, 시장 데이터 조회, 실시간 스트리밍 등 다양한 기능을 명령줄에서 바로 수행할 수 있습니다. 초보자는 페이퍼 트레이딩(모의투자)을 권장하며, 실행 전 명령어 확인, 시장 시간 확인, 계좌 잔고 확인 등 안전한 거래를 위한 모범 사례를 포함하고 있습니다. 주문 유형(시장가, 지정가, 중지, 트레일링 스탑 등)에 대한 상세한 설명과 함께 설치, 환경 변수 설정, 문제 해결 가이드를 제공하여 개발자와 고급 사용자가 효율적으로 자동화된 거래 워크플로우를 구축할 수 있도록 지원합니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add lacymorrow/openclaw-alpaca-trading-skill

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

Alpaca 거래 스킬

apcacli 명령줄 도구를 통해 Alpaca 거래 API로 거래를 실행하고 포트폴리오를 관리합니다.

설치

apcacli는 Rust CLI입니다. 크로스 플랫폼으로 설치하세요:

macOS (Homebrew)

brew install rustup
rustup-init -y
source "$HOME/.cargo/env"
cargo install apcacli

Linux

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y
source "$HOME/.cargo/env"
cargo install apcacli

Windows

  1. rustup-init.exe를 다운로드하여 실행하세요.
  2. 새 터미널을 열고: cargo install apcacli

환경 변수

export APCA_API_KEY_ID='your-key-id'
export APCA_API_SECRET_KEY='your-secret-key'
# 실시간 거래 (기본값은 페이퍼):
# export APCA_API_BASE_URL='https://api.alpaca.markets'

개요

당신은 명령줄 주식 거래를 위한 apcacli 사용 전문가입니다. 목표는 Alpaca의 API를 통해 사용자가 주식, ETF, 옵션, 암호화폐를 효율적으로 거래하도록 돕되, 안전과 모범 사례를 강조하는 것입니다.

이 스킬 사용 방법

거래 작업을 도울 때:

  1. 안전 우선: 신규 사용자나 테스트 시 항상 페이퍼 트레이딩 권장
  2. 명령어 확인: 거래 실행 전 정확한 명령어를 보여주세요
  3. 사전 조건 확인: 시장 시간, 계좌 잔고, 유효한 심볼 확인
  4. 주문 유형 설명: 사용자의 필요에 맞는 주문 유형을 선택하도록 도움
  5. 위험 관리: 손절매와 포지션 크기 조정 제안

이 스킬이 하는 일

apcacli는 Alpaca 거래 플랫폼과 상호작용하기 위한 Rust 기반 CLI입니다. 제공 기능:

  • 거래: 주식, ETF, 옵션, 암호화폐에 대한 주문 제출, 수정, 취소
  • 포트폴리오 관리: 포지션, 손익(P/L), 계정 정보 보기
  • 시장 데이터: 자산 정보 및 시장 시계 상태 접근
  • 계정 활동: 거래 내역 및 계정 변경 사항 추적
  • 실시간 스트리밍: 계정 및 거래 이벤트 모니터링

이 스킬을 사용해야 할 때

사용자가 다음과 같은 작업을 원할 때 사용:

  • 거래 실행 (주식, ETF, 옵션, 암호화폐 매수/매도)
  • 포트폴리오 포지션 및 성과 확인
  • 주문 조회 및 관리 (미체결, 체결, 취소됨)
  • 계좌 잔고 및 매수력 확인
  • 시장 데이터 및 자산 정보 접근
  • 계정 활동 및 이벤트 모니터링
  • 시장 개장 여부 확인
  • 손절매 또는 트레일링 스탑 설정
  • 스크립트를 통한 거래 워크플로우 자동화

일반적인 트리거 문구:

  • "AAPL 10주 매수"
  • "내 포지션 보여줘"
  • "내 계좌 잔고는?"
  • "내 모든 주문 목록"
  • "주문 [ID] 취소"
  • "시장 열렸어?"
  • "내 포트폴리오 성과 보여줘"
  • "내 포지션에 손절매 설정"
  • "모든 포지션 청산"

이 스킬을 사용하지 말아야 할 때:

  • 사용자가 GUI 기반 거래를 원하는 경우 (웹 인터페이스로 안내)
  • 사용자가 재정적 조언을 요청하는 경우 (도구를 제공할 뿐, 추천하지 않음)
  • 사용자가 Alpaca에서 지원하지 않는 상품을 거래하려는 경우
  • 사용자가 apcacli를 설치하지 않은 경우 (먼저 설치를 도움)

설치 및 설정

apcacli 설치

# Cargo(Rust 패키지 관리자) 사용
cargo install apcacli

# 설치 확인
apcacli --help

요구 사항:

  • Rust 1.71 이상
  • Alpaca 계정 (페이퍼 또는 실거래)
  • Alpaca API 자격 증명

환경 변수 구성

페이퍼 트레이딩 (테스트 권장):

export APCA_API_KEY_ID='your_paper_key_id'
export APCA_API_SECRET_KEY='your_paper_secret_key'
# 페이퍼 트레이딩이 기본값이므로 APCA_API_BASE_URL 설정 불필요

실거래:

export APCA_API_BASE_URL='https://api.alpaca.markets'
export APCA_API_KEY_ID='your_live_key_id'
export APCA_API_SECRET_KEY='your_live_secret_key'

API 자격 증명 얻기:

  1. https://alpaca.markets/ 에 가입
  2. 대시보드로 이동
  3. API 키 생성 (페이퍼 또는 실거래)
  4. 환경 변수 내보내기

핵심 명령어

계정 정보

계정 세부 정보 보기:

apcacli account get

계정 상태, 현금 잔고, 매수력, 자기자본, 증거금 정보를 표시합니다.

계정 활동 보기:

apcacli account activity

최근 계정 활동(거래, 배당금, 이체)을 표시합니다.

계정 구성 업데이트:

apcacli account config <options>

계정 설정 수정 (사용 가능한 옵션은 --help 사용).

주문 관리

시장가 주문 제출:

# 금액으로 매수
apcacli order submit buy AAPL --value 1000

# 수량으로 매수
apcacli order submit buy AAPL --quantity 10

# 주식 매도
apcacli order submit sell TSLA --quantity 5

지정가 주문 제출:

# 특정 가격에 매수
apcacli order submit buy MSFT --quantity 10 --limit-price 420

# 특정 가격에 매도
apcacli order submit sell NVDA --quantity 20 --limit-price 850

고급 주문 제출:

# 중지 주문
apcacli order submit sell AAPL --quantity 10 --stop-price 180

# 중지-지정가 주문
apcacli order submit sell TSLA --quantity 5 --stop-price 800 --limit-price 795

# 트레일링 스탑 주문 (백분율)
apcacli order submit sell NVDA --quantity 10 --trail-percent 5

모든 주문 목록:

apcacli order list

모든 주문을 상태(미체결, 체결, 취소 등)와 함께 표시합니다.

특정 주문 세부 정보:

apcacli order get <ORDER_ID>

타임스탬프, 가격, 상태를 포함한 포괄적인 주문 정보를 표시합니다.

주문 취소:

apcacli order cancel <ORDER_ID>

ID로 대기 중인 주문을 취소합니다.

모든 주문 취소:

apcacli order cancel-all

모든 미체결 주문을 취소합니다.

포지션 관리

모든 오픈 포지션 목록:

apcacli position list

모든 오픈 포지션을 다음 정보와 함께 표시:

  • 수량 및 진입 가격
  • 현재 시장 가치
  • 일일 손익 (백분율 포함)
  • 총 손익 (백분율 포함)
  • 색상으로 구분된 손익

특정 포지션 정보:

apcacli position get <SYMBOL>

특정 포지션의 상세 정보를 표시합니다.

포지션 청산:

# 전체 포지션 청산
apcacli position close <SYMBOL>

# 부분 청산
apcacli position close <SYMBOL> --quantity 5

모든 포지션 청산:

apcacli position close-all

모든 오픈 포지션을 청산합니다.

자산 정보

거래 가능 자산 목록:

apcacli asset list

모든 거래 가능 자산을 표시합니다.

자산 세부 정보:

apcacli asset get <SYMBOL>

거래소, 종류, 거래 가능 상태를 포함한 자산 정보를 표시합니다.

자산 검색:

apcacli asset search <QUERY>

쿼리와 일치하는 자산을 검색합니다.

시장 데이터

시장 시계 확인:

apcacli market clock

현재 시장 상태(개장/폐장), 다음 개장 시간, 다음 폐장 시간을 표시합니다.

스트리밍 (실시간 이벤트)

계정 업데이트 스트리밍:

apcacli stream account

주문 업데이트 및 체결을 포함한 실시간 계정 이벤트를 모니터링합니다.

거래 업데이트 스트리밍:

apcacli stream trades

포지션에 대한 실시간 거래 이벤트를 모니터링합니다.

모범 사례

안전 및 위험 관리

  1. 페이퍼 트레이딩으로 시작 - 항상 먼저 페이퍼 트레이딩으로 전략 테스트
  2. 지정가 주문 사용 - 변동성 있는 상황에서 더 나은 가격 통제를 위해 시장가 주문 지양
  3. 심볼 확인 - 거래 실행 전 티커 심볼을 다시 확인
  4. 실행 전 검토 - apcacli order get으로 주문 세부 정보 확인
  5. 손절매 설정 - 중지 주문으로 포지션 보호
  6. 계좌 잔고 확인 - 거래 전 충분한 매수력 확인
  7. 포지션 모니터링 - apcacli position list로 정기적으로 손익 검토

효과적인 사용법

  1. 모든 명령어의 도움말 확인 - apcacli <command> --help로 상세 옵션 확인
  2. 주문 ID 저장 - 반환된 주문 ID를 저장하여 나중에 추적 및 관리
  3. 환경 변수 사용 - 자격 증명을 환경 변수에 안전하게 보관, 하드코딩 금지
  4. 시장 시간 확인 - 주문 전 apcacli market clock으로 확인
  5. 정기적으로 활동 검토 - 예상치 못한 변경 사항을 위해 계정 활동 모니터링

일반적인 워크플로우

간단한 주식 매수:

# 1. 계좌 잔고 확인
apcacli account get

# 2. 자산 거래 가능 여부 확인
apcacli asset get AAPL

# 3. 시장 개장 여부 확인
apcacli market clock

# 4. 시장가 주문 제출
apcacli order submit buy AAPL --value 1000

# 5. 포지션 확인
apcacli position list

지정가 주문 및 모니터링:

# 1. 지정가 주문 제출
apcacli order submit buy MSFT --quantity 10 --limit-price 420

# 2. 반환된 ORDER_ID 저장
# 3. 주문 상태 확인
apcacli order get <ORDER_ID>

# 4. 필요한 경우 취소
apcacli order cancel <ORDER_ID>

포트폴리오 검토:

# 1. 모든 포지션 보기
apcacli position list

# 2. 계정 요약 확인
apcacli account get

# 3. 최근 활동 검토
apcacli account activity

손절매와 함께 포지션 청산:

# 1. 현재 포지션 확인
apcacli position get AAPL

# 2. 이익 보호를 위해 트레일링 스탑 설정
apcacli order submit sell AAPL --quantity 10 --trail-percent 5

# 3. 주문 모니터링
apcacli order list

명령어 참조 빠른 가이드

작업명령어
계정 보기apcacli account get
계정 활동apcacli account activity
주식 매수 (시장가)apcacli order submit buy SYMBOL --value AMOUNT
주식 매수 (지정가)apcacli order submit buy SYMBOL --quantity N --limit-price PRICE
주식 매도apcacli order submit sell SYMBOL --quantity N
모든 주문 목록apcacli order list
주문 세부 정보apcacli order get ORDER_ID
주문 취소apcacli order cancel ORDER_ID
모든 주문 취소apcacli order cancel-all
포지션 목록apcacli position list
포지션 정보apcacli position get SYMBOL
포지션 청산apcacli position close SYMBOL
모든 포지션 청산apcacli position close-all
자산 목록apcacli asset list
자산 정보apcacli asset get SYMBOL
시장 상태 확인apcacli market clock
계정 이벤트 스트리밍apcacli stream account
거래 스트리밍apcacli stream trades

주문 유형 및 매개변수

기본 주문 매개변수

  • --quantity N - 거래할 주식 수
  • --value AMOUNT - 투자할 금액 (시장가 주문용)
  • --limit-price PRICE - 지정가 주문의 지정 가격
  • --stop-price PRICE - 중지 주문의 중지 가격
  • --trail-percent N - 트레일링 스탑 백분율
  • --trail-amount AMOUNT - 트레일링 스탑 금액

주문 유형

시장가 주문 - 현재 시장 가격으로 즉시 체결

apcacli order submit buy AAPL --quantity 10

지정가 주문 - 지정된 가격 또는 더 나은 가격에서만 체결

apcacli order submit buy AAPL --quantity 10 --limit-price 185

중지 주문 - 중지 가격에 도달하면 시장가 주문으로 전환

apcacli order submit sell AAPL --quantity 10 --stop-price 180

중지-지정가 주문 - 중지 가격에 도달하면 지정가 주문으로 전환

apcacli order submit sell AAPL --quantity 10 --stop-price 180 --limit-price 179

트레일링 스탑 - 중지 가격이 지정된 백분율 또는 금액만큼 시장을 따라감

# 백분율 기반
apcacli order submit sell AAPL --quantity 10 --trail-percent 5

# 금액 기반
apcacli order submit sell AAPL --quantity 10 --trail-amount 10

중요 참고 사항

요구 사항

  • apcacli 바이너리 설치 필수 - cargo install apcacli로 설치
  • 환경 변수 설정 필수 - APCA_API_KEY_ID와 APCA_API_SECRET_KEY 필요
  • Alpaca 계정 - 활성 페이퍼 또는 실거래 계정
  • Rust 1.71+ - 소스에서 설치 시 필요

거래 제한 사항

  • 페이퍼 vs 실거래: 기본값은 페이퍼 트레이딩; 실거래는 APCA_API_BASE_URL 설정
  • 시장 시간: 대부분의 거래는 시장 시간(동부 표준시 오전 9:30 - 오후 4:00)에만 체결
  • 패턴 데이 트레이딩(PDT): $25k 미만 계정은 PDT 제한 있음
  • 매수력: 계정 자기자본 및 증거금 요건에 의해 제한됨
  • 주문 제한: 일부 주문 유형은 모든 증권에 사용 불가
  • 암호화폐 거래: 다른 규칙 및 거래 시간이 적용될 수 있음

데이터 및 성능

  • API 속도 제한: Alpaca는 남용 방지를 위한 요청 제한 있음
  • 실시간 데이터: 활성 데이터 구독 필요 가능
  • 명령어 출력: 쉬운 읽기를 위해 색상으로 결과 포맷
  • 주문 ID: 추적 및 관리를 위해 반환된 주문 ID 저장
  • 네트워크 의존성: Alpaca API에 인터넷 연결 필요

문제 해결

환경 변수 미설정

# 오류: "Missing APCA_API_KEY_ID"
# 해결책: 필수 환경 변수 내보내기
export APCA_API_KEY_ID='your_key'
export APCA_API_SECRET_KEY='your_secret'

명령어를 찾을 수 없음

# 오류: "apcacli: command not found"
# 해결책: apcacli 설치
cargo install apcacli

# 설치 확인
which apcacli

API 인증 실패

  • API 자격 증명이 올바른지 확인
  • 올바른 엔드포인트 사용 여부 확인 (페이퍼 vs 실거래)
  • API 키가 취소되지 않았는지 확인
  • 계정 상태가 활성 상태인지 확인

주문 거부됨

  • 시장이 개장했는지 확인 (주식의 경우)
  • 충분한 매수력 확인
  • 심볼이 유효하고 거래 가능한지 확인
  • 주문 매개변수(가격, 수량) 검토
  • 계정 제한 사항 확인

포지션을 찾을 수 없음

  • 심볼이 올바른지 확인
  • 포지션이 실제로 열려 있는지 확인
  • 이전에 포지션이 청산되었는지 확인
  • 올바른 계정 사용 여부 확인 (페이퍼 vs 실거래)

고급 기능

셸 완성

더 빠른 명령어 입력을 위한 셸 완성 생성:

# 완성 스크립트 설치
cargo run --bin=shell-complete > apcacli.bash
source apcacli.bash

# 이제 탭 완성 사용 가능
apcacli order <TAB>

모니터링을 위한 스트리밍

실시간 계정 활동 모니터링을 위해 스트리밍 명령어 사용:

# 터미널 1: 계정 이벤트 모니터링
apcacli stream account

# 터미널 2: 거래 실행
apcacli order submit buy AAPL

[truncated for translation]

관련 스킬