Get Account Transaction History

API Description

Retrieves account transaction history (deposits and withdrawals) for a specific address on a given chain. This endpoint provides detailed information about account deposit and withdrawal transactions including the amount, token information, transaction hash, and timestamp.

HTTP Request

GET /v4/public/mm/account/transaction-history

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)
page	uint32	No	Page number (default: 1)
size	uint32	No	Page size (default: 50, max: 100)
startTime	int64	No	Start time in Unix timestamp (seconds)
endTime	int64	No	End time in Unix timestamp (seconds)

Response Parameters

Parameter	Type	Description
list	array	Array of transaction records
-> id	string	Transaction record ID
-> tokenAddress	string	Token contract address
-> timestamp	number	Transaction timestamp (Unix timestamp in seconds)
-> value	string	Transaction amount (in token units)
-> valueUsd	string	Transaction amount in USD
-> txHash	string	Transaction hash on the blockchain
-> type	number	Transaction type (0: deposit, 1: withdraw)
-> typeString	string	Transaction type as string ("deposit", "withdraw")
-> tokenInfo	object	Token information
-> -> address	string	Token contract address
-> -> symbol	string	Token symbol (e.g., USDC, ETH)
-> -> decimals	number	Token decimal places
-> -> image	string	Token image URL
-> -> price	number	Current token price
totalCount	number	Total number of transaction records

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

Response Example

Success Response

{
    "data": {
        "list": [
            {
                "id": "1030037699739000002",
                "tokenAddress": "0x754704bc059f8c67012fed69bc8a327a5aafb603",
                "timestamp": 1763992667,
                "value": "10.176675",
                "valueUsd": "10.176675",
                "txHash": "0xd7735d803027f78c78a8108232ac1d1341a0b1c7e58a7d845db6eab794714c09",
                "type": 0,
                "tokenInfo": {
                    "address": "0x754704bc059f8c67012fed69bc8a327a5aafb603",
                    "symbol": "USDC",
                    "decimals": 6,
                    "image": "https://coin-images.coingecko.com/coins/images/6319/large/usdc.png?1696506694",
                    "price": 0.99989
                },
                "typeString": "deposit"
            },
            {
                "id": "1030037699481000091",
                "tokenAddress": "0x754704bc059f8c67012fed69bc8a327a5aafb603",
                "timestamp": 1763992563,
                "value": "75.201985",
                "valueUsd": "75.201985",
                "txHash": "0xecc1dcd3536d04ff9d08b141f0c113c2f4d569cc99169c5afd53969318edf28f",
                "type": 0,
                "tokenInfo": {
                    "address": "0x754704bc059f8c67012fed69bc8a327a5aafb603",
                    "symbol": "USDC",
                    "decimals": 6,
                    "image": "https://coin-images.coingecko.com/coins/images/6319/large/usdc.png?1696506694",
                    "price": 0.99989
                },
                "typeString": "deposit"
            }
        ],
        "totalCount": 2
    },
    "msg": "",
    "code": 0,
    "requestId": "f1af78ed-fc50-4ebb-9023-8987d703d189"
}

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)

• Both chainId and address parameters are required

• The address must be a valid EVM address format

• Returns account deposit and withdrawal transaction history for the specified address

• Supports pagination with page and size parameters

• Default page size is 50, maximum is 100

• type: 0 for deposit, 1 for withdraw

• typeString: "deposit" or "withdraw" as string

• timestamp: Unix timestamp in seconds

• value: Transaction amount in token units (consider decimals for actual amount)

• valueUsd: Transaction amount in USD

• tokenInfo: Contains token metadata including symbol, decimals, image, and current price

• totalCount: Total number of transaction records (useful for pagination)

• Optional startTime and endTime parameters can be used to filter transactions by time range

• Rate limit: 120 requests per minute

• Success response has code: 0 (not 200)