페이퍼 트레이딩 연동 + 최종 발표

이번 주 학습 목표

여러분이 지나온 8주

1교시 — Alpaca Paper Trading API 연동

Alpaca는 미국 주식 + 암호화폐 전용 브로커 API입니다. Paper Trading은 완전 무료이며, 가입 직후 $100,000 가상 자본이 자동 지급됩니다. 실제 시장 데이터로 실시간 주문 시뮬레이션이 가능합니다.

Alpaca 가입 + Paper API 키 발급

// n8n Credentials (Header Auth) 2개 설정
Name: APCA-API-KEY-ID
Value: 여러분의_KEY_ID

Name: APCA-API-SECRET-KEY
Value: 여러분의_SECRET

// 또는 Generic Credential 방식으로 2개 헤더 동시 전송

핵심 엔드포인트 3개

매수 주문 예시

// POST Body - 시장가 매수 예시
{
  "symbol": "AAPL",
  "qty": "1",
  "side": "buy",
  "type": "market",
  "time_in_force": "day"
}

// 응답 (성공)
{
  "id": "9d4e1d7f-...",
  "status": "accepted",
  "symbol": "AAPL",
  "qty": "1",
  "filled_qty": "0",
  "limit_price": null
}

포지션 사이징 Code 노드

Claude verdict가 와도 얼마나 살지는 별도 규칙. 무작정 몰빵 금지. 계좌 자본의 몇 %만 사용하는 규칙을 Code 노드로 구현합니다.

// 포지션 사이징 - 계좌 자본의 2%만 사용 (Kelly Criterion 단순화)
const verdict = $input.item.json;
const account = $('GetAccount').item.json;

// 기본 자본의 2%를 한 포지션에 할당
const equity = parseFloat(account.equity);
const positionBudget = equity * 0.02;  // 2%

// confidence에 따라 가중치 (3/5 → 1배, 4/5 → 1.5배, 5/5 → 2배)
let sizeMultiplier = 1;
if (verdict.confidence === 4) sizeMultiplier = 1.5;
else if (verdict.confidence === 5) sizeMultiplier = 2;

const finalBudget = positionBudget * sizeMultiplier;

// 현재 가격 기준으로 수량 계산
const currentPrice = parseFloat(verdict.current_price);
const qty = Math.floor(finalBudget / currentPrice);

// 최소 1주, 최대 자본의 5% 제한
const maxQty = Math.floor((equity * 0.05) / currentPrice);
const safeQty = Math.min(Math.max(qty, 1), maxQty);

return {
  symbol: verdict.ticker,
  qty: safeQty.toString(),
  side: 'buy',
  type: 'market',
  time_in_force: 'day',
  budget_used: finalBudget.toFixed(2),
  equity_pct: ((finalBudget / equity) * 100).toFixed(2)
};

2교시 — Risk Guards 4단계 안전장치

AI 에이전트의 판단을 무조건 실행하면 사고가 납니다. 프로 트레이딩 시스템의 핵심은 "잘 사는 법"이 아니라 "크게 안 잃는 법"입니다. 4가지 필수 안전장치를 구현합니다.

Bracket Order — Alpaca의 원샷 3단 주문

Alpaca는 매수 + 익절 + 손절을 한 번의 주문으로 묶는 "Bracket Order"를 지원합니다. Risk Guard 2, 3을 한 노드로 해결.

// Bracket Order - 매수와 동시에 익절·손절 주문 예약
{
  "symbol": "AAPL",
  "qty": "10",
  "side": "buy",
  "type": "market",
  "time_in_force": "day",
  "order_class": "bracket",
  "take_profit": {
    "limit_price": "198.00"    // 매수가 180 × 1.10
  },
  "stop_loss": {
    "stop_price": "171.00",    // 매수가 180 × 0.95
    "limit_price": "170.50"     // slippage 보호
  }
}

Guard 4 — Daily Loss Limit 구현

매 주문 전에 당일 손실이 한도 초과인지 체크. 초과하면 주문 스킵.

// Daily Loss Limit Guard
const account = $input.item.json;
const equity = parseFloat(account.equity);
const lastEquity = parseFloat(account.last_equity);

// 당일 수익률 계산
const dailyPnLPct = ((equity - lastEquity) / lastEquity) * 100;

const DAILY_LOSS_LIMIT = -2.0;  // -2%

if (dailyPnLPct < DAILY_LOSS_LIMIT) {
  return {
    should_trade: false,
    reason: `Daily loss limit hit: ${dailyPnLPct.toFixed(2)}%`,
    daily_pnl_pct: dailyPnLPct,
    equity: equity
  };
}

return {
  should_trade: true,
  daily_pnl_pct: dailyPnLPct,
  equity: equity,
  remaining_budget: equity * 0.05
};

전체 트레이딩 워크플로

3교시 — 성과 추적 대시보드

투자 시스템에서 가장 중요한 것은 기록입니다. 어제 왜 샀고 오늘 얼마가 됐는지 추적 안 하면 개선 못 합니다.

거래 로그 — Sheets "trades" 탭

일일 성과 계산 — 저녁 자동 실행

장 마감 후 당일 성과를 자동 집계하는 별도 워크플로. 매일 저녁 8시 실행.

// 일일 성과 요약 계산
const trades = $input.all();
const account = $('GetAccount').item.json;

const today = new Date().toISOString().slice(0, 10);
const todayTrades = trades.filter(t => 
  t.json.timestamp.startsWith(today)
);

const buyCount = todayTrades.filter(t => t.json.side === 'buy').length;
const sellCount = todayTrades.filter(t => t.json.side === 'sell').length;

const equity = parseFloat(account.equity);
const lastEquity = parseFloat(account.last_equity);
const dailyReturn = ((equity - lastEquity) / lastEquity) * 100;

// 누적 수익률 (시작 자본 $100,000 기준)
const INITIAL_CAPITAL = 100000;
const totalReturn = ((equity - INITIAL_CAPITAL) / INITIAL_CAPITAL) * 100;

return {
  date: today,
  trades_count: todayTrades.length,
  buy_orders: buyCount,
  sell_orders: sellCount,
  daily_return_pct: dailyReturn.toFixed(3),
  total_return_pct: totalReturn.toFixed(3),
  equity: equity.toFixed(2),
  status: dailyReturn >= 0 ? '🟢 profit' : '🔴 loss'
};

성과 예시 — 1주일 시뮬레이션 결과

4교시 — 최종 발표 + 포트폴리오화

이제 여러분이 만든 것을 세상에 보여줄 시간입니다. 아무리 대단한 프로젝트도 설명 못하면 없는 것입니다. 5분 발표 + GitHub + 이력서 한 줄로 정리합니다.

5분 발표 구조 — 3단계

발표 시 꼭 보여줄 3가지

GitHub 포트폴리오 만들기

프로젝트를 GitHub에 공개해야 진짜 포트폴리오가 됩니다. 면접관이 "코드 보여주세요"라고 할 때 바로 링크 줄 수 있어야 합니다.

이력서/자소서 한 줄 문구

이 8주 프로젝트를 이력서 한 줄로 압축합니다. 모호한 "AI 프로젝트" 말고 구체적 기술·성과로.

이번 주 자주 발생하는 오류

8주 전 과정 완료 체크리스트

수료 후 다음 단계

참고 자료