비트코인 자동매매 주문 실행 엔진

안녕하세요. 비트코인 자동매매 주문 실행 엔진 공고를 읽고, 말로만 설명드리기보다 먼저 만들어 보았습니다. 제안서, 운영 대시보드 스토리보드, 직접 눌러 보실 수 있는 데모를 한 페이지에 모았습니다.

▶ 제안 자료 보기: https://wishket-158501-bitcoin-order-engine.pages.dev/

■ 이 프로젝트의 핵심은 "신호 한 번에 주문도 한 번"입니다
전략이 아니라 주문 실행이 범위이므로, 성패는 같은 지시가 두 번 들어와도 주문이 한 건만 나가는지, 응답이 끊기거나 프로그램이 죽어도 계좌와 기록이 어긋나지 않는지에서 갈립니다. 그래서 신호 ID로 거래소 클라이언트 주문번호(OKX clOrdId, Bitget clientOid)를 만들고 데이터베이스에도 같은 값으로 고유 제약을 걸어, 재수신·재시도·재시작 어디에서도 새 주문이 생기지 않게 설계합니다.

■ 기술 스택과 선택 이유 (비개발자용 설명)
- 엔진: Python 3.12 + asyncio. 공고에 지정된 언어이며, 여러 주문과 거래소 응답을 동시에 처리하기 좋습니다.
- 거래소 연동: OKX·Bitget 공식 REST/WebSocket API를 거래소별 어댑터로 분리. 거래소를 추가·교체할 때 엔진 본체를 건드리지 않습니다.
- 신호 수신: FastAPI 웹훅(서명·타임스탬프 검증). 허용된 전략만 주문 지시를 보낼 수 있습니다.
- 기록: PostgreSQL. 신호·주문·체결 이력이 남아 "언제 무엇이 왜 나갔는지" 추적됩니다.
- 대시보드: React(PC 웹). 잔고·포지션, 주문 현황, 엔진 상태·오류를 한 화면에서 봅니다.
- 운영: Docker + 클라우드 서버. 프로세스가 죽으면 자동 재시작되고, 발주사 계정에 그대로 배포합니다.

■ 어디까지 되어야 성공적으로 끝났다고 보는지
1. 가상 신호로 신규·취소 주문과 체결 확인이 정상 동작한다.
2. 같은 신호를 여러 번 보내도 거래소 주문은 한 건만 존재한다.
3. 전송 중 응답 끊김·강제 종료를 일부러 발생시켜도, 재시작 후 거래소의 실제 주문·체결·잔고와 엔진 기록이 일치한다(부분 체결 포함).
4. 주문 실패·장애 시 알림이 실제로 도착한다.
5. 위 1~4를 모의(데모 트레이딩) 계좌에서 통과한 뒤 소액 실거래로 동일 시나리오를 확인한다.
이 시나리오 표를 착수 시 합의하고, 그대로 테스트 문서로 남겨 인계합니다.

■ 아직 정하지 않은 범위에 대한 의견
1. 외부 신호 수신 방식 — 포함하는 편이 낫습니다. HTTPS 웹훅(JSON + 서명 검증)을 기본으로 권합니다. 전략이 어디서 돌아가든 붙일 수 있고, 나중에 메시지 큐나 파일 방식으로 바꿔도 수신부만 교체하면 됩니다.
2. 알림 채널 — 포함을 권합니다. 텔레그램 봇이 가장 빠르고 비용이 없습니다. 알림 내용을 한 곳에서 만들게 설계하면 이후 이메일·카카오 채널을 추가로 붙이는 작업만 남습니다.
3. 대시보드 화면 구성 — 1차는 개요(엔진 상태·잔고·포지션), 주문 현황, 오류·복구 로그, 실거래 전환 4개 화면을 제안드립니다. 스토리보드로 먼저 보여드리고 확정 후 개발합니다.
4. 다중 사용자 확장 — 이번 범위에서는 만들지 않되, 계정 단위로 키·주문·원장을 분리해 두겠습니다. 나중에 사용자 테이블과 권한만 얹으면 되고, 지금 미리 만들면 검증할 계정이 하나뿐이라 비용만 늘어납니다.
확인이 필요한 부분: 신호의 정확한 형식과 발신 주기, 대상 종목(현물/선물·레버리지), 1회 주문 한도, 부분 체결 시 잔량 처리 기준, OKX·Bitget 모의 계좌 사용 가능 여부입니다.

■ 완성 후 오류 대응과 하자보수
납품 후 30일간 무상 하자보수를 기본으로 하며, 이 기간에는 결함 접수 시 영업일 기준 1일 내 회신, 주문이 나가지 않는 수준의 장애는 당일 대응을 기준으로 합니다. 소스코드·테스트 문서·운영 문서(배포, API 키 교체, 긴급 정지 절차)를 발주사 저장소로 인계하며, 이후 월 단위 운영 지원도 이어서 맡을 수 있습니다.

제안 금액은 4,000,000원(VAT 별도), 기간은 30일을 기준으로 합니다. 위 링크의 데모에서 중복 신호와 재시작 복구가 어떻게 처리되는지 먼저 한번 눌러 봐 주세요.

지원완료 댓글 공고 댓글란에 작성할 짧은 정중 멘트

안녕하세요, 비트코인 자동매매 주문 실행 엔진에 지원했습니다. 전략이 아니라 주문 실행에 초점을 맞춰, 같은 신호가 여러 번 와도 주문이 한 건만 나가는 구조와 응답 끊김·재시작 후 거래소 실제 계좌와 대사하는 복구 절차를 제안서·스토리보드·데모로 정리했습니다. 가상 신호 형식과 모의 계좌 키 준비 일정만 먼저 맞춰 주시면 착수 후 빠르게 검증 단계까지 진행하겠습니다. 지원서의 링크에서 확인 부탁드립니다.

포트폴리오 1: 제안서 포트폴리오 신규 등록용 제목 및 설명

[포트폴리오 제목]
[제안서] 비트코인 자동매매 주문 실행 엔진

[포트폴리오 설명]
매매 전략이 보낸 주문 지시를 받아 OKX·Bitget에 실행하는 Python 주문 엔진과 관리용 대시보드 제안서입니다. 같은 신호가 다시 들어와도 주문이 한 건만 나가는 클라이언트 주문번호 고정 방식, 응답 끊김과 재시작 뒤 거래소 실제 주문·체결·잔고와 대사해 부분 체결까지 복구하는 절차, 모의(데모 트레이딩) 계좌에서 장애 시나리오를 통과해야 실거래로 넘어가는 전환 기준, 비개발자도 이해할 수 있는 기술 선택 이유와 단계별 로드맵을 담았습니다.

*본 포트폴리오는 공고지원을 위해 사전 제작된 내용임을 알려드립니다.

포트폴리오 2: 스토리보드 포트폴리오 신규 등록용 제목 및 설명

[포트폴리오 제목]
[스토리보드] 주문 실행 엔진 운영 대시보드 화면 흐름

[포트폴리오 설명]
스토리보드는 서비스의 화면을 실제 모습에 가깝게 미리 그려 보는 문서입니다. 운영자(발주자)가 쓰는 화면을 여정 순서대로 담았습니다. 신호 수신과 중복 차단이 함께 보이는 주문 현황, 재시작 복구 기록과 엔진 원장·거래소 실제 값 대사 및 오류·알림 로그, 잔고·포지션과 모의 시나리오 통과 후 열리는 실거래 전환 화면입니다. 마지막까지 보시면 생각하고 계신 시스템의 모습이 머릿속에 그려지실 것입니다.

*본 포트폴리오는 공고지원을 위해 사전 제작된 내용임을 알려드립니다.

PDF → 이미지 변환 명령어 터미널에 입력하여 PDF를 고해상도 이미지로 일괄 분할 변환 (ImageMagick)

magick -density 300 proposal.pdf -quality 100 proposal_page_%02d.png