프로젝트 소개

Arbitrage Insights는 소규모 외환 차익거래 도구 키트입니다. 현물환율과 두 가지 이자율에서 산출한 통화쌍의 공정 선물환율을 시장 선물환율과 비교하여 갭을 찾고, 거래 비용과 세금을 제외한 남은 수익을 보여줍니다. 프로젝트는 세 페이지를 제공합니다. Live Monitor는 매분 실시간 현물환율을 가져와 감시 중인 각 통화쌍의 공정 선물환율을 계산하고, 사용자가 입력한 선물환 호가와 비교한 뒤 비용을 차감하며, 조치할 가치가 있는 갭이 발생하면 배너, 소리, 브라우저 알림으로 알립니다. Arbitrage Calculator는 단일 거래를 단계별로 확인합니다. Investment Calculator는 자본, 통화쌍, 국가를 입력하면 총수익, 비용 차감 후 수익, 세금 차감 후 수익을 국가 비교와 함께 반환합니다. 공유 파일에는 수학 계산을 담당하는 engine.js, theme.css, monitor.js, monitor_config.json이 있습니다. 실시간 현물환율은 공공 피드(api.fxratesapi.com, 실패 시 open.er-api.com 사용)에서 가져옵니다. 이자율과 선물환 포인트는 monitor_config.json에서 가져옵니다. 무료 피드에서는 선물환 호가를 제공하지 않으므로 사용자가 해당 파일에 브로커의 선물환 포인트를 입력해야 합니다. 그 전까지 사이트는 샘플 모드로 실행되며 알림을 보내지 않습니다. 비용 차감 후 갭이 alert_threshold_bp를 초과하고 입력값이 정상성 검사를 통과하면 알림이 발생합니다. 열린 페이지가 없을 때 알림을 받으려면 monitor_check.py가 GitHub Actions에서 15분마다 실행되어 동일한 config와 engine을 사용하고, 페이지가 읽을 signals.json을 작성하며, 기회가 나타나고 quotes_are_real이 true이면 텔레그램 메시지를 보냅니다. 설정하려면 BotFather를 통해 텔레그램 봇을 만들고 TELEGRAM_BOT_TOKEN과 TELEGRAM_CHAT_ID를 리포지토리 비밀 변수로 저장한 뒤 config에 실제 forward_points, quotes_as_of, quotes_are_real을 설정해야 합니다. fx_arbitrage.py는 기준이 되는 파이썬 구현이며, engine.js는 이를 상호 검증한 포트입니다. 이를 실행하면 네 가지 완성된 예시가 출력되고, monitor_check.py는 로컬에서 모니터링을 한 차례 실행합니다. README에는 이자율과 세율이 예시 또는 자리표시자이므로 사용 전에 확인해야 하며, 이 프로젝트는 투자 조언이 아니라는 점이 명시되어 있습니다.