Get My Ads
HTTP Request
POST /v5/p2p/item/personal/list
Request Parameters
| Parameter | Required | Type | Comments |
|---|---|---|---|
| itemId | false | string | Advertisement ID |
| status | false | string | 1: Sold Out; 2: Available |
| side | false | string | Ad side for token. 0: buy; 1: sell |
| tokenId | false | string | Token id. e.g. USDT,ETH,BTC |
| page | false | string | Page number. Default Value is 1 |
| size | false | string | Page size. Default Value is 10 |
| currencyId | false | string | Currency id e.g HKD,USD,EUR |
Response Parameters
| Parameter | Type | Comments |
|---|---|---|
| count | integer | Total page count |
| hiddenFlag | boolean | Are any ads hidden? true: There are ads that are hidden, false: No ads are hidden |
| items | array<object> | List of advertisements |
| > id | string | Ads ID |
| > accountId | string | Account ID |
| > userId | string | User ID |
| > nickName | string | Nickname |
| > tokenId | string | Token ID |
| > currencyId | string | Currency ID |
| > side | integer | 0: buy; 1: sell |
| > priceType | integer | Ad pricing exchange rate model. 0: fixed rate; 1: floating rate |
| > price | string | Price |
| > premium | string | Floating ratio with current exchange rate |
| > lastQuantity | string | Remaining tradable quantity of token in an advertisement |
| > quantity | string | Quantity |
| > frozenQuantity | string | Frozen qty of token for ongoing transactions |
| > executedQuantity | string | Executed qty of token |
| > minAmount | string | Min transaction amount of currency |
| > maxAmount | string | Max transaction amount of currency |
| > remark | string | Advertisement description |
| > status | integer | Ads Status. 10: online; 20: offline; 30: completed |
| > createDate | string | Creation time (timestamp) |
| > payments | array<string> | Payment method type ID |
| > tradingPreferenceSet | object | Trading preferences |
| >> hasUnPostAd | integer | Whether the counterparty must not have posted any advertisements. 0: not required; 1: required |
| >> isKyc | integer | Whether or not the counterparty must complete identity authentication. 0: not required; 1: required |
| >> isEmail | integer | Whether or not the counterparty must bind an email address. 0: not required; 1: required |
| >> isMobile | integer | Whether or not the counterparty must bind a mobile number. 0: not required; 1: required |
| >> registerTimeThreshold | integer | Registration time threshold(Unit: Day) |
| >> orderFinishNumberDay30 | integer | Limit on number of completed orders in the last 30 days |
| >> completeRateDay30 | string | Completion rate in the last 30 days |
| >> nationalLimit | string | KYC restricted countries. Format: three-letter ISO country code |
| >> hasOrderFinishNumberDay30 | integer | Is it necessary to have no less than {} orders in the last 30 days? 0: not required; 1: required |
| >> hasCompleteRateDay30 | integer | Is it necessary to have a completion rate of no less than {} in the last 30 days? 0: not required; 1: required |
| >> hasNationalLimit | integer | Whether or not KYC restricted countries list enabled; 0: disabled; 1: enabled |
| > updateDate | string | Update time (timestamp) |
| > feeRate | string | Fee Rate |
| > paymentPeriod | integer | Payment period (unit: minutes) |
| > itemType | string | ORIGIN: original P2P advertisement, generally refers to non-bulk advertisement; BULK: bulk advertisement |
| > paymentTerms | array<object> | Payment methods |
| >> id | string | Payment method ID |
| >> paymentType | string | Payment method type |
Request Example
- HTTP
- Python
POST /v5/p2p/item/personal/list HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN: XXXXXX
X-BAPI-API-KEY: xxxxxxxxxxxxxxxxxx
X-BAPI-TIMESTAMP: 1741761792313
X-BAPI-RECV-WINDOW: 5000
Content-Type: application/json
{}
from bybit_p2p import P2P
api = P2P(
testnet=True,
api_key="xxxxxxxxxxxxxxxxxx",
api_secret="xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
)
print(api.get_ads_list())
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"
}