Skip to content
ChordChordChord Docs

Follow a liquidity provider

POST
/lp/watch/follow
curl --request POST \
  --url https://api.getchord.xyz/v1/lp/watch/follow \
  --header 'Content-Type: application/json' \
  --data '{ "chain": 4663, "wallet": "0xb145400da27a2497d9fc2cd5621f2bfd37617af4", "target": "0x5b0dbd62f7639bef7a1ae1c4ff9408105946a9b9", "on": true }'

Alerts for wallet when target opens or closes a position, from now on (a follow does not replay the wallet’s past). An “opened” alert links to the same pool with the same range; nothing is copied for the wallet. At most 10 followed wallets.

Request Bodyrequired

Section titled “Request Bodyrequired”
Media typeapplication/json
object
chain
required
integer
Allowed values: 5042 4663 143
wallet
required

EVM address, hex, case-insensitive.

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

EVM address, hex, case-insensitive.

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

False = stop following. Default true.

boolean
Example
{
  "chain": 4663,
  "wallet": "0xb145400da27a2497d9fc2cd5621f2bfd37617af4",
  "target": "0x5b0dbd62f7639bef7a1ae1c4ff9408105946a9b9",
  "on": true
}

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}$/
following
Array<string>
Examplegenerated
{
  "chain": 1,
  "wallet": "example",
  "following": [
    "example"
  ]
}

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"
}