OP0 Altar Protocol Skill
You can create and manage self-rewarding meme coins on Solana through the OP0 Altar protocol. Every token launched through this skill deploys on pump.fun with automatic holder rewards -- holders receive payouts in a chosen token (129 options including SOL, wBTC, BONK, MEW, TRUMP, JUP, and more) every few Bitcoin blocks.
API Configuration
- - Base URL: INLINECODE0
- Auth Header: INLINECODE1
- Method: All requests are
POST with INLINECODE3 - Auth: All endpoints require
X-API-Key header except generate-key and INLINECODE6
Generating an API Key (Autonomous)
If OP0_API_KEY is not set, you can generate one autonomously. The user must provide their Solana wallet address.
CODEBLOCK0
Response contains api_key (format: op0_live_ + 64 hex chars). Save it immediately -- it cannot be retrieved again. Tell the user to add it to their OpenClaw config:
CODEBLOCK1
Or store it in their environment for this skill to use.
Available Actions
1. Create an Altar
Create a new self-rewarding token on Solana. Required fields: token_name, token_ticker, marketing_wallet.
CODEBLOCK2
Optional fields: token_description, website, token_twitter, token_telegram, payout_token_ticker (default: wbtcsol), blocks_per_cycle (2-9, default: 5), payout_percent (10-50, default: 30), min_hold_amount (default: 500000), community_percent (50-98, default: 50), color (hex, default: #3b8fff).
For images, use base64: add token_image_base64, token_image_mime, and token_image_name fields.
Response returns altar_id, dev_wallet, amount_required_sol (typically 0.05), expires_at (30 min window).
After creation: Tell the user to send the required SOL to the dev_wallet address. Then poll the status endpoint.
2. Check Altar Status
Poll this every 5 seconds after the user sends SOL. When funded, token deployment triggers automatically.
CODEBLOCK3
Status transitions: awaiting_funding -> creating -> active. When active, response includes token_mint, altar_url, pump_fun_url, treasury_wallet.
If status is expired, the 30-minute funding window closed. Create a new altar.
3. List All Altars
CODEBLOCK4
Returns array of altars with altar_id, name, token_mint, status, altar_url, website, payout_token, config fields.
4. Get Altar Info
CODEBLOCK5
Returns full altar details including live treasury balance (fetched via RPC) and current cycle state.
5. List Payout Tokens (No Auth)
CODEBLOCK6
Returns all 129 available tokens. Categories: Stablecoins (usdc, usdt, pyusd, usd1, eurc, fdusd, usds), Blue Chips (sol, wbtcsol, jitosol, msol, bnsol, render, pyth, hnt), Memecoins (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), Tokenized Stocks (tslax, nvdax, aaplx, mstrx, googlx, spyx, qqqx, coinx, crclx), Political (trump, melania, wlfi, a47).
Behavior Rules
- 1. Always ask for
marketing_wallet before creating an altar. Without it, 98% of creator fees go to the community treasury with no marketing distribution. - When the user says "create a coin/token/altar", gather: name, ticker, marketing wallet, and optionally payout token preference. Use sensible defaults for everything else.
- After calling create, clearly tell the user the
dev_wallet address and exact SOL amount to send. Remind them of the 30-minute window. - After the user confirms they sent SOL, poll the status endpoint every 5 seconds (up to 60 attempts). Report the final state.
- If the user asks "what tokens can I reward holders with", call the payout-tokens endpoint and present the results organized by category.
- Rate limits: 3 API keys per wallet, 5 creates per key per 24 hours.
- If no API key is configured, offer to generate one. The user just needs their Solana wallet address.
Error Handling
- -
401: Invalid or missing API key. Offer to generate a new one. - INLINECODE49 : Rate limit exceeded. Response includes
resets_at timestamp. Tell the user when they can try again. - INLINECODE51 : Bad request. Check required fields. Most common: missing
marketing_wallet. - INLINECODE53 status: The 30-minute funding window closed. Create a new altar.
MCP Server Alternative
If the user's OpenClaw instance supports MCP servers, they can also use the OP0 MCP server for a richer integration:
CODEBLOCK7
This exposes 5 tools: op0_create_altar, op0_check_altar_status, op0_list_altars, op0_altar_info, op0_list_payout_tokens.
OP0 Altar 协议技能
你可以通过 OP0 Altar 协议在 Solana 上创建和管理自奖励型模因币。通过此技能启动的每个代币都会部署在 pump.fun 上,并自动向持有者发放奖励——持有者每隔几个比特币区块就会收到所选代币(共 129 种可选,包括 SOL、wBTC、BONK、MEW、TRUMP、JUP 等)的分红。
API 配置
- - 基础 URL: https://api.op0.live/functions/v1/altar-api-public
- 认证头: X-API-Key: APIKEY>
- 方法: 所有请求均为 POST,Content-Type: application/json
- 认证: 除 generate-key 和 payout-tokens 外,所有端点均需 X-API-Key 头
生成 API 密钥(自主操作)
如果未设置 OP0APIKEY,你可以自主生成一个。用户必须提供其 Solana 钱包地址。
bash
curl -s -X POST https://api.op0.live/functions/v1/altar-api-public \
-H Content-Type: application/json \
-d {action:generate-key,wallet:用户钱包地址,label:OpenClaw Agent}
响应中包含 apikey(格式:op0live_ + 64 个十六进制字符)。请立即保存——无法再次获取。告知用户将其添加到 OpenClaw 配置中:
openclaw config set mcpServers.op0.env.OP0APIKEY op0live...
或将其存储在用户的环境中供此技能使用。
可用操作
1. 创建 Altar
在 Solana 上创建新的自奖励型代币。必填字段:tokenname、tokenticker、marketing_wallet。
bash
curl -s -X POST https://api.op0.live/functions/v1/altar-api-public \
-H Content-Type: application/json \
-H X-API-Key: $OP0APIKEY \
-d {
action: create,
token_name: 代币名称,
token_ticker: 代币符号,
marketing_wallet: SOLANA钱包地址,
payouttokenticker: wbtcsol,
blockspercycle: 5,
payout_percent: 30,
minholdamount: 500000,
community_percent: 50,
color: #3b8fff
}
可选字段:tokendescription、website、tokentwitter、tokentelegram、payouttokenticker(默认:wbtcsol)、blockspercycle(2-9,默认:5)、payoutpercent(10-50,默认:30)、minholdamount(默认:500000)、community_percent(50-98,默认:50)、color(十六进制,默认:#3b8fff)。
对于图片,使用 base64:添加 tokenimagebase64、tokenimagemime 和 tokenimagename 字段。
响应返回 altarid、devwallet、amountrequiredsol(通常为 0.05)、expires_at(30 分钟窗口)。
创建后: 告知用户将所需的 SOL 发送到 dev_wallet 地址。然后轮询状态端点。
2. 检查 Altar 状态
在用户发送 SOL 后,每 5 秒轮询一次。资金到位后,代币部署将自动触发。
bash
curl -s -X POST https://api.op0.live/functions/v1/altar-api-public \
-H Content-Type: application/json \
-H X-API-Key: $OP0APIKEY \
-d {action:status,altarid:ALTARID}
状态转换:awaitingfunding -> creating -> active。当状态为 active 时,响应包含 tokenmint、altarurl、pumpfunurl、treasurywallet。
如果状态为 expired,则表示 30 分钟的资金窗口已关闭。需要创建新的 altar。
3. 列出所有 Altars
bash
curl -s -X POST https://api.op0.live/functions/v1/altar-api-public \
-H Content-Type: application/json \
-H X-API-Key: $OP0APIKEY \
-d {action:list}
返回 altar 数组,包含 altarid、name、tokenmint、status、altarurl、website、payouttoken 和配置字段。
4. 获取 Altar 信息
bash
curl -s -X POST https://api.op0.live/functions/v1/altar-api-public \
-H Content-Type: application/json \
-H X-API-Key: $OP0APIKEY \
-d {action:info,altarid:ALTARID}
返回完整的 altar 详情,包括实时金库余额(通过 RPC 获取)和当前周期状态。
5. 列出分红代币(无需认证)
bash
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)、模因币(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)。
行为规则
- 1. 创建 altar 前务必询问 marketingwallet。没有它,98% 的创建者费用将进入社区金库,无法进行营销分发。
- 当用户说创建币/代币/altar时,收集:名称、代币符号、营销钱包,以及可选的分红代币偏好。其他所有字段使用合理的默认值。
- 调用 create 后,明确告知用户 devwallet 地址和需要发送的精确 SOL 数量。提醒他们有 30 分钟的时间窗口。
- 用户确认已发送 SOL 后,每 5 秒轮询状态端点(最多 60 次)。报告最终状态。
- 如果用户问可以用哪些代币奖励持有者,调用 payout-tokens 端点并按类别展示结果。
- 速率限制: 每个钱包 3 个 API 密钥,每个密钥每 24 小时可创建 5 次。
- 如果未配置 API 密钥,主动提供生成选项。用户只需提供其 Solana 钱包地址。
错误处理
- - 401:API 密钥无效或缺失。主动提供生成新密钥。
- 429:超出速率限制。响应中包含 resetsat 时间戳。告知用户何时可以重试。
- 400:请求错误。检查必填字段。最常见原因:缺少 marketingwallet。
- 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.OP0APIKEY op0liveYOUR_KEY
openclaw config set mcpServers.op0.env.OP0APIURL https://api.op0.live/functions/v