---
title: "Set Hooks"
method: POST
path: "/v1/hooks"
tags: ["hooks"]
---

# Set Hooks

`POST /v1/hooks`

## Request

- Base URL: `https://api.fereai.xyz`
- URL: `https://api.fereai.xyz/v1/hooks`
- Auth: none declared

Set stop-loss and/or take-profit hooks on a token.

## Request body

- HooksRequest
  - `chain_id` integer, required: Chain ID where the token is held.
  - `token_address` string, required: Token address to set hooks on.
  - `stop_loss` HookConfig
    - `price_percentage` number, required: Price percentage trigger (e.g., 0.3 for -30% stop-loss, 1.0 for +100% take-profit).
    - `sell_percentage` number, required: Fraction of holdings to sell when triggered (0.0 to 1.0, where 1.0 = sell all).
  - `take_profit` HookConfig
    - `price_percentage` number, required: Price percentage trigger (e.g., 0.3 for -30% stop-loss, 1.0 for +100% take-profit).
    - `sell_percentage` number, required: Fraction of holdings to sell when triggered (0.0 to 1.0, where 1.0 = sell all).

## Response `200`

Successful Response

- HooksResponse: Response from setting stop-loss / take-profit hooks.
  - `task_id` string, required: Task ID for tracking the hook setup.
  - `agent_id` string, required: Agent that owns the hooks.
  - `token_address` string, required: Token address the hooks are set on.
  - `hooks_registered` integer, required: Number of hooks registered.

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/fereai/apis/fereai-gateway.md) - [All operations](https://skmtc.dev/fereai/apis/fereai-gateway/llms.txt) - [OpenAPI document](https://skmtc.dev/fereai/apis/fereai-gateway/revisions/ad211f8e2f30?raw)