SuperAPI AI 工具集

sp3nd

通用与其它

查看项目

更新于 10-16 01:12

技能介绍

SP3ND 用于让 AI 智能体用 Solana 上的 USDC 购买 Amazon 和 eBay 的真实商品。官方资料称无需 KYC、无需账户、默认 0% 平台费,符合条件的 Amazon 商品可享免费 Prime 配送。API 文档见 https://sp3nd.shop/partner-api/docs,SKILL.md 见 https://sp3nd.shop/skill.md,Base URL 为 https://us-central1-sp3nddotshop-prod.cloudfunctions.net。

使用前提:一个持有 USDC 的 Solana 钱包(mint:EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v);安装 solders 与 solana Python 包(pip install solders solana);在 .env 中保存注册得到的 SP3ND API 凭据。

主要流程:先调用 /registerAgent 自助注册,api_key 与 api_secret 仅展示一次,需立即保存为 SP3ND_API_KEY 和 SP3ND_API_SECRET。然后按发货国家选择正确的 Amazon 或 eBay 域名(TLD),域名选错会导致下单失败或价格错误。调用 /createPartnerCart 传商品链接与数量创建购物车,返回 cart_id 与以美元计的 total_amount(即所需 USDC 数量)。购物车 30 分钟后过期。再调用 /createPartnerOrder,需提供 cart_id、customer_email(必填)和收货地址(含国家 ISO 二字码、电话等),返回 order_id、order_number 与 total_amount。

支付采用 x402 v2 协议:调用 payAgentOrder 会返回 HTTP 402 及支付要求。需在链上查询 SP3ND 金库真实的 USDC 代币账户(ATA),不要自行推导;构建含 transferChecked 与 Memo(内容为 SP3ND Order: <order_number>)两笔指令的交易;Memo 为必需项,否则付款无法被匹配。签名后通过 Solana RPC 直接广播。Starchild 智能体可用内置 Privy 钱包工具,依次用 wallet_info() 获取地址、wallet_sol_balance() 检查余额、wallet_sol_sign_transaction(transaction=unsigned_b64) 签名,再自行广播;注意不要用 wallet_sol_transfer 转 SPL 代币,它只处理原生 SOL。最后每约 5 秒轮询 /getPartnerOrders,订单通常在 60 秒内变为 Paid。

关键地址:SP3ND 金库 2nkTRv3qxk7n2eYYjFAndReVXaV7sTF3Z9pNimvp5jcp;USDC mint EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v;x402 facilitator https://facilitator.payai.network。支持邮箱 support@sp3nd.shop。

限制与注意事项:USDC 为 6 位小数,金额需乘以 1,000,000;Amazon TLD 必须与发货国匹配;缺 customer_email 会返回 400;必须使用链上查询到的金库 ATA;购物车 30 分钟过期需及时下单;eBay 运费由卖家按商品设定。其他收费、价格或可用国家资料暂未提供。