PumpView — Solana Trading & Live Data

PumpView Agent Kit

为 AI Agent 提供 Solana 交易和实时交易数据。 构建 swap，在本地签名， 通过 PumpView 提交，并从确认后开始读取执行回执。

交易 API · 控制面板 · 快速入门 · OpenAPI

已列入官方 MCP 注册表， 名称为 fun.pumpview/trading。托管服务使用已验证的 pumpview.fun 域名命名空间。 也可在 Glama MCP 目录中找到。

连接 Agent

从此仓库安装技能：

npx skills add grinchdev/pumpview-agent-kits --skill pumpview-trading

或者，在支持自定义标头的客户端中配置远程 MCP 连接：

URL: https://api.pumpview.fun/mcp/
Transport: Streamable HTTP
Authorization: Bearer <PUMPVIEW_API_KEY>

标头配置语法取决于客户端。PumpView 使用 API 密钥， 而非 OAuth。请将真实密钥保存在客户端的密钥存储区中。初始化、 工具发现和交易配置均为公开操作；账户操作需要使用你的密钥。 安装技能不会创建账户或授权支出。

无需密钥即可尝试公开发现（Node 18+）：

node examples/mcp-discovery.mjs

获取访问权限

已有 PumpView 账户： 登录控制面板，关联你的签名钱包， 然后创建 API 密钥。

由 Agent 持有的钱包： 请求 /v1/agent/challenge，在本地对其确切消息签名， 然后在 /v1/agent/access 处提交签名以换取密钥。无需通过浏览器注册即可创建密钥。请参阅 钱包接入参考。 切勿向 PumpView 发送私钥或助记词。

来源归因

密钥创建时会记录可选的 acquisition_source，以便 PumpView 按获取渠道统计 请求和已确认交易量。通过 npx skills 安装时使用 skills_sh；通过 ClawHub 安装时使用 clawhub；直接使用 GitHub 的用户 可以使用 github。来源未知的套件安装使用 agent_kit。Python 客户端的 complete_wallet_access(..., acquisition_source="skills_sh") 接受此标签。 此来源归因为客户端自行声明，并非推荐验证。请勿发送原始来源 URL 或机密信息。 它不会改变费用、限额或权限。

通过 MCP 购买实时数据访问权限

依次使用 list_data_plans → get_payment_instructions → prepare_invoice_payment。 检查发票和未签名的付款，然后使用你的本地钱包签名并广播。使用该交易签名调用 confirm_invoice_payment，直到交易最终确认，然后读取 get_access_status。 get_invoice_status 可找回已有发票。确认待处理期间，切勿重复付款。 交易本身无需数据套餐。无需使用 Coinbase 服务。

Python 客户端

Python 3.10+；客户端没有运行时依赖。从本地克隆安装：

git clone https://github.com/grinchdev/pumpview-agent-kits.git
cd pumpview-agent-kits
python -m pip install -e .

通过环境或密钥管理器加载 PUMPVIEW_API_KEY，然后构建一笔未经签名的 0.06 SOL → USDC 兑换，滑点为 1%：

python examples/build_swap.py --wallet YOUR_LINKED_PUBLIC_KEY --output USDC --amount 60000000 --slippage-bps 100 --state state/intent-001.json

示例会在联系 PumpView 之前保存请求 ID。发生构建超时后，使用相同的文件和参数运行，即可恢复。它只构建并模拟；绝不会签名或提交。美元最低金额检查使用当前价格，因此在启动新的意图前，可能需要调整此示例中的金额。

客户端还提供 wallet_challenge、complete_wallet_access、trading_config、swap_status、trading_usage、recent_trades 和 submit_swap。**submit_swap 会广播交易并可能花费资金。**仅提供经过用户授权的本地钱包审核并签名的字节。

import os
from pumpview_agent_kit import PumpView

client = PumpView(os.environ["PUMPVIEW_API_KEY"])
policy = client.trading_config()
volume = client.trading_usage()
# Recover a known submission without creating or sending another trade:
# receipt = client.swap_status(saved_swap_id)

对于 TypeScript，examples/build_swap.mts 可直接在 Node 22.18+ 上运行。提供 PUMPVIEW_API_KEY、PUMPVIEW_WALLET、PUMPVIEW_OUTPUT、PUMPVIEW_AMOUNT、PUMPVIEW_SLIPPAGE_BPS 和先前已保存的 PUMPVIEW_REQUEST_ID；PUMPVIEW_INPUT 默认为 SOL。运行 node examples/build_swap.mts。此示例同样只构建并模拟。

交易工作流

1. 读取 /v1/swaps/config，了解可用性、支持的交易对和当前成本。
2. 保存唯一的请求 ID 和精确意图。通过 REST 或 MCP 构建。
3. 根据获准的意图审核返回的带版本消息、最低输出、费用和小费；使用自己的钱包适配器对精确消息签名。
4. 安全保存构建 ID 和已签名字节。提交已签名的交易。
5. 轮询同一交换 ID。submitted 响应不代表已执行。回执从 confirmed 开始；需要 finalized 结算时，请继续轮询。

SDK 刻意不提供自动请求重试或钱包签名器。 构建超时后，重复使用请求 ID；提交超时后，查询同一交换 ID。不要自动更改区块哈希或创建替代请求。 收到 429 时遵守 Retry-After。完整的 集成参考介绍了身份验证、恢复和原子单位。

成本和支持的交易对

• Trading API 访问不收取订阅费。已执行的兑换收取 0.5% 平台费，另加小费和网络成本。最低小费：0.002 SOL。
• 至少一端必须是 SOL、WSOL 或原生 Solana USDC。不支持其他 TOKEN–TOKEN 兑换，也不支持仅进行 SOL–WSOL 包装的请求。路由使用 Jupiter；可用性取决于代币和当前资金池。
• SOL 指原生 SOL，支持包装／解包；WSOL 指 SPL 代币余额。ExactIn 金额是以原子单位表示的整数字符串；滑点需明确指定。
• 最低兑换金额：等值 5 美元（Unlimited 除外）。Unlimited 不设此最低金额。所有交易仍需有足够的 SOL 支付成本和适用的租金。
• PumpView 通过其交易落地基础设施，同时向 4 个验证者发送交易，并提供 MEV 保护。PumpView 报告称，在当前区块中的实测纳入时间低于 100 ms；这是其自身基准测试，并非已确认／最终结算时间的 SLA。
• 已认证的 HTTP 和 MCP 调用共用每个账户每秒 3 / 5 / 20 次请求的限制，分别适用于 Free 或 Day Pass / Starter / Unlimited。多个密钥不会提高限额。

实时数据与交易量

交易与实时数据访问彼此独立。数据需要有效套餐； 当前套餐为准。无限套餐目前的价格为 49 USDC，有效期 30 天。所有套餐均共享每个账户一个 WSS 连接。直接通过 USDC 发票付款无需 Coinbase。

get_recent_trades 返回已接受的交换摘要；get_stream_connection 用于说明 wss://api.pumpview.fun/v1/stream。你的 Agent 运行时负责维护套接字和重放游标。数据流保留了 PumpView 的可疑价格过滤和解码器覆盖范围；它并不包含 Solana 上的每笔单独交换或存档历史记录。

get_trading_usage / /v1/swaps/usage 返回账户和每个密钥已执行的交易量。已确认的交换只计一次；最终确认和重复轮询不会增加交易量。美元总额使用构建时的价格估算；未定价的交换仍会显示。

开发

python -m unittest discover -s tests

server.json 描述了面向官方 Registry 的托管 MCP。发布清单不会部署新服务。托管服务保留自身的访问控制和费用。本仓库包含客户端代码、示例和 Agent 指令，采用 MIT 许可证；其中不包含后端凭据或签名密钥。