Get My Ad Details

HTTP Request

POST /v5/p2p/item/info

Request Parameters

Parameter	Required	Type	Comments
itemId	true	string	Advertisement ID

Response Parameters

Parameter	Type	Comments
id	string	Advertisement ID
accountId	string	Account ID
userId	string	User ID
nickName	string	Nick name
tokenId	string	Token ID
currencyId	string	Currency ID
side	integer	Ad side for token. 0: buy; 1: sell
priceType	integer	Ad pricing exchange rate model. 0: fixed rate; 1: floating rate
price	string	Ad price
premium	string	Floating ratio with current exchange rate
lastQuantity	string	Remaining tradable quantity of ad
quantity	string	Quantity of token
frozenQuantity	string	Frozen quantity of token for ongoing transactions
executedQuantity	string	Executed qty of token
minAmount	string	Min transaction amount in currency
maxAmount	string	Max transaction amount in 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 has posted any advertisements or not. 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
> hasRegisterTime	integer	Is the registration time required to be no less than {} days? 0: not required; 1: required
> registerTimeThreshold	integer	Registration time threshold (unit: number of days)
> 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
version	integer	Ad 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
paymentPeriod	integer	Payment period (unit: minutes)
itemType	string	ORIGIN: original P2P advertisement, generally refers to non-bulk advertisements BULK: bulk advertisement
paymentTerms	array<object>	Payment methods
> id	string	Payment method ID
> paymentType	string	Payment method type

Request Example

HTTP

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

Python

from bybit_p2p import P2P
api = P2P(
    testnet=True,
    api_key="xxxxxxxxxxxxxxxxxx",
    api_secret="xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
)
print(api.get_ad_details(
    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"
}