用途:通过 Uniswap LP REST API 在前后端与机器人中集成流动性提供(LP)。该 API 是交易构建服务:你发送仓位参数,API 读取实时池状态、计算另一代币数量并返回完整未签名交易,由你的应用签名并广播。API 不持有密钥、不转移资金、不广播。
主要能力:支持 V2、V3、V4。端点包括 /lp/check_approval(检查/授权代币批准)、/lp/create(V3/V4 集中流动性)、/lp/create_classic(V2 全范围)、/lp/increase、/lp/decrease、/lp/claim_fees(V3/V4,V2 不可单独领取)、/lp/pool_info(读取池状态)。API 负责池状态获取、依赖金额计算、交易创建、tick 对齐与可选 gas 估算;你的应用负责签名、广播、EIP-712 permit 签名与错误处理。
使用方式:基础地址 LP_API_BASE_URL = https://liquidity.api.uniswap.org,所有 LP 端点为 /lp/ 前缀下的 POST 请求。写/授权端点需 x-api-key 头,密钥从环境变量加载,不可硬编码。建议先调用 /lp/check_approval,再执行相应操作。地址须匹配 ^0x[a-fA-F0-9]{40}$,金额为非负整数最小单位字符串,liquidityPercentageToDecrease 为 1-100 整数。执行任何消耗 gas 或转移代币的交易前必须向用户确认。
适用场景:需要将 Uniswap 流动性提供集成到前端、后端或自动化机器人的开发者。
限制:需先熟悉 viem 基础;V2 手续费不可单独领取;claim_fees 使用 tokenId,increase/decrease 使用 nftTokenId,check_approval 使用 v3NftTokenId;权限池可能返回 KYC 警告。具体支持链列表、费率与价格等资料未完整提供。