Skip to content

Erin-Wave/ox64

Repository files navigation

ox64

🔗 ox64.app 바로가기

지인들끼리 수익률을 겨루는 모의 선물 트레이딩 플랫폼.

실시간 시세(바이낸스) 기반으로 롱/숏 포지션을 연습하고, 친구들과 랭킹으로 경쟁합니다. 잔고·포지션·손익은 전부 서버(Cloudflare D1)가 계산·보관하므로, 클라이언트에서 가격이나 잔고를 조작해도 랭킹에는 반영되지 않습니다 — 공정한 경쟁을 위한 서버 권위 구조입니다.

주요 기능

  • 📈 실시간 차트 — TradingView Lightweight Charts, 38개 실제 심볼 + 가상 심볼(OX/USDT) 39종, 다양한 타임프레임(초/분/시간/일+)
  • 🎨 차트 색상 테마 — 바이낸스 / OKX / 트레이딩뷰 배색 프리셋(캔들 색·배경), 사이트 다크/라이트/고대비 테마와 별개로 선택
  • 📊 보조지표 — EMA / Bollinger Bands / RSI(기간·개수 자유 설정), 거래량 히스토그램
  • 💰 모의 거래 — 시장가/지정가 롱·숏, 레버리지 1~125배, SL/TP, 부분청산, 강제청산(계좌 파산) + 리필 안전망
  • 🪙 가상 코인(OX/USDT) — 실제 코인과 완전히 동일한 레버리지 거래, 체결가만 마켓메이커 봇이 생성
  • 📖 호가창 · 체결내역 — 매수/매도 좌우 2열 호가, 실시간 체결 탭(실제 심볼은 바이낸스 체결 스트림)
  • 🏆 친구 랭킹 — 평가자산(잔고 + 미실현 손익) 기준 실시간 순위
  • 🔐 간편 로그인 — 이름 + 패스코드만으로 가입/로그인
  • 📱 반응형 UI — 모바일 1줄 헤더 + 아이콘 위주 컴팩트 레이아웃, PC 확장 레이아웃

기술 스택

구분 기술
프론트엔드 Vite + React (TypeScript), Zustand, Tailwind CSS
차트 TradingView Lightweight Charts v4
실시간 시세 RxJS + Native WebSocket (바이낸스 스팟)
백엔드 Cloudflare Pages Functions (functions/)
DB Cloudflare D1 (SQLite)
인증 HMAC 서명 세션 쿠키 + PBKDF2 패스코드 해싱
백그라운드 작업 별도 Cron Worker (cron/) — 강제청산 + OX 마켓메이커 봇을 접속자 없이도 5분마다 실행

프론트(정적 SPA)와 백엔드(Pages Functions)를 한 레포·한 배포로 운영합니다(단, Pages 는 정기 실행을 지원하지 않아 cron/ 만 별도 Workers 프로젝트로 배포). 커스텀 도메인(ox64.app)만 접속되도록 *.pages.dev 는 자동 리다이렉트됩니다.

왜 서버 권위 구조인가

클라이언트(브라우저 저장소)에 잔고나 시세를 두면 콘솔로 얼마든지 변조할 수 있어 랭킹 경쟁이 무의미해집니다. 그래서 체결가 조회, 증거금 계산, 손익 정산을 모두 서버가 수행하고 D1에 원자적으로 기록합니다. 클라이언트가 보내는 값은 symbol / side / size / leverage 뿐이며, 가격은 서버가 직접 거래소에서 받아옵니다.

시작하기

npm install
npm run dev              # 프론트 개발 서버 (Vite) — /api 는 동작하지 않음

npm run build            # tsc -b && vite build → dist/
npx wrangler pages dev dist   # 백엔드(D1 + Functions) 포함 로컬 구동

D1 스키마 적용:

npx wrangler d1 execute ox64 --remote --file=./schema.sql

자세한 폴더 구조, 데이터 흐름, 배포 설정은 CLAUDE.md를 참고하세요.

로드맵

  • 서버 권위 백엔드(D1) + 친구 랭킹
  • 이름+패스코드 로그인
  • 반응형 UI, 커스텀 폰트/파비콘
  • 지정가/스탑 주문 + SL/TP + 부분청산
  • 강제청산가 계산 + 강제청산 시스템 + 리필 안전망(접속 여부 무관, cron 워커로 자동 실행)
  • 거래 내역 패널, 호가창(호가/체결 탭)
  • OX/USDT 가상 코인 — 레버리지 롱/숏으로 실제 코인과 완전히 동일하게 거래(체결가만 봇이 생성)
  • OX 실제 호가창 매칭 엔진 — 주문이 봇 호가를 walking 체결(있는 물량만·실제 호가 가격·잔량 대기), 호가 역전/유령체결 없음
  • 차트 색상 테마(바이낸스/OKX/트레이딩뷰)
  • 수수료·펀딩비 반영

라이선스

개인/친목용 프로젝트입니다. 별도 명시 없는 한 상업적 이용을 염두에 두지 않았습니다.

About

Mock Trading Platform

Resources

License

Stars

0 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages