Skip to content
ChordChordChord Docs

Watch state and alert inbox

GET
/lp/watch
curl --request GET \
  --url 'https://api.getchord.xyz/v1/lp/watch?chain=5042&wallet=example'

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.

Parameters

Section titled “ Parameters ”

Query Parameters

Section titled “Query Parameters”
chain
required
integer
Allowed values: 5042 4663 143

Chain id: 5042 Arc · 4663 Robinhood Chain · 143 Monad.

wallet
required

EVM address, hex, case-insensitive.

string
/^0x[a-fA-F0-9]{40}$/

Responses

Section titled “ Responses ”

200

Section titled “200”
Media typeapplication/json
object
chain
integer
wallet

EVM address, hex, case-insensitive.

string
/^0x[a-fA-F0-9]{40}$/
watched
boolean
telegramChats
integer
feeBarUsd

Alert when uncollected fees pass this.

number
drainPct

Alert when a pool loses this share of its liquidity.

number
telegramBot

Bot username for the deep link.

string | null
alerts
Array<object>
object
kind
required
string
chain
required
integer
wallet
required

EVM address, hex, case-insensitive.

string
/^0x[a-fA-F0-9]{40}$/
manager

EVM address, hex, case-insensitive.

string
/^0x[a-fA-F0-9]{40}$/
tokenId
string
pool

A pool: a 20-byte contract address (V2 / V3) or a 32-byte Uniswap V4 pool id.

string | null
/^0x([a-fA-F0-9]{40}|[a-fA-F0-9]{64})$/
token

EVM address, hex, case-insensitive.

string | null
/^0x[a-fA-F0-9]{40}$/
symbol
string | null
text
required
string
usd
number | null
ts
required

Unix time, seconds, UTC.

integer
href

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.

string | null
pools
Array<string>
marks

Take-profit / stop-loss marks by <manager>:<tokenId>.

object
key
additional properties
object
tpPct

Take-profit: PnL in percent of the dollars that went in, above 0.

number | null
slPct

Stop-loss: the same, between -100 and 0.

number | null
at

Unix time, seconds, UTC.

integer
unit

Present, and native, when the percent is counted in the chain’s own coin; absent = in dollars.

string
Allowed values: native
following
Array<string>
updatedAt

Unix time, milliseconds — when the server built this answer.

integer
Example
{
  "marks": {
    "additionalProperty": {
      "unit": "native"
    }
  }
}

400

Section titled “400”

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

Media typeapplication/json

Every non-2xx body.

object
error
required

Stable machine code, e.g. INVALID_PARAMS, NOT_READY, RATE_LIMIT_EXCEEDED.

string
message

For humans.

string
statusCode

HTTP status, when included.

integer
Example
{
  "error": "INVALID_PARAMS",
  "message": "amount must be an integer string in the token's smallest unit"
}