meridian  by yunus-0x

Autonomous DeFi liquidity management agent for Solana

Created 3 weeks ago

New!

276 stars

Top 93.7% on SourcePulse

GitHubView on GitHub
Project Summary

Summary

Meridian is an autonomous LLM-powered agent for managing liquidity in Solana's Meteora DLMM pools. It automates screening, deployment, and active position management based on live data and performance learning, targeting DeFi users seeking optimized yield and automated LP operations.

How It Works

The system uses a ReAct agent loop where an LLM reasons over live data and executes actions. Two specialized agents run on cron schedules: a Screening Agent (30 min) identifies and deploys into high-quality pools using configurable thresholds (fee/TVL, organic score, mcap, etc.). A Management Agent (10 min) monitors open positions, claims fees, and autonomously decides to hold, close, or redeploy based on PnL and range data. Meridian learns by studying top LPers and evolving its screening parameters, utilizing data from Meteora SDK, PnL API, OKX OnchainOS, and Jupiter API. LLMs are swappable via OpenRouter.

Quick Start & Requirements

  • Requirements: Node.js 18+, OpenRouter API key, Solana wallet (base58 private key), Solana RPC endpoint (Helius recommended), optional Telegram bot token and Claude Code CLI.
  • Installation: Clone repo, cd meridian, npm install.
  • Setup: Run npm run setup for a wizard configuring .env (API keys, wallet, RPC) and user-config.json (risk, thresholds, models). Manual .env setup is supported.
  • Execution: Use npm run dev for dry runs or npm start for live autonomous trading.
  • Documentation: README is the primary source.

Highlighted Details

  • Autonomous LLM-driven screening and management of Meteora DLMM liquidity.
  • Performance-based learning: analyzes top LPers, saves lessons, and evolves screening thresholds.
  • Integrated Discord listener for token calls and Telegram chat/notifications.
  • Direct terminal interaction via Claude Code CLI with specialized AI agents.
  • Optional "Hive Mind" for collective intelligence sharing.

Maintenance & Community

The project features a Discord listener for signal aggregation and Telegram integration for chat/notifications. A private Telegram discussion exists for Hive Mind registration. Public community links and contributor/sponsorship details are not explicitly provided.

Licensing & Compatibility

The repository's license is not specified. Compatibility is focused on Solana. Commercial use implications are undetermined.

Limitations & Caveats

Provided "as-is" without warranty. Autonomous trading carries significant financial risk; users can incur losses. Strongly recommended to start with DRY_RUN=true before live deployment. Never deploy capital that cannot be afforded to lose.

Health Check
Last Commit

2 days ago

Responsiveness

Inactive

Pull Requests (30d)
23
Issues (30d)
2
Star History
277 stars in the last 27 days

Explore Similar Projects

Starred by Elie Bursztein Elie Bursztein(Cybersecurity Lead at Google DeepMind), Chip Huyen Chip Huyen(Author of "AI Engineering", "Designing Machine Learning Systems"), and
7 more.

SuperAGI by TransformerOptimus

0.1%
17k
Open-source framework for autonomous AI agent development
Created 2 years ago
Updated 1 year ago
Starred by Lilian Weng Lilian Weng(Cofounder of Thinking Machines Lab), Chip Huyen Chip Huyen(Author of "AI Engineering", "Designing Machine Learning Systems"), and
59 more.

AutoGPT by Significant-Gravitas

0.1%
183k
AI agent platform for building, deploying, and running autonomous workflows
Created 3 years ago
Updated 23 hours ago
Feedback? Help us improve.