Skip to main content

Update / Relist My Ad

HTTP Request

POST /v5/p2p/item/update

Request Parameters

ParameterRequiredTypeComments
idtruestringadv id
priceTypetruestringAds Pricing Exchange Rate Model. 0 - Fixed rate; 1 - Floating rate
premiumtruestringFloating ratio with current exchange rate
pricetruestringads price
minAmounttruestringMin transaction amount
maxAmounttruestringMax transaction amount
remarktruestringTransaction Description(max=900)
tradingPreferenceSettrueObjectTrading Preferences
> hasUnPostAdfalsestringWhether the counterparty must not have posted any advertisements. 0:not needed, 1:need
> isKycfalsestringIs it necessary for the counterparty to complete identity authentication? 0:not needed, 1:need
> isEmailfalsestringIs it necessary for the counterparty to bind an email address? 0:not needed, 1:need
> isMobilefalsestringIs it necessary for the counterparty to bind an telphone? 0:not needed, 1:need
> hasRegisterTimefalsestringIs the registration time required to be no less than {} days? 0:not needed, 1:need
> registerTimeThresholdfalsestringRegistration time threshold(Unit: Day)
> orderFinishNumberDay30falsestringLimit on number of completed orders in the last 30 days
> completeRateDay30falsestringCompletion rate limit in the last 30 days
> nationalLimitfalsestringRestricted KYC Countries;IOS 3 CODE
> hasOrderFinishNumberDay30falsestringIs it necessary to have no less than {} orders in the last 30 days? 0:not needed, 1:need
> hasCompleteRateDay30falsestringIs it necessary to have a completion rate of no less than {} in the last 30 days? 0:not needed, 1:need
> hasNationalLimitfalsestringAre country restrictions required? 0:not needed, 1:need
paymentIdstruearray[string]Payment method type id(len<=5)
actionTypetruestringOperation Type: MODIFY modify adv; ACTIVE. reonline adv
quantitytruestringNumber of ads
paymentPeriodtruestringpayment duration

Response Parameters

None

Request Example

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

{
"priceType": "0",
"premium": "",
"quantity": "1000",
"minAmount": "25",
"maxAmount": "5000",
"paymentPeriod": "15",
"remark": "",
"price": "0.914",
"paymentIds": [
"-1"
],
"tradingPreferenceSet": {},
"itemType": "ORIGIN",
"subsidyAd": false,
"actionType": "ACTIVE",
"id": "1898988222063644672",
"securityRiskToken": ""
}

Response Example

{
"ret_code": 0,
"ret_msg": "SUCCESS",
"result": {
"securityRiskToken": "",
"riskTokenType": "",
"riskVersion": "",
"needSecurityRisk": false
},
"ext_code": "",
"ext_info": {},
"time_now": "1741769514.655369"
}