AI Chat
Tools Reference
All 13 Kairu tools — what each one fetches and example questions that trigger it.
The AI assistant has access to 13 tools. They are called automatically based on your question — you never select them manually.
All data is fetched live at query time. Kairu never serves cached numbers to the AI.
Position & risk tools
| Tool | What it fetches | Example question |
|---|---|---|
get_position | Health factor, collateral assets, debt assets, supply/borrow APYs, available borrows, net APY | "What's my current position?" |
get_liquidation_info | Per-asset liquidation prices, price buffer percentages, net equity | "How close am I to liquidation?" |
analyze_e_mode | E-Mode eligibility, available categories, LTV/threshold improvements, estimated borrow uplift | "Should I enable E-Mode?" |
Market data tools
| Tool | What it fetches | Example question |
|---|---|---|
get_market_data | All reserve APYs, liquidity, utilization, borrow/supply caps | "What's the current USDC borrow rate?" |
get_reserve_details | Single reserve: risk parameters, caps, utilization, price oracle | "What are the WBTC risk parameters on Aave?" |
get_apy_history | Historical supply and borrow APY for a reserve (30/90 days) | "How has the ETH borrow rate changed over the past month?" |
Simulation tools
| Tool | What it fetches | Example question |
|---|---|---|
simulate | What-if position state after: deposit, withdraw, borrow, repay, price change, or swap-repay | "What if I deposit 1 WBTC?" |
The simulate tool supports six action types. For swap-repay, it fetches a live CowSwap quote for the collateral-to-debt conversion.
Portfolio tools
| Tool | What it fetches | Example question |
|---|---|---|
get_portfolio | Aggregated position across all wallets in a wallet group | "What's my total exposure across all my wallets?" |
simulate_portfolio | Batch simulation applied to all wallets in a group | "What if ETH drops 20% across all my positions?" |
Portfolio tools require a wallet group to be configured.
Rewards & GHO tools
| Tool | What it fetches | Example question |
|---|---|---|
get_rewards | Claimable Merit rewards per asset, USD value | "How much in rewards can I claim?" |
get_gho_position | GHO balance, sGHO balance, staking APY | "What's my GHO position?" |
Activity & signals tools
| Tool | What it fetches | Example question |
|---|---|---|
get_transaction_history | Recent Aave supply/borrow/repay/withdraw transactions | "Show my recent deposits" |
get_signals | Active market signals with type, severity, and context | "Are there any active funding rate signals?" |
Tool execution indicators
When a tool is running during a response, the chat shows a brief inline indicator. Once the tool completes, the result is incorporated into the response — you won't see raw JSON output, only the interpreted result.