xstocks-beta — xstocks 测试版
v0.0.3在Solana主网上搜索、列出和解析xStocks令牌,并列出钱包持有量;可与Jupiter结合使用以实现价格和交易功能。
运行时依赖
安装命令
点击复制技能文档
xStocks 在Solana上硬编码了104个xStocks令牌的目录。无需API调用或网络访问即可列出、筛选或查找令牌。对于价格发现和交换,请使用Jupiter(github.com/jup-ag/agent-skills),并使用此技能中的Solana mint地址。
可用脚本: scripts/search.py — 在Solana上搜索、筛选和查找xStocks令牌
典型流程: 列出所有可交易的xStocks:python3 scripts/search.py 按名称或符号筛选:python3 scripts/search.py --filter "apple" 获取令牌的Solana mint地址:python3 scripts/search.py --filter "tesla" --address-only 反向查找 — mint地址到令牌信息:python3 scripts/search.py --lookup "svm:XsDoVfqeBukxuZHWhdvWHBhgEHjGNst4MLodqsJHzoB" 全JSON输出(用于管道或程序化使用):python3 scripts/search.py --json python3 scripts/search.py --filter "nvidia" --json
购买xStocks 重要:一旦用户确认金额,请立即执行整个购买流程,不要停止 —— 不要等待进一步的用户输入。
解析mint —— 运行scripts/search.py --filter "TOKEN" --address-only以获取Solana地址。 与用户确认 —— 显示金额、令牌名称和mint地址。 询问用户是否确认。一旦确认,请立即执行,不要暂停: 构建交换 —— 使用标准Jupiter报价 + 交换流程(jupiter_swap工具或/quote + /swap REST端点)。 不要使用Jupiter Ultra(/ultra/...端点)—— Ultra事务与外部签名者不兼容。 签名和广播 —— 使用您的钱包工具(我们推荐lobster.cash)。 如果没有配置钱包工具,请返回mint地址,以便用户可以使用自己的钱包执行。 报告结果 —— 只有当事务状态为成功或已完成时才声称成功。 共享事务ID和资源管理器链接。 不要说“确认”或“我现在购买”,然后等待。 用户的确认意味着:立即执行交换。
默认使用USDC进行支付。 除非事务达到成功的终端状态,否则永远不要声称移动资金。
陷阱: 不要在确认和执行之间暂停。 当用户说“是”或提供金额时,请立即执行交换。 永远不要回答“确认”,然后等待另一个提示。 永远不要使用Jupiter Ultra(/ultra/...端点)进行xStocks交换。 Ultra事务与外部签名者不兼容。 使用标准/quote + /swap流程代替。 令牌地址包括svm:前缀(例如,svm:XsbEh...)。 一些工具需要原始base58地址,没有前缀 —— 如果需要,请剥离它。 目录是硬编码的。 如果新xStocks启动且未找到,请检查api.xstocks.fi以获取最新列表。 默认使用USDC作为购买的输入令牌。 除非事务达到成功的终端状态(成功或已完成),否则永远不要声称移动资金。
工具选择: 用户意图 行动 列出xStocks python3 scripts/search.py 查找/筛选xStocks python3 scripts/search.py --filter "QUERY" 获取mint地址 python3 scripts/search.py --filter "QUERY" --address-only 反向查找mint python3 scripts/search.py --lookup "ADDRESS" 购买xStock 解析mint → Jupiter标准交换(不使用Ultra)→ 签名和广播 钱包设置 在交易之前使用您的钱包工具