Метод позволяет получить детальную информацию об объявлении
Статусы объявления:
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 – сделка отменена (в том числе в рамках апелляции)
Response
Параметр | Обязательность | Описание |
|---|---|---|
id | Да | ID (внутренний) объявления |
idNumber | Да | ID объявления, который отображается пользователю |
availableAmount | Да | Доступное к покупке/продаже количество |
maxLimit | Да | Максимальная сумма сделки |
minLimit | Да | Минимальная сумма сделки |
price | Да | Цена объявления |
quote | Да | Котируемая валюта |
base | Да | Базовая валюта |
user | Да | Информация о мейкере |
user.id | Да | ID мейкера |
user.username | Да | Никнейм мейкера |
user.tradesCount | Да | Количество успешно завершенных сделок |
user.tradesSuccessRate | Да | Не используется |
user.online | Да | Не используется |
side | Да | Тип объявления
|
paymentMethods | Да | Массив методов оплаты объявления |
paymentMethods.id | Да | ID метода оплаты |
paymentMethods.name | Да | Название метода оплаты |
paymentMethods.deletedAt | Да | Не используется |
difference | Да | Процент доплаты (только для пары RUBRUB) |
createdAt | Да | Дата создания объявления |
comment | Да | Комментарий к объявлению |
status | Да | Статус объявления |
market | Да | Описание спецификации торговой пары |
marketId | Да | ID торговой пары |
baseCurrencyId | Да | Базовая валюта пары |
quoteCurrencyId | Да | Валюта котировки |
baseDicCurrencyId | Да | Не используется |
quoteDicCurrencyId | Да | Не используется |
baseCurrencyPrecision | Да | Количество знаков после запятой в базовой валюте пары |
baseCurrencyRound | Да | Округление базовой валюты |
quoteCurrencyPrecision | Да | Количество знаков после запятой в валюте котировки |
quoteCurrencyRound | Да | Округление валюты котировки |
advertisementMaxCountSell | Да | Максимальное количество активных объявлений в стакане по продаже |
advertisementMaxCountBuy | Да | Максимальное количество активных объявлений в стакане по покупке |
advertisementMaxCountDeactivatedSell | Да | Максимальное количество неактивных объявлений по продаже |
advertisementMaxCountDeactivatedBuy | Да | Максимальное количество неактивных объявлений по покупке |
advertisementMinAmount | Да | Минимальное количество объявления (указывается в базовой валюте) |
advertisementMaxAmount | Да | Максимальное количество объявления (указывается в базовой валюте) |
tradeMinAmount | Да | Минимальная сумма сделки (указывается в фиатной валюте) |
tradeMaxAmount | Да | Максимальная сумма сделки (указывается в фиатной валюте) |
tradeActiveMaxCount | Да | Максимальное количество одновременных активных сделок |
pricePrecision | Да | Количество знаков после запятой в цене объявления |
quoteCurrency | Да | Данные о валюте котировки (фиатной валюте) |
quoteCurrency.id | Да | ID валюты |
quoteCurrency.isCoin | Да | Признак криптовалюты
|
quoteCurrency.precision | Да | Количество знаков после запятой в валюте |
quoteCurrency.title | Да | Название валюты |
baseCurrency | Да | Данные о базовой валюте |
baseCurrency.id | Да | ID валюты |
baseCurrency.isCoin | Да | Признак криптовалюты
|
baseCurrency.precision | Да | Количество знаков после запятой в валюте |
baseCurrency.title | Да | Название валюты |
marketPriceValidationRule | Да | Правило для определения границ выставления цены |
marketPriceValidationRule. | Да | Не используется |
marketPriceValidationRule.marketId | Да | Название торговой пары |
marketPriceValidationRule.ruleType | Да | Тип цены
|
marketPriceValidationRule.params | Да | Параметры отклонения цены (для выставления границ) |
marketPriceValidationRule.params.ask | Да | Процент отклонения вниз от цены |
marketPriceValidationRule.params.bid | Да | Процент отклонения вверх от цены |
marketPriceValidationRule.params.price | Да | Если |
marketPriceValidationRule.description | Да | Описание формирования цены |
marketPriceValidationRule.deletedAt | Да | Не используется |
marketPriceValidationRule.updatedAt | Да | Дата и время обновления |
trades | Да | Массив всех сделок по объявлению |
trades.id | Да | ID сделки |
trades.volume | Да | Объем сделки, сколько пользователь получит. Важно: число отдается без запятой, необходимо учитывать |
trades.volumeCurrencyId | Да | Валюта объема |
trades.amount | Да | Количество, сколько пользователь должен отправить. Важно: число отдается без запятой, необходимо учитывать |
trades.amountCurrencyId | Да | Валюта количества |
trades.createdAt | Да | Дата и время создания сделки |
trades.updatedAt | Да | Дата и время последнего обновления сделки |
trades.status | Да | Статус сделки |
trades.sellUserId | Да | ID продавца |
trades.buyUserId | Да | ID покупателя |
trades.roomId | Да | ID чата |
trades.advertisementId | Да | ID объявления |
trades.price | Да | Цена сделки. Важно: число отдается без запятой, необходимо учитывать |
trades.marketId | Да | ID торговой пары |
trades.idNumber | Да | Номер сделки, который отображается пользователю в интерфейсе P2P |
trades.paymentMethodId | Да | ID метода оплаты |
{
"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"
}
]
}