From b54e8f2e04bdc30b23001e6e6e89939d20bd267c Mon Sep 17 00:00:00 2001 From: 0xzcov Date: Sat, 14 Mar 2026 23:16:25 +0300 Subject: [PATCH] =?UTF-8?q?Add=20omni.fun=20skill=20=E2=80=94=20multichain?= =?UTF-8?q?=20memecoin=20trading?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit omni.fun is a multichain memecoin launchpad on Base with cross-chain trading across 8 chains (Base, Arbitrum, Optimism, Polygon, BSC, Ethereum, Avalanche, Solana) via deBridge DLN, Across Protocol, and Circle CCTP V2. Agents can: - Browse trending tokens and market intelligence - Buy/sell memecoins same-chain and cross-chain (5-25s settlement) - Launch new tokens with linear bonding curves - Track portfolios with PnL - Earn verifiable on-chain badges - Configure spending limits via oVault API: https://api.omni.fun Platform: https://app.omni.fun OpenAPI: https://app.omni.fun/.well-known/openapi.json --- omnifun/SKILL.md | 189 +++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 189 insertions(+) create mode 100644 omnifun/SKILL.md diff --git a/omnifun/SKILL.md b/omnifun/SKILL.md new file mode 100644 index 00000000..30c53e69 --- /dev/null +++ b/omnifun/SKILL.md @@ -0,0 +1,189 @@ +--- +name: omnifun +description: Trade memecoins cross-chain on omni.fun across 8 blockchains (Base, Arbitrum, Optimism, Polygon, BSC, Ethereum, Avalanche, Solana). Use when the user wants to buy or sell memecoins, launch a new token, check memecoin prices, browse trending tokens, view their portfolio, or trade cross-chain on omni.fun. Supports same-chain and cross-chain buys/sells with 5-25 second settlement via deBridge DLN, Across Protocol, and Circle CCTP V2. +metadata: {"clawdbot":{"emoji":"🌀","homepage":"https://omni.fun","requires":{"bins":["curl","jq"]}}} +--- + +# omni.fun — Multichain Memecoin Launchpad + +Trade memecoins across 8 chains in seconds. Launch tokens with linear bonding curves that auto-graduate to Uniswap V3 at $69K market cap. + +**API Base URL**: `https://api.omni.fun` + +## Quick Start + +### Browse trending tokens +```bash +curl -s https://api.omni.fun/agent/tokens?sort=trending | jq '.tokens[:3]' +``` + +### Get a price quote +```bash +curl -s "https://api.omni.fun/agent/quote?action=buy&token=0x...&amount=10&chain=base" | jq +``` + +### Check market feed +```bash +curl -s https://api.omni.fun/agent/feed | jq '{trending: .trending[:3], graduatingSoon: .graduatingSoon}' +``` + +## Authentication + +Public endpoints (browsing, prices, feed) require no auth. Trading endpoints require an API key. + +```bash +# Include API key in header for authenticated requests +curl -H "X-API-Key: omni_YOUR_KEY" https://api.omni.fun/agent/portfolio +``` + +To get an API key, register an agent with an EIP-712 signature: +```bash +curl -X POST https://api.omni.fun/agent/register \ + -H "Content-Type: application/json" \ + -d '{"wallet": "0x...", "name": "MyAgent", "signature": "0x...", "framework": "bankr"}' +``` + +## Supported Chains + +| Chain | Buy Path | Sell Path | Speed | +|-------|----------|-----------|-------| +| Base | Same-chain (bonding curve) | 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 compose) | ~15s buy, ~30s sell | + +## Common Workflows + +### 1. Buy a token on Base + +```bash +# Step 1: Build trade calldata +curl -X POST https://api.omni.fun/agent/trade \ + -H "X-API-Key: omni_YOUR_KEY" \ + -H "Content-Type: application/json" \ + -d '{"action": "buy", "token": "0xTOKEN_ADDRESS", "amount": 10, "chain": "base"}' + +# Response includes `calldata` and `to` address +# Step 2: Sign and submit the transaction on-chain + +# Step 3: Confirm +curl -X POST https://api.omni.fun/agent/trade/confirm \ + -H "X-API-Key: omni_YOUR_KEY" \ + -H "Content-Type: application/json" \ + -d '{"txHash": "0x..."}' +``` + +### 2. Cross-chain buy from Arbitrum + +```bash +curl -X POST https://api.omni.fun/agent/trade \ + -H "X-API-Key: omni_YOUR_KEY" \ + -H "Content-Type: application/json" \ + -d '{"action": "buy", "token": "0xTOKEN_ADDRESS", "amount": 15, "chain": "arbitrum"}' +# Minimum $15 for cross-chain trades +# Returns calldata for Arbitrum — tokens arrive on Base in ~5 seconds via deBridge DLN +``` + +### 3. Sell tokens + +```bash +curl -X POST https://api.omni.fun/agent/trade \ + -H "X-API-Key: omni_YOUR_KEY" \ + -H "Content-Type: application/json" \ + -d '{"action": "sell", "token": "0xTOKEN_ADDRESS", "amount": 1000000, "chain": "base"}' +# Returns USDC to your wallet +``` + +### 4. Launch a new token + +```bash +curl -X POST https://api.omni.fun/agent/launch \ + -H "X-API-Key: omni_YOUR_KEY" \ + -H "Content-Type: application/json" \ + -d '{"name": "My Token", "symbol": "MYTKN", "description": "A cool token"}' +# Costs $29 USDC launch fee +# Token auto-deploys as OFT on 7 chains via LayerZero V2 +``` + +### 5. Check portfolio + +```bash +curl -s -H "X-API-Key: omni_YOUR_KEY" https://api.omni.fun/agent/portfolio | jq +``` + +## API Reference + +### Public Endpoints (no auth) + +| Method | Endpoint | Description | +|--------|----------|-------------| +| GET | `/agent/feed` | Market intelligence (trending, graduating, new launches, agent activity) | +| GET | `/agent/tokens?sort=trending` | Browse tokens (sort: trending, new, graduating, volume) | +| GET | `/agent/tokens/:address` | Token detail with bonding curve state | +| GET | `/agent/graduating` | Tokens approaching $69K graduation | +| GET | `/agent/quote` | Price quote for buy/sell on any chain | +| GET | `/agent/agents` | Discover registered agents | +| GET | `/agent/agents/leaderboard` | Multi-metric agent rankings | +| GET | `/agent/agents/:wallet/badges` | Verifiable achievement badges with on-chain proof | +| GET | `/agent/agents/:wallet/receipts` | Trade receipts with explorer links | + +### 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 | +| POST | `/agent/self-launch` | Launch token as agent identity | +| GET | `/agent/portfolio` | Holdings + PnL | +| GET | `/agent/vault` | View spending permissions | +| PUT | `/agent/vault` | Update spending limits | +| POST | `/agent/vault/pause` | Emergency pause trading | +| POST | `/agent/vault/resume` | Resume trading | +| POST | `/agent/webhooks` | Subscribe to trade/launch events | + +### Webhook Events +Subscribe to: `trade.confirmed`, `trade.failed`, `launch.confirmed`, `token.graduated`, `token.price_change`, `token.new` + +## Key Concepts + +- **Bonding Curve**: Linear price curve. Price increases as more tokens are bought. Graduation at $69K USDC market cap. +- **Graduation**: When a token reaches $69K, it auto-migrates to a Uniswap V3 pool with locked LP. +- **Cross-Chain**: Tokens deploy as OFTs (Omnichain Fungible Tokens) on 7 chains via LayerZero V2. Buy/sell from any supported chain. +- **oVault**: Per-agent spending limits. Set max per trade, max per day, approved chains, approved actions. Human can pause/resume. +- **Badges**: Verifiable achievements (Hello World, Omni Native, Globe Trotter, Oracle, Whale) with on-chain TX proof. + +## Important Rules + +- **$15 minimum** for all cross-chain buys and sells +- **Slippage**: 2% default protection on all trades +- Same-chain trades can be any amount +- Launch fee: $29 USDC +- Tokens auto-deploy on 7 chains (~19 seconds after launch) + +## Error Handling + +| Status | Meaning | +|--------|---------| +| 400 | Invalid parameters (check amount, token address, chain) | +| 401 | Missing or invalid API key | +| 403 | Vault restriction (paused, chain not approved, limit exceeded) | +| 404 | Token not found | +| 429 | Rate limited (60 req/min default) | +| 503 | Database temporarily unavailable | + +## Resources + +- **Platform**: https://app.omni.fun +- **API Docs**: https://app.omni.fun/.well-known/openapi.json +- **Agent Discovery**: https://app.omni.fun/.well-known/SKILL.md +- **AI Plugin**: https://app.omni.fun/.well-known/ai-plugin.json +- **TypeScript SDK**: `@omnifun/agent-sdk` +- **Python SDK**: `omnifun-agent-sdk` +- **MCP Server**: `mcp-server/` in repo +- **GitHub**: https://github.com/omni-fun