SuperAPI AI 工具集

op0-altar

智能体与模型

查看项目

更新于 10-15 08:01

技能介绍

OP0 Altar Protocol Skill 用于在 Solana 上创建和管理自我奖励型 meme 币。通过该技能发行的每个代币都会部署在 pump.fun 上,并带有自动持币者奖励机制:持币者每隔若干个比特币区块会收到以所选代币支付的奖励,可选代币共 129 种,包括 SOL、wBTC、BONK、MEW、TRUMP、JUP 等。

API 配置

基础 URL:https://api.op0.live/functions/v1/altar-api-public 认证头:X-API-Key: <OP0_API_KEY> 方法:所有请求均为 POST,Content-Type: application/json 认证:除 generate-key 和 payout-tokens 外,所有端点都需要 X-API-Key 头。

自主生成 API Key

如果未设置 OP0_API_KEY,可以自主生成一个,用户需提供其 Solana 钱包地址。

curl -s -X POST https://api.op0.live/functions/v1/altar-api-public
-H "Content-Type: application/json"
-d '{"action":"generate-key","wallet":"USER_WALLET_ADDRESS","label":"OpenClaw Agent"}'

响应包含 api_key(格式:op0_live_ + 64 位十六进制字符)。需立即保存,之后无法再次获取。可提示用户将其加入 OpenClaw 配置:

openclaw config set mcpServers.op0.env.OP0_API_KEY "op0_live_..."

或存入环境变量供本技能使用。

可用操作

  1. 创建 Altar

在 Solana 上创建新的自我奖励型代币。必填字段:token_name、token_ticker、marketing_wallet。

curl -s -X POST https://api.op0.live/functions/v1/altar-api-public
-H "Content-Type: application/json"
-H "X-API-Key: $OP0_API_KEY"
-d '{ "action": "create", "token_name": "TOKEN_NAME", "token_ticker": "TICKER", "marketing_wallet": "SOLANA_WALLET_ADDRESS", "payout_token_ticker": "wbtcsol", "blocks_per_cycle": 5, "payout_percent": 30, "min_hold_amount": 500000, "community_percent": 50, "color": "#3b8fff" }'

可选字段:token_description、website、token_twitter、token_telegram、payout_token_ticker(默认 wbtcsol)、blocks_per_cycle(2-9,默认 5)、payout_percent(10-50,默认 30)、min_hold_amount(默认 500000)、community_percent(50-98,默认 50)、color(十六进制,默认 #3b8fff)。

图片使用 base64:添加 token_image_base64、token_image_mime 和 token_image_name 字段。

响应返回 altar_id、dev_wallet、amount_required_sol(通常为 0.05)、expires_at(30 分钟窗口)。

创建后:告知用户向 dev_wallet 地址发送所需 SOL,然后轮询状态端点。

  1. 查询 Altar 状态

用户发送 SOL 后每 5 秒轮询一次。资金到位后,代币部署会自动触发。

curl -s -X POST https://api.op0.live/functions/v1/altar-api-public
-H "Content-Type: application/json"
-H "X-API-Key: $OP0_API_KEY"
-d '{"action":"status","altar_id":ALTAR_ID}'

状态转换:awaiting_funding -> creating -> active。当状态为 active 时,响应包含 token_mint、altar_url、pump_fun_url、treasury_wallet。

如果状态为 expired,表示 30 分钟资金窗口已关闭,需创建新的 altar。

  1. 列出所有 Altar

curl -s -X POST https://api.op0.live/functions/v1/altar-api-public
-H "Content-Type: application/json"
-H "X-API-Key: $OP0_API_KEY"
-d '{"action":"list"}'

返回 altar 数组,包含 altar_id、name、token_mint、status、altar_url、website、payout_token、config 字段。

  1. 获取 Altar 信息

curl -s -X POST https://api.op0.live/functions/v1/altar-api-public
-H "Content-Type: application/json"
-H "X-API-Key: $OP0_API_KEY"
-d '{"action":"info","altar_id":ALTAR_ID}'

返回完整 altar 详情,包括实时金库余额(通过 RPC 获取)和当前周期状态。

  1. 列出奖励代币(无需认证)

curl -s -X POST https://api.op0.live/functions/v1/altar-api-public
-H "Content-Type: application/json"
-d '{"action":"payout-tokens"}'

返回全部 129 种可用代币。类别包括:稳定币(usdc、usdt、pyusd、usd1、eurc、fdusd、usds)、蓝筹(sol、wbtcsol、jitosol、msol、bnsol、render、pyth、hnt)、meme 币(bonk、wif、popcat、fartcoin、mew、pnut、bome、moodeng、ponke、myro、giga、pengu、goat、chillguy、dood、vine)、AI(virtual、griffain、elizaos、zerebro、swarms、tai、holo、llm、ani、buzz)、DeFi(jup、ray、orca、drift、jto、kmno、met、fida、tensor)、代币化股票(tslax、nvdax、aaplx、mstrx、googlx、spyx、qqqx、coinx、crclx)、政治(trump、melania、wlfi、a47)。

行为规则

创建 altar 前始终询问 marketing_wallet。若缺失,98% 的创作者费用将进入社区金库,无营销分配。

当用户说「创建代币/coin/altar」时,收集:名称、代号、营销钱包,以及可选的奖励代币偏好。其余使用合理默认值。

调用 create 后,清楚告知用户 dev_wallet 地址和需发送的确切 SOL 金额,并提醒 30 分钟窗口。

用户确认已发送 SOL 后,每 5 秒轮询状态端点(最多 60 次),报告最终状态。

如果用户问「可以用哪些代币奖励持币者」,调用 payout-tokens 端点并按类别整理结果。

速率限制:每个钱包 3 个 API Key,每个 Key 每 24 小时 5 次创建。

如果未配置 API Key,可主动提供生成。用户只需提供其 Solana 钱包地址。

错误处理

401:API Key 无效或缺失,可提供生成新 Key。

429:超出速率限制。响应包含 resets_at 时间戳,告知用户何时可重试。

400:请求错误。检查必填字段,最常见的是缺少 marketing_wallet。

expired 状态:30 分钟资金窗口已关闭,需创建新 altar。

MCP 服务器替代方案

如果用户的 OpenClaw 实例支持 MCP 服务器,也可使用 OP0 MCP 服务器获得更丰富的集成:

openclaw config set mcpServers.op0.command "npx" openclaw config set mcpServers.op0.args '["@op0live/mcp-server"]' openclaw config set mcpServers.op0.env.OP0_API_KEY "op0_live_YOUR_KEY" openclaw config set mcpServers.op0.env.OP0_API_URL "https://api.op0.live/functions/v1/altar-api-public"

该方式暴露 5 个工具:op0_create_altar、op0_check_altar_status、op0_list_altars、op0_altar_info、op0_list_payout_tokens。