跳至主要内容

Get Market Online Ads list

HTTP Request

POST /v5/p2p/item/online

Request Parameters

ParameterRequiredTypeComments
tokenIdtruestringToken ID. e.g. USDT, ETH, BTC
currencyIdtruestringCurrency ID e.g HKD, USD, EUR
sidetruestring0: buy; 1: sell
pagefalsestringPage number. Default value is 1
sizefalsestringPage size. Default value is 10

Response Parameters

ParameterTypeComments
countintTotal count
itemsarray<object>
> idstringAd id
> nickNamestringNickname of ad maker
> tokenIdstringToken ID
> currencyIdstringCurrency ID
> sidestring0: buy; 1: sell
> pricestringAd price
> lastQuantitystringcan trade token quantity
> minAmountstringMin transaction amount
> maxAmountstringMax transaction amount
> paymentsarray[string]Payment method type id
> recentOrderNumintmaker recent order num
> recentExecuteRateintmaker recent order execute rate
> isOnlinebooleanmaker online
> authTagarray[string]user tag ; VA, BA
> paymentPeriodintPayment time
> accountIdintAccount id
> userIdintUser id
> priceTypeintAd pricing exchange rate model. 0: fixed rate; 1: floating rate
> premiumstringpremium
> quantitystringQuantity
> frozenQuantitystringFrozen quantity
> executedQuantitystringExecuted quantity
> remarkstringremark
> statusintAds Status. 10: online; 20: offline; 30: completed
> createDatestringcreated time
> orderNumstringOrder number
> finishNumstringFinish number
> recentOrderNumstringRecent order number
> recentExecuteRatestringRecent execute rate
> feestringFee
> isOnlinebooleanwhether is online
> lastLogoutTimestringlast logout time
> blockedstringwhether is blocked
> makerContactbooleanwhether it is a maker contact
> symbolInfoObjectsymbol info
>> idstringsymbol id
>> exchangeIdstringexchange id
>> orgIdstringorg Id
>> tokenIdstringtoken id. e.g. USDT,ETH,BTC
>> currencyIdstringcurrency id e.g HKD,USD,EUR
>> statusstringsymbol status
>> lowerLimitAlarmintlower Limit Alarm
>> upperLimitAlarmintupper Limit Alarm
>> itemDownRangestringitem down range
>> itemUpRangestringitem up range
>> currencyMinQuotestringcurrency min quote
>> currencyMaxQuotestringcurrency max quote
>> currencyLowerMaxQuotestringcurrency lower max quote
>> tokenMinQuotestringtoken min quote
>> tokenMaxQuotestringtoken max quote
>> kycCurrencyLimitstringkyc currency limit
>> itemSideLimitstringitem side limit
>> buyFeeRatestringbuy fee rate
>> sellFeeRatestringsell fee rate
>> orderAutoCancelMinuteintorder auto cancel minute
>> orderFinishMinuteintorder finish minute
>> tradeSideinttrade side
>> currencyObjectcurrency info
>>> idstringcurrency Id
>>> exchangeIdstringexchange id
>>> orgIdstringorg Id
>>> currencyIdstringcurrency id
>>> scaleintscale
>> tokenObjecttoken info
>>> idstringtoken Id
>>> exchangeIdstringexchange id
>>> orgIdstringorg Id
>>> tokenIdstringtoken id
>>> scaleintscale
>>> sequenceintsequence
>> buyAdintsequence
>> sellAdintsequence
> tradingPreferenceSetObjecttrading preference
>> hasUnPostAdintWhether the counterparty must not have posted any advertisements. 0:not needed, 1:need
>> isKycintIs it necessary for the counterparty to complete identity authentication? 0:not needed, 1:need
>> isEmailintIs it necessary for the counterparty to bind an email address? 0:not needed, 1:need
>> isMobileintIs it necessary for the counterparty to bind an telphone? 0:not needed, 1:need
>> hasRegisterTimeintIs the registration time required to be no less than {} days? 00:not needed, 1:need
>> registerTimeThresholdintRegistration time threshold(Unit: Day)
>> orderFinishNumberDay30intLimit on number of completed orders in the last 30 days
>> completeRateDay30intCompletion rate limit in the last 30 days
>> nationalLimitintRestricted KYC Countries;IOS 3 CODE
>> hasOrderFinishNumberDay30intIs it necessary to have no less than {} orders in the last 30 days? 0:not needed, 1:need
>> hasCompleteRateDay30intIs it necessary to have a completion rate of no less than {} in the last 30 days? 0:not needed, 1:need
>> hasNationalLimitintAre country restrictions required? 0:not needed, 1:need
> versionintversion
> authStatusintauth Status
> recommendbooleanwhether is recommended
> recommendTagstringrecommend Tag
> userTypestringuser Type
> itemTypestringitem Type

Request Example

POST /v5/p2p/item/online HTTP/1.1
Host: api-testnet.bybit.com
X-BAPI-SIGN: XXXXX
X-BAPI-API-KEY: XXXXX
X-BAPI-TIMESTAMP: 1675866354698
X-BAPI-RECV-WINDOW: 5000
Content-Type: application/json
{
"tokenId":"USDT",
"currencyId":"EUR",
"side":"0"
}

Response Example

{
"ret_code": 0,
"ret_msg": "SUCCESS",
"result": {
"count": 3,
"items": [
{
"id": "1899658238346616832",
"accountId": "290120",
"userId": "290118",
"nickName": "cjmtest",
"tokenId": "USDT",
"tokenName": "",
"currencyId": "EUR",
"side": 0,
"priceType": 0,
"price": "0.93",
"premium": "0",
"lastQuantity": "10000",
"quantity": "10000",
"frozenQuantity": "0",
"executedQuantity": "0",
"minAmount": "200",
"maxAmount": "9300",
"remark": "1111121212",
"status": 10,
"createDate": "1741748793000",
"payments": [
"14"
],
"orderNum": 0,
"finishNum": 0,
"recentOrderNum": 0,
"recentExecuteRate": 0,
"fee": "",
"isOnline": true,
"lastLogoutTime": "1741749194",
"blocked": "N",
"makerContact": false,
"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": "0",
"sellFeeRate": "0",
"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": null,
"sellAd": null
},
"tradingPreferenceSet": {
"hasUnPostAd": 0,
"isKyc": 1,
"isEmail": 0,
"isMobile": 0,
"hasRegisterTime": 0,
"registerTimeThreshold": 0,
"orderFinishNumberDay30": 0,
"completeRateDay30": "0",
"nationalLimit": "",
"hasOrderFinishNumberDay30": 0,
"hasCompleteRateDay30": 0,
"hasNationalLimit": 0
},
"version": 0,
"authStatus": 1,
"recommend": false,
"recommendTag": "",
"authTag": [
"BA"
],
"userType": "ORG",
"itemType": "ORIGIN",
"paymentPeriod": 15
},
{
"id": "1899659847717838848",
"accountId": "290120",
"userId": "290118",
"nickName": "cjmtest",
"tokenId": "USDT",
"tokenName": "",
"currencyId": "EUR",
"side": 0,
"priceType": 0,
"price": "0.92",
"premium": "0",
"lastQuantity": "20000",
"quantity": "20000",
"frozenQuantity": "0",
"executedQuantity": "0",
"minAmount": "20",
"maxAmount": "18400",
"remark": "test",
"status": 10,
"createDate": "1741749177000",
"payments": [
"377"
],
"orderNum": 0,
"finishNum": 0,
"recentOrderNum": 0,
"recentExecuteRate": 0,
"fee": "",
"isOnline": true,
"lastLogoutTime": "1741749194",
"blocked": "N",
"makerContact": false,
"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": "0",
"sellFeeRate": "0",
"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": null,
"sellAd": null
},
"tradingPreferenceSet": {
"hasUnPostAd": 0,
"isKyc": 1,
"isEmail": 0,
"isMobile": 0,
"hasRegisterTime": 0,
"registerTimeThreshold": 0,
"orderFinishNumberDay30": 60,
"completeRateDay30": "95",
"nationalLimit": "",
"hasOrderFinishNumberDay30": 1,
"hasCompleteRateDay30": 1,
"hasNationalLimit": 0
},
"version": 0,
"authStatus": 1,
"recommend": false,
"recommendTag": "",
"authTag": [
"BA"
],
"userType": "ORG",
"itemType": "ORIGIN",
"paymentPeriod": 15
},
{
"id": "1898988222063644672",
"accountId": "1448940",
"userId": "1448939",
"nickName": "Saaaul",
"tokenId": "USDT",
"tokenName": "",
"currencyId": "EUR",
"side": 0,
"priceType": 0,
"price": "0.91",
"premium": "0",
"lastQuantity": "5000",
"quantity": "5000",
"frozenQuantity": "0",
"executedQuantity": "0",
"minAmount": "10",
"maxAmount": "4550",
"remark": "1. 付款賬號名稱應和 Bybit 賬號名稱一致。\n2. 請確保轉賬留言中不要出現 USDT 等幣種名稱,否則轉賬將會失敗。",
"status": 10,
"createDate": "1741589049000",
"payments": [
"377"
],
"orderNum": 0,
"finishNum": 0,
"recentOrderNum": 0,
"recentExecuteRate": 0,
"fee": "",
"isOnline": true,
"lastLogoutTime": "1741751952",
"blocked": "N",
"makerContact": false,
"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": "0",
"sellFeeRate": "0",
"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": null,
"sellAd": null
},
"tradingPreferenceSet": {
"hasUnPostAd": 1,
"isKyc": 1,
"isEmail": 1,
"isMobile": 0,
"hasRegisterTime": 1,
"registerTimeThreshold": 15,
"orderFinishNumberDay30": 60,
"completeRateDay30": "95",
"nationalLimit": "",
"hasOrderFinishNumberDay30": 1,
"hasCompleteRateDay30": 1,
"hasNationalLimit": 0
},
"version": 0,
"authStatus": 1,
"recommend": false,
"recommendTag": "",
"authTag": [
"BA"
],
"userType": "PERSONAL",
"itemType": "ORIGIN",
"paymentPeriod": 15
}
]
},
"ext_code": "",
"ext_info": {},
"time_now": "1741761340.014127"
}