SkillHub

omnifun

v1.2.1

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...

Sourced from ClawHub, Authored by 0xzcov

Installation

Please help me install the skill `omnifun` from SkillHub official store. npx skills add 0xzcov/omnifun

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):

# 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:

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:

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.

# Check rewards
curl -s -H "X-API-Key: $OMNIFUN_API_KEY" https://api.omni.fun/agent/rewards/summary | jq
# Claim rewards
curl -X POST -H "X-API-Key: $OMNIFUN_API_KEY" 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
# Set a $50/trade and $200/day limit
curl -X PUT https://api.omni.fun/agent/vault 
  -H "X-API-Key: $OMNIFUN_API_KEY" 
  -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-API-Key: $OMNIFUN_API_KEY"

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

curl -s https://api.omni.fun/agent/tokens?sort=trending | jq '.tokens[:5]'

Get AI strategy analysis (Venice-powered, private, zero-retention)

curl -s https://api.omni.fun/agent/strategy/market | jq
# Returns: market regime, top opportunities, risk assessment, suggested actions

Get a price quote

curl -s "https://api.omni.fun/agent/quote?action=buy&token=0x...&amount=10&chain=base" | jq

Buy a token

curl -X POST https://api.omni.fun/agent/trade 
  -H "X-API-Key: $OMNIFUN_API_KEY" 
  -H "Content-Type: application/json" 
  -d '{"action": "buy", "token": "0xTOKEN", "amount": 10, "chain": "base"}'

Sell a token

curl -X POST https://api.omni.fun/agent/trade 
  -H "X-API-Key: $OMNIFUN_API_KEY" 
  -H "Content-Type: application/json" 
  -d '{"action": "sell", "token": "0xTOKEN", "amount": 1000000, "chain": "base"}'

Check portfolio

curl -s -H "X-API-Key: $OMNIFUN_API_KEY" https://api.omni.fun/agent/portfolio | jq
curl -s https://api.omni.fun/agent/feed | jq '{trending: .trending[:3], graduatingSoon: .graduatingSoon}'

Launch your own token

curl -X POST https://api.omni.fun/agent/launch 
  -H "X-API-Key: $OMNIFUN_API_KEY" 
  -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.

curl -X POST https://api.omni.fun/agent/webhooks 
  -H "X-API-Key: $OMNIFUN_API_KEY" 
  -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