Skip to main content

​
Overview

AIUSD provides two official skills for integrating trading capabilities into AI agents:

AIUSD Core

Structured CLI toolsYour agent’s LLM calls trading commands directly via MCP. You control the reasoning and orchestration.No platform inference cost.

AIUSD Pro

Managed AI agentDelegates to a backend agent that handles reasoning, tool selection, and multi-step execution.Natural language in, results out.

​
Which Should I Use?

CorePro
How it worksAgent calls CLI/MCP tools directlyMessages sent to managed backend agent
ReasoningClient-side (your agent’s LLM)Server-side (AIUSD backend)
InterfaceStructured commandsNatural language
Multi-step flowsAgent manages stateBackend maintains session context
Inference costNone — bring your own LLMIncluded
Best forDevelopers building custom agentsEnd users and turnkey integrations
Trade-offMore control, requires capable host agentEasier setup, less granular control
Not sure? Start with AIUSD Pro for the fastest setup. Switch to AIUSD Core when you need granular control over execution logic.

​
AIUSD Core

Structured CLI tools and MCP integration. Your agent invokes trading commands and handles orchestration.

​
Installation

npx skills add galpha-ai/aiusd-core -y -g

​
Authentication

# Browser login (recommended)
aiusd-core login --browser

# Create new account
aiusd-core login --new-wallet

# Switch accounts
aiusd-core logout
aiusd-core login --browser

​
CLI Usage

# Check balances
aiusd-core balances

# Get command reference for a domain
aiusd-core guide spot

# Execute trades
aiusd-core spot buy -b SOL -a 100
aiusd-core perp long --asset ETH --size 0.1 --leverage 10

​
Command Reference

DomainCommands
Accountaiusd-core balances, aiusd-core accounts, aiusd-core transactions, aiusd-core get-deposit-address
Spotaiusd-core spot buy -b SOL -a 100, aiusd-core spot sell -b ETH -a all
Perpetualsaiusd-core perp long --asset ETH --size 0.1 --leverage 10, aiusd-core perp close --asset ETH, aiusd-core perp deposit --amount 100, aiusd-core perp withdraw --amount 50
HyperLiquid Spotaiusd-core hl-spot buy --coin HYPE --amount 100, aiusd-core hl-spot sell --coin PURR --amount 50
Prediction Marketsaiusd-core pm buy --market "bitcoin-100k" --outcome Yes --amount 10, aiusd-core pm sell, aiusd-core pm positions, aiusd-core pm orders, aiusd-core pm search -q "election", aiusd-core pm cancel --order-id <id>
Monitoringaiusd-core monitor add --handle @elonmusk --budget 100, aiusd-core monitor list, aiusd-core monitor cancel --order-id <id>
Market Dataaiusd-core market hot-tokens
Stakingaiusd-core call genalpha_stake_aiusd -p '{"amount":"100"}', aiusd-core call genalpha_unstake_aiusd -p '{"amount":"50"}'
Run aiusd-core guide <domain> before executing commands to get the latest parameter reference. Source: github.com/galpha-ai/aiusd-core

​
AIUSD Pro

Natural language interface to a managed backend agent. Send messages in plain language — the agent handles reasoning, execution, and transaction confirmation.

​
Installation

npx skills add galpha-ai/aiusd-pro -y -g

​
Authentication

# Browser login (recommended)
aiusd-pro login --browser

# Create new account
aiusd-pro login --new-wallet

# Switch accounts
aiusd-pro logout
aiusd-pro login --browser

​
Usage

aiusd-pro send "What are my balances?"
aiusd-pro send "Buy $100 of SOL"
aiusd-pro send "Long ETH 10x with $500"

​
How It Works

You send a message
       ↓
Backend agent processes intent
       ↓
Agent streams response via WebSocket
       ↓
CLI auto-polls transaction status
       ↓
Session maintained for follow-ups
  1. Send — your message is posted to the AIUSD backend agent
  2. Reason — the agent selects tools, plans execution, and handles multi-step logic
  3. Execute — trades are placed and transactions confirmed automatically
  4. Respond — results stream back in natural language

​
What You Can Ask

DomainExamples
Spot Trading”Buy $100 of SOL”, “Sell all my ETH”, “Swap TRUMP for USDC”
Perpetuals”Long ETH 10x”, “Short BTC at $70k”, “Close my position”
Account”What’s my balance?”, “Show my deposit addresses”
Staking”Stake 500 AIUSD”, “Unstake my AIUSD”
Market Data”What’s trending?”, “Show xStock prices”

​
Session Management

aiusd-pro session new      # Start a new conversation
aiusd-pro session list     # List sessions
aiusd-pro session reset    # Reset current session
aiusd-pro cancel           # Cancel active operation
Source: github.com/galpha-ai/aiusd-pro

​
Supported Platforms

Both skills support the same platforms:
PlatformInstall
Claude Codenpx skills add or symlink to ~/.claude/skills/
Codexnpx skills add or symlink to ~/.codex/skills/
Cursornpx skills add or symlink to .cursor/skills/
OpenClaw.skill file or symlink to ~/.openclaw/skills/
GitHub CopilotSymlink to .github/skills/
Both skills require Node.js >= 18.0.0.

​
Security

Authentication tokens stored locally on your device in ~/.aiusd/. No credentials sent to third parties.
Token files written with restrictive permissions (0600). Wallet mnemonic stored separately.
All skill code is transparent and auditable on GitHub.

​
Troubleshooting

​
Authentication Issues

# Logout and re-login
aiusd-core logout              # or aiusd-pro logout
aiusd-core login --browser     # or aiusd-pro login --browser
If browser login fails, try creating a new account with --new-wallet.

​
Skill Not Loading

# Check installation
ls ~/.claude/skills/aiusd-core
ls ~/.claude/skills/aiusd-pro

# Reinstall
npx skills add galpha-ai/aiusd-core -y -g
npx skills add galpha-ai/aiusd-pro -y -g