Get Liquidity Info

API Description

Retrieves active liquidity positions for a specific address on a given chain. This endpoint provides detailed information about all active liquidity positions including price ranges, liquidity amounts, entry prices, and last update information.

HTTP Request

GET /v4/public/mm/liquidity/list

Request Parameters

Parameter	Type	Required	Description
chainId	uint64	Yes	Chain ID (e.g., 143 for Monad mainnet)
address	string	Yes	Trader wallet address (EVM address format)

Response Parameters

Parameter	Type	Description
instrumentAddr	string	Contract address of the instrument
expiry	number	Expiry timestamp (4294967295 for perpetual)
tickLower	number	Lower tick of the price range
tickUpper	number	Upper tick of the price range
liquidity	string	Current liquidity amount
entryFeeIndex	string	Entry fee index for fee calculation
balance	string	Position balance
sqrtEntryPX96	string	Square root of entry price in Q96 format
rid	number	Range ID
lowerPrice	string	Lower price of the range
upperPrice	string	Upper price of the range
entryPrice	string	Entry price for the liquidity position
traderAddr	string	Trader wallet address
lastUpdateTime	number	Last update timestamp (Unix timestamp in seconds)
lastUpdateTxHash	string	Transaction hash of the last update
symbol	string	Trading pair symbol (e.g., MONUSDC)

Request Example

Python (requests)

Note: This endpoint requires API authentication. See Quick Start Guide for signature generation details.

import hmac
import hashlib
import base64
import json
import requests
from datetime import datetime, timezone
from urllib.parse import urlencode

def generate_mm_signature(secret_key, timestamp, method, request_path, body="", content_type=""):
    """Generate API signature"""
    message = timestamp + method.upper() + request_path
    if body and method.upper() in ["POST", "PUT", "PATCH"]:
        if content_type and "application/json" in content_type.lower():
            data = json.loads(body)
            body = json.dumps(data, sort_keys=True, separators=(',', ':'))
        message += body
    
    mac = hmac.new(
        secret_key.encode('utf-8'),
        message.encode('utf-8'),
        hashlib.sha256
    )
    return base64.b64encode(mac.digest()).decode('utf-8')

# Generate timestamp
timestamp = datetime.now(timezone.utc).isoformat(timespec='milliseconds').replace('+00:00', 'Z')

# Build request path with sorted query parameters
params = {
    'chainId': 143,
    'address': '0x9f8fc7d92e57631f932bcf4c3e4e573a104724b0'
}
# Sort parameters alphabetically for signature
sorted_params = sorted(params.items())
query_string = urlencode(sorted_params)
request_path = f"/v4/public/mm/liquidity/list?{query_string}"

# Generate signature
signature = generate_mm_signature(secret_key, timestamp, "GET", request_path)

# Make request
headers = {
    "X-ACCESS-KEY": api_key,
    "X-ACCESS-SIGN": signature,
    "X-ACCESS-TIMESTAMP": timestamp,
    "X-ACCESS-PASSPHRASE": passphrase,
}

url = f"https://api.monday.trade/v4/public/mm/liquidity/list?{urlencode(params)}"
response = requests.get(url, headers=headers)
result = response.json()
print(json.dumps(result, indent=2))

Response Example

Success Response

{
    "data": [
        {
            "instrumentAddr": "0x8c5243a6a4c6c7a82d954c8ff29e0611e25ac33e",
            "expiry": 4294967295,
            "tickLower": -39650,
            "tickUpper": -33200,
            "liquidity": "362398252300144314644",
            "entryFeeIndex": "230053433773088",
            "balance": "3000000000000000000",
            "sqrtEntryPX96": "12822666118178814831805157257",
            "rid": 280809776840272,
            "lowerPrice": "18971797147738844",
            "upperPrice": "36158833222131123",
            "entryPrice": "26193739293945400",
            "traderAddr": "0x9f8fc7d92e57631f932bcf4c3e4e573a104724b0",
            "lastUpdateTime": 1765471933,
            "lastUpdateTxHash": "0xd396e90064503c0e16119d035c103ca51e1e4ab0bf65772d184da4a947c4912e",
            "symbol": "MONUSDC"
        }
    ],
    "msg": "",
    "code": 0,
    "requestId": "bd83735b-a45a-4f9a-9a73-76a26230ba10"
}

Error Response

{
    "code": 400,
    "msg": "Request parameter error",
    "data": {},
    "requestId": "bd83735b-a45a-4f9a-9a73-76a26230ba10"
}

Notes

• This endpoint requires API authentication (see Quick Start Guide)

• Both chainId and address parameters are required

• The address must be a valid EVM address format

• Returns all active liquidity positions for the specified address

• Only returns positions that currently have liquidity (non-zero liquidity)

• tickLower and tickUpper: Tick values defining the price range

• lowerPrice and upperPrice: Actual price values for the liquidity range

• entryPrice: Price at which the liquidity position was entered

• liquidity: Current liquidity amount in the position

• balance: Position balance

• entryFeeIndex: Used for calculating fees earned from the position

• sqrtEntryPX96: Square root of entry price in Q96 fixed-point format (used for internal calculations)

• rid: Unique range ID for this liquidity position

• expiry: 4294967295 indicates a perpetual contract

• lastUpdateTime: Unix timestamp in seconds of the last update to this position

• lastUpdateTxHash: Transaction hash of the last update

• symbol: Trading pair symbol (e.g., MONUSDC for MON/USDC)

• Rate limit: 120 requests per minute

• Success response has code: 0 (not 200)