Skip to main content
skill CX Codex

simulating-flash-loans — Claude Code skill: how to install

simulating-flash-loans simulates flash loans across Aave V3, dYdX, and Balancer without spending real tokens. It estimates arbitrage and liquidation net profits, gas costs, and execution risks.

MIT 1 installs ★ 2,935 updated 2026-11-01

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add jeremylongshore/tons-of-skills-marketplace --skill simulating-flash-loans -a claude-code
Open on GitHub

What simulating-flash-loans does

This skill models flash loan operations using Aave V3, dYdX, or Balancer without submitting live transactions. It evaluates DEX arbitrage and lending liquidations by tracking price discrepancies alongside pool fees. The bundled flash_simulator.py script calculates gas costs for trade routes between Uniswap and Sushiswap.

The tool requires Python 3.9+ with the web3 and httpx libraries. It connects to the Ethereum network via the ETH_RPC_URL environment variable or ${CLAUDE_SKILL_DIR}/config/settings.yaml. Public nodes from chainlist.org work for queries. Without an operational RPC endpoint, the script fails immediately on data fetching.

Outputs include a fast Go/No-Go verdict, detailed transaction fee breakdowns, or provider comparisons. Adding --risk-analysis scores MEV competition and pool liquidity on a 0 to 100 scale with an A-F grade.

What it helps with

  • calculate net profit for two-DEX arbitrage routes
  • compare provider borrowing fees across Aave V3, dYdX, and Balancer
  • evaluate liquidation profitability on lending platforms like Aave
  • simulate multi-hop triangular arbitrage paths
  • score execution and MEV competition risks before trading

Example prompts for the agent

  • Simulate flash loan arbitrage between Uniswap and Sushiswap for ETH and USDC.
  • Compare flash loan provider fees across Aave and Balancer for 100 ETH.
  • Check liquidation profitability on Aave for a position with a 0.95 health factor.

How to install simulating-flash-loans

1Skills CLI (Vercel)

npx skills add jeremylongshore/tons-of-skills-marketplace --skill simulating-flash-loans -a claude-code

2Manually: put the files in place

~/.claude/skills/simulating-flash-loans/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/simulating-flash-loans/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about simulating-flash-loans

How do I install simulating-flash-loans in Claude Code?

Run npx skills add jeremylongshore/tons-of-skills-marketplace --skill simulating-flash-loans -a claude-code. This command writes the skill definition to ~/.claude/skills/simulating-flash-loans/SKILL.md.

What is the purpose of simulating-flash-loans?

It evaluates flash loan strategies by calculating gas fees, lending interest, and net arbitrage returns. This helps spot unprofitable routes before committing real funds on-chain.

What dependencies are required to run the simulation?

You need Python 3.9+ with web3, httpx, and rich, plus an RPC URL defined in ETH_RPC_URL or config/settings.yaml. An optional Etherscan API key improves gas estimates.

Source text

SKILL.md · MIT
---
name: simulating-flash-loans
description: 'Simulate flash loan strategies with profitability calculations and risk
  assessment across Aave, dYdX, and Balancer.

  Use when simulating flash loans, analyzing arbitrage profitability, evaluating liquidation
  opportunities, or comparing flash loan providers.

  Trigger with phrases like "simulate flash loan", "flash loan arbitrage", "liquidation
  profit", "compare Aave dYdX", "flash loan strategy", or "DeFi arbitrage simulation".

  '
allowed-tools: Read, Write, Edit, Grep, Glob, Bash(crypto:flashloan-*)
version: 1.31.0
author: Jeremy Longshore <[email protected]>
license: MIT
tags:
- crypto
- simulating-flash
compatibility: Designed for Claude Code
---
# Simulating Flash Loans

## Contents

[Overview](#overview) | [Prerequisites](#prerequisites) | [Instructions](#instructions) | [Output](#output) | [Error Handling](#error-handling) | [Examples](#examples) | [Resources](#resources)

## Overview

Simulate flash loan strategies across Aave V3, dYdX, and Balancer with profitability calculations, gas cost estimation, and risk assessment. Evaluate flash loan opportunities without executing real transactions.

## Prerequisites

1. Install Python 3.9+ with `web3`, `httpx`, and `rich` packages
2. Configure RPC endpoint access (free public RPCs via https://chainlist.org work fine)
3. Optionally add Etherscan API key for better gas estimates
4. Set RPC in `${CLAUDE_SKILL_DIR}/config/settings.yaml` or use `ETH_RPC_URL` env var

## Instructions

1. Simulate a two-DEX arbitrage with automatic fee and gas calculation:

   ```bash
   python ${CLAUDE_SKILL_DIR}/scripts/flash_simulator.py arbitrage ETH USDC 100 \
     --dex-buy uniswap --dex-sell sushiswap
   ```

2. Compare flash loan providers to find the cheapest for your strategy:

   ```bash
   python ${CLAUDE_SKILL_DIR}/scripts/flash_simulator.py arbitrage ETH USDC 100 --compare-providers
   ```

3. Analyze liquidation profitability on lending protocols:

   ```bash
   python ${CLAUDE_SKILL_DIR}/scripts/flash_simulator.py liquidation \
     --protocol aave --health-factor 0.95
   ```

4. Simulate triangular arbitrage with multi-hop circular paths:

   ```bash
   python ${CLAUDE_SKILL_DIR}/scripts/flash_simulator.py triangular \
     ETH USDC WBTC ETH --amount 50
   ```

5. Add risk assessment (MEV competition, execution, protocol, liquidity) to any simulation:

   ```bash
   python ${CLAUDE_SKILL_DIR}/scripts/flash_simulator.py arbitrage ETH USDC 100 --risk-analysis
   ```

6. Run full analysis combining all features:

   ```bash
   python ${CLAUDE_SKILL_DIR}/scripts/flash_simulator.py arbitrage ETH USDC 100 \
     --full --output json > simulation.json
   ```

## Output

- **Quick Mode**: Net profit/loss, provider recommendation, Go/No-Go verdict
- **Breakdown Mode**: Step-by-step transaction flow with individual cost components
- **Comparison Mode**: All providers ranked by net profit with fee differences
- **Risk Analysis**: Competition, execution, protocol, and liquidity scores (0-100) with viability grade (A-F)

See [`references/implementation.md`](references/implementation.md) for detailed output examples and risk scoring methodology.

## Error Handling

| Error | Cause | Solution |
|-------|-------|----------|
| RPC Rate Limit | Too many requests | Switch to backup endpoint or wait |
| Stale Prices | Data older than 30s | Auto-refreshes with warning |
| No Profitable Route | All routes lose after costs | Try different pairs or amounts |
| Insufficient Liquidity | Trade exceeds pool depth | Reduce amount or split across pools |

See [`references/errors.md`](references/errors.md) for comprehensive error handling.

## Examples

**Basic arbitrage simulation:**

```bash
python ${CLAUDE_SKILL_DIR}/scripts/flash_simulator.py arbitrage ETH USDC 100 \
  --dex-buy uniswap --dex-sell sushiswap
```

**Find cheapest provider:**

```bash
python ${CLAUDE_SKILL_DIR}/scripts/flash_simulator.py arbitrage ETH USDC 100 --compare-providers
```

**Liquidation opportunity scan:**

```bash
python ${CLAUDE_SKILL_DIR}/scripts/flash_simulator.py liquidation --protocol aave --health-factor 0.95
```

See [`references/examples.md`](references/examples.md) for multi-provider comparison and backtesting examples.

## Resources

- [`references/implementation.md`](references/implementation.md) - Provider comparison, strategy details, risk scoring, output modes
- [Aave V3 Flash Loans](https://docs.aave.com/developers/guides/flash-loans)
- dYdX Flash Loans
- Balancer Flash Loans
- [Flashbots Protect](https://docs.flashbots.net/flashbots-protect/overview)

© Jeremy Longshore · MIT · jeremylongshore/tons-of-skills-marketplace

Similar skills

All skills for Finance and business →

From the same set139

The whole set →
tracking-crypto-portfolio tracking-crypto-portfolio — a skill for Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI and OpenCode that monitors crypto holdings with live valuations, asset allocation analysis, and P&L tracking. CX Codex +1 1installs calculating-crypto-taxes calculating-crypto-taxes is a Claude Code skill that processes exchange CSVs, calculates crypto capital gains using FIFO, LIFO, or HIFO, and prepares Form 8949 data. CX Codex +1 1installs finding-arbitrage-opportunities finding-arbitrage-opportunities compares top bid and ask prices for a crypto pair across exchanges, applies taker fees, and searches triangular cycles. Useful for checking price gaps. CX Codex +1 1installs routing-dex-trades routing-dex-trades — a skill that pulls quotes from 1inch, Paraswap, and 0x to find swap routes with lower slippage and gas. Use it before trading to compare venues or split a large order. CX Codex +1 1installs speak-hello-world speak-hello-world — a skill for Claude Code, Codex, Cursor, and other platforms that sets up a language tutoring session via the Speak API with pronunciation scoring and real-time feedback. CX Codex +1 1installs speak-cost-tuning speak-cost-tuning — a skill that tunes costs for a Speak API integration. It monitors usage, picks a tier, and makes audio processing cheaper. CX Codex +1 1installs speak-reference-architecture speak-reference-architecture sets up a production architecture for Speak language learning apps, spanning the client, API gateway, and progress store. Useful when building a backend that integrates GPT-4o and Whisper. CX Codex +1 1installs speak-data-handling This skill sets up Speak data handling for student audio, assessment records, and learning progress with GDPR/COPPA considerations. CX Codex +1 1installs

Project sponsors

Companies that keep this analytics open