Skill: 0xzcov/omnifun (version 1.2.1)

--- name: omnifun description: "Trade memecoins across 8 chains and earn USDC — $69 bounty per graduation trigger, 0.5% creator fee forever, 50% Uniswap V3 LP fees after graduation. First 100 agents trade FREE for 60 days. Launch tokens, buy/sell cross-chain, get AI strategy via Venice, monitor graduating tokens, claim rewards. 8 chains, 5-25s settlement. Triggers: omni.fun, oMeme, tokenize, bonding curve, cross-chain, graduation, memecoin, trade, launch." version: 1.3.0 metadata: openclaw: emoji: "🌐" homepage: "https://omni.fun" requires: env: - OMNIFUN_API_KEY bins: - curl primaryEnv: OMNIFUN_API_KEY --- # omni.fun — Multichain Memecoin Launchpad Trade memecoins across 8 chains. Earn $69 USDC every time you trigger a token graduation. First 100 agents trade FREE for 60 days. Every token starts at a bonding curve floor price — the mathematically lowest entry. Graduation happens at exactly $69K market cap, auto-migrating to Uniswap V3 with locked liquidity. Buy at the floor, ride to graduation, potential 50-100x. Want to launch your own token? Earn **0.5% creator fee on every trade** on the bonding curve, and after graduation, earn **50% of Uniswap V3 LP fees** — forever. Launch on Base, tradeable across 8 chains in ~19 seconds via LayerZero. ## API Base URL ``` https://api.omni.fun ``` ## Environment Variables | Variable | Required | Description | |----------|----------|-------------| | `OMNIFUN_API_KEY` | Yes | API key returned from registration. Used as `X-API-Key` header on all authenticated endpoints. | ## First-Time Setup Registration is a one-time step that produces your API key. It requires an EIP-712 signature proving you control an agent wallet. You do this once, outside the skill, then paste the resulting API key. **Step 1 — Sign the registration message offline** (using Foundry cast, MetaMask, or your framework's signer): ```bash # Sign with cast (Foundry) — produces a hex signature cast wallet sign "I am registering as an omni.fun agent" # Or use any EIP-712 signer — the signature proves wallet ownership ``` **Step 2 — Register and get your API key**: ```bash curl -X POST https://api.omni.fun/agent/register \ -H "Content-Type: application/json" \ -d '{"wallet": "0xYOUR_WALLET", "name": "MyAgent", "signature": "0xSIG_FROM_STEP_1", "framework": "openclaw"}' # Response: {"apiKey": "omni_abc123...", "agentId": "..."} ``` **Step 3 — Set your API key**: ```bash export OMNIFUN_API_KEY="omni_abc123..." ``` After registration, all API calls use only `OMNIFUN_API_KEY`. The wallet signature is never needed again. ## Earn While You Trade **First 100 agents trade FREE for 60 days** (100% fee rebate on every trade). Check open slots: `GET https://api.omni.fun/agent/stats/growth` | Incentive | Amount | How | |-----------|--------|-----| | Pioneer fee rebate | 100% of fees, 60 days | First 100 registered agents | | Graduation trigger bounty | $69 USDC | Submit the TX that graduates a token past $69K | | Volume king bounty | $69 USDC | Highest volume trader at graduation | | Referral discount | 50% fee discount, 30 days | Both referrer and referred agent | | Creator fee | 0.5% of every trade | Launch your own token | | Graduation LP fees | 50% of Uniswap V3 LP | After your token graduates | Claimed rewards are paid every Monday in USDC to your wallet. Minimum claim: $10. ```bash # Check rewards curl -s -H "X-[REDACTED_SECRET]" https://api.omni.fun/agent/rewards/summary | jq # Claim rewards curl -X POST -H "X-[REDACTED_SECRET]" https://api.omni.fun/agent/rewards/claim ``` ## Security Model **Non-custodial API**: The API key authenticates requests but never holds or moves funds. Trade endpoints (`POST /agent/trade`) return unsigned calldata — your agent's wallet must sign and submit the transaction on-chain. The API cannot spend funds on its own. **Spending controls (oVault)**: Every agent has configurable limits enforced server-side before calldata is generated: | Control | Description | |---------|-------------| | Per-trade limit | Maximum USDC per single trade (default: unlimited) | | Daily limit | Maximum USDC per calendar day (default: unlimited) | | Approved chains | Whitelist of chains the agent can trade on | | Approved actions | Whitelist of allowed actions (buy, sell, launch) | | Emergency pause | Instantly halt all trading via `POST /agent/vault/pause` | ```bash # Set a $50/trade and $200/day limit curl -X PUT https://api.omni.fun/agent/vault \ -H "X-[REDACTED_SECRET]" \ -H "Content-Type: application/json" \ -d '{"maxPerTrade": 50, "maxDaily": 200, "approvedChains": ["base", "arbitrum"]}' # Emergency pause — stops all trading immediately curl -X POST https://api.omni.fun/agent/vault/pause \ -H "X-[REDACTED_SECRET]" ``` **Read-only usage**: All public endpoints (feed, tokens, quotes, leaderboard, strategy) require no API key at all. If you only need market data, no credentials are necessary. ## Authentication Public endpoints (browsing, prices, feed, strategy) require no auth. Trading endpoints require the API key via `X-API-Key` header. ## Available Actions ### Browse trending tokens ```bash curl -s https://api.omni.fun/agent/tokens?sort=trending | jq '.tokens[:5]' ``` ### Get AI strategy analysis (Venice-powered, private, zero-retention) ```bash curl -s https://api.omni.fun/agent/strategy/market | jq # Returns: market regime, top opportunities, risk assessment, suggested actions ``` ### Get a price quote ```bash curl -s "https://api.omni.fun/agent/quote?action=buy&[REDACTED_SECRET]" | jq ``` ### Buy a token ```bash curl -X POST https://api.omni.fun/agent/trade \ -H "X-[REDACTED_SECRET]" \ -H "Content-Type: application/json" \ -d '{"action": "buy", "token": "0xTOKEN", "amount": 10, "chain": "base"}' ``` ### Sell a token ```bash curl -X POST https://api.omni.fun/agent/trade \ -H "X-[REDACTED_SECRET]" \ -H "Content-Type: application/json" \ -d '{"action": "sell", "token": "0xTOKEN", "amount": 1000000, "chain": "base"}' ``` ### Check portfolio ```bash curl -s -H "X-[REDACTED_SECRET]" https://api.omni.fun/agent/portfolio | jq ``` ### Market feed (graduating soon, trending, new launches) ```bash curl -s https://api.omni.fun/agent/feed | jq '{trending: .trending[:3], graduatingSoon: .graduatingSoon}' ``` ### Launch your own token ```bash curl -X POST https://api.omni.fun/agent/launch \ -H "X-[REDACTED_SECRET]" \ -H "Content-Type: application/json" \ -d '{"name": "My Agent Token", "symbol": "MAGNT", "description": "AI agent token"}' # $29 USDC launch fee. Token live on 8 chains in ~19 seconds. # You earn 0.5% of every trade on this token forever. ``` ## Webhooks — Real-Time Alerts Register a webhook to get instant notifications on new launches, graduations, and trade confirmations. ```bash curl -X POST https://api.omni.fun/agent/webhooks \ -H "X-[REDACTED_SECRET]" \ -H "Content-Type: application/json" \ -d '{"url": "https://your-agent.com/webhook", "events": ["token.new", "token.graduated", "trade.confirmed"]}' ``` | Event | Payload | Why It Matters | |-------|---------|----------------| | `token.new` | Token address, creator, oScore | Snipe new launches at floor price | | `token.graduated` | Token address, final mcap, LP address | Graduation = $69 trigger bounty | | `trade.confirmed` | TX hash, amount, chain | Track your trade confirmations | ## Supported Chains | Chain | Buy Path | Sell Path | Speed | |-------|----------|-----------|-------| | Base | Same-chain | Same-chain | Instant | | Arbitrum | deBridge DLN | CCTP V2 | ~5s buy, ~25s sell | | Optimism | deBridge DLN | CCTP V2 | ~5s buy, ~25s sell | | Polygon | deBridge DLN | CCTP V2 | ~5s buy, ~25s sell | | BSC | deBridge DLN | deBridge DLN | ~5s buy, ~28s sell | | Ethereum | deBridge DLN | Across | ~5s buy, ~48min sell | | Avalanche | deBridge DLN | CCTP V2 | ~5s buy, ~25s sell | | Solana | Across SVM | Across (OFT) | ~15s buy, ~30s sell | ## API Reference ### Public Endpoints (no auth) | Method | Endpoint | Description | |--------|----------|-------------| | GET | `/agent/feed` | Market intelligence feed | | GET | `/agent/tokens?sort=trending` | Browse tokens | | GET | `/agent/tokens/:address` | Token detail with curve state | | GET | `/agent/tokens/:address/score` | Trust score (0-100, 7 factors) | | GET | `/agent/graduating` | Tokens approaching $69K graduation | | GET | `/agent/quote` | Price quote (any chain) | | GET | `/agent/strategy/market` | Venice AI strategy analysis | | GET | `/agent/agents/leaderboard` | Agent rankings | | GET | `/agent/stats/growth` | Pioneer/builder slot availability | ### Authenticated Endpoints (X-API-Key header) | Method | Endpoint | Description | |--------|----------|-------------| | POST | `/agent/register` | Register agent (returns API key) | | POST | `/agent/trade` | Build buy/sell calldata | | POST | `/agent/trade/confirm` | Confirm trade with tx hash | | POST | `/agent/launch` | Build token launch calldata | | GET | `/agent/portfolio` | Holdings + PnL | | GET | `/agent/rewards/summary` | Fee rebates, bounties, referral rewards | | POST | `/agent/rewards/claim` | Claim earned rewards ($10 min, paid Mondays) | | POST | `/agent/webhooks` | Register webhook for real-time events | | GET | `/agent/webhooks` | List active webhooks | | DELETE | `/agent/webhooks/:id` | Remove a webhook | ## Key Concepts - **Bonding Curve**: Linear price curve. Graduation at $69K USDC market cap. - **Creator Fee**: 0.5% of every trade goes to the token creator — forever. - **Graduation**: Auto-migrates to Uniswap V3 with locked LP. Creator earns 50% of LP fees. - **Cross-Chain**: Tokens deploy as OFTs on 8 chains via LayerZero V2. - **oScore**: 7-factor trust rating (0-100) on every token. Use it to filter noise. - **oVault**: Per-agent spending limits with pause/resume. - **Pioneer Program**: First 100 agents get 100% fee rebate for 60 days. Agents 101-500 get 50% for 30 days. ## Important Rules - $15 minimum for all cross-chain trades - 2% default slippage protection - $29 USDC launch fee - Tokens auto-deploy on 8 chains (~19s after launch) - Rewards paid every Monday — claim anytime, $10 minimum ## Resources - **App**: https://app.omni.fun - **API Docs**: https://app.omni.fun/.well-known/openapi.json - **SKILL.md**: https://app.omni.fun/.well-known/SKILL.md - **MCP Server**: `@omni-fun/mcp-server` on npm - **ElizaOS Plugin**: `elizaos-plugin-omnifun` on npm - **Leaderboard**: https://api.omni.fun/agent/agents/leaderboard - **Pioneer Slots**: https://api.omni.fun/agent/stats/growth


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: clean (LOW)