pathfinder

KO | EN

gitlite — search

#typescript #ai-agents #ai #dsh-plugin #deepseek-harness #open-source #cli #claude-code #codex #developer-tools #react #windows

★ 85 Open GitHub ↗

Cyclic arbitrage detection CLI for DEXs

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Pathfinder
A command line interface (CLI) for quantifying & detecting DEX token pair arbitrage on the Ethereum blockchain. <br/> Currently supports UniswapV3 and Sushiswap.

# ⚡️ Quick start
First, install Node.js. Then, run the following commands:
```
npm install
npm install ts-node -g
npm install typescript -g
```

# ⚙️ Commands & Options
### **`start`**

begin searching for dex cycles repeatedly
```bash
ts-node ./src/program.ts start [OPTIONS]
```
| Option | Description                                              | Type    | Default | Required? |
|--------|----------------------------------------------------------|---------|---------|-----------|
| `--tokens`    | Number of highest daily volume tokens             | `number`| `5`     | No        |
| `--timeout`   | Polling timeout (seconds)                         | `number`| `5`     | No        | 
| `-x, --dex`   | Select which DEX(s) to arbitrage                  | `bool`  | `false` | No        |
| `-d, --debug` | Enable debug mode for printing                    | `bool`  | `false` | No        |

### **`run`**

search once for dex cycles
```bash
ts-node ./src/program.ts run [OPTIONS]
```
| Option | Description                                              | Type    | Default | Required? |
|--------|----------------------------------------------------------|---------|---------|-----------|
| `--tokens`    | Number of highest daily volume tokens             | `number`| `5`     | No        |
| `-x, --dex`   | Select which DEX(s) to arbitrage                  | `bool`  | `false` | No        |
| `-d, --debug` | Enable debug mode for printing                    | `bool`  | `false` | No        |

# 🔮 Future Roadmap
- More DEXs (PancakeSwap)
- CEX
- More L1s
- L2s
- Price slippage
- Live gas cost feed

pathfinder

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README