Skip to main content

Post Ad

HTTP Request

POST /v5/p2p/item/create

Request Parameters

ParameterRequiredTypeComments
tokenIdtruestringToken ID. E.g. USDT,ETH,BTC
currencyIdtruestringCurrency ID. E.g. HKD,USD,EUR
sidetruestringBuying or selling the token. 0: buy; 1: sell
priceTypetruestringPricing exchange rate model. 0: fixed rate; 1: floating rate
premiumtruestringThe premium applied to the floating exchange rate
pricetruestringPrice
minAmounttruestringMin. transaction amount
maxAmounttruestringMax. transaction amount
remarktruestringAd description (max. length: 900)
tradingPreferenceSettrueObjectTrading preferences
> hasUnPostAdfalseintegerWhether the counterparty must not have posted any advertisements. 0: not required; 1: required
> isKycfalseintegerIs it necessary for the counterparty to complete identity authentication? 0: not required; 1: required
> isEmailfalseintegerIs it necessary for the counterparty to bind an email address? 0: not required; 1: required
> isMobilefalseintegerIs it necessary for the counterparty to bind a mobile number? 0: not required1: required
> hasRegisterTimefalseintegerIs the registration time required to be no less than {} days? 0: not required; 1: required
> registerTimeThresholdfalseintegerRegistration time threshold(Unit: Day)
> orderFinishNumberDay30falseintegerLimit on number of completed orders in the last 30 days
> completeRateDay30falsestringCompletion rate in the last 30 days
> nationalLimitfalsestringKYC restricted countries. Format: three-letter ISO country code
> hasOrderFinishNumberDay30falseintegerIs it necessary to have no less than {} orders in the last 30 days? 0: not required; 1: required
> hasCompleteRateDay30falseintegerIs it necessary to have a completion rate of no less than {} in the last 30 days? 0: not required; 1: required
> hasNationalLimitfalseintegerAre country restrictions required? 0: not required; 1: required
paymentIdstruearray[string]Payment method type ID (len<=5)
quantitytruestringNumber of ads
paymentPeriodtruestringPayment period (unit: minutes)
itemTypetruestringORIGIN: original P2P advertisement, generally refers to non-bulk advertisement;
BULK: bulk advertisement

Response Parameters

ParameterTypeComments
itemIdstringitem Id
securityRiskTokenstringsecurity risk token
riskTokenTypestringrisk token type
riskVersionstringrisk version
needSecurityRiskbooleanWhether security risk is necessary

Request Example

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

{
"tokenId": "USDT",
"currencyId":"EUR",
"side": "0",
"priceType":"0",
"premium":"",
"price":"0.92",
"minAmount":"20",
"maxAmount":"45000",
"paymentIds":["7110"],
"remark":"test",
"tradingPreferenceSet":{
"isKyc": "1",
"hasCompleteRateDay30": "1",
"completeRateDay30": "95",
"hasOrderFinishNumberDay30": "1",
"hasRegisterTime":"0",
"hasUnPostAd":"0",
"isEmail":"0",
"isMobile":"0",
"nationalLimit":"",
"orderFinishNumberDay30":"60",
"registerTimeThreshold": "0",
"verificationOrderLabels":[],
"verificationOrderSwitch": false
},
"quantity":"20000",
"paymentPeriod":"15",
"itemType":"ORIGIN"
}

Response Example

{
"ret_code": 0,
"ret_msg": "SUCCESS",
"result": {
"itemId": "1899659847717838848",
"securityRiskToken": "",
"riskTokenType": "",
"riskVersion": "",
"needSecurityRisk": false
},
"ext_code": "",
"ext_info": {},
"ext_map": {},
"time_now": "1741749176.939208"
}