QFEX 메이커 봇 셋팅법 (Claude Code / Codex) QFEX는 베리나처럼 RWA Perp에서 높은 지표를 뽑고 있는데, Kyle과 몇몇을 제외하면 아직 관심이 적은

QFEX 메이커 봇 셋팅법 (Claude Code / Codex)

QFEX는 베리나처럼 RWA Perp에서 높은 지표를 뽑고 있는데, Kyle과 몇몇을 제외하면 아직 관심이 적은 편입니다.

포인트 프로그램도 곧 시작될 예정이고, 듣기로는 괜찮은 호재도 몇 개 있다고 합니다. 공식 발표 전인 내용은 참고만 하시면 됩니다.

현재 아커스나 베리나와 반대 포지션을 잡는 사이드파티 방식도 유행하고 있습니다. 이 경우 거래소 간 가격 차이·펀딩·체결 시차까지 함께 확인해야 합니다.

관심이 덜할 때 미리 셋팅해두실 분들을 위해 메이커 봇 제작 방법을 정리했습니다.

아래 프롬프트를 Claude Code / Codex에 전달하면 됩니다. 처음에는 주문 없는 모의 실행부터 시작하고, 주문 금액·재고 한도·손실 중단 기준은 본인 자금에 맞게 설정하세요.

1. 계정 준비

• 가입: https://qfex.com/
• 가입 후 안내에 따라 인증 진행
• 사이트에서 API 사용 신청 → 승인 후 설정 → API에서 키 발급
• 입금 화면에서 지원 네트워크·최소 입금액 확인 후 소액 입금
• API 키는 조회·거래에 필요한 권한만 부여하고 출금 권한 제외
• 키는 채팅·텔레그램·AI 대화창에 붙여넣지 말고 내 PC에 직접 저장

초대 코드 — 아래 중 하나 사용

Y2H0WKWW
8JKBVKHM
6BCD5Y90
YN183G18
GHGZERWM
GKBRFGQ7
QJN400VK
WJ71CKX5
RTDJPEMH
VTK7MJNZ

2. 운영하면서 볼 것

• 미국장·장외 시간대 성과를 따로 확인
• CPM = 순손실 ÷ 거래량 × 1,000,000
• CPM $182 = 거래량 $100만당 비용 $182
• 순손실은 입출금을 보정하고 미실현 손익·수수료·펀딩까지 반영
• 사이드파티 방식은 양쪽 거래소의 손익과 비용을 합산
• 포인트·에어드랍은 확정 수익으로 계산하지 않기

메이커 봇도 손실이 납니다. 시세 급변이나 연결 장애로 설정한 손실 한도를 넘길 수 있고, 주문을 취소해도 보유 포지션은 남습니다.

3. API 키 저장

WSL / Linux / macOS 터미널에서 아래 명령어를 한 줄씩 입력하세요.

mkdir -p ~/qfex-bot
cd ~/qfex-bot
touch .env
chmod 600 .env
nano .env

아래 두 줄을 입력하고 실제 키로 바꿔주세요.

QFEX_API_KEY=발급받은_공개키
QFEX_API_SECRET=발급받은_시크릿키

저장: Ctrl+O → Enter
종료: Ctrl+X

4. Claude Code / Codex에 전달할 프롬프트

아래 내용을 그대로 복사해서 전달하세요.

──── 프롬프트 시작 ────

~/qfex-bot 폴더에 QFEX 메이커 마켓메이킹 봇을 파이썬으로 만들어줘.

공식 문서 https://docs.qfex.com/llms.txt 를 먼저 읽고 인증 방식, post-only 주문 설정, 최소 주문금액, 호가·수량 단위, 수수료, 레이트리밋을 확인해. 문서에 없는 기능은 추측해서 구현하지 마.

[키 관리]

• python-dotenv로 .env를 로드한 뒤 os.environ으로 키를 읽어.
• 키 값과 인증 헤더는 출력하거나 로그에 남기지 마.
• .env는 .gitignore에 추가해.

[전략]

• post-only 지정가 주문만 사용해. GTC만으로 post-only가 보장된다고 가정하지 마.
• 시장가·IOC 주문은 구현하지 마.
• 계정 수수료와 호가 유동성을 확인해 마켓 1~2개를 제안해.
• 최우선 매수·매도 호가(BBO) 기준으로 양방향 호가를 내고, 재고에 따라 호가를 조정해.
• 주문당 금액, 마켓당 최대 재고, 일일 손실 한도는 설정값으로 분리해. 내 운용 자금과 최소 주문 조건을 확인한 뒤 실거래 전에 나와 확정해.
• 미체결 주문이 모두 체결돼도 재고 한도를 넘지 않게 해.
• 최소 주문 조건을 충족하지 못하면 금액을 자동으로 늘리지 말고 중지해.

[안전장치]

• 기본값 DRY_RUN=1. 이 모드에서는 주문 생성·취소 등 계정 변경을 하지 마.
• DRY_RUN=0이고 LIVE_ACK=YES일 때만 실주문을 허용해.
• 실거래는 전용 계정 또는 서브계정에서 진행해. 실거래 시작·종료 시 해당 범위의 미체결 주문을 취소해.
• cancel_on_disconnect의 지원 여부와 적용 범위를 확인해. 지원하면 실거래에서 활성화하고, 미지원이면 한계를 알려줘.
• 시세 지연·연결 끊김 발생 시 신규 주문을 중단하고 기존 주문 취소를 시도해.
• 주문 응답이 불명확하면 주문 상태를 조회한 뒤 재시도해. 상태 확인이 안 되면 신규 주문을 중단해 중복 주문을 막아.
• 입출금을 보정한 평가자산 변동으로 일일 손익을 계산해. 실현·미실현 손익과 수수료·펀딩이 반영되도록 하되 중복 차감하지 마.
• 일일 손실 한도에 도달하면 주문 취소 후 정지하고 HALT 파일을 생성해. 파일 삭제 전에는 재시작하지 마.
• 주문 취소는 포지션 청산이 아니므로 남은 포지션을 명확히 알리고 자동 시장가 청산은 하지 마.
• 연속 오류 8회면 주문 취소를 시도한 뒤 정지해. 레이트리밋에는 백오프를 적용해.
• 1분마다 평가자산·재고·체결수·거래량·손익을 출력해.

[검증]

① DRY_RUN으로 5분 실행해 연결과 호가 계산을 확인해. 실제 체결 검증과 구분해.
② 내 확인 후 최소 주문 조건을 충족하는 소액 주문으로 체결 1건을 확인해.
③ 메이커 체결 여부와 실제 수수료를 확인해. 수수료 0을 가정하지 마.
④ Ctrl+C 종료 후 미체결 주문이 없는지, 남은 포지션은 얼마인지 확인해.

──── 프롬프트 끝 ────