Skip to content

feat: add omni.fun skill — multichain memecoin trading #244

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
0xzcov wants to merge 1 commit into
base: main
Choose a base branch
from
Open

feat: add omni.fun skill — multichain memecoin trading #244

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
222 changes: 222 additions & 0 deletions omnifun/SKILL.md
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,222 @@
---
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.
metadata: {"clawdbot":{"emoji":"🌀","homepage":"https://omni.fun","requires":{"bins":["curl","jq"]}}}
---

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

## 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-API-Key: omni_YOUR_KEY" https://api.omni.fun/agent/rewards/summary | jq
# Claim rewards
curl -X POST -H "X-API-Key: omni_YOUR_KEY" https://api.omni.fun/agent/rewards/claim
```

## Quick Start

### 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&token=0x...&amount=10&chain=base" | jq
```

## Authentication

Public endpoints (browsing, prices, feed, strategy) require no auth. Trading endpoints require an API key via `X-API-Key` header.

```bash
curl -X POST https://api.omni.fun/agent/register \
-H "Content-Type: application/json" \
-d '{"wallet": "0x...", "name": "MyAgent", "signature": "0x...", "framework": "bankr"}'
```

## 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 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 your own 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 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.
```

### 5. Check portfolio

```bash
curl -s -H "X-API-Key: omni_YOUR_KEY" https://api.omni.fun/agent/portfolio | jq
```

## Webhooks — Real-Time Alerts

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

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

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