Pool Liquidity Event

Retrieve the liquidity history (join/exit events) of a specific liquidity pool, with pagination support.

---

Endpoint

GET /api/v1/partner/pool/event/liquidity

---

Request Parameters

Name	Type	Required	Description
pool_address	string	Yes	The address of the liquidity pool.
action	string	No	Filter by action: join or exit.
limit	int	No	Number of records to return (default: 20, max: see backend config).
desc	bool	No	Fetch order: true for descending (default), false for ascending.
cursor	int64	No	Cursor for pagination (must be used with timestamp).
timestamp	int64	No	Timestamp for pagination (must be used with cursor).

• If desc=false, both cursor and timestamp must be provided.

• If desc=true, both cursor and timestamp can be omitted for the first page.

• If action is omitted, all actions are returned.

Note:

• If you want to fetch the latest events, you can omit both cursor and timestamp, just provide pool_address and limit.

• If you want to fetch the next page, you must provide both cursor and timestamp.

• If you want to fetch the previous page, you must provide both cursor and timestamp with desc=false.

---

Headers

Header	Required	Description
x-api-key	No	API key for authorization.

---

cURL Example

curl --location 'https://api.noodles.fi/api/v1/partner/pool/event/liquidity?pool_address=0x682f4b17874ec47723bb527cf21e18b630eba0699d10781740cd0a7964dc6b19&cursor=865526449&timestamp=1748401534150' \
--header 'x-api-key: YOUR_API_KEY'

---

Response

Fields

Field	Type	Nullable	Description
code	number	No	HTTP status code (200 for success).
message	string	No	Status message.
data	array	No	Array of liquidity history objects.
pagination	object	No	Pagination info for next page.

Liquidity History Object

Field	Type	Nullable	Description
id	int64	No	Unique event ID.
timestamp	int64	No	Event timestamp (ms since epoch).
action	string	No	Event type: join or exit.
pool_address	string	No	Pool address.
coin_a_type	string	No	Coin A type.
coin_b_type	string	No	Coin B type.
coin_a_symbol	string	No	Coin A symbol.
coin_b_symbol	string	No	Coin B symbol.
amount_a	float	No	Amount of coin A.
amount_b	float	No	Amount of coin B.
tx_digest	string	No	Transaction digest.
sender	string	No	Sender address.

Pagination Object

Field	Type	Nullable	Description
last_cursor	int64	Yes	Cursor for next page.
last_timestamp	int64	Yes	Timestamp for next page.
limit	int64	Yes	Page size.

Success Response

{
    "code": 200,
    "message": "OK",
    "data": [
        {
            "id": 148000398,
            "timestamp": 1748388384263,
            "action": "join",
            "pool_address": "0x682f4b17874ec47723bb527cf21e18b630eba0699d10781740cd0a7964dc6b19",
            "coin_a_type": "0xe1b45a0e641b9955a20aa0ad1c1f4ad86aad8afb07296d4085e349a50e90bdca::blue::BLUE",
            "coin_b_type": "0xdba34672e30cb065b1f93e3ab55318768fd6fef66c15942c9f7cb846e2f900e7::usdc::USDC",
            "coin_a_symbol": "BLUE",
            "coin_b_symbol": "USDC",
            "amount_a": 0,
            "amount_b": 14365.010042,
            "tx_digest": "EFbNBD1G7PHarq1i9YQj4Dgu4cMqDZubTeUJtKT8iPaM",
            "sender": "266e250ee6c71ec6883b282fa986a6a18f96131952f93fb4addcafe530a3396f"
        },
        {
            "id": 148000274,
            "timestamp": 1748388208314,
            "action": "join",
            "pool_address": "0x682f4b17874ec47723bb527cf21e18b630eba0699d10781740cd0a7964dc6b19",
            "coin_a_type": "0xe1b45a0e641b9955a20aa0ad1c1f4ad86aad8afb07296d4085e349a50e90bdca::blue::BLUE",
            "coin_b_type": "0xdba34672e30cb065b1f93e3ab55318768fd6fef66c15942c9f7cb846e2f900e7::usdc::USDC",
            "coin_a_symbol": "BLUE",
            "coin_b_symbol": "USDC",
            "amount_a": 2730370.730181823,
            "amount_b": 497692.275162,
            "tx_digest": "NFVFknbZyLNC9gAbWDhpQfhNXWbHtFqW28nJ9eTY1BE",
            "sender": "b2e6286dad58b03231709402a3094a10886dd22ffb3751e7b59e709f5df77492"
        },
    ],
    "message": "OK",
    "pagination": {
        "last_cursor": 147807480,
        "last_timestamp": 1748184968134,
        "limit": 20
    }
}

Response when no data is available

{
    "code": 200,
    "message": "OK",
    "data": [],
    "pagination": {
        "last_cursor": null,
        "last_timestamp": null,
        "limit": 10
    }
}

---

See also: Environment Setup