Insights
AI가 자동으로 큐레이션·번역·정리하는 기술 동향 피드입니다.
본 문서는 Alpaca의 Trading 및 Broker API를 위한 오픈 에이전트 스킬을 소개합니다. 이 스킬들은 AI 코딩 어시스턴트가 백테스트 실행, 계정 온보딩, 주문 체결 등 특정 금융 작업을 수행할 때 필요한 단계별 지침과 가드레일을 제공합니다. Skills CLI 또는 수동 설치를 통해 에이전트에 통합하여 사용할 수 있습니다.
AI 자동 생성 콘텐츠
본 콘텐츠는 GitHub AI Coding Assistants의 원문을 AI가 자동으로 요약·번역·분석한 것입니다. 원 저작권은 원저작자에게 있으며, 정확한 내용은 반드시 원문을 확인해 주세요.
원문 바로가기Alpaca의 Trading API 및 Broker API를 위한 오픈 에이전트 스킬입니다. 각 스킬은 SKILL.md 파일로 구성되어 있으며, 사용자가 AI 코딩 어시스턴트에게 특정 작업을 요청할 때(예: 과거 백테스트 실행, Broker API 계정 온보딩, 자금 이동, 주문 체결, 실시간 이벤트 소비 등) 따라야 하는 단계별 지침을 제공합니다.
스킬은 에이전트가 실행 간에 더 일관된 결과를 생성하도록 공유되는 지침(shared instructions), 가드레일(guardrails), 그리고 보고 표준을 제공합니다.
Alpaca CLI — Homebrew 또는 Go를 통해 설치합니다:
brew install alpacahq/tap/cli
# or
go install github.com/alpacahq/cli/cmd/alpaca@latest
Alpaca API 자격 증명 (credentials) — 스킬에 따라 종이(paper), 샌드박스(sandbox) 또는 라이브(live) 키를 사용합니다. CLI 기반 워크플로우의 경우 alpaca profile login을 실행하거나, API 예제를 사용할 때는 ALPACA_API_KEY와 ALPACA_SECRET_KEY를 설정합니다.
Skills CLI를 사용하여 이 GitHub 저장소에서 설치하는 것이 좋습니다:
# 대화형 설치
npx skills add alpacahq/alpaca-skills
...
아래 표의 스킬 이름으로 대체하여 사용합니다.
Skills CLI를 지원하지 않는 에이전트의 경우, 에이전트를 스킬 디렉터리를 가리키도록 설정하거나 해당 디렉터리를 에이전트의 스킬 폴더에 복사/심볼릭 링크합니다.
| Agent | Typical path |
|---|---|
| Cursor | 스킬 디렉터리를 .cursor/skills/ (프로젝트) 또는 사용자 스킬 디렉터리에 복사하거나 심볼릭 링크합니다. |
| ... |
예시 (Cursor 프로젝트 스킬):
mkdir -p .cursor/skills
cp -r path/to/alpaca-skills/skills/trading-api/backtest .cursor/skills/alpaca-trading-backtest
| Name | Path | Title | Product |
|---|---|---|---|
alpaca-trading-backtest | skills/trading-api/backtest/ | Trading API Backtesting | Trading API |
| ... | |||
Product 이름 공간화(namespacing)는 폴더 경로(skills/trading-api/, skills/broker-api/)와 스킬의 name 필드를 사용합니다: alpaca-<product-scope>-<skill-name> (예: alpaca-trading-backtest, alpaca-broker-integration). 제품 범위(product scope)로는 api가 아닌 trading 또는 broker를 사용하세요. |
CONTRIBUTING.md를 참조하세요. 스킬 작성자를 위한 에이전트 컨벤션은 AGENTS.md에 있습니다.
Apache License 2.0으로 라이선스가 부여되었습니다. LICENSE를 참조하세요.
Alpaca Skill Libraries와 연결된 AI 에이전트가 생성한 통찰력은 교육 및 정보 제공 목적으로만 사용되어야 하며 투자 조언으로 간주되어서는 안 됩니다. Alpaca는 특정 증권이나 투자 전략을 추천하지 않습니다. 결정 전에 반드시 자체 실사(due diligence)를 수행해 주십시오. 언급된 모든 회사는 독립적으로 운영되며 서로에 대해 책임을 지지 않습니다.
옵션 거래는 내재된 높은 위험으로 인해 모든 투자자에게 적합하지 않을 수 있으며, 이로 인해 상당한 손실을 초래할 수 있습니다. 옵션에 투자하기 전에 표준화된 옵션의 특성 및 위험(Characteristics and Risks of Standardized Options)(Options Disclosure Document)을 읽어보십시오.
Alpaca는 제3자 콘텐츠를 준비하거나, 편집하거나, 보증하거나, 승인하지 않습니다. Alpaca는 제3자 콘텐츠의 정확성, 시기 적절성, 완전성 또는 유용성을 보장하지 않으며, 제3자 사이트에 게시되거나 이용 가능한 어떠한 콘텐츠, 광고, 제품 또는 기타 자료에 대해서도 책임이나 배상 책임을 지지 않습니다.
모든 투자는 위험을 수반하며, 증권이나 금융 상품의 과거 실적이 미래의 결과나 수익을 보장하지 않습니다. 어떤 투자 전략이 목표를 달성할 것이라는 보장은 없습니다. 분산 투자가 이익을 보장하거나 손실로부터 보호한다는 의미는 아닙니다. 증권이나 기타 금융 상품에 투자할 때는 항상 돈을 잃을 가능성이 있습니다. 투자자는 투자하기 전에 자신의 투자 목표와 위험을 신중하게 고려해야 합니다.
알고리즘의 계산은 과거 및 실시간 시장 데이터를 기반으로 하지만, 갑작스러운 가격 변동, 유동성 제약 또는 실행 지연 등 모든 시장 요인을 반영하지 못할 수 있습니다. 변동성 추정치나 배당금 처리와 같은 모델 가정은 성과와 정확도에 영향을 미칠 수 있습니다. 알고리즘이 생성하는 거래는 중개사(brokerage)의 실행 과정, 시장 유동성, 주문 우선순위 및 시간 지연의 적용을 받습니다. 이러한 요인들은 예상되는 거래 체결 가격이나 시간과의 편차를 야기할 수 있습니다. 사용자는 알고리즘 활동을 모니터링하고 관련된 위험을 이해할 책임이 있습니다. Alpaca는 이 시스템 사용으로 인해 발생하는 어떠한 손실에 대해서도 책임을 지지 않습니다.
과거의 가상 백테스트 결과가 미래 수익을 보장하지 않으며, 실제 결과는 분석 내용과 다를 수 있습니다.
Paper Trading API는 AlpacaDB, Inc.에서 제공하며 실제 자금이 필요하지 않으며 사용자가 시장의 실제 증권으로 거래할 수 있도록 허용하지 않습니다. Paper Trading API의 사용을 제공하는 것은 AlpacaDB, Inc. 또는 AlpacaDB, Inc. 계열사가 제공하거나 어떤 방식으로 승인한 어떠한 종류의 증권, 증권 파생상품 또는 선물 상품에 대한 매매를 위한 제안이나 권유가 아니며, 어떠한 유형의 거래 또는 투자 자문, 추천 또는 전략도 아닙니다. 또한 Paper Trading API를 통해 이용 가능한 정보는 AlpacaDB, Inc. 또는 AlpacaDB, Inc. 계열사(총칭하여 "Alpaca")가 사업을 할 권한이 없는 관할권에서 어떠한 종류의 제안이나 권유도 아닙니다.
증권 중개 서비스는 AlpacaDB, Inc.의 전액 출자 자회사인 Alpaca Securities LLC("Alpaca Securities")가 제공하며, FINRA 및 SIPC 회원사입니다. 기술 및 서비스는 AlpacaDB, Inc.에서 제공합니다.
암호화폐 서비스는 AlpacaDB, Inc.의 전액 출자 자회사인 Alpaca Crypto LLC("Alpaca Crypto")가 제공하며, FinCEN에 등록된 돈 서비스 사업체(NMLS # 2160858)입니다. Alpaca Crypto는 SIPC 또는 FINRA 회원사가 아닙니다. 암호화폐는 주식이 아니며 고객님의 암호화폐 투자는 FDIC나 SIPC 어느 쪽에서도 보호받지 못합니다. 암호화폐 자산은 변동성이 매우 크고 투기적이며, 상당한 손실 위험을 수반하며, FDIC 또는 어떠한 정부 기관으로부터 보험에 가입되어 있지 않습니다. 고객은 원금 손실 가능성, 사이버 보안 고려 사항, 규제 개발 상황, 그리고 디지털 자산 기술의 진화하는 특성을 포함하여 이러한 서비스를 이용하기 전에 다양한 위험을 인지해야 합니다. 암호화폐 위험에 대한 추가 정보는 여기를 클릭하십시오.
이는 Alpaca Securities 또는 Alpaca Crypto가 각각 등록되거나 허가되지 않은 관할권에서 증권이나 암호화폐를 매수하거나 매도하는 것에 대한 제안, 청약 또는 자문이 아닙니다.