> For the complete documentation index, see [llms.txt](https://katoshi.gitbook.io/katoshi-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://katoshi.gitbook.io/katoshi-docs/app/agents.md).

# Agents

This section documents the Agents page.

***

{% hint style="info" %}
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](/katoshi-docs/mcp/introduction.md) or check out the [n8n Integration](/katoshi-docs/integrations/n8n.md).
{% endhint %}

## 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 <mark style="color:green;">`Hyperagents`</mark>
* Agents have access to various tools, allowing them to complete complex workflow.&#x20;
* Agents can be called via API request, webhooks, or directly using the Chat Interface.

***

## What Can Agents Do?

* Use the Katoshi [Signal API](/katoshi-docs/api/signal-api.md) via our [MCP server](/katoshi-docs/mcp/introduction.md) to execute orders
* Use most of the [Hyperliquid Info API](https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint) 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 bands, ema, sma, atr, obv, vwap (we can support more indicators based on user requests.)

{% hint style="info" %}
You can ask your agent to use custom values for indicator settings.
{% endhint %}

> 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

<figure><img src="https://451313995-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMapKEK98qSAHMhn1eIRY%2Fuploads%2FCukOxM7wNzkC6Ve2LpqR%2Fimage.png?alt=media&amp;token=27afae72-1bcd-4ded-9a95-7e37f6b08402" alt=""><figcaption></figcaption></figure>

***

## Agent Chat

* A simple chat interface for sending messages to your agent

<figure><img src="https://451313995-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMapKEK98qSAHMhn1eIRY%2Fuploads%2FJDa2Gkyp2DUZSbOj6T95%2Fimage.png?alt=media&amp;token=c02bdaf0-8245-425d-bd6a-8b3a1a8368e4" alt=""><figcaption></figcaption></figure>

***

## Agent Settings

{% hint style="info" %}
Agent requires an OpenRouter API Key, please add one in the Settings page.
{% endhint %}

* **Name:** name of your agent
* **Bot:** linked bot your agent can control
* **Whitelisted Signal Tools:** specify which [signal actions](/katoshi-docs/api/signal-api.md) 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

<figure><img src="https://451313995-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FMapKEK98qSAHMhn1eIRY%2Fuploads%2FWnOPkaZce030zm7F78uL%2Fimage.png?alt=media&amp;token=a3f30c37-9a26-45ce-ae33-09def2ea1731" alt=""><figcaption></figcaption></figure>

***

## Agent API

Send messages to your agent via API calls or Webhooks

{% content-ref url="/pages/WGJJV5tg6pCIgkah2U2j" %}
[Agent API](/katoshi-docs/api/agent-api.md)
{% endcontent-ref %}