pumpdata

pumpdata 示例

通过 Agent 或脚本调用 pumpdata.fun：自 pump.fun 创立之日起，所有 pump.fun 交易数据，涵盖 bonding curve 和 PumpSwap；数据直接从链上账本读取，已归零的代币也会保留；通过 Solana 上的 x402 以 USDC 付款。无需密钥，无需账户。

调用	查询内容	价格
GET /baserate?band=15k-28k&from=<iso>&to=<iso>&venue=any	在指定时间段内，首次在某个市值区间交易的代币数量，以及在 3 h 内达到 2x、5x、10x、20x 的代币数量	$0.005
POST /wallets {"addresses": [...], "mint": "<optional>"}	最多 50 个钱包的情况：赢家、机器人、供应卖家、新钱包，以及其背后的 SOL	$0.01
GET /launch/{mint}	部署者的记录、创建时的捆绑交易、内部人士持有比例，以及外观相似的发行在 24 h 内的表现	$0.005
POST /replay {"picks": [{"mint", "at", "size_sol"}, ...]}	最多 500 笔交易选择，结合链上历史数据回放，计入手续费和成交情况（排队任务；轮询 GET /replay/{id}）	$2

免费，无需付款：昨日所有区间的基准率，见 /public/baserate.json，每小时更新。

接口规范：/openapi.json。Agent 文档：/llms.txt。技能：/skill.md。

如何支付调用费用

1. 不带付款信息调用。响应为 402，正文和 PAYMENT-REQUIRED 标头中都会提供报价：价格、收款方、网络（Solana 主网上的 USDC），以及包含输入项的 Bazaar 声明。
2. 使用你的钱包为相应金额签署 USDC 转账（支付服务商会支付网络费用；你无需持有 SOL）。
3. 在 PAYMENT-SIGNATURE 中携带已签名的付款信息再次调用。响应会返回数据，并在 PAYMENT-RESPONSE 中附上收据。

x402 客户端库会代你完成第 2 和第 3 步。每个响应都带有 X-Data-As-Of（数据对应的构建版本）和 X-Data-From（数据起始时间）。没有数据的时间段会返回 404，且不收费。

示例

• curl.sh：查看 402 响应和免费文件，无需钱包。
• node.mjs：使用 @x402/fetch 和 Solana 密钥对进行付费调用。
• python.py：通过 Python 查看 402 响应和免费文件；使用 x402 软件包进行付费重试。
• mcp.md：将相同调用作为 MCP 工具使用（Claude Code、Cursor、Cline、Claude Desktop）。

在冲之前先查看基准率：Agent 配方

以四种形式进行付费 GET /baserate（$0.005）调用，每种形式 17–21 行。付款密钥来自 PUMPDATA_PAYER_KEY （base58 格式，或 solana-keygen JSON 数组）。钱包需要有 USDC，无需 SOL。切勿提交密钥。

文件	内容	运行
x402-fetch.ts	使用官方客户端进行普通 fetch：@x402/fetch + @x402/svm	npm run fetch
elizaos-action.ts	ElizaOS（@elizaos/core 1.x）：含 PUMPDATA_BASE_RATE action 的 pumpdata 插件	npm run eliza
solana-agent-kit-tool.ts	solana-agent-kit v2：插件中的 Action，通过 executeAction 运行	npm run agent-kit
vercel-ai-tool.ts	Vercel AI SDK（ai v7）：用于 generateText / streamText 的 tool()	npm run ai-sdk

npm install
export PUMPDATA_PAYER_KEY='<secret key>'
npm run fetch        # yesterday's (UTC) $15-28K base rate, any venue
npm run typecheck

三个框架文件都会复用 x402-fetch.ts 中的 baseRate()。单独运行时，它们会像框架本身那样直接调用 action 或工具，因此无需模型或 Agent 即可试用。

与 pump.fun 无关联。