Skip to main content

Get My Ads List

HTTP Request

POST /v5/p2p/item/personal/list

Request Parameters

ParameterRequiredTypeComments
itemIdfalsestringad's id
statusfalsestring1: Sold Out; 2: Available
sidefalsestringad's for buying token or for selling token. 0: buy; 1: sell
tokenIdfalsestringToken id. e.g. USDT,ETH,BTC
pagefalsestringPage number. Default Value is 1
sizefalsestringPage size. Default Value is 10
currencyIdfalsestringCurrency id e.g HKD,USD,EUR

Response Parameters

ParameterTypeComments
countintegerTotal page count
hiddenflagbooleanAre any ads hidden? true: There are ads that are hidden, false: No ads are hidden
itemsarray<object>ads Information. see Items Fields
> idstringAds ID
> accountIdstringAccount ID
> userIdstringUser ID
> nickNamestringNick name
> tokenIdstringToken ID
> currencyIdstringCurrency ID
> sideinteger0: buy; 1: sell
> priceTypeintegerAd pricing exchange rate model. 0: fixed rate; 1: floating rate
> pricestringPrice
> premiumstringFloating ratio with current exchange rate
> lastQuantitystringRemaining tradable quantity of ads
> quantitystringQuantity
> frozenQuantitystringForzen qty for ongoing transactions
> executedQuantitystringExecuted qty
> minAmountstringMin transaction amount
> maxAmountstringMax transaction amount
> remarkstringTransaction Description
> statusintegerAds Status. 10: online; 20: offline; 30: completed
> createDatestringcreation time(timestamp)
> paymentsarray<string>Payment method type id
> tradingPreferenceSetobjectTrading Preferences
>> hasUnPostAdintegerWhether the counterparty must not have posted any advertisements. 0: not needed; 1: need
>> isKycintegerIs it necessary for the counterparty to complete identity authentication? 0: not needed; 1: need
>> isEmailintegerIs it necessary for the counterparty to bind an email address? 0: not needed; 1: need
>> isMobileintegerIs it necessary for the counterparty to bind an telphone? 0: not needed; 1: need
>> hasRegisterTimeintegerIs the registration time required to be no less than {} days? 0: not needed; 1: need
>> registerTimeThresholdintegerRegistration time threshold(Unit: Day)
>> orderFinishNumberDay30integerLimit on number of completed orders in the last 30 days
>> completeRateDay30stringCompletion rate limit in the last 30 days
>> nationalLimitstringRestricted KYC Countries;IOS 3 CODE
>> hasOrderFinishNumberDay30integerIs it necessary to have no less than {} orders in the last 30 days? 0: not needed; 1: need
>> hasCompleteRateDay30integerIs it necessary to have a completion rate of no less than {} in the last 30 days? 0: not needed; 1: need
>> hasNationalLimitintegerAre country restrictions required; 0: not needed; 1: need
> updateDatestringUpdate time (timestamp)
> feeRatestringFee Rate
> paymentPeriodintegerpayment duration
> itemTypestringORIGIN: original P2P advertisement, generally refers to non-bulk advertisement;
BULK: bulk advertisement
> paymentTermsarray<object>Payment Methods
>> idstringPayment method id
>> paymentTypestringPayment method type

Request Example

POST /v5/p2p/item/personal/list HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN: XXXXXX
X-BAPI-API-KEY: XXXXXX
X-BAPI-TIMESTAMP: 1741761792313
X-BAPI-RECV-WINDOW: 5000
Content-Type: application/json
Content-Length: 2

{}

Response Example

{
"ret_code": 0,
"ret_msg": "SUCCESS",
"result": {
"count": 1,
"items": [
{
"id": "1898988222063644672",
"accountId": "1448940",
"userId": "1448939",
"nickName": "",
"tokenId": "USDT",
"tokenName": "USDT",
"currencyId": "EUR",
"side": 0,
"priceType": 0,
"price": "0.91",
"premium": "0",
"lastQuantity": "5000",
"quantity": "5000",
"frozenQuantity": "0",
"executedQuantity": "0",
"minAmount": "10",
"maxAmount": "5000",
"remark": "",
"status": 10,
"createDate": "1741589049000",
"payments": [
"377"
],
"orderNum": 0,
"finishNum": 0,
"recentOrderNum": 0,
"recentExecuteRate": 0,
"fee": "",
"isOnline": false,
"lastLogoutTime": "0",
"symbolInfo": {
"id": "13",
"exchangeId": "301",
"orgId": "9001",
"tokenId": "USDT",
"currencyId": "EUR",
"status": 1,
"lowerLimitAlarm": 90,
"upperLimitAlarm": 110,
"itemDownRange": "70",
"itemUpRange": "130",
"currencyMinQuote": "2",
"currencyMaxQuote": "46500",
"currencyLowerMaxQuote": "2",
"tokenMinQuote": "1",
"tokenMaxQuote": "50000",
"kycCurrencyLimit": "900",
"itemSideLimit": 3,
"buyFeeRate": "",
"sellFeeRate": "",
"orderAutoCancelMinute": 15,
"orderFinishMinute": 10,
"tradeSide": 9,
"currency": {
"id": "14",
"exchangeId": "0",
"orgId": "9001",
"currencyId": "EUR",
"scale": 3
},
"token": {
"id": "1",
"exchangeId": "0",
"orgId": "9001",
"tokenId": "USDT",
"scale": 4,
"sequence": 1
},
"buyAd": {
"paymentPeriods": [
15,
30
]
},
"sellAd": {
"paymentPeriods": [
15,
30
]
}
},
"tradingPreferenceSet": {
"hasUnPostAd": 1,
"isKyc": 1,
"isEmail": 1,
"isMobile": 0,
"hasRegisterTime": 1,
"registerTimeThreshold": 15,
"orderFinishNumberDay30": 60,
"completeRateDay30": "95",
"nationalLimit": "",
"hasOrderFinishNumberDay30": 1,
"hasCompleteRateDay30": 1,
"hasNationalLimit": 0
},
"paymentTerms": [
{
"id": "-1",
"realName": "",
"paymentType": 377,
"bankName": "",
"branchName": "",
"accountNo": "",
"qrcode": "",
"visible": 0,
"payMessage": "",
"firstName": "",
"lastName": "",
"secondLastName": "",
"clabe": "",
"debitCardNumber": "",
"mobile": "",
"businessName": "",
"concept": "",
"paymentExt1": "",
"paymentExt2": "",
"paymentExt3": "",
"paymentExt4": "",
"paymentExt5": "",
"paymentExt6": "",
"paymentTemplateVersion": 0,
"paymentConfig": {
"paymentType": 377,
"paymentName": "Balance",
"paymentDialect": "payment_field_balance",
"paymentTemplateItem": []
},
"realNameVerified": false
}
],
"version": 2,
"updateDate": "1741753781000",
"feeRate": "0",
"paymentPeriod": 15,
"itemType": "ORIGIN"
}
],
"hiddenFlag": false
},
"ext_code": "",
"ext_info": {},
"time_now": "1741761792.917532"
}