| name | beam |
| version | 0.0.31 |
| description | Operate Beam, an autonomous Solana DLMM liquidity agent for Meteora pools. Use when the user asks about "beam", "DLMM", "liquidity agent", "Meteora pools", "rebalance positions", "paper trade Solana", or "start the trading agent".
|
| license | MIT |
| author | irfndi |
| homepage | https://github.com/irfndi/beam-clmm |
| tags | ["evm","defi","liquidity","uniswap-v3","uniswap-v4","trading-agent"] |
| compatibility | Requires Bun 1.4+, the `beam` CLI, and a Helius RPC key. |
| metadata | {"chain":"robinhood-chain (evm)","protocol":"uniswap-v3, uniswap-v4","openclaw":{"requires":{"bins":"[Truncated]"},"os":["darwin","linux"],"capabilities":["mcp","http"]},"hermes":{"tags":["evm","defi","liquidity","trading"],"category":"defi","requires_toolsets":["terminal"],"blueprint":{"schedule":"0 * * * *","deliver":"origin","prompt":"Check Beam status and alert the user to any important positions, decisions, or risks. Use `beam status --message` and summarize in 3-5 bullets.","no_agent":false}}} |
Beam Liquidity Agent
Beam is an autonomous liquidity agent for Solana Meteora DLMM pools. It runs
locally, makes deterministic rebalancing decisions, and can optionally ask a
local agent runtime (Hermes via ACP or OpenClaw via Gateway) for a second opinion
when running as an agent skill.
When to use
- User asks about liquidity pool management on Solana.
- User wants to check pool health or position performance.
- User needs to rebalance concentrated liquidity positions.
- User mentions Meteora DLMM, fee-IL ratio, volume authenticity, or bin arrays.
- User wants to start, stop, configure, or monitor the Beam trading agent.
Quick start
bun install
beam setup --non-interactive --rpc-url=$ROBINHOOD_RPC_URL
beam dev
export WALLET_PRIVATE_KEY=...
beam dev
Common commands
| Command | Purpose |
|---|
beam status --json | JSON snapshot for agents/skills |
beam status --message | Markdown summary for messaging apps |
beam dev | Start the trading agent |
beam backtest --days 7 | Run historical simulation |
beam backtest --source replay --days 7 --pools <addr> | Replay on-chain snapshots |
beam wallet show | Show wallet balance |
beam whoami | Show account info |
Decision flow
For each pool on each scan cycle:
- Fetch pool state and bin array from Meteora via Helius RPC.
- Compute metrics: fee/IL ratio, volume authenticity, bin utilization, TVL velocity.
- Apply decision rules in order:
- EXIT — TVL drop, stop-loss, trailing-stop, high volatility, low volume auth.
- REBALANCE — drift > 60%, OOR grace expired, net benefit positive.
- HOLD — existing position with healthy fee/IL ratio.
