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 or not the user's nickname is a default nickname generated by the system
isOnlinebooleanWhether or not the user is online on the bybit site
kycLevelstringKYC level
emailstringEmail address (masked)
mobilestringMobile phone number (mask)
lastLogoutTimestringLast logout time
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: minutes)
averageTransferTimestringAverage payment currency time (unit: minutes)
accountCreateDaysintegerDays since the account was created
firstTradeDaysintegerDays since the account's first transaction
realNamestringReal name
recentTradeAmountstringCumulative successful transaction amount USDT in the past 30 days
totalTradeAmountstringThe sum of all USDT transaction volume in the past
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
userIdstringUser ID
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: xxxxxxxxxxxxxxxxxx
X-BAPI-TIMESTAMP: 1741831548391
X-BAPI-RECV-WINDOW: 5000
Content-Type: application/json

{
"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"
}