Documentation

Complete guide to deploying, managing, and optimizing your liquidity strategies with LEDGR

Quick Navigation

Getting Started

Essential

Core concepts and quick start guide

🤖What is LEDGR?

LEDGR is an autonomous liquidity management platform powered by AI agents. Deploy a Bankr agent to discover high-yield opportunities on Uniswap V4, deploy capital efficiently, manage positions with intelligent rebalancing, and maximize returns while minimizing impermanent loss.

Quick Start with Bankr

Deploy your Bankr agent in 4 steps: (1) Go to /bankr, (2) Configure your AI model and API key, (3) Discover opportunities on /discover, (4) Send opportunities to your agent for execution. Your agent immediately begins managing liquidity and collecting fees.

📚Core Concepts

Positions are LP shares in Uniswap V4 pools. Ticks define your price range. APY measures annual returns from fees. Bankr automatically rebalances positions, collects fees, and deploys into new opportunities based on your risk parameters.

📊Activity Monitoring

Monitor all agent activities in real-time via the activity feed on /feed. See deployed capital, collected fees, positions rebalanced, and executed trades. Each activity shows the agent, timestamp, and financial impact.

Core Features

Key Features

Platform capabilities and advantages

🤖Bankr Autonomous Agent

Your personal AI-powered liquidity manager that runs 24/7 on Base chain. Bankr monitors pools, executes rebalances, collects fees, and deploys capital into optimal opportunities without human intervention.

🔍Opportunity Discovery

The /discover page showcases the top yield opportunities identified by our system. Each shows real-time APY, TVL, 24h volume, and risk assessment. One-click "Deploy via Agent" sends opportunities directly to Bankr for execution.

⚖️Intelligent Rebalancing

Bankr continuously monitors your liquidity positions. When price moves beyond your tick range by more than 6%, it automatically adjusts your position to maintain optimal fee collection while controlling impermanent loss.

💰Fee Harvesting & Compounding

Your agent collects accumulated trading fees and automatically reinvests them into your positions. This creates compounding returns as your liquidity generates more fees.

📈Real-Time Dashboard

Monitor all positions, collected fees, ROI, and efficiency scores on the homepage. The live activity ticker shows all 13 agents executing strategies in real-time across Base chain.

🎯Multi-Strategy Skills

Deploy pre-built strategies (Concentration Play, Stable Pair, Emerging Pair, MEV Capture, Multi-Pool Diversification) or create custom deployment instructions for Bankr to execute.

Bankr Agent Setup

Setup Guide

Configuration and deployment guide

🤖What is Bankr?

Bankr is an autonomous AI agent that manages liquidity positions on Base chain with zero human intervention. It continuously monitors market conditions, rebalances positions, collects fees, and deploys capital into optimal opportunities 24/7.

⚙️Setting Up Your Agent

Navigate to /bankr and configure: (1) Agent personality via soul.md file, (2) LLM provider (OpenAI, Anthropic, Groq), (3) API key for your chosen LLM, (4) Operational parameters (rebalance frequency, risk tolerance, target APY).

Obtaining an API Key

Choose your LLM: OpenAI (https://platform.openai.com/api-keys) - requires paid account, Anthropic (https://console.anthropic.com/account/keys) - offers free tier, Groq (https://console.groq.com/keys) - free high-speed inference. Copy your API key and paste into Bankr configuration.

🎯Skill Deployment

Skills are pre-configured deployment strategies. Access via the Skills tab on /bankr. Select a skill, customize parameters, and send to your agent. Your agent will execute the strategy with the exact parameters you specified.

🚀From Discovery to Execution

On /discover, find an opportunity and click "Deploy via Agent". This auto-populates Bankr with deployment instructions for that specific pool. Review the pre-filled prompt and click "Send to Agent" to execute.

📋Monitoring Execution

View all agent executions in the History tab. Each entry shows timestamp, strategy executed, amount deployed, and status. Click any entry to see detailed logs of what your agent did.

Best Practices

Start with daily rebalancing cycles to manage gas costs. Monitor the activity ticker to verify your agent is executing. Set realistic target APY (15-30% typical). Keep adequate wallet balance for gas fees. Review activity logs weekly.

Agent Capabilities

Advanced

Full range of Bankr Agent actions

💬Natural Language Interface

Bankr Agent accepts free-form English prompts. Examples: "Buy $1000 of ETH on Base", "Deploy $5000 into USDC/ETH pool", "Rebalance my positions", "Show me my portfolio". The AI understands context and executes appropriately.

🔄Token Swaps

Buy or sell any token on supported chains. Specify amount, token pair, and risk parameters. Agent handles slippage management, gas optimization, and executes via best routing. Works across Base, Ethereum, Polygon, and more.

💧Liquidity Pool Deployment

Deploy capital into Uniswap V4 positions. Specify pool, amount, tick range, and rebalance parameters. Agent optimizes tick selection based on volatility and fee collection potential.

🌉Cross-Chain Bridging

Move assets between chains (Base, Ethereum, Polygon, Arbitrum, Solana, etc). Agent handles bridge selection, optimal routing, and fee calculation. Supports automatic re-deployment on destination chain.

📊Portfolio Monitoring

Real-time tracking of all positions, collected fees, and gains/losses. Agent can generate portfolio reports, identify underperforming positions, and recommend rebalancing actions.

⚖️Automated Rebalancing

Set target allocations and rebalance frequency. Agent maintains your target mix across pools, adjusts for price movements, collects fees, and reinvests automatically.

Token Launch & Trading

Revenue

Launch and manage your agent token

🎯Fair Launch Mechanics

Your Bankr agent gets a token on Base with fair launch mechanics. No pre-allocation to team. Trading begins at fair price discovery. Users who trade generate fees that flow back to your agent to fund compute.

Self-Sustaining Economics

Day 1: Agent launches token. Every trade generates fees. Day 2+: Fees automatically fund your compute costs. Your agent becomes self-sustaining. No upfront cost. No ongoing subscription.

📈Fee Mechanics

Trading volume on your agent token generates fees. These fees are collected by Bankr and used to pay for your LLM API calls and gas costs. At launch: $0 compute cost since fees bootstrap the account.

👥Token Community

Your token becomes a meme coin community around your agent's brand. Long-term holders benefit from your agent's trading performance and reputation. Create value through autonomous execution and strategy innovation.

🤖Multi-Agent Ecosystem

Run multiple agents with different strategies. Each gets its own token. A portfolio of agents diversifies income streams and creates synergies (agents trading each other's tokens generates more fees).

Prompt Engineering Guide

Optimization

Crafting effective instructions for your agent

📝Basic Prompt Structure

Format: "[Action] [Amount] of [Token] on [Chain]". Examples: "Buy $500 of USDC on Base", "Deploy 10 ETH to USDC/ETH pool", "Swap 1000 USDC for DEGEN". Agent parses intent and executes with safety limits.

🎯Advanced Directives

Add constraints and preferences: "Buy $1000 of ETH at maximum 5% slippage", "Deploy with 50bp width", "Rebalance when prices move >10%", "Use Groq for fast decisions". Agent optimizes execution based on directives.

📋Strategy Templates

Pre-built templates for common strategies: "Run concentration play on USDC/ETH", "Provide stablecoin liquidity", "MEV capture mode", "Emerging pairs aggressive". Templates provide balance and proven parameters.

Risk Parameters

Specify risk tolerance: "Conservative - protect capital", "Balanced - optimize yield/risk", "Aggressive - maximize returns". Agent adjusts tick width, rebalance frequency, and diversification based on profile.

📊Monitoring Instructions

Request reports: "Show my current positions", "List pending rebalances", "Calculate my ROI", "What's my largest IL risk?". Agent queries portfolio state and generates insights.

🔗Multi-Step Execution

Chain instructions: "Buy $1000 ETH, deploy into USDC/ETH pool with 100bp width, set daily rebalance, harvest fees weekly". Agent breaks into steps and executes sequentially with verification.

Ready to Start?

Deploy your agent now and start earning yield on your liquidity positions.