Skip to main content

Get Counterparty User Info

HTTP Request

POST /v5/p2p/user/order/personal/info

Request Parameters

ParameterRequiredTypeComments
originalUidstringCounterparty User ID
orderIdstringOrder ID

Response Parameters

ParameterTypeComments
nickNamestringUser's nickname
defaultNickNamebooleanWhether the user's nickname is a default nickname generated by the system. true: The user's nickname is a default nickname generated by the system. false: User nickname is set by the user
isOnlinebooleanWhether the user is online on the bybit site true: the user is online false: the user is offline
kycLevelintegerkyc level
emailstringEmail address (masked)
mobilestringMobile phone number (mask)
lastLogoutTimestringLast logout time from bybit platform
recentRateintegerCompletion rate in the past 30 days
totalFinishCountintegerTotal number of completed orders
totalFinishSellCountintegerTotal number of completed orders - sell token
totalFinishBuyCountintegerTotal number of completed orders - buy token
recentFinishCountintegerOrder quantity within 30 days
averageReleaseTimestringAverage release token time. unit is minute
averageTransferTimestringAverage payment currency time. unit is minute
accountCreateDaysintegerDays since the account was created
firstTradeDaysintegerDays from first transaction to today
realNamestringReal name
recentTradeAmountstringCumulative successful transaction amount USDT in the past 30 days
totalTradeAmountstringThe sum of all USDT transaction volumes in the past for the account
registerTimestringUser's registration time
authStatusintegerVA status 1 - VA 2 - Not VA
kycCountryCodestringUser's KYC country code
blockedstringUser's banned status
goodAppraiseRatestringPositive rating
goodAppraiseCountintegernumber of positive comments
badAppraiseCountintegernumber of negative comments
vipLevelintegerVIP level
userIdstringUserId
realNameEnstringKYC in English

Request Example

POST /v5/p2p/user/order/personal/info HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN: XXXXXX
X-BAPI-API-KEY: XXXXXX
X-BAPI-TIMESTAMP: 1741831548391
X-BAPI-RECV-WINDOW: 5000
Content-Type: application/json
Referer: wuliang
Content-Length: 66

{
"originalUid": "290118",
"orderId": "1900004704665923584"
}

Response Example

{
"ret_code": 0,
"ret_msg": "SUCCESS",
"result": {
"nickName": "cjmtest",
"defaultNickName": false,
"whiteFlag": 1,
"contactConfig": true,
"isOnline": false,
"email": "j**********n@jin.com",
"mobile": "",
"kycLevel": 2,
"lastLogoutTime": "1741778675",
"recentRate": 0,
"totalFinishCount": 0,
"totalFinishSellCount": 0,
"totalFinishBuyCount": 0,
"recentFinishCount": 0,
"averageReleaseTime": "0",
"averageTransferTime": "0",
"accountCreateDays": 1241,
"firstTradeDays": 2,
"realName": "1**** ",
"recentTradeAmount": "0",
"totalTradeAmount": "0",
"executeNum": 0,
"orderNum": 0,
"hasUnPostAd": 0,
"registerTime": "1634552356",
"authStatus": 2,
"kycCountryCode": "MYS",
"blocked": "N",
"goodAppraiseRate": "0",
"goodAppraiseCount": 0,
"badAppraiseCount": 0,
"accountId": "290120",
"paymentCount": 1,
"contactCount": 0,
"realNameMask": "",
"vipLevel": 0,
"vipProfit": [],
"userTag": [],
"userCancelCountLimit": 1000,
"paymentRealNameUneditable": false,
"lostRoleAffected": false,
"userCurPrivilege": [
"OPEN_API_ACCESS",
"DISPLAY_MAKER_BULK",
"POST_EDIT_AD",
"CREATE_ORDER_BULK",
"POST_AD_BULK",
"POST_VERIFICATION_ORDER_AD",
"CAN_APPLY_OPEN_API"
],
"userType": "ORG",
"userId": "",
"realNameEn": "",
"canSubOnline": true,
"curPrivilegeInfo": [],
"openApiSwitch": 1
},
"ext_code": "",
"ext_info": {},
"time_now": "1741831548.654030"
}