Liquidity Events by Pool Address

curl --request GET \
  --url https://pro-api.coingecko.com/api/v3/onchain/networks/{network}/pools/{pool_address}/liquidity_events \
  --header 'x-cg-pro-api-key: <api-key>'

{
  "data": [
    {
      "id": "solana_457611113_ya1EoX4PYj6vh3h5iVnqpXrs1K4tB2u1xsYadxU27kbKzGgfNihLgek1qSU68ws3o4VYsngpGFw4HNGqfbKaoVv_20_1792148006",
      "type": "liquidity_event",
      "attributes": {
        "block_number": 457611113,
        "tx_hash": "ya1EoX4PYj6vh3h5iVnqpXrs1K4tB2u1xsYadxU27kbKzGgfNihLgek1qSU68ws3o4VYsngpGFw4HNGqfbKaoVv",
        "tx_from_address": "8wUyLahcTw85GWGxsXWNgPF7DEbMPH45zpkjJnxPYrNP",
        "block_timestamp": "2026-10-16T10:53:26Z",
        "kind": "remove",
        "base_token_address": "3GP5xgK7cdSeWkgmcAh4vomARuDYoWi89saU3AKZnhKm",
        "base_token_amount": "131587980.65415",
        "quote_token_address": "So11111111111111111111111111111111111111112",
        "quote_token_amount": "187.258906",
        "base_token_price_in_usd": "0.0001417",
        "quote_token_price_in_usd": "106.496866",
        "volume_in_usd": "38593.231589"
      }
    }
  ],
  "meta": {
    "next_cursor": null
  }
}

GET

onchain

networks

{network}

pools

{pool_address}

liquidity_events

Liquidity Events by Pool Address

curl --request GET \
  --url https://pro-api.coingecko.com/api/v3/onchain/networks/{network}/pools/{pool_address}/liquidity_events \
  --header 'x-cg-pro-api-key: <api-key>'

{
  "data": [
    {
      "id": "solana_457611113_ya1EoX4PYj6vh3h5iVnqpXrs1K4tB2u1xsYadxU27kbKzGgfNihLgek1qSU68ws3o4VYsngpGFw4HNGqfbKaoVv_20_1792148006",
      "type": "liquidity_event",
      "attributes": {
        "block_number": 457611113,
        "tx_hash": "ya1EoX4PYj6vh3h5iVnqpXrs1K4tB2u1xsYadxU27kbKzGgfNihLgek1qSU68ws3o4VYsngpGFw4HNGqfbKaoVv",
        "tx_from_address": "8wUyLahcTw85GWGxsXWNgPF7DEbMPH45zpkjJnxPYrNP",
        "block_timestamp": "2026-10-16T10:53:26Z",
        "kind": "remove",
        "base_token_address": "3GP5xgK7cdSeWkgmcAh4vomARuDYoWi89saU3AKZnhKm",
        "base_token_amount": "131587980.65415",
        "quote_token_address": "So11111111111111111111111111111111111111112",
        "quote_token_amount": "187.258906",
        "base_token_price_in_usd": "0.0001417",
        "quote_token_price_in_usd": "106.496866",
        "volume_in_usd": "38593.231589"
      }
    }
  ],
  "meta": {
    "next_cursor": null
  }
}

Notes

Paginate with cursor rather than a page number:
- Pass meta.next_cursor back unchanged as cursor to fetch the next page.
- meta.next_cursor is null on the last page.
- An invalid or expired cursor returns 400 — restart pagination without cursor.
base_token_amount and quote_token_amount are always positive; kind carries the direction.
volume_in_usd is the combined USD value of both tokens in the event.

Supported networks

Chain	Network `id`	DEXes
Solana	`solana`	PumpSwap, Meteora DAMM v2

Pools on any other network or DEX return 400.
A pool on a supported DEX with no liquidity events returns 200 with an empty data array, not 404.

Event history is available from May 2026 onwards.

Authorizations

x-cg-pro-api-key

string

header

required

Learn how to set up your API key

Path Parameters

network

string

default:solana

required

Network ID. *refers to /onchain/networks.

pool_address

string

default:G9YxfMcZQiW7EmsU1Asxuomcm5iQrBDKpbozuTM2iwne

required

Pool contract address.

Query Parameters

kind

enum<string>

Filter by liquidity event kind, omit to return both. Available values: add, remove

Available options:

add,

remove

volume_in_usd_greater_than

number

Filter liquidity events by volume in USD greater than this value. Must be a positive number.

cursor

string

Cursor from the previous response, passed back unchanged to fetch the next page.

per_page

integer

Total results per page. Default value: 20 Valid values: 1...50

Response

200 - application/json

Liquidity events from a pool

data

object[]

required

Hide child attributes

data.id

string

required

Liquidity event identifier

data.type

string

required

Resource type

data.attributes

object

required

Hide child attributes

data.attributes.block_number

integer

required

Block number of the liquidity event

data.attributes.tx_hash

string

required

Transaction hash

data.attributes.tx_from_address

string

required

Transaction sender address

data.attributes.block_timestamp

string

required

Block timestamp

data.attributes.kind

enum<string>

required

Liquidity event kind (add or remove)

Available options:

add,

remove

data.attributes.base_token_address

string

required

Base token contract address

data.attributes.base_token_amount

string

required

Amount of base token added or removed

data.attributes.quote_token_address

string

required

Quote token contract address

data.attributes.quote_token_amount

string

required

Amount of quote token added or removed

data.attributes.base_token_price_in_usd

string

required

Price of base token in USD at the time of the event

data.attributes.quote_token_price_in_usd

string

required

Price of quote token in USD at the time of the event

data.attributes.volume_in_usd

string

required

Total value of the liquidity event in USD

CoinGecko API

Onchain API

Liquidity Events by Pool Address

Notes

Authorizations

Path Parameters

Query Parameters

Response

​Notes

Authorizations

Path Parameters

Query Parameters

Response

Notes