Skip to main content

Get My Ad Details

HTTP Request​

POST /v5/p2p/item/info

Request Parameters​

ParameterRequiredTypeComments
itemIdtruestringAdvertisement ID

Response Parameters​

ParameterTypeComments
idstringAdvertisement ID
accountIdstringAccount ID
userIdstringUser ID
nickNamestringNick name
tokenIdstringToken ID
currencyIdstringCurrency ID
sideintegerAd side for token. 0: buy; 1: sell
priceTypeintegerAd pricing exchange rate model. 0: fixed rate; 1: floating rate
pricestringAd price
premiumstringFloating ratio with current exchange rate
lastQuantitystringRemaining tradable quantity of ads
quantitystringQuantity
frozenQuantitystringFrozen quantity for ongoing transactions
executedQuantitystringExecuted qty
minAmountstringMin transaction amount
maxAmountstringMax transaction amount
remarkstringAdvertisement remarks for the counterparty
statusintegerAds Status. 10: online; 20: offline; 30: completed
createDatestringCreation time (timestamp)
paymentsarray<string>Payment method type ID
tradingPreferenceSetobjectTrading Preferences
> hasUnPostAdintegerWhether the counterparty has posted any advertisements or not. 0: not required; 1: required
> isKycintegerWhether or not the counterparty must complete identity authentication. 0: not required; 1: required
> isEmailintegerWhether or not the counterparty must bind an email address. 0: not required; 1: required
> isMobileintegerWhether or not the counterparty must bind a mobile number. 0: not required; 1: required
> hasRegisterTimeintegerIs the registration time required to be no less than {} days? 0: not required; 1: required
> registerTimeThresholdintegerRegistration time threshold (unit: number of days)
> orderFinishNumberDay30integerLimit on number of completed orders in the last 30 days
> completeRateDay30stringCompletion rate in the last 30 days
> nationalLimitstringKYC restricted countries. Format: three-letter ISO country code
> hasOrderFinishNumberDay30integerIs it necessary to have no less than {} orders in the last 30 days? 0: not required; 1: required
> hasCompleteRateDay30integerIs it necessary to have a completion rate of no less than {} in the last 30 days? 0: not required; 1: required
> hasNationalLimitintegerAre country restrictions required; 0: not required; 1: required
updateDatestringUpdate time (timestamp)
feeRatestringFee rate
versionintegerAd version, a way of posting advertisements that existed in the past, is divided into two types: pre-freezing funds for posting advertisements and not pre-freezing funds for posting advertisements.
1: pre-freezing funds; 2: not pre-freezing funds
paymentPeriodintegerPayment period (unit: minutes)
itemTypestringORIGIN: original P2P advertisement, generally refers to non-bulk advertisements
BULK: bulk advertisement
paymentTermsarray<object>Payment methods
> idstringPayment method ID
> paymentTypestringPayment method type

Request Example​

POST /v5/p2p/item/info HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN: XXXXXX
X-BAPI-API-KEY: xxxxxxxxxxxxxxxxxx
X-BAPI-TIMESTAMP: 1741767097117
X-BAPI-RECV-WINDOW: 5000
Content-Type: application/json

{
    "itemId": "1898988222063644672"
}

Response Example​

{
    "ret_code": 0,
    "ret_msg": "SUCCESS",
    "result": {
        "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": "1. 付款賬號名稱應和 Bybit 賬號名稱一致。\n2. 請確保轉賬留言中不要出現 USDT 等幣種名稱，否則轉賬將會失敗。",
        "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"
    },
    "ext_code": "",
    "ext_info": {},
    "time_now": "1741767097.388146"
}