Детальная информация об объявлении
Метод позволяет получить детальную информацию об объявлении
Статусы объявления:
-
active– активное объявление, отображается всем пользователям в списке объявлений -
deactivated– неактивное, скрыто из списка объявлений, доступно к редактированию данных -
canceled– объявление было удалено пользователем -
completed– завершенное объявление, по которому выкуплена вся ликвидность
Статусы сделки:
-
open:wait-confirm– ожидает подтверждения начала сделки от мейкера, на подтверждение сделки есть 10 минут, иначе она автоматически отменится -
open– мейкер подтвердил начало сделки, сделка открыта -
send-payment-document– покупатель оплатил сделку, необходимо проверить получение средств, если они пришли – отправить запрос POST /api/v1/p2p/client/trade/confirm подтверждение получения, иначе – отправить апелляцию POST /api/v1/p2p/client/trade/dispute -
dispute:open– открыта апелляция по сделке -
complete– сделка завершена (в том числе в рамках апелляции) -
cancel– сделка отменена (в том числе в рамках апелляции)
Request
Запрос не содержит тело запроса
Response
-
id(string): ID (внутренний) объявления -
idNumber(string): ID объявления, который отображается пользователю -
availableAmount(number): Доступное к покупке/продаже количество -
maxLimit(number): Максимальная сумма сделки -
minLimit(number): Минимальная сумма сделки -
price(float): Цена объявления -
quote(string): Котируемая валюта -
base(string): Базовая валюта -
user: Информация о мейкере-
id(string): ID мейкера -
username(string): Никнейм мейкера -
tradesCount(number): Количество успешно завершенных сделок -
tradesSuccessRate(number): Не используется -
online(boolean): Не используется
-
-
side(string): Тип объявления (возможные значения: buy – продажа, sell – покупка) -
paymentMethods: Массив методов оплаты объявления-
id(string): ID метода оплаты -
name(string): Название метода оплаты -
deletedAt(date&time): Не используется
-
-
difference(string): Процент доплаты (только для пары RUBRUB) -
createdAt(date&time): Дата создания объявления -
comment(string): Комментарий к объявлению -
status(string): Статус объявления -
market(array): Описание спецификации торговой пары-
marketId(string): ID торговой пары -
baseCurrencyId(string): Базовая валюта пары -
quoteCurrencyId(string): Валюта котировки -
baseDicCurrencyId(string): Не используется -
quoteDicCurrencyId(string): Не используется -
baseCurrencyPrecision(number): Количество знаков после запятой в базовой валюте пары -
baseCurrencyRound(number): Округление базовой валюты (возможные значения) -
quoteCurrencyPrecision(number): Количество знаков после запятой в валюте котировки -
quoteCurrencyRound(number): Округление валюты котировки (возможные значения) -
advertisementMaxCountSell(number): Максимальное количество активных объявлений в стакане по продаже -
advertisementMaxCountBuy(number): Максимальное количество активных объявлений в стакане по покупке -
advertisementMaxCountDeactivatedSell(number): Максимальное количество неактивных объявлений по продаже -
advertisementMaxCountDeactivatedBuy(number): Максимальное количество неактивных объявлений по покупке -
advertisementMinAmount(number): Минимальное количество объявления (указывается в базовой валюте) -
advertisementMaxAmount(number): Максимальное количество объявления (указывается в базовой валюте) -
tradeMinAmount(number): Минимальная сумма сделки (указывается в фиатной валюте) -
tradeMaxAmount(number): Максимальная сумма сделки (указывается в фиатной валюте) -
tradeActiveMaxCount(number): Максимальное количество одновременных активных сделок -
pricePrecision(number): Количество знаков после запятой в цене объявления -
quoteCurrency(array): Данные о валюте котировки (фиатной валюте)-
id(string): ID валюты -
isCoin(boolean): Признак криптовалюты, false – фиат, иначе – криптовалюта -
precision(number): Количество знаков после запятой в валюте -
title(string): Название валюты
-
-
baseCurrency(array): Данные о базовой валюте-
id(string): ID валюты -
isCoin(boolean): Признак криптовалюты, false – фиат, иначе – криптовалюта -
precision(number): Количество знаков после запятой в валюте -
title(string): Название валюты
-
-
marketPriceValidationRule(array): Правило для определения границ выставления цены-
marketsPriceValidationRuleId(string): Не используется -
marketId(string): Название торговой пары -
ruleType(string): Тип цены (возможные значения: anchor – фиксированная цена, spread – по спреду на бирже по аналогичной торговой паре) -
params(array): Параметры отклонения цены (для выставления границ)-
ask(number): Процент отклонения вниз от цены -
bid(number): Процент отклонения вверх от цены -
price(number): Если ruleType - anchor, то отклонение необходимо считать от этого значения. Иначе – этот параметр не приходит
-
-
description(string): Описание формирования цены -
deletedAt(date&time): Не используется
-
-
updatedAt(date&time): Дата и время обновления -
trades(object): Массив всех сделок по объявелнию-
id(string): ID сделки -
volume(string): Объем сделки, сколько пользователь получит. Важно: число отдается без запятой, необходимо учитыватьprecisionвалюты (для RUB – 2, для USDT – 4 знака после запятой) -
volumeCurrencyId(string): Валюта объема -
amount(string): Количество, сколько пользователь должен отправить. Важно: число отдается без запятой, необходимо учитыватьprecisionвалюты (для RUB – 2, для USDT – 4 знака после запятой) -
amountCurrencyId(string): Валюта количества -
createdAt(date&time): Дата и время создания сделки -
updatedAt(date&time): Дата и время последнего обновления сделки -
status(string): Статус сделки -
sellUserId(string): ID продавца -
buyUserId(string): ID покупателя -
roomId(string): ID чата -
advertisementId(string): ID объявления -
price(string): Цена сделки. Важно: число отдается без запятой, необходимо учитыватьprecisionцены валюты (для RUB и USDT – 4 знака после запятой) -
marketId(string): ID торговой пары -
idNumber(string): Номер сделки, который отображается пользователю в интерфейсе P2P -
paymentMethodId(string): ID метода оплаты
-
-
Example Response
{
"id": "cd7a9707-bbfe-4f3b-a6dd-7d969f8ba7a9",
"idNumber": "10-71817655",
"availableAmount": 900,
"maxLimit": 10000,
"minLimit": 1000,
"price": 90,
"quote": "RUB",
"base": "RUB",
"user": {
"id": "00000000-0000-0000-0000-000000000004",
"name": "user4",
"lastTime": null,
"registerDate": "2024-05-13",
"firstTrade": "2024-05-27",
"lastTrade": "2024-08-02",
"trades": {
"buy": 11,
"sell": 2
},
"tradesPast": {
"buy": 2,
"sell": 2,
"percent": 0.5
},
"rating": {
"negative": 0,
"positive": 0
},
"role": "maker",
"username": "user4"
},
"side": "buy",
"paymentMethods": [
{
"id": "203464d8-f298-405a-81fa-86f788788228",
"name": "Тинькофф",
"deletedAt": null
},
{
"id": "3200ae4c-65e4-485e-b93d-60ff3c57292a",
"name": "СБП",
"deletedAt": null
},
{
"id": "33ec4ee4-6a1c-4705-97f6-0e218c5297f3",
"name": "СберБанк",
"deletedAt": null
}
],
"difference": 89,
"createdAt": "2024-08-02T09:32:58.596Z",
"comment": "ваыаываыа",
"status": "active",
"market": {
"marketId": "USDTRUB",
"baseCurrencyId": "USDT",
"quoteCurrencyId": "RUB",
"baseDicCurrencyId": "USDT0000",
"quoteDicCurrencyId": "0RUB0000",
"baseCurrencyPrecision": 4,
"baseCurrencyRound": 0,
"quoteCurrencyPrecision": 2,
"quoteCurrencyRound": 1,
"advertisementMaxCountActiveSell": 3,
"advertisementMaxCountActiveBuy": 3,
"advertisementMaxCountDeactivatedSell": 100,
"advertisementMaxCountDeactivatedBuy": 100,
"advertisementMinAmount": 10,
"advertisementMaxAmount": 100000,
"tradeMinAmount": 1000,
"tradeMaxAmount": 10000000,
"tradeActiveMaxCount": 5,
"pricePrecision": 2,
"quoteCurrency": {
"id": "RUB",
"isCoin": false,
"precision": 2,
"title": "RUB"
},
"baseCurrency": {
"id": "USDT",
"isCoin": true,
"precision": 4,
"title": "USDT"
},
"marketPriceValidationRule": {
"marketsPriceValidationRuleId": "ce7842e6-a4c7-4c15-821e-fcb3aa69d984",
"marketId": "USDTRUB",
"ruleType": "spread",
"params": {
"ask": 0.5,
"bid": 0.5
},
"description": "percentage of deviation"
},
"deletedAt": null
},
"updatedAt": "2024-08-02T09:44:40.318Z",
"trades": [
{
"id": "d0e4c287-82a6-4816-a053-05991aefc26d",
"volume": "1000000",
"volumeCurrencyId": "USDT",
"amount": "900000",
"amountCurrencyId": "RUB",
"createdAt": "2024-08-02T09:34:57.811Z",
"updatedAt": "2024-08-02T09:40:24.646Z",
"status": "complete",
"sellUserId": "774dec9f-e60d-442e-9368-3df903ee07b7",
"buyUserId": "00000000-0000-0000-0000-000000000004",
"roomId": "ce4a15ca-3329-4ad8-a54d-847ebd09ebf1",
"advertisementId": "cd7a9707-bbfe-4f3b-a6dd-7d969f8ba7a9",
"price": "9000",
"marketId": "USDTRUB",
"idNumber": "11-41127579",
"paymentMethodId": "3200ae4c-65e4-485e-b93d-60ff3c57292a"
},
{
"id": "955126df-b6f0-46b1-92e4-061c945935a9",
"volume": "1000000",
"volumeCurrencyId": "USDT",
"amount": "900000",
"amountCurrencyId": "RUB",
"createdAt": "2024-08-02T09:43:56.101Z",
"updatedAt": "2024-08-02T09:44:40.318Z",
"status": "cancel",
"sellUserId": "774dec9f-e60d-442e-9368-3df903ee07b7",
"buyUserId": "00000000-0000-0000-0000-000000000004",
"roomId": "f2906ce4-3812-401b-ac72-8d8edc59a2f8",
"advertisementId": "cd7a9707-bbfe-4f3b-a6dd-7d969f8ba7a9",
"price": "9000",
"marketId": "USDTRUB",
"idNumber": "11-85027148",
"paymentMethodId": "3200ae4c-65e4-485e-b93d-60ff3c57292a"
}
]
}