← 포트폴리오 목록

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

암호화폐 거래소(OKX·Bitget) 연동, 신호 기반 주문 실행 엔진, 중복 주문 방지, 장애 자동 복구, 모의(테스트넷) 계좌 검증 모드를 포함한 금융 자동매매 관제 시스템을 FastAPI + React 기반으로 설계·구현합니다.

거래소 공통 어댑터 구조 설계OKX·Bitget API 차이를 공통 인터페이스로 추상화, 신규 거래소 추가 시 확장 가능한 구조를 구축합니다
멱등키 기반 중복 주문 차단 구현신호 수신 웹훅에 idempotency key 검증 로직을 적용, PostgreSQL 유니크 제약과 트랜잭션으로 원자성을 보장합니다
워치독 기반 장애 자동 복구 구조 구현프로세스 헬스체크와 재기동 후 거래소 재조회 동기화 로직을 설계, 상태 정합성 복구 흐름을 구축합니다
서비스 타입Web
업종모니터링
기술 스택
React 18TypeScriptTailwind CSSRechartsPythonFastAPISQLAlchemyPostgreSQLWebSocket
주요 기능
  • 통합 관제 대시보드
  • 멀티 거래소 연동 (OKX·Bitget)
  • 주문 실행 엔진 & 중복 방지
  • 장애 자동 복구 & 모의계좌 검증
Overview

프로젝트 개요

범위: 개발, 디자인, 기획

암호화폐 거래소(OKX·Bitget) 연동, 신호 기반 주문 실행 엔진, 중복 주문 방지, 장애 자동 복구, 모의(테스트넷) 계좌 검증 모드를 포함한 금융 자동매매 관제 시스템을 FastAPI + React 기반으로 설계·구현합니다. 관리자는 하나의 대시보드에서 잔고·포지션·주문현황·엔진 상태를 실시간으로 모니터링할 수 있습니다.

작업 범위

  • 통합 관제 대시보드: 관리자가 잔고·포지션·주문현황·엔진 상태를 한 화면에서 실시간으로 모니터링합니다
  • 멀티 거래소 연동 (OKX·Bitget): OKX·Bitget REST/WebSocket API를 공통 인터페이스로 통합해 거래소별 차이를 흡수합니다
  • 주문 실행 엔진 & 중복 방지: 외부 신호 수신부터 주문 생성·취소·체결 동기화까지 처리하며 동일 신호의 중복 주문을 차단합니다
  • 장애 자동 복구 & 모의계좌 검증: 프로세스 비정상 종료 시 자동 재시작하고, 테스트넷 모드로 실거래 전환 전 전체 흐름을 검증합니다

주요 업무

  • 통합 관제 대시보드 화면: FastAPI 비동기 엔드포인트에서 다중 거래소 데이터를 집계해 WebSocket으로 React 대시보드에 push하는 구조를 구현합니다
  • 멀티 거래소 연동 (OKX·Bitget) 화면: 거래소별 인증·서명·레이트리밋 처리를 공통 어댑터 구조로 추상화하고, WebSocket 재연결 로직을 구현합니다
  • 주문 실행 엔진 & 중복 방지 화면: 신호 수신 웹훅 → 멱등키 검증 → 트랜잭션 기반 주문 생성 파이프라인을 구현합니다
  • 장애 자동 복구 & 모의계좌 검증 화면: 워치독 프로세스가 엔진 상태를 감시해 재기동하고, 재기동 직후 거래소 상태를 재조회해 정합성을 복구하는 구조를 구현합니다
비트코인 자동매매 주문 실행 엔진
요구사항 정의

프로젝트 핵심 과제

프로젝트 진행 시 해결한 핵심 기술 과제입니다.

실거래 자금이 걸린 시스템 특성상 주문 로직 오류가 금전적 손실로 이어질 위험이 있으며

모의(테스트넷) 계좌에서 충분히 검증한 뒤 실거래로 단계적 전환하는 절차로 대응합니다

동일 신호가 네트워크 재시도로 중복 수신될 경우 이중 주문이 발생할 위험이 있으며

멱등키와 DB 유니크 제약을 이중으로 적용해 대응합니다

거래소 API 레이트리밋 초과 시 주문·조회가 실패할 위험이 있으며

거래소별 요청 큐와 백오프 재시도 정책을 적용해 대응합니다

프로세스 비정상 종료 시 진행 중이던 주문 상태가 유실될 위험이 있으며

재기동 직후 거래소 상태를 재조회해 로컬 DB와 재동기화하는 복구 로직으로 대응합니다

구현 내용

핵심 기능 상세

핵심 기능 1

통합 관제 대시보드

관리자가 잔고·포지션·주문현황·엔진 상태를 한 화면에서 실시간으로 모니터링합니다.

  • WebSocket 구독으로 잔고·포지션·체결 이벤트를 초 단위로 프런트엔드에 push하는 구조를 구현합니다
  • FastAPI 비동기 엔드포인트(asyncio)로 다중 거래소 조회를 병렬 처리하는 구조를 설계합니다
  • Recharts 기반 잔고 추이·포지션 비중 차트를 재사용 가능한 컴포넌트로 구성합니다

asyncio 기반 비동기 집계 파이프라인과 WebSocket 실시간 push를 결합해 다중 거래소 상태를 지연 없이 한 화면에 통합하는 구조를 구현합니다.

통합 관제 대시보드
통합 관제 대시보드 실제 화면
핵심 기능 2

멀티 거래소 연동 (OKX·Bitget)

OKX·Bitget REST/WebSocket API를 공통 인터페이스로 통합해 거래소별 차이를 흡수합니다.

  • 거래소 공통 어댑터 인터페이스를 설계해 OKX·Bitget REST/WS 클라이언트를 동일한 방식으로 다룰 수 있게 구현합니다
  • HMAC 서명 기반 API 인증과 거래소별 레이트리밋 큐를 분리해 구현합니다
  • WebSocket 재연결 백오프 로직으로 시세·체결 스트림 끊김을 자동 복구하는 구조를 설계합니다

어댑터 구조로 거래소별 API 차이를 추상화해, 향후 거래소를 추가할 때 신규 어댑터 하나만 구현하면 되는 확장 구조를 설계합니다.

멀티 거래소 연동 (OKX·Bitget)
멀티 거래소 연동 (OKX·Bitget) 실제 화면
핵심 기능 3

주문 실행 엔진 & 중복 방지

외부 신호 수신부터 주문 생성·취소·체결 동기화까지 처리하며 동일 신호의 중복 주문을 차단합니다. 신호 수신 웹훅 → 멱등키 검증 → 트랜잭션 기반 주문 생성 파이프라인을 구현합니다.

  • 신호 수신 웹훅에 멱등키(idempotency key) 기반 중복 요청 차단 로직을 적용합니다
  • PostgreSQL 트랜잭션으로 주문 생성·상태 갱신을 원자적으로 처리하는 구조를 구현합니다
  • asyncio 기반 백그라운드 태스크로 체결 상태를 주기적으로 폴링해 로컬 주문 상태와 동기화하는 구조를 설계합니다

멱등키 대조와 원자적 트랜잭션 처리를 결합해, 동일 신호가 중복 수신되어도 중복 주문이 발생하지 않는 실행 엔진을 구현합니다.

주문 실행 엔진 & 중복 방지
주문 실행 엔진 & 중복 방지 실제 화면
핵심 기능 4

장애 자동 복구 & 모의계좌 검증

프로세스 비정상 종료 시 자동 재시작하고, 테스트넷 모드로 실거래 전환 전 전체 흐름을 검증합니다.

  • 워치독 프로세스가 엔진 헬스체크를 주기적으로 수행하고 무응답 시 프로세스를 자동 재기동하는 구조를 구현합니다
  • 재기동 직후 거래소 API를 재조회해 진행 중이던 주문·포지션 상태를 로컬 DB와 다시 동기화하는 로직을 설계합니다
  • 테스트넷/실거래 모드 토글로 동일 로직을 모의 계좌 환경에서 먼저 검증할 수 있게 구현합니다

재기동 후 거래소 상태 재조회 동기화 로직을 통해, 프로세스 장애가 발생해도 주문·포지션 데이터 정합성을 복구하는 구조를 설계합니다.

장애 자동 복구 & 모의계좌 검증
장애 자동 복구 & 모의계좌 검증 실제 화면
구현 과정

프로젝트 진행 단계

STEP 1

거래소 API 연동 및 인증 구조 설계 · 2026.09

OKX·Bitget REST/WebSocket 클라이언트와 HMAC 서명 인증 모듈을 구현하고 공통 어댑터 구조를 설계합니다

STEP 2

주문 실행 엔진 및 멱등성 처리 개발 · 2026.09

신호 수신 웹훅, 멱등키 검증, 주문 생성·취소 트랜잭션 파이프라인을 구현합니다

STEP 3

장애 복구 및 모의계좌 검증 모드 구현 · 2026.09

워치독 프로세스, 재기동 후 상태 동기화 로직, 테스트넷/실거래 모드 스위치를 구현합니다

STEP 4

관제 대시보드 UI 개발 · 2026.09

React 기반 잔고·포지션·주문·엔진상태 대시보드 화면을 구현하고 Recharts 시각화를 적용합니다

STEP 5

통합 테스트 및 알림 연동 · 2026.09

이메일·텔레그램 알림 발송을 연동하고 전체 파이프라인 통합 테스트를 수행합니다

프로젝트 성과

주요 성과

거래소 공통 어댑터 구조 설계OKX·Bitget API 차이를 공통 인터페이스로 추상화, 신규 거래소 추가 시 확장 가능한 구조를 구축합니다
멱등키 기반 중복 주문 차단 구현신호 수신 웹훅에 idempotency key 검증 로직을 적용, PostgreSQL 유니크 제약과 트랜잭션으로 원자성을 보장합니다
워치독 기반 장애 자동 복구 구조 구현프로세스 헬스체크와 재기동 후 거래소 재조회 동기화 로직을 설계, 상태 정합성 복구 흐름을 구축합니다
실시간 WebSocket 관제 파이프라인 구축다중 거래소 시세·체결 이벤트를 asyncio 기반으로 병합해 대시보드에 초 단위로 push하는 구조를 설계합니다
Highlights

기술적 주안점

  • asyncio 기반 비동기 집계 파이프라인과 WebSocket 실시간 push를 결합해 다중 거래소 상태를 지연 없이 한 화면에 통합하는 구조를 구현합니다
  • 어댑터 구조로 거래소별 API 차이를 추상화해, 향후 거래소를 추가할 때 신규 어댑터 하나만 구현하면 되는 확장 구조를 설계합니다
  • 멱등키 대조와 원자적 트랜잭션 처리를 결합해, 동일 신호가 중복 수신되어도 중복 주문이 발생하지 않는 실행 엔진을 구현합니다

유사한 프로젝트를 기획하고 계신가요?

FIRSTPIP이 개발 범위와 로드맵을 함께 정리해드립니다

무료 상담 시작하기