Get Message List

tip

Rate limit:

• Global: 100 QPS
• Per User: 10 requests/second

Data within the last 3 months only;

HTTP Request

POST /v5/p2p/chat/message/listpage

Request Parameters

Parameter	Required	Type	Comments
lastId	false	int	ID of the last message on the previous page (descending order); pass 0 to start from the latest
limit	true	int	Page size, maximum 30
sessionId	true	string	Session ID

Response Parameters

Parameter	Type	Comments
messages	array	List of chat messages
> id	string	Message ID
> sendUserNickName	string	Sender nickname
> contentType	string	Message content type. str for text, pic for image, pdf for pdf, video for videos
> message	string	Message payload as a JSON-encoded string. See a breakdown below
>> content	string	For str, text content. For pic, pdf, or video, it is an URL
>> msgType	integer	Message type code
>> fileName	string	File name. Empty for text messages
> createDate	string	Message creation timestamp in milliseconds

Request Example

HTTP

POST /v5/p2p/chat/message/listpage HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN: XXXXX
X-BAPI-API-KEY: xxxxxxxxxxxxxxxxxx
X-BAPI-TIMESTAMP: 1675866354698
X-BAPI-RECV-WINDOW: 5000
Content-Type: application/json

{
    "limit": 2,
    "sessionId": "rl8BAkdDTQDgSTg+FGrPjr6Vc06F1TWGGU7rg1oLqPDKtM0VNXvL1I7Oo1aPYKKWVbnEEZRclyY+/w=="
}

Python

from bybit_p2p import P2P
api = P2P(
    testnet=True,
    api_key="xxxxxxxxxxxxxxxxxx",
    api_secret="xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
)
print(api.get_message_list(
    sessionId="rl8BAkdDTQDgSTg+FGrPjr6Vc06F1TWGGU7rg1oLqPDKtM0VNXvL1I7Oo1aPYKKWVbnEEZRclyY+/w==",
    limit=2
))

Response Example

{
  "ret_code": 0,
  "ret_msg": "SUCCESS",
  "result": {
    "messages": [
      {
        "id": "3004232936",
        "sendUserNickName": "kolya",
        "contentType": "str",
        "message": "{\"content\":\"hello world by kolya\",\"msgType\":301,\"fileName\":\"\"}",
        "createDate": "1773867363932"
      },
      {
        "id": "3004232935",
        "sendUserNickName": "kolya",
        "contentType": "pic",
        "message": "{\"content\":\"/fiat/p2p/oss/showObj/otc/9001/100571889c0KzUhd1Zw0ytzlu69b2KZn_po8SpHm9x7qtW4h36yY.png?e=1773878266&token=9ElO6c92Gg5gEJPsnUE7vZoSPnO9ivlwEOLJNVuKIB0=&salt=bb32b0e50a5f4fff9a96c1a0843f6208\",\"msgType\":302,\"fileName\":\"grub.png\"}",
        "createDate": "1773866621818"
      }
    ]
  },
  "ext_code": "",
  "ext_info": {},
  "time_now": "1773867466.080287"
}