# Agents

***

{% 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="/files/WUdcnbkFDpiIs3WeNViZ" alt=""><figcaption></figcaption></figure>

***

## Agent Chat

* A simple chat interface for sending messages to your agent

<figure><img src="/files/CI2rRFJeYENGL0t7sHLM" 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="/files/WZWGAFVgyIC83j9wbHmH" 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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://katoshi.gitbook.io/katoshi-docs/app/agents.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.