Skip to content

tmwclaxton/personal-arbitrage-node

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

687 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Personal Arbitrage Node

Automated DeFi & P2P trading for Robosats.
A self-hosted Laravel trading kit from Lightning Arbitrage Solutions.

Website GitHub

Website · GitHub · Telegram waitlist

Laravel 11 Vue 3 Inertia PHP 8.2+ Lightning Network Docker MIT License


The problem

P2P Bitcoin trading on Robosats is profitable but operationally intense. You need Lightning liquidity, timely bond and escrow payments, payment confirmation across fiat rails, offer management across providers, and enough uptime to catch good spreads before they disappear.

Running that manually means babysitting chat rooms, copy-pasting payment handles, and hoping you do not miss a bond window at 2 a.m.

Personal Arbitrage Node is a self-hosted trading kit that automates the repetitive Robosats workflow — robot creation, offer posting, escrow handling, payment matching, and reward collection — while keeping your keys, data, and configuration on infrastructure you control.

What it does

flowchart LR
    A["⚡ Umbrel / Lightning node"] --> B["🤖 Robosats API"]
    B --> C["📋 Offer & robot manager"]
    C --> D["💳 Fiat payment rails"]
    D --> E["📊 Dashboard & analytics"]
    E --> F["🔔 Slack alerts"]
Loading
Area Capability
Robosats automation Robot creation, offer posting, auto-accept, bond/escrow payment, reward claims, collaborative cancel
Offer templates Reusable sell/buy templates with premiums, cooldowns, and scheduled auto-create
Payment matching Wise, Revolut, and Monzo integrations with transaction ingestion and payment confirmation
Lightning & BTC Umbrel node integration, Kraken auto-purchasing, sats-in-transit tracking
Admin controls Panic button, time-window scheduler, per-method/currency configuration
Analytics Graphs, transaction history, BTC purchases, tax-return exports
Notifications Slack messaging for trades, payments, and scheduler events
Privacy tooling Local data storage, PGP support, optional MITM certificate verification, Tor-friendly design

Feature highlights

  • Fully automated trading loop — create robots, post offers, accept trades, pay bonds and escrow, confirm fiat receipts, and claim rewards without manual tab-hopping.
  • 87+ payment methods — Revolut, Wise, Cash App, SEPA, Faster Payments, PIX, and dozens more, with configurable handles and per-method premiums.
  • 79+ currencies — multi-currency offer templates aligned with Robosats' supported fiat set.
  • Template-driven posting — define sell/buy templates once; the scheduler and auto-create commands keep your book live within configured windows.
  • Panic button — instantly pause all active offers when you need to stop the line.
  • Built-in guide & logs — operator UI for configuration, worker logs, and troubleshooting.

Hardware kit: Lightning Arbitrage Solutions also ships a physical trading kit. Join the waitlist via Telegram (@las_2024) or Signal (@las.24).

Tech stack

Layer Choices
Backend Laravel 11, scheduled Artisan commands, queue workers
Frontend Vue 3, Inertia.js, Tailwind CSS
Trading Robosats WebSocket/API via Umbrel-hosted node
Fiat rails Wise, Revolut, Monzo APIs; IMAP for verification flows
Exchange Kraken API for BTC balance management
Crypto PGP (OpenPGP), TOTP/2FA helpers
Infrastructure Docker Compose (Laravel Sail), Redis, MySQL; Umbrel OS target

Deployment

Designed to run on Umbrel home nodes or standalone Docker hosts. A Portainer stack (piScripts/portainer.yml) is included for production-style deployments with MySQL and Redis sidecars.

Prerequisites

  • PHP 8.2+ with curl and openssl extensions
  • Composer, Node.js, and npm
  • Docker & Docker Compose (recommended)
  • A running Umbrel instance with Robosats and a Lightning node
  • API credentials for the fiat rails and exchanges you intend to use

Quick start (Sail)

git clone https://github.com/tmwclaxton/personal-arbitrage-node.git
cd personal-arbitrage-node
composer install
cp .env.example .env
php artisan key:generate
./vendor/bin/sail up -d
./vendor/bin/sail artisan migrate
./vendor/bin/sail npm install && ./vendor/bin/sail npm run dev

Copy .env.example.env and configure your Umbrel IP, Robosats credentials, Kraken/Wise/Revolut keys, Slack webhooks, and IMAP settings before enabling automation.

For operator guidance, see the in-app Guide route or reach out via lightningarbitragesolutions.com.

Target platforms

Platform Status
Umbrel OS Primary target
Docker / Portainer Supported via docker-compose.yml and piScripts/portainer.yml
Rooted Android Planned

Future integration with Bisq 2 is on the roadmap.


Disclaimer

This software automates real-money P2P Bitcoin trades. Misconfiguration, downtime, or operating outside your local regulations can lose funds — or get your bank accounts closed.

You are responsible for compliance, tax reporting, and operational security. Lightning Arbitrage Solutions provides tooling, not financial advice.

You will probably get your bank accounts banned using this :P

Use at your own risk. Test on small sizes. Keep a panic button handy.


Built by Lightning Arbitrage Solutions

About

Money Printer

Resources

Stars

2 stars

Watchers

1 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors