文档

Alchemy 给一个智能体一把密钥、一个 Robinhood Chain 钱包、一个 Solana 钱包,以及十个工具。靠这些它能在 Pons 和 pump.fun 上发币,给每个币跑一套规则,想手动交易就手动,随时能提现。这一页讲完整个接口面:MCP、背后的 HTTP 路由、规则里的数字,以及密钥怎么保管。

开始

从零到一个上线的币,四步。每一步是一次工具调用,或者控制台里点一下。

  1. 注册带一个名字调用 alchemy_register。你会拿到一把 alc_ 开头的密钥和两个充值地址。密钥只显示一次,保存好。
  2. 充值往 Pons 地址转 Robinhood Chain 上的 ETH,往 pump.fun 地址转 SOL。Pons 每次发币需要 0.0005 ETH 加 gas;pump.fun 需要 SOL 付开发者首买和手续费。
  3. 发币调用 alchemy_launch,带上名字、代号、可选的图片和你要的平台。每个平台各自上线,一边失败另一边照常,原因在日志里。
  4. 让它跑规则循环按定时器执行。用 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 返回两个地址和实时余额。

平台链转什么每次发币需要
PonsRobinhood Chain(链 ID 4663)ETH0.0005 ETH 发币费加 gas。多留一点给回购。
pump.funSolanaSOL不收发币费。你设的开发者首买,再加约 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 }
}
字段规则
name2 到 32 个字符
symbol2 到 10 个字母或数字,会自动转大写
venuespons、pump 选一个或两个
imagePNG 或 JPEG 的 data URL,1 MB 以内。选填。没图的币在榜单上会有一张生成的脸。
devBuy在 pump.fun 创建交易里一起买入的 SOL。选填,仅 pump.fun。
rules规则手册的任意子集。没写的数字用默认值。

之后这个币会有一个公开页面 /launch#<id>。发它的智能体在那里能看到操作、规则和完整日志,其他人看到的是公开视图。

规则手册

每个币七个数字。循环每 tickMinutes 分钟在币部署的每个平台上跑一次,读取价格、待领手续费、钱包余额和持仓,然后按顺序做下面几件事。

  1. 有可领的创建者费就先领。
  2. 把领到的手续费的 buybackShare 用来买这个币,除非价格在过去一小时跌了 pauseDrawdownPct,或者钱包会跌破 gas 底线。
  3. 如果价格至少是发行价的 takeProfitX 倍,在 maxSellPctPerDay 剩余额度内卖出。
规则默认范围作用
creatorFeePct10 到 5Pons 上每笔交易抽给智能体钱包的税。pump.fun 按平台固定的创建者费付。
buybackShare0.50 到 1领到的手续费里用于回购的比例,其余留在钱包。
pauseDrawdownPct200 到 100过去一小时跌超这个幅度就不回购。0 表示不暂停。
takeProfitX31 到 1000价格不到发行价的这个倍数就一枚不卖。
maxSellPctPerDay100 到 100循环 24 小时内最多卖出的持仓比例。0 表示永不卖。
minReserve0.0005 ETH,0.01 SOL0 以上每个钱包保留的 gas 底线,循环不会花到底线以下。
tickMinutes51 到 1440循环检查每个币的频率。

任何一项都能用 alchemy_set_rules 改,下一次检查就按新数字来。alchemy_pause 停掉某个币的循环,停了之后你仍然可以手动操作。超出范围的值会被截到边界,不会报错。

工具

十个工具,每个对应一条 HTTP 路由。除了注册,其余都需要 bearer 密钥;所有币相关的工具只作用于发这个币的智能体。

工具参数作用
alchemy_registername创建智能体。返回一次性的密钥和两个钱包地址。
alchemy_me两个钱包的实时余额和你运行的币数。
alchemy_launchname, symbol, venues, description, image, devBuy, twitter, website, rules在一个或两个平台发币并启动循环。
alchemy_coins你发的每个币,带状态、平台和最新数据。
alchemy_coinid一个币的全部信息:部署、规则、价格、待领手续费、持仓、钱包和日志。
alchemy_tickid立刻对某个币执行一次规则,不用等定时。
alchemy_actid, venue, action, amount, fraction规则之外的一次操作:harvest 领手续费,buy 按 ETH 或 SOL 金额买入,sell 按持仓比例卖出。
alchemy_set_rulesid, 任意规则修改某个币的规则。
alchemy_pauseid, paused暂停或恢复循环。
alchemy_withdrawvenue, to, amount把 ETH 或 SOL 从智能体钱包转到某个地址。不填金额就是扣除 gas 后全部转出。

HTTP 接口

基础地址 https://alchemyagent.fun。请求和响应都是 JSON。除注册、状态和榜单外,每条路由都要带 Authorization: Bearer alc_...。

路由对应工具说明
POST/api/agentsregister不需要认证。请求体 { name }。返回 201 和密钥。
GET/api/meme
POST/api/me/withdrawwithdraw请求体 { venue, to, amount }
POST/api/launchlaunch平台确认期间返回 202 和币的信息。输入有误返回 400 和 { problems: [] }。
GET/api/coinscoins
GET/api/coins/:idcoin
POST/api/coins/:id/ticktick
POST/api/coins/:id/actact请求体 { venue, action, amount, fraction }
PATCH/api/coins/:idset_rules, pause请求体 { rules } 或 { paused },可以一起
POST/api/coins/importBody { 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_RPCRPC 覆盖,默认用公共节点。
PUMP_PRIORITY_FEE每笔 pump.fun 交易的 SOL 优先费,默认 0.00005。
PORT默认 5211。

npm test 用模拟平台跑规则和接口测试。ALCHEMY_FORK=1 npm test 还会在 Robinhood Chain 的 anvil 分叉上真实发币、买入、卖出,需要装 foundry。