---
title: "Liquidity events"
method: GET
path: "/lp/events"
tags: ["Liquidity"]
---

# Liquidity events

`GET /lp/events`

## Request

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

Adds, removes and fee collects on one token, wallet or pool, newest first, each valued in dollars where the pool has an anchor side. One of `token`, `wallet` or `pool` is required.

## Query parameters

- `chain` 5042 | 4663 | 143, required
- `token` string: EVM address, hex, case-insensitive.
- `wallet` string: EVM address, hex, case-insensitive.
- `pool` string: A pool: a 20-byte contract address (V2 / V3) or a 32-byte Uniswap V4 pool id.
- `kind` 'add' | 'remove' | 'collect'
- `minUsd` number
- `limit` integer
- `offset` integer

## Response `200`

- object
  - `chain` integer
  - `events` LpEvent[]
    - `tx` string: Transaction hash.
    - `logIndex` integer
    - `pool` string: A pool: a 20-byte contract address (V2 / V3) or a 32-byte Uniswap V4 pool id.
    - `dex` string
    - `kind` 'add' | 'remove' | 'collect'
    - `wallet` string, nullable: EVM address, hex, case-insensitive.
    - `token` string: EVM address, hex, case-insensitive.
    - `tokenAmt` number
    - `anchor` string: EVM address, hex, case-insensitive.
    - `anchorAmt` number
    - `usd` number: Dollars that entered or left the pool.
    - `priced` boolean: False when the event could not be valued (no anchor side).
    - `tickLower` integer, nullable
    - `tickUpper` integer, nullable
    - `block` integer
    - `ts` integer: Unix time, seconds, UTC.
    - `manager` string, nullable: EVM address, hex, case-insensitive.
    - `tokenId` string, nullable: Position NFT id, for managed positions.
  - `limit` integer
  - `offset` integer
  - `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)