# Liquidity flow for a token

`GET https://api.getchord.xyz/v1/lp/token/{address}`

Source: https://getchord.xyz/docs/api-reference/operations/lptoken/

Adds, removes and net dollars over the window, one-sided (token-only) events counted but not valued, just-in-time liquidity (same-transaction add and remove) called out so the totals read right, the top providers and the pools by net flow.

## Parameters

| Name | In | Required | Type | Description |
| --- | --- | --- | --- | --- |
| `address` | path | yes | string |  |
| `chain` | query | yes | `5042` · `4663` · `143` | Chain id: `5042` Arc · `4663` Robinhood Chain · `143` Monad. |
| `hours` | query | no | integer (default `24`) |  |

## Response 200

Example (captured from the live API):

```json
{
  "chain": 5042,
  "token": "0x171a4217b86a807a64eb94757db6849fb4bdbaa0",
  "hours": 24,
  "adds": 200,
  "addUsd": 274228.1437317083,
  "removes": 176,
  "removeUsd": 2291418.4063887238,
  "netUsd": -2017190.2626570156,
  "tokenOnlyAdds": 5,
  "tokenOnlyRemoves": 30,
  "jitTxs": 18,
  "jitUsd": 39153.40135616365,
  "providers": 51,
  "top": [
    {
      "wallet": "0xa77401a1640e4f090fd5d08b7350b59d6a99b0fd",
      "netUsd": -2064877.6495731266,
      "addedUsd": 0,
      "removedUsd": 2063818.8216671266,
      "events": 2,
      "lastTs": 1789845091
    },
    {
      "wallet": "0x08d0d1d9d58675fea6e36670d85a9e8dad89f465",
      "netUsd": 21439.05777238525,
      "addedUsd": 21439.05777238525,
      "removedUsd": 0,
      "events": 1,
      "lastTs": 1789817213
    }
  ],
  "pools": [
    {
      "pool": "0x82916bee18fcef517b26c72d7cb5f13694e1db41",
      "dex": "uniswap_v3",
      "netUsd": -2065710.8817895816,
      "events": 88
    },
    {
      "pool": "0xd945caee4635bcd7fb8a9fa74dc1d0c4c1472782",
      "dex": "slipstream_fork",
      "netUsd": 44581.441725988414,
      "events": 282
    }
  ],
  "updatedAt": 1789891863259
}
```

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