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
- rustup-init.exe를 다운로드하여 실행하세요.
- 새 터미널을 열고:
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, 옵션, 암호화폐를 효율적으로 거래하도록 돕되, 안전과 모범 사례를 강조하는 것입니다.
이 스킬 사용 방법
거래 작업을 도울 때:
- 안전 우선: 신규 사용자나 테스트 시 항상 페이퍼 트레이딩 권장
- 명령어 확인: 거래 실행 전 정확한 명령어를 보여주세요
- 사전 조건 확인: 시장 시간, 계좌 잔고, 유효한 심볼 확인
- 주문 유형 설명: 사용자의 필요에 맞는 주문 유형을 선택하도록 도움
- 위험 관리: 손절매와 포지션 크기 조정 제안
이 스킬이 하는 일
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 자격 증명 얻기:
- https://alpaca.markets/ 에 가입
- 대시보드로 이동
- API 키 생성 (페이퍼 또는 실거래)
- 환경 변수 내보내기
핵심 명령어
계정 정보
계정 세부 정보 보기:
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
포지션에 대한 실시간 거래 이벤트를 모니터링합니다.
모범 사례
안전 및 위험 관리
- 페이퍼 트레이딩으로 시작 - 항상 먼저 페이퍼 트레이딩으로 전략 테스트
- 지정가 주문 사용 - 변동성 있는 상황에서 더 나은 가격 통제를 위해 시장가 주문 지양
- 심볼 확인 - 거래 실행 전 티커 심볼을 다시 확인
- 실행 전 검토 -
apcacli order get으로 주문 세부 정보 확인 - 손절매 설정 - 중지 주문으로 포지션 보호
- 계좌 잔고 확인 - 거래 전 충분한 매수력 확인
- 포지션 모니터링 -
apcacli position list로 정기적으로 손익 검토
효과적인 사용법
- 모든 명령어의 도움말 확인 -
apcacli <command> --help로 상세 옵션 확인 - 주문 ID 저장 - 반환된 주문 ID를 저장하여 나중에 추적 및 관리
- 환경 변수 사용 - 자격 증명을 환경 변수에 안전하게 보관, 하드코딩 금지
- 시장 시간 확인 - 주문 전
apcacli market clock으로 확인 - 정기적으로 활동 검토 - 예상치 못한 변경 사항을 위해 계정 활동 모니터링
일반적인 워크플로우
간단한 주식 매수:
# 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]