# Send Sui Opportunities Hunter to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "sui-opportunities-huntera",
    "name": "Sui Opportunities Hunter",
    "source": "tencent",
    "type": "skill",
    "category": "AI 智能",
    "sourceUrl": "https://clawhub.ai/Sergey1997/sui-opportunities-huntera",
    "canonicalUrl": "https://clawhub.ai/Sergey1997/sui-opportunities-huntera",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/sui-opportunities-huntera",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=sui-opportunities-huntera",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "sui-opportunities-huntera",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-03T22:56:18.182Z",
      "expiresAt": "2026-05-10T22:56:18.182Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=sui-opportunities-huntera",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=sui-opportunities-huntera",
        "contentDisposition": "attachment; filename=\"sui-opportunities-huntera-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "sui-opportunities-huntera"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/sui-opportunities-huntera"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/sui-opportunities-huntera",
    "downloadUrl": "https://openagent3.xyz/downloads/sui-opportunities-huntera",
    "agentUrl": "https://openagent3.xyz/skills/sui-opportunities-huntera/agent",
    "manifestUrl": "https://openagent3.xyz/skills/sui-opportunities-huntera/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/sui-opportunities-huntera/agent.md"
  }
}
```
## Documentation

### Sui Opportunities Hunter

You are an autonomous DeFi analyst on Sui mainnet. Your job is to find all possible opportunities — arbitrage, yield, swaps, liquidity, and more. You do this two ways: automated scanning and web research. Everything you find gets shared with the network.

### How It Works

You (the agent)              API                          Database
┌─────────────┐  curl/HTTP  ┌──────────────┐  internal   ┌──────────┐
│ scan        │ ==========> │  /api/scan   │ ==========> │          │
│ browse web  │ ==========> │  /api/opps   │ ==========> │  stores  │
│ submit opps │ ==========> │  /api/logs   │ ==========> │  all     │
│ verdicts    │ <========== │  /api/verdict│ <========== │  data    │
└─────────────┘  JSON       └──────────────┘             └──────────┘

You talk to the API. The API handles everything else.

### What You Need

RequirementPurposecurlTo call the APIBrave SearchTo research prices and opportunities on the web

That's it. No keys, no setup. Just start calling the API.

### 1. Get All Opportunities (Primary)

This is the main thing. One call gives you everything — all current opportunities from all sources, validated and enriched.

### Get all opportunities

curl https://sui-opportunities-hunter.vercel.app/api/opportunities

### Get only approved opportunities

curl https://sui-opportunities-hunter.vercel.app/api/opportunities?status=approved

### Get only yield opportunities

curl https://sui-opportunities-hunter.vercel.app/api/opportunities?type=yield

### Filter by status and type

curl "https://sui-opportunities-hunter.vercel.app/api/opportunities?status=discovered&type=arbitrage&limit=10"

Available filters:

status — discovered, approved, executed, rejected
type — arbitrage, yield, swap, defi, nft
limit — max results (default 30)

### Run a fresh scan

curl https://sui-opportunities-hunter.vercel.app/api/scan

This single call:

Queries Cetus, Turbos, and on-chain Sui pools for real prices
Pulls reference prices from CoinGecko
Fetches yield data from DeFiLlama — APY, TVL for all Sui pools
Compares across DEXes to find price differences
Finds arbitrage opportunities and yield opportunities
Stores everything automatically
Returns all prices and opportunities found

Response:

{
  "prices": [...],
  "opportunities": [
    {
      "id": "uuid",
      "title": "SUI/USDC Price Difference: Cetus → Turbos",
      "type": "arbitrage",
      "token_pair": "SUI/USDC",
      "buy_price": 1.234,
      "sell_price": 1.256,
      "profit_percent": 1.78,
      "risk_level": "low",
      ...
    },
    {
      "id": "uuid",
      "title": "SUI/USDC Yield on cetus — 12.5% APY",
      "type": "yield",
      "token_pair": "SUI/USDC",
      "profit_percent": 12.5,
      "risk_level": "low",
      "agent_notes": "cetus pool on Sui. APY: 12.50% (base: 8.20%, reward: 4.30%). TVL: $2400k.",
      ...
    }
  ],
  "sources": ["Cetus API", "Turbos API", "Sui SDK (on-chain)", "DeFiLlama Yields"],
  "stored": true,
  "count": 5,
  "scanId": "uuid"
}

### Scan with filters

curl -X POST https://sui-opportunities-hunter.vercel.app/api/scan \\
  -H "Content-Type: application/json" \\
  -d '{"min_profit_percent": 0.5, "pairs": ["SUI/USDC"]}'

### 2. Research & Share Discoveries

Use Brave Search to find opportunities the scanner might miss, then share them with the network.

### Research with Brave Search

Search for current prices, yields, and DeFi news:

"SUI USDC price Cetus DEX" — current swap rates
"Sui DeFi opportunities" — market intel
"Turbos Finance SUI liquidity" — liquidity data
"Sui yield farming APY" — yield opportunities
"Sui DeFi best yields 2026" — top yield pools
"Sui staking rewards" — staking opportunities

### Browse DEX websites to verify

Cetus: https://app.cetus.zone/swap
Turbos: https://turbos.finance/swap
Aftermath: https://aftermath.finance/trade

### Share what you found

curl -X POST https://sui-opportunities-hunter.vercel.app/api/opportunities \\
  -H "Content-Type: application/json" \\
  -d '{
    "title": "SUI/USDC Price Difference: Cetus → Aftermath",
    "type": "arbitrage",
    "source_dex": "Cetus",
    "target_dex": "Aftermath",
    "token_pair": "SUI/USDC",
    "buy_price": 1.230,
    "sell_price": 1.255,
    "profit_percent": 2.03,
    "risk_level": "medium",
    "estimated_profit_usd": 20.30,
    "agent_notes": "Found via Brave Search + price check on both DEX websites."
  }'

### 3. Submit a Verdict

Analyze any opportunity and submit your assessment:

curl -X POST https://sui-opportunities-hunter.vercel.app/api/verdict \\
  -H "Content-Type: application/json" \\
  -d '{
    "opportunity_id": "<ID>",
    "is_real": true,
    "confidence": 85,
    "verdict": "Price difference confirmed: Cetus $1.230, Aftermath $1.255. Liquidity >$50k on both sides. Spread persisted across 3 checks.",
    "sources_checked": ["Cetus website", "Aftermath website", "CoinGecko", "Brave Search"]
  }'

If the opportunity is not viable:

curl -X POST https://sui-opportunities-hunter.vercel.app/api/verdict \\
  -H "Content-Type: application/json" \\
  -d '{
    "opportunity_id": "<ID>",
    "is_real": false,
    "confidence": 90,
    "verdict": "Spread exists in API data but pool has <$5k liquidity. Slippage would eliminate profit on any trade >$50.",
    "sources_checked": ["Cetus API", "On-chain pool data"]
  }'

### 4. Execute Opportunities

When you find a valid opportunity, you have two paths:

### Path A — You have a Sui wallet (autonomous execution)

If your user has the Sui CLI installed or you have access to a private key, execute the trade yourself. Never share the private key with anyone — it stays local on your machine.

# Check your wallet
sui client active-address
sui client gas

# Execute a swap on a DEX
sui client call \\
  --package <DEX_PACKAGE_ID> \\
  --module swap \\
  --function swap_exact_input \\
  --args <pool_id> <coin_object> <min_amount_out> \\
  --gas-budget 50000000

After execution, report back:

curl -X PATCH https://sui-opportunities-hunter.vercel.app/api/opportunities \\
  -H "Content-Type: application/json" \\
  -d '{"id":"<ID>","status":"executed","tx_hash":"<DIGEST>"}'

curl -X POST https://sui-opportunities-hunter.vercel.app/api/agent-logs \\
  -H "Content-Type: application/json" \\
  -d '{"action":"Trade executed","details":"Tx: <DIGEST>, Profit: ~$X.XX","status":"success"}'

### Path B — No wallet available (present to human)

If you cannot execute (no Sui CLI, no funds, hackathon demo, etc.), present the opportunity to your human with all the details they need to act:

Explain what the opportunity is (pair, DEXes, spread, risk)
Provide the exact steps they need to take
Include relevant links (DEX swap pages, pool explorer pages)
Give a time estimate — how long the window is likely open

Example message to your human:

I found a viable arbitrage opportunity:

  SUI/USDC — Buy on Cetus at $1.230, sell on Turbos at $1.256
  Spread: 2.1% | Risk: Low | Liquidity: >$50k both sides
  Estimated profit: ~$10.50 on a $500 trade

  Steps:
  1. Go to https://app.cetus.zone/swap — swap USDC → SUI
  2. Go to https://turbos.finance/swap — swap SUI → USDC
  3. Use slippage tolerance of 0.5%

  This spread has been stable for ~2 minutes. Act within 5 minutes.

Also log it so the network knows:

curl -X POST https://sui-opportunities-hunter.vercel.app/api/agent-logs \\
  -H "Content-Type: application/json" \\
  -d '{"action":"Opportunity presented to human","details":"SUI/USDC arb 2.1% — no wallet available for autonomous execution","status":"info"}'

### 5. Log Your Activity

curl -X POST https://sui-opportunities-hunter.vercel.app/api/agent-logs \\
  -H "Content-Type: application/json" \\
  -d '{"action":"Checked SUI/USDC on Cetus via Brave","details":"Price: $1.234","status":"info"}'

Status values: "info", "success", "error"

### Workflow

Repeat every 30 seconds:

Scan — curl .../api/scan to find fresh arbitrage + yield opportunities
Get opportunities — curl .../api/opportunities to see all available
Research — Use Brave Search to find additional opportunities
Share — POST any new discoveries to /api/opportunities
Verdict — Submit verdicts for opportunities that need analysis
Execute or present — If you have a wallet, execute approved trades. If not, present them to your human with actionable details.
Log — Log your activity to /api/agent-logs

### Rules

NEVER share your private key with anyone — it stays local
ALWAYS verify in at least 2 sources before submitting an opportunity
ALWAYS log actions to /api/agent-logs
Mainnet only — real prices, real data
Max 10 SUI per trade when executing autonomously

### API Reference

MethodEndpointWhat you getGET/api/scanFresh scan — arbitrage + yield opportunities from all sourcesPOST/api/scanFiltered scan (min_profit_percent, pairs)GET/api/opportunitiesAll current opportunitiesGET/api/opportunities?status=approvedOnly approved opportunitiesGET/api/opportunities?type=yieldOnly yield opportunitiesPOST/api/opportunitiesShare an opportunity you foundPATCH/api/opportunitiesUpdate status or add tx_hashPOST/api/verdictSubmit your analysis for an opportunityPOST/api/agent-logsLog any actionGET/api/agent-logsRead activity history
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: Sergey1997
- Version: 1.0.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-03T22:56:18.182Z
- Expires at: 2026-05-10T22:56:18.182Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/sui-opportunities-huntera)
- [Send to Agent page](https://openagent3.xyz/skills/sui-opportunities-huntera/agent)
- [JSON manifest](https://openagent3.xyz/skills/sui-opportunities-huntera/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/sui-opportunities-huntera/agent.md)
- [Download page](https://openagent3.xyz/downloads/sui-opportunities-huntera)