Agents

This section documents the Agents page.

---

Katoshi Agents is our in-house solution for building AI trading agents quickly without any coding hassle. If you want to use your own agent framework, head over the MCP Introduction or check out the n8n Integration.

About Agents

Katoshi Agents allow you to build smart AI agents that are linked to your Hyperliquid account or vault.

• Agents are built on top of our proprietary Agentic Framework Hyperagents

• Agents have access to various tools, allowing them to complete complex workflow.

• Agents can be called via API request or directly using the Chat Interface.

---

What Can Agents Do?

• Use the Katoshi Signal API via our MCP server to execute orders

• Use most of the Hyperliquid Info API endpoints to retrieve structured market and user account data

• Run technical analysis of any Hyperliquid chart using indicators and visual charts

  • Supported indicators: rsi, macd, bollinger, ema, atr, obv, vwap

Custom indicator periods can be requested for rsi, macd, bollinger, ema, atr

e.g. Hey agent, can you long HYPE with $100 if the 15m RSI is oversold?

---

Agent Creation

• Name: enter a name for your agent

• Bot: select which bot your agent can use

---

Agent Chat

• A simple chat interface for sending messages to your agent

---

Agent Tasks

• Tasks allow you to build pre-defined messages that can be sent to your agent via API requests

---

Agent Settings

Agent requires an OpenRouter API Key, please add one in the Settings page.

• Name: name of your agent

• Bot: linked bot your agent can control

• Whitelisted Signal Tools: specify which signal actions your agent is allowed to use (all trading actions are allowed if not specified)

• Model: LLM model of your agent

• System Prompt: custom system prompt (instructions) for your agent

---

Agent API

Send messages to your agent via API calls or Webhooks

Agent API