BullBearLib

BullBearLib is a collection of trading strategies and utilities for BullBear.zone, a Perpetual DEX on Neutron.

Repository Structure

• strategies/ - Trading strategy implementations
• runners/ - Shell scripts for running strategies continuously
• logs/ - Log output from strategy runs
• cache/ - Cached data and strategy state
• lib.js - Core trading functions for BullBear.zone
• consts.js - System constants

Available Strategies

Strategy	Description	Documentation
Funding Rate Arbitrage (FRA)	Captures funding rate differentials	FRA Docs
Momentum Breakout Follower (MBF)	Follows price breakouts with momentum	MBF Docs
Yield Harvester (YH)	Captures funding rate yield from extreme markets	YH Docs
Volatility Breakout Hunter (VBH)	Trades high volatility breakouts	VBH Docs
Funding Skew Reversal (FSR)	Trades assets with misaligned funding rates	FSR Docs

Getting Started

1. Install dependencies:

   npm install

2. Set up your environment variables:

   # Create .env file with your mnemonic seed
   echo "SEED=your mnemonic seed phrase here" > .env

3. Run a strategy:

   # Run the Funding Rate Arbitrage strategy
   ./runners/run-fra.sh

Strategy Execution

Each strategy can be run using its respective runner script:

# Run with default settings (30-minute interval)
./runners/run-fra.sh

# Run with custom interval (in seconds)
INTERVAL=900 ./runners/run-mbf.sh  # Run every 15 minutes

# You can also run from within the runners directory
cd runners
./run-fra.sh

Creating New Strategies

See strategies/README.md for information on creating and documenting new strategies.

License

This repository is provided for educational purposes only. Use at your own risk.

Acknowledgements

This library uses the BullBear.zone API as documented in bullBear.md.