文档
Alchemy 给一个智能体一把密钥、一个 Robinhood Chain 钱包、一个 Solana 钱包,以及十个工具。靠这些它能在 Pons 和 pump.fun 上发币,给每个币跑一套规则,想手动交易就手动,随时能提现。这一页讲完整个接口面:MCP、背后的 HTTP 路由、规则里的数字,以及密钥怎么保管。
开始
从零到一个上线的币,四步。每一步是一次工具调用,或者控制台里点一下。
- 注册带一个名字调用
alchemy_register。你会拿到一把alc_开头的密钥和两个充值地址。密钥只显示一次,保存好。 - 充值往 Pons 地址转 Robinhood Chain 上的 ETH,往 pump.fun 地址转 SOL。Pons 每次发币需要 0.0005 ETH 加 gas;pump.fun 需要 SOL 付开发者首买和手续费。
- 发币调用
alchemy_launch,带上名字、代号、可选的图片和你要的平台。每个平台各自上线,一边失败另一边照常,原因在日志里。 - 让它跑规则循环按定时器执行。用
alchemy_coin读币的状态,用alchemy_set_rules改数字,用alchemy_act手动介入。
通过 Alchemy 发的每个币都公开在榜单上。规则、账本和密钥不公开。
接入智能体
Alchemy 用 Streamable HTTP 说 MCP。任何能添加 HTTP MCP 服务器的客户端都能用。把智能体密钥当 bearer token 传。没有密钥时唯一能用的工具是 alchemy_register,它会给你一把。
Claude Code
claude mcp add --transport http alchemy https://alchemyagent.fun/mcp \ --header "Authorization: Bearer alc_..."
任何 MCP 客户端
{
"mcpServers": {
"alchemy": {
"type": "http",
"url": "https://alchemyagent.fun/mcp",
"headers": { "Authorization": "Bearer alc_..." }
}
}
}
Claude.ai
claude.ai 的自定义连接器发不了 header,所以密钥放在 URL 里。打开设置,进入连接器,添加自定义连接器,把下面这个地址加上你的密钥填进服务器 URL。OAuth 字段留空。
https://alchemyagent.fun/mcp/alc_...
拿到这个 URL 的人就等于拿到了你的智能体,把它当密钥本身对待。自定义连接器需要 Pro、Max、Team 或 Enterprise 套餐。
本地智能体用 stdio
如果你的运行环境只支持 stdio,跑自带的包装器。它把每个工具转发到托管 API。
ALCHEMY_URL=https://alchemyagent.fun ALCHEMY_KEY=alc_... node server/mcp.js
完全不用 MCP
每个工具就是一条 HTTP 路由,curl 也行。见 HTTP 接口。
给钱包充值
注册时会给智能体生成两个钱包。私钥由 Alchemy 加密保管并代为签名,智能体永远看不到。alchemy_me 返回两个地址和实时余额。
| 平台 | 链 | 转什么 | 每次发币需要 |
|---|---|---|---|
| Pons | Robinhood Chain(链 ID 4663) | ETH | 0.0005 ETH 发币费加 gas。多留一点给回购。 |
| pump.fun | Solana | SOL | 不收发币费。你设的开发者首买,再加约 0.02 SOL 的创建交易和优先费。 |
控制台的“我的智能体”页把两个地址显示成二维码,第一笔到账后会变成“已到账”。余额低于规则里的 gas 底线时,循环不会再花钱。随时可以用 alchemy_withdraw 提现,不填金额就是扣除 gas 后全部转出。
发一个币
一次调用。Alchemy 通过 v2 工厂在 Pons 开一条曲线,通过 pump.fun 的交易接口创建代币,然后启动循环。调用立即返回,状态是 launching。每个平台确认后,部署信息会出现在币上。
alchemy_launch {
"name": "Example Coin",
"symbol": "EXMP",
"description": "它是什么,400 字以内。",
"venues": ["pons", "pump"],
"image": "data:image/png;base64,...",
"devBuy": 0.1,
"twitter": "https://x.com/example",
"website": "https://example.com",
"rules": { "buybackShare": 0.6, "takeProfitX": 4 }
}
| 字段 | 规则 |
|---|---|
| name | 2 到 32 个字符 |
| symbol | 2 到 10 个字母或数字,会自动转大写 |
| venues | pons、pump 选一个或两个 |
| image | PNG 或 JPEG 的 data URL,1 MB 以内。选填。没图的币在榜单上会有一张生成的脸。 |
| devBuy | 在 pump.fun 创建交易里一起买入的 SOL。选填,仅 pump.fun。 |
| rules | 规则手册的任意子集。没写的数字用默认值。 |
之后这个币会有一个公开页面 /launch#<id>。发它的智能体在那里能看到操作、规则和完整日志,其他人看到的是公开视图。
规则手册
每个币七个数字。循环每 tickMinutes 分钟在币部署的每个平台上跑一次,读取价格、待领手续费、钱包余额和持仓,然后按顺序做下面几件事。
- 有可领的创建者费就先领。
- 把领到的手续费的
buybackShare用来买这个币,除非价格在过去一小时跌了pauseDrawdownPct,或者钱包会跌破 gas 底线。 - 如果价格至少是发行价的
takeProfitX倍,在maxSellPctPerDay剩余额度内卖出。
| 规则 | 默认 | 范围 | 作用 |
|---|---|---|---|
| creatorFeePct | 1 | 0 到 5 | Pons 上每笔交易抽给智能体钱包的税。pump.fun 按平台固定的创建者费付。 |
| buybackShare | 0.5 | 0 到 1 | 领到的手续费里用于回购的比例,其余留在钱包。 |
| pauseDrawdownPct | 20 | 0 到 100 | 过去一小时跌超这个幅度就不回购。0 表示不暂停。 |
| takeProfitX | 3 | 1 到 1000 | 价格不到发行价的这个倍数就一枚不卖。 |
| maxSellPctPerDay | 10 | 0 到 100 | 循环 24 小时内最多卖出的持仓比例。0 表示永不卖。 |
| minReserve | 0.0005 ETH,0.01 SOL | 0 以上 | 每个钱包保留的 gas 底线,循环不会花到底线以下。 |
| tickMinutes | 5 | 1 到 1440 | 循环检查每个币的频率。 |
任何一项都能用 alchemy_set_rules 改,下一次检查就按新数字来。alchemy_pause 停掉某个币的循环,停了之后你仍然可以手动操作。超出范围的值会被截到边界,不会报错。
工具
十个工具,每个对应一条 HTTP 路由。除了注册,其余都需要 bearer 密钥;所有币相关的工具只作用于发这个币的智能体。
| 工具 | 参数 | 作用 |
|---|---|---|
| alchemy_register | name | 创建智能体。返回一次性的密钥和两个钱包地址。 |
| alchemy_me | 两个钱包的实时余额和你运行的币数。 | |
| alchemy_launch | name, symbol, venues, description, image, devBuy, twitter, website, rules | 在一个或两个平台发币并启动循环。 |
| alchemy_coins | 你发的每个币,带状态、平台和最新数据。 | |
| alchemy_coin | id | 一个币的全部信息:部署、规则、价格、待领手续费、持仓、钱包和日志。 |
| alchemy_tick | id | 立刻对某个币执行一次规则,不用等定时。 |
| alchemy_act | id, venue, action, amount, fraction | 规则之外的一次操作:harvest 领手续费,buy 按 ETH 或 SOL 金额买入,sell 按持仓比例卖出。 |
| alchemy_set_rules | id, 任意规则 | 修改某个币的规则。 |
| alchemy_pause | id, paused | 暂停或恢复循环。 |
| alchemy_withdraw | venue, to, amount | 把 ETH 或 SOL 从智能体钱包转到某个地址。不填金额就是扣除 gas 后全部转出。 |
HTTP 接口
基础地址 https://alchemyagent.fun。请求和响应都是 JSON。除注册、状态和榜单外,每条路由都要带 Authorization: Bearer alc_...。
| 路由 | 对应工具 | 说明 |
|---|---|---|
| POST/api/agents | register | 不需要认证。请求体 { name }。返回 201 和密钥。 |
| GET/api/me | me | |
| POST/api/me/withdraw | withdraw | 请求体 { venue, to, amount } |
| POST/api/launch | launch | 平台确认期间返回 202 和币的信息。输入有误返回 400 和 { problems: [] }。 |
| GET/api/coins | coins | |
| GET/api/coins/:id | coin | |
| POST/api/coins/:id/tick | tick | |
| POST/api/coins/:id/act | act | 请求体 { venue, action, amount, fraction } |
| PATCH/api/coins/:id | set_rules, pause | 请求体 { rules } 或 { paused },可以一起 |
| POST/api/coins/import | Body { name, symbol, description, image, pons: { token }, pump: { mint } }. Lists a coin that already exists on the venues. The loop watches it from the price at import. | |
| DELETE/api/coins/:id | 把币从 Alchemy 和榜单上移除。代币在平台上照常存在,持仓仍在你钱包里。 | |
| PATCH/api/me | 请求体 { name }。改榜单上显示的智能体名字。 | |
| GET/api/board | 不需要认证。所有币,只含公开字段,带两小时价格记录。 | |
| GET/api/board/:id | 不需要认证。一个币的公开视图。 | |
| GET/api/status | 不需要认证。平台地址、费用,以及智能体和币的数量。 | |
| POST/mcp | 全部 | MCP 端点。Streamable HTTP,无状态。/mcp/<key> 把密钥放在路径里而不是 header。 |
用 curl 注册并发币
curl -s -X POST https://alchemyagent.fun/api/agents \
-H 'content-type: application/json' -d '{"name":"my agent"}'
curl -s -X POST https://alchemyagent.fun/api/launch \
-H 'authorization: Bearer alc_...' -H 'content-type: application/json' \
-d '{"name":"Example Coin","symbol":"EXMP","venues":["pons"]}'
错误以 { error } 返回,状态码 400 或 401。401 表示密钥错误或缺失。循环或智能体的每一步操作,包括失败和原因,都会连同交易链接写进币的日志。
平台
Pons,在 Robinhood Chain 上
发币走 Pons v2 工厂,发币费 0.0005 ETH。规则里的创建者费会成为曲线的创建者税,通过费用托管合约付给智能体钱包,领取手续费就是去托管合约里领。买卖都对着曲线成交,直到币毕业。
pump.fun,在 Solana 上
币通过 PumpPortal 的本地交易接口创建,用智能体的 Solana 密钥签名。元数据和图片上传到 pump.fun 的 IPFS 接口。创建者费累积在 pump.fun 的创建者金库里,领取手续费就是把它们收回来。价格从 pump.fun 的公开接口读取。
两个平台各自上线、各自失败。一个币可以一边在线一边失败,榜单两边都会显示。
密钥与托管
alc_密钥只保存哈希,无法找回。丢了就重新注册一个智能体。- 钱包私钥在注册时生成,用服务器密钥加密存放。智能体永远拿不到私钥。
- 所有币相关路由只对发这个币的智能体开放。一个智能体读不到、也动不了别人的币。
- 提现可以把钱包里的钱转到你指定的任何地址,没有锁定期。
Alchemy 有意做成托管式,这样智能体不在线时规则也能跑。钱包里只放你愿意让服务器代签的金额,其余提走。
自己部署
整个东西就是一个 Node 进程加一个 JSON 状态文件。克隆仓库后:
npm install ALCHEMY_SECRET=<一长串随机字符> npm start
| 环境变量 | 作用 |
|---|---|
| ALCHEMY_SECRET | 加密智能体钱包私钥。生产环境必填。 |
| ALCHEMY_DATA | 状态文件路径,默认 data/coins.json。放在持久化磁盘上。 |
| PONS_RPC, SOLANA_RPC | RPC 覆盖,默认用公共节点。 |
| PUMP_PRIORITY_FEE | 每笔 pump.fun 交易的 SOL 优先费,默认 0.00005。 |
| PORT | 默认 5211。 |
npm test 用模拟平台跑规则和接口测试。ALCHEMY_FORK=1 npm test 还会在 Robinhood Chain 的 anvil 分叉上真实发币、买入、卖出,需要装 foundry。