Overview

EVE Flipper helps traders decide whether an opportunity is actually executable, not just mathematically attractive on top-of-book prices. It combines ESI market data, local history, orderbook depth, liquidity scoring, route risk, character data, and paper/live trade workflows in one local application.

The app is built for practical EVE trading:

• Station trading and same-hub flipping.
• Regional hauling and route opportunity scanning.
• Contract arbitrage and liquidation checks.
• Industry build-vs-buy analysis, reactions, invention, and project tracking.
• Portfolio, wallet, PnL, cashflow, active orders, assets, and risk views.
• Paper backtesting, orderbook snapshot recording, and trade journaling.

Use the hosted web build at app.eveflipper.com, or run the desktop/server builds locally when you want the full local-first workflow. EVE Flipper does not depend on a shared user database for the desktop app.

Screenshots

| Station Trading | Route Trading | Radius Scanner | |---|---|---| | | | |

Current Public Release

The current public release is v1.6.13.

Download it from:

• Hosted web app
• GitHub Releases

Release packages are published as two runtime families:

| Runtime | Assets | Use When | |---|---|---| | Desktop app | eve-flipper-desktop-windows-amd64.exe, eve-flipper-desktop-linux-, eve-flipper-desktop-darwin- | You want the normal app window with the embedded backend. Recommended for most users. | | Web/server binary | eve-flipper-web-windows-amd64.exe, eve-flipper-web-linux-, eve-flipper-web-darwin- | You want to run the local backend and open the UI in a browser. | | Checksums | SHA256SUMS.txt | Used by the updater and for manual release verification. |

Main Modules

| Module | What It Does | |---|---| | Flipper (Radius) | Finds local buy/sell opportunities around a source system using depth-aware profit, slippage, liquidity, and fillability math. | | Station Trading | Same-station market scanner for hub trading with advanced filters, active order context, history, and paper trade actions. | | Regional Trade | Cross-region scanner for hauling and market spread discovery. | | Route | Builds route opportunities with execution estimates, cargo trips, travel time, ISK/hour, liquidity, and gank-risk signals. | | Contract Arbitrage | Evaluates contracts, courier risk, collateral issues, liquidation assumptions, and suspicious pricing. | | Paper Backtest | Simulates hold and instant-flip strategies with configurable entry cadence, volume limits, price assumptions, ROI filters, fees, and equity charts. | | Trade Journal | Tracks manual and scanner-created paper/live trade records, live drafts from ESI, reconciliation, and suggested status updates. | | Portfolio and Risk | Calculates wallet, assets, active orders, exposure, PnL, optimizer diagnostics, and inventory-aware capital usage. | | Industry | Performs build-vs-buy analysis, material depth checks, sell-mode comparison, reactions, invention, project planning, blueprints, jobs, and ledger coverage. | | Wallet/Cashflow | Provides EveLedger-style foundations for income, outgoing, inventory mark-to-market, category views, and capital tracking. | | PLEX+ | Tracks PLEX-oriented market analytics and profitability dashboards. | | War/Demand Tracker | Surfaces region activity, demand hot zones, and opportunity context. |

Execution-Aware Trading

The project intentionally avoids the most common market-tool trap: treating the first buy/sell order as if the whole position can trade there.

Current execution logic includes:

• VWAP-style depth walking for market scanner and route calculations.
• Slippage and safe quantity calculation.
• Real profit fields after depth and fees.
• Liquidity, fill-rate, fill-time, turnover, and confidence signals.
• Daily volume and history-aware filters.
• Active character orders/assets context where available.
• Route cargo trips, execution minutes, safety delay, and ISK/hour.
• Gank-risk and hot-zone indicators for hauling.
• Courier and collateral risk signals.

Backtesting and Orderbook Replay

The Paper Backtest module supports two practical modes:

• Hold mode: buy, hold for a configured period, then exit using historical assumptions.
• Instant flip mode: simulate repeated buy-haul-sell cycles when opportunities appear again after cooldown.

The app can also record orderbook snapshots locally and replay recorded coverage. ESI does not provide historical orderbook depth retroactively, so real historical orderbook replay becomes useful only after you have accumulated your own snapshots.

Character-Aware Workflows

EVE SSO is optional, but login unlocks deeper workflows:

• Character wallet, transactions, journal, orders, assets, location, skills, and blueprints.
• Structure market access where your character has access.
• Live trade journal drafts and reconciliation.
• Portfolio optimizer using wallet, inventory, and active orders.
• Industry coverage against owned materials and BPO/BPCs.
• Active industry job sync.
• EVE UI actions such as open market and set waypoint.

Quick Start

Desktop Release

• Download the desktop asset for your OS from latest release.
• Run the binary.
• Add a character if you want SSO-backed features, or use public-market scanners without login.

Web/Server Release

Windows:

.\eve-flipper-web-windows-amd64.exe

Linux/macOS:

chmod +x ./eve-flipper-web-linux-amd64
./eve-flipper-web-linux-amd64

Then open:

http://127.0.0.1:13370

Build From Source

Prerequisites:

• Go 1.25+
• Node.js 24+
• pnpm 11+ through Corepack

git clone https://github.com/ilyaux/Eve-flipper.git
cd Eve-flipper
corepack pnpm -C frontend install --frozen-lockfile
corepack pnpm -C frontend run build
go run .

Developer Commands

Backend:

go run .

Frontend dev server:

corepack pnpm -C frontend install --frozen-lockfile
corepack pnpm -C frontend run dev

Production web build:

corepack pnpm -C frontend run build
go build -o build/eve-flipper .

Wails desktop build:

corepack pnpm -C frontend run build:wails
go build -tags "wails,production" -ldflags "-s -w -X main.version=dev" -o build/eve-flipper-desktop .

PowerShell helpers:

.\make.ps1 build
.\make.ps1 run
.\make.ps1 test
.\make.ps1 wails
.\make.ps1 wails-run

Unix Make targets:

make build
make run
make test
make wails

Runtime Configuration

The web/server binary listens on localhost by default:

./eve-flipper-web-linux-amd64 --host 127.0.0.1 --port 13370

| Flag | Default | Description | |---|---:|---| | --host | 127.0.0.1 | Bind address. Use 0.0.0.0 only if you know how to secure the host. | | --port | 13370 | HTTP port for the local web UI and API. |

Desktop builds start their own local backend internally. If 13370 is already busy, the desktop app can use a free local port and route API calls through the Wails asset server.

EVE SSO Setup for Source Builds

Official release builds are configured through GitHub release secrets. For local source builds, create .env in the repository root:

ESICLIENTID=your-client-id
ESICLIENTSECRET=your-client-secret
ESICALLBACKURL=http://localhost:13370/api/auth/callback

Do not commit .env.

Useful scopes include market orders, wallet, assets, skills, blueprints, industry jobs, structures, corporation data, and EVE UI actions. The app requests the scopes required by its character-aware modules.

Data and Privacy

• SQLite stores local config, history, snapshots, journal records, projects, and cached state.
• ESI tokens are stored locally.
• Public market scans can run without EVE login.
• No project-operated cloud backend receives your trading data.

Release Safety

• Release binaries are built by GitHub Actions from tags.
• Release assets include SHA256SUMS.txt.
• The auto-updater verifies the downloaded asset checksum before replacing the local binary.
• Windows release builds include version metadata and app icon resources.

Known Limits

• ESI does not provide old orderbook depth. Historical orderbook replay requires locally recorded snapshots.
• Market data can move between scan and execution. Always check volume, fees, taxes, standings, skills, and order depth before committing serious ISK.
• Gank-risk and route scoring are decision support, not safety guarantees.
• Industry and portfolio tools are models. They improve discipline, but they do not replace manual review of jobs, orders, assets, and market conditions.

Tests

go test ./...
go test -tags wails ./...
corepack pnpm -C frontend run build
corepack pnpm -C frontend run build:wails

Documentation and Community

• Project wiki
• Getting Started
• API Reference
• Discord

Contributing

Issues, pull requests, bug reports, screenshots, and trading workflow feedback are welcome. For larger changes, describe the trading scenario and the expected behavior clearly so it can be tested against real EVE market conditions.

License

MIT License. See LICENSE.

Disclaimer

EVE Flipper is an independent third-party project and is not affiliated with CCP Games. EVE Online and related trademarks are property of CCP hf.