AIUSD Core#

AIUSD Core is a unified trading toolkit that lets agents trade across venues, manage perpetual futures, access prediction markets, earn yield by staking, and manage funds — all through a single CLI.

CLI entry point#

All commands in this skill use npx -y aiusd-core as the CLI prefix. This works without any global installation — npx resolves the package from npm automatically.

If aiusd-core is already in PATH (via npm install -g aiusd-core), you may use aiusd-core directly instead.

NEVER use dist/cli.js — it is a library module, not an entry point.

When to use this skill#

Trigger this skill when the user wants to:

• Trade — buy, sell, or swap any asset across supported venues
• Perpetual futures — long, short, or close positions with leverage, TP/SL
• Prediction markets — trade on event outcomes, search markets, manage positions
• Account & funds — check balances, deposit, withdraw, stake AIUSD for yield
• Market intelligence — trending assets, price feeds, holder analysis
• Automated trading — monitor signals, set conditional execution rules

Authentication#

When a user wants to get started or is not yet logged in, present 2 options:

1. Create new account — set up a fresh wallet
2. Browser login — sign in with an existing account via browser

Map the user's choice to the corresponding CLI flag:

• Create new account → npx -y aiusd-core login --new-wallet. The CLI creates a wallet, authenticates, and prints a JSON auth_event with the wallet address.

• Browser login → two-step flow:

  1. Run npx -y aiusd-core login --browser. The CLI prints a JSON with url and session_id, then exits immediately. Send the url to the user — NEVER fabricate or guess it.
  2. After sending the URL, run npx -y aiusd-core login --poll-session <session_id>. This blocks until the user signs in, then saves the token and exits with "Login successful".

• Restore from backup → npx -y aiusd-core login --restore <path>. Only use when the user explicitly asks to restore from a mnemonic file.

CommandDescriptionnpx -y aiusd-core login --new-walletCreate new wallet and authenticatenpx -y aiusd-core login --browserPrint browser login URL and exitnpx -y aiusd-core login --poll-session <id>Wait for browser sign-in to completenpx -y aiusd-core login --restore <path>Restore from mnemonic backup filenpx -y aiusd-core loginInteractive prompt (fallback for manual use)npx -y aiusd-core logoutSign out and remove stored token

To switch account: npx -y aiusd-core logout, then npx -y aiusd-core login --browser (or --new-wallet).

Capabilities#

Before executing commands in a domain, run npx -y aiusd-core guide <domain> to get the latest commands, parameters, and workflows. Follow the guide exactly.

DomainWhat it coversTrigger phrasesGuideaccountBalances, deposit addresses, transaction history, staking, withdrawals, gas top-up"balance", "deposit", "withdraw", "stake", "transactions", "how much do I have"npx -y aiusd-core guide accountspotBuy/sell/swap any asset on supported venues"buy SOL", "sell ETH", "swap TRUMP", "trade", "convert AIUSD to USDC"npx -y aiusd-core guide spotperpPerpetual futures — long, short, close, deposit/withdraw, orderbook, trade history"long ETH", "short BTC", "close position", "leverage", "futures", "perps"npx -y aiusd-core guide perphl-spotHyperLiquid spot trading — buy/sell on HL spot market"buy HYPE", "HL spot", "HyperLiquid spot"npx -y aiusd-core guide hl-spotpredictionPolymarket — search markets, buy/sell shares, manage orders and positions"bet on", "prediction", "Polymarket", "will X happen", "election odds"npx -y aiusd-core guide predictionmonitorWatch signals for trade execution, set conditional auto-buy orders"monitor @elonmusk", "watch account", "auto-buy", "conditional order"npx -y aiusd-core guide monitormarketTrending assets, price feeds, holder analysis"trending", "hot tokens", "market data", "stock prices", "holders"npx -y aiusd-core guide market

Fallback: if npx -y aiusd-core guide is unreachable, refer to static files in skills/ directory.

Domain Knowledge#

AIUSD is not a token#

AIUSD is a centralized balance pegged 1:1 to USDT. It is not a tradeable token — there is no contract address or on-chain balance to query. AIUSD can be used to trade any asset on supported venues. The conversion path is handled internally by the CLI; do not attempt to orchestrate it manually.

Always guide before operate#

Do not guess command syntax or parameters from memory. Before executing commands in any domain, run npx -y aiusd-core guide <domain> to get the current reference. Guides may change between CLI versions.

Asset names can be ambiguous#

The same asset symbol may exist on multiple venues. When the user's intent is ambiguous, ask which venue before executing. If the user has a clear preference from context (e.g., "buy SOL" implies Solana), proceed without asking.

Follow next_steps, don't re-confirm#

When a command returns action_required with next_steps, execute those steps directly. The user has already confirmed the intent — do not ask again unless the next step involves a different action than what was originally requested.

Rules#

1. Always confirm trades with the user before executing.
2. Never expose internal details (JSON responses, tool names, file paths) to users.
3. Present results in clear, conversational language.