Get Position Info

API Description

Retrieves current position information for a specific trader address. This endpoint provides detailed data about open positions including size, entry price, balance, and funding information. Only positions with non-zero size are returned.

HTTP Request

GET /v4/public/mm/position/list

Request Parameters

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

Response Parameters

Parameter	Type	Description
balance	string	Position balance (in wei/smallest unit)
size	string	Position size (positive for long, negative for short)
entryNotional	string	Total entry notional value
entrySocialLossIndex	string	Entry social loss index
entryFundingIndex	string	Entry funding index
side	uint32	Position side (0 = LONG, 1 = SHORT)
entryPrice	string	Average entry price (in wei/smallest unit)
lastUpdateTime	uint64	Last update timestamp (Unix timestamp in seconds)
lastUpdateTxHash	string	Transaction hash of last update
instrumentAddr	string	Instrument contract address
expiry	uint32	Expiry timestamp (4294967295 for perpetual)
symbol	string	Trading pair symbol (e.g., BTCUSDC)

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': '0x8bcef483f1c9226c192430b8f5191ee801601480'
}
# Sort parameters alphabetically for signature
sorted_params = sorted(params.items())
query_string = urlencode(sorted_params)
request_path = f"/v4/public/mm/position/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/position/list?{urlencode(params)}"
response = requests.get(url, headers=headers)
result = response.json()
print(json.dumps(result, indent=2))

Response Example

Success Response

{
    "data": [
        {
            "balance": "46083772825603941851",
            "size": "-3846140783074555",
            "entryNotional": "356176398389846893215",
            "entrySocialLossIndex": "0",
            "entryFundingIndex": "-6235458388299695385920",
            "side": 1,
            "entryPrice": "92606178109040539405050",
            "lastUpdateTime": 1765712212,
            "lastUpdateTxHash": "0xbb279c9171b6e423c44b2ff95016349e0f460b33d4bb3f014e8893b4d7a376a9",
            "instrumentAddr": "0x73ada1ea346cc3908f41cf67a040f0acd7808be0",
            "expiry": 4294967295,
            "symbol": "BTCUSDC"
        }
    ],
    "msg": "",
    "code": 0,
    "requestId": "c01900a4-29a8-498b-a8bd-63e7c3d9eeb4"
}

Error Response

{
    "code": 400,
    "msg": "Request parameter error",
    "data": {},
    "requestId": "bbf4fa1a-0f41-449f-8d9c-44fdceae0bf7"
}

Notes

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

• Required parameters: chainId, address

• Response format: Returns an array of position objects

• Position filtering: Only positions with non-zero size are returned

• Position side:

  • side: 0 = LONG position

  • side: 1 = SHORT position

• Position size:

  • Positive value = LONG position

  • Negative value = SHORT position

• Price and size format: All values are returned as strings in wei/smallest unit format to preserve precision

• Entry indices:

  • entrySocialLossIndex: Social loss index at entry time

  • entryFundingIndex: Funding index at entry time (used for funding fee calculations)

• Expiry: 4294967295 indicates a perpetual contract

• Time fields: lastUpdateTime is a Unix timestamp in seconds (not milliseconds)

• Transaction hash: lastUpdateTxHash is the transaction hash of the last position update

• Balance: Current position balance (collateral)

• Entry price: Average entry price for the position

• Entry notional: Total notional value at entry

• Rate limit: 120 requests per minute

• Success response has code: 0 (not 200)