Build with X-Agent (xagent) × OKX

Hackathon — join us at xagt.ai/hackathon

Build the next X-Agent plugin and ship it to the marketplace. Past submissions live in submissions/. 6,000 USDT prize pool.

X-Agent (also searched as xagent or XAgent) is the AI agent builder, runtime, and marketplace at xagt.ai. This repository is the X-Agent plugin marketplace and OKX Agentic Wallet hackathon submission hub. It is not the OpenBMB/XAgent autonomous LLM research framework, the xorbitsai/xagent enterprise agent workforce repository, or the xagents.store tender procurement product.

One command. Browser opens, you log in (= registered), OKX skill suite installs into your agent (Cursor / Claude Code / OpenClaw). Go build.

npx @xagt/agent-plugin@latest setup --target all

Or install globally so you can run xagt-plugin <cmd> directly later:

npm i -g @xagt/agent-plugin
xagt-plugin setup --target all

Need to switch accounts later?

xagt-plugin logout
xagt-plugin login

Hackathon kicks off May 11, 2026. Node >= 18.17 required.

---

What you get out of the box

After login + install, your agent (Cursor / Claude Code / OpenClaw / any AgentSkills runtime) can:

• Swap tokens across 500+ DEXs on 20+ chains (XLayer, Solana, Ethereum, Base, BSC, Arbitrum, Polygon…)
• Read any wallet — balances, holdings, PnL, trade history
• Discover DeFi yield — APY, TVL, lend, borrow, stake, claim, CLMM positions
• Scan meme launches on pump.fun — dev rug history, bundle/sniper detection, bonding curve progress
• Track smart money — leaderboards, KOL trade feeds, aggregated whale signals
• Pre-flight transactions — token risk, honeypot detection, phishing dApp scan, signature safety
• Get live market data — prices, K-lines, OHLC, holder cluster analysis
• Route to specific dApps — Polymarket, Aave V3, Hyperliquid, PancakeSwap, Morpho

Verify you're set up:

xagt-plugin doctor

Prints session status, expiry, backend, and runtime versions.

How it fits together

                Your hackathon product
                 (TG bot / web / CLI / extension)
   ┌──────────────┼──────────────┐
   │              │              │
 X-Agent       OKX            Agent runtime
 identity       agentic        (Claude Code /
 (us)           wallet         Cursor / any)
                (OKX)          + OKX skills
   ↑              ↑              ↑
 hackathon     wallet ops      we ship them;
 registration  + signing       LLM auto-routes

Layer	Owned by	What it does	What you do
Identity	X-Agent (us)	Knows who the hacker is. Registers entries.	xagt-plugin login — once.
Wallet / writes	OKX agentic wallet	User signs, swaps, transfers, pays gas.	Have your end-users connect their OKX wallet.
Intelligence	Agent runtime + OKX skills	LLM matches "find me trending memes" → okx-dex-trenches etc.	Just chat; the runtime routes.
Product	You	UX, niche, business logic.	Code it.

A finished hackathon project uses all four layers. The first three are already wired — you build the fourth.

Product shapes that fit

• AI Trading Telegram Bot — user types "buy 100u BONK" in TG; X-Agent identity tags the user; OKX agentic wallet signs the swap; OKX skill executes the route.
• Smart Money Copy Trading dashboard — web UI, user connects OKX wallet, backend agent runs okx-dex-signal to watch KOL buys, auto-mirrors positions; X-Agent identity isolates per-user config.
• DeFi Onboarding Agent — user asks "where can I earn 8% on USDC?"; okx-defi-invest finds the protocol; OKX wallet does the deposit; X-Agent records strategy preference.
• Rug-proof Swap Frontend — every swap quote runs okx-security first; honeypots blocked; one-click execution via OKX wallet.
• Onchain News Desk — agent summarizes overnight smart-money signals into a 6 a.m. digest, posts to a hacker-defined channel.

Build something — open prompts

If you want a thinner spec to riff on:

1. "Show me the next 10x meme before it 10xs."
2. "Rebalance my portfolio when any LP APY drops below 6%."
3. "Buy any token the top 5 KOLs all bought in the last hour, max 5% slippage."
4. "Summarize what whales did overnight."
5. "Find me the cheapest gas route to bridge USDC from Base to Solana."

The agent does the on-chain work. You design the experience.

Five seed ideas — pick one or invent better:

1. Agent-native trading copilot — "buy $100 of any meme the top 10 KOLs bought in the last hour, max 5% slippage"
2. DeFi auto-rebalancer — agent watches your portfolio, proposes lending/staking moves when APY drifts
3. Rug-proof swap UI — every swap quote runs a security scan first, blocks honeypots automatically
4. Onchain news desk — agent that summarizes every smart-money buy signal into a 6am digest
5. Cross-chain arbitrage scout — finds price gaps the aggregator hasn't priced in yet

The agent does the on-chain work. You design the experience.

Eligibility

To qualify for judging, you must complete xagt-plugin setup --target all (or xagt-plugin login) so you have an X-Agent participant ID. Your submission file is named after that ID — judges only count submissions whose participant ID corresponds to a real X-Agent account.

Each participant ID owns one folder under projects/. Re-submitting overwrites the existing one (open a fresh PR to update before the deadline).

Required for a valid submission:

• ✅ Registered via xagt-plugin setup --target all (or xagt-plugin login)
• ✅ Project uses at least one OKX skill (DEX, wallet, DeFi, signal, market, security, dApp routing, etc.)
• ✅ A public GitHub repo with your source code
• ✅ A one-line description of what it does

Optional but encouraged:

• A deployed demo URL (web app / Telegram bot / hosted API / browser extension)
• A demo video / GIF embedded in your repo README

Submit

One command:

xagt-plugin submit

Asks you for:

  Project name:           AI Trading Telegram Bot
  One-line description:   TG bot that swaps via OKX wallet, gated by smart-money signals
  GitHub repo URL:        https://github.com/alice/ai-trading-bot
  Deployed URL (optional, blank to skip): https://t.me/my_trading_bot

Then your browser opens GitHub at the right URL with the submission file pre-filled. Click "Propose new file" → GitHub forks xerpa-ai/xagt-plugin to your account and opens the PR for you. Click "Create pull request" and you're done.

The file lands at projects/<your-participant-id>/README.md. Judges merge accepted submissions.

Or scripted (CI / Makefile):

xagt-plugin submit \
  --name "AI Trading Telegram Bot" \
  --intro "TG bot that swaps via OKX wallet, gated by smart-money signals" \
  --repo "https://github.com/alice/ai-trading-bot" \
  --deploy "https://t.me/my_trading_bot"

Lost your local credentials? Run xagt-plugin login again with the same X-Agent account — your participant ID stays stable, so your existing submission folder stays yours.

Get help

In-person at the venue. No Discord, no Telegram. Pull a mentor over.

---

Reference

Commands

xagt-plugin setup     [--target all|cursor|claude-code|generic] [--dry-run] [--no-browser] [--skip-substep]
                          # one-shot: registers + installs OKX skills
xagt-plugin submit    [--name <s>] [--intro <s>] [--repo <url>] [--deploy <url>]
                          # opens GitHub in browser to submit (requires login)
xagt-plugin login     [--no-browser]    # re-login or switch accounts
xagt-plugin logout                      # clear local credentials
xagt-plugin install   [--target ...]    # install skills only (no login)
xagt-plugin doctor                      # login + runtime status
xagt-plugin report    [--target ...]    # resend install report
xagt-plugin print-skill                 # print SKILL.md to stdout

Hackathon path: setup --target all → build → submit. Switch accounts with logout then login.

Targets

Target	Path
cursor	<workspace>/.cursor/skills/xagt-setup/
claude-code	~/.claude/skills/xagt-setup/
generic	~/.agents/skills/xagt-setup/ (AgentSkills, OpenClaw)
all	all of the above

Credentials at ~/.config/xagt/credentials.json (%APPDATA%\xagt\credentials.json on Windows), chmod 600.

Troubleshooting

Symptom	Fix
npx ... setup exits 0 with no output	You hit 0.1.0. Pin @latest or npx clear-npx-cache.
Browser opens but never returns	Frontend allowlist missing host. See docs/SETUP_FLOW.md.
EACCES writing to ~/.claude/skills/	Wrong user. Don't sudo.
command not found: xagt-plugin	Not globally installed. Run npm i -g @xagt/agent-plugin.

License: UNLICENSED — XerpaAI internal tooling, hackathon use granted.