---
title: "Watch state and alert inbox"
method: GET
path: "/lp/watch"
tags: ["Liquidity"]
---

# Watch state and alert inbox

`GET /lp/watch`

## Request

- Base URL: `https://api.getchord.xyz/v1`
- URL: `https://api.getchord.xyz/v1/lp/watch`
- Auth: none declared

Whether the wallet's positions are watched, how many Telegram chats receive its alerts, the alert thresholds, the last alerts, and the pools on its watchlist.

## Query parameters

- `chain` 5042 | 4663 | 143, required
- `wallet` string, required: EVM address, hex, case-insensitive.

## Response `200`

- object
  - `chain` integer
  - `wallet` string: EVM address, hex, case-insensitive.
  - `watched` boolean
  - `telegramChats` integer
  - `feeBarUsd` number: Alert when uncollected fees pass this.
  - `drainPct` number: Alert when a pool loses this share of its liquidity.
  - `telegramBot` string, nullable: Bot username for the deep link.
  - `alerts` object[]
    - `kind` string, required
    - `chain` integer, required
    - `wallet` string, required: EVM address, hex, case-insensitive.
    - `manager` string: EVM address, hex, case-insensitive.
    - `tokenId` string
    - `pool` string, nullable: A pool: a 20-byte contract address (V2 / V3) or a 32-byte Uniswap V4 pool id.
    - `token` string, nullable: EVM address, hex, case-insensitive.
    - `symbol` string, nullable
    - `text` string, required
    - `usd` number, nullable
    - `ts` integer, required: Unix time, seconds, UTC.
    - `href` string, nullable: Where the wallet's owner acts on the alert: the position's page for a mark, the pool with the same range for a followed wallet's new position.
  - `pools` string[]
  - `marks` object: Take-profit / stop-loss marks by `<manager>:<tokenId>`.
  - `following` string[]
  - `updatedAt` integer: Unix time, milliseconds — when the server built this answer.

## Other responses

- `400`: Invalid parameters — `error` names the check that failed (`INVALID_PARAMS`, `BAD_ADDRESS`, `BAD_LIMIT`, `BAD_HOURS`, …).

---

[API](https://skmtc.dev/getchord/apis/chord-api.md) · [All operations](https://skmtc.dev/getchord/apis/chord-api/llms.txt) · [OpenAPI document](https://skmtc.dev/getchord/apis/chord-api/revisions/d3bc4640fea0?raw)