CLI

LP Agent CLI

lpagent 是 LP Agent 的命令行工具。用户和 AI Agent 可以用它在终端脚本里发现池子、查看仓位，以及执行 zap-in/zap-out 交易流程。

可以作为独立 CLI 使用
在编程 Agent 环境里也很好用
JSON 输出方便自动化，表格输出方便人看

CLI 仓库

LP Agent CLI 的源代码、版本发布和 issue 跟踪。

安装

一键安装脚本

curl -fsSL https://raw.githubusercontent.com/lpagent/cli/main/install.sh | bash

其他安装方式

# Go install
go install github.com/lpagent/cli/cmd/lpagent@latest

# Build from source
git clone https://github.com/lpagent/cli.git && cd cli
make build
./bin/lpagent --help

初始设置

lpagent auth set-key
lpagent auth set-default-owner <wallet-address>

然后验证能否正常访问：

lpagent positions open -o table --native

核心命令组

仓位

lpagent positions open --owner <addr>
lpagent positions historical --owner <addr> --from 2025-01-01
lpagent positions overview -o table --native
lpagent positions logs --position <id>
lpagent positions get --position <id>
lpagent positions revenue <addr>

池子

lpagent pools discover --chain SOL --sort-by tvl
lpagent pools discover --chain SOL --sort-by fee_tvl_ratio --fee-tvl-interval 1h
lpagent pools info <poolId>
lpagent pools positions <poolId> --status Open
lpagent pools onchain-stats <poolId>
lpagent pools top-lpers <poolId>

Zap-In / Zap-Out 交易流程

# Zap-In
lpagent pools add-tx <poolId> --owner <addr> --strategy Spot --input-sol 1
lpagent pools landing-add-tx --file signed-tx.json

# Zap-Out
lpagent tx zap-out-estimates --position-id <id> --bps 10000
lpagent tx decrease-tx --position-id <id> --bps 10000 --owner <addr> --slippage-bps 500
lpagent tx landing-decrease-tx --file signed-tx.json

tx zap-out-estimates 会在你执行 decrease-tx 之前，显示每种输出方式（allToken0、allToken1、both、allBaseToken）实际能拿到多少。需要 CLI v0.4.0 或更高版本，新版本里 tx decrease-quotes 保留为它的别名。旧版本调用的是已经移除的 /position/decrease-quotes 接口，会失败，所以请运行 lpagent upgrade 升级。

代币和原始 API 访问

lpagent token balance --owner <addr>

lpagent api get /lp-positions/open --query "owner=<addr>"
lpagent api post /position/zap-out-estimates --data '{"position_id":"...","bps":5000}'

输出模式

所有命令都支持：

json（默认）
table
quiet

用法：

lpagent positions open -o json
lpagent positions open -o table --native

配置

配置文件路径：

~/.lpagent/config.json

覆盖来源：

变量	Flag	说明
`LPAGENT_API_KEY`	`--api-key`	API key
`LPAGENT_API_URL`	-	API 基础 URL
`LPAGENT_DEFAULT_OWNER`	`--owner`	默认钱包地址

优先级顺序：

CLI flag
环境变量
配置文件

AI Agent 使用模式

把 lpagent 集成到 AI 工作流时：

优先用 -o json，方便机器解析
钱包签名要限制在可信的运行环境内
执行命令之前，先跑一步只读查询（positions open、pools info）
用“生成交易 + landing 命令”成对执行，更可靠

AI

LP Agent MCP

LP Agent CLI

CLI 仓库

安装

一键安装脚本

其他安装方式

初始设置

核心命令组

仓位

池子

Zap-In / Zap-Out 交易流程

代币和原始 API 访问

输出模式

配置

AI Agent 使用模式

相关文档