포트폴리오 제출 가이드
전향(forward) 평가 · M6 방식
전략 개발·백테스트는 각자 로컬 · 서버엔 다음 주 목표비중만 제출 ·
공식 성적 = 제출 후 실현된 미래 수익률(과적합 원천 불가능)
1. 로컬 개발·검증 (각자 시스템)
cp -r strategies/_template strategies/<내전략> # Strategy 상속 구현
pip install -e ".[dev]" && pytest strategies/<내전략> -q
faip backtest strategies/<내전략> --mode walkforward # 로컬 참고용
2. 다음 주 비중 미리보기
faip portfolio strategies/<내전략> --name 내이름
# → {"participant":"내이름","weights":{"AAPL":0.05,...},"gross":0.25}
3. 제출 (매주 월요일 00:00 UTC 마감)
faip submit strategies/<내전략> --name 내이름 \
--gateway https://faip-gateway.juhonov.workers.dev --token $SUBMIT_TOKEN
# 또는 직접 JSON POST
curl -X POST https://faip-gateway.juhonov.workers.dev/api/portfolio \
-H "Authorization: Bearer $SUBMIT_TOKEN" -H "Content-Type: application/json" \
-d '{"participant":"내이름","weights":{"AAPL":0.125,"MSFT":0.125}}'
4. 규칙 (M6 규율)
유니버스: US 대형주 30 (GET /api/universe) · 주 1회, 유효주 = 다음 월요일 ·
같은 주 재제출은 마지막 승 · 종목당 |비중| ≤ 0.25 ·
총노출 0.25 ~ 1.0 (레버리지 금지, 롱숏 허용, 1 미만은 현금) ·
공식 지표
IR = Σ주간수익률/σ (M6 정의) ·
과거 비중 제출은 채점되지 않음(전향 전용) ·
이론 문서는
Notion 허브.