Создать объявление

Создать объявление

Метод позволяет создать объявление в секции P2P для выбранной валютной пары.

Объявление можно создать:

  • Активным, то есть сразу отобразить в списке объявлений

  • Неактивным, то есть скрытым из списка, при необходимости, его можно активировать с помощью метода PATCH /api/v1/p2p/client/advertisement/deactivate/:id

Максимальное количество активных объявлений по каждому типу (покупка/продажа) – 3.

Максимальное количество деактивированных объявлений по каждому типу (покупка/продажа) – 100.

Все валидации полей формы создания объявления для торговой пары можно получить через GET /api/v1/p2p/client/market

Request Body

  • quote (string, required): Котируемая валюта (возможные значения: RUB)

  • base (string, required): Базовая валюта (возможные значения: USDT, RUB)

  • availableAmount (float, required): Доступное количество к покупке/продаже (в базовой валюте). Необходимо присылать число с учетом максимального количества знаков после запятой – можно получить в запросе /api/v1/p2p/client/market в параметре baseCurrencyPrecision

  • minLimit (float, required): Минимальная сумма сделки (в фиате). Необходимо присылать число с учетом максимального количества знаков после запятой – можно получить в запросе /api/v1/p2p/client/market в параметре quoteCurrencyPrecision

  • maxLimit (float, required): Максимальная сумма сделки (в фиате). Необходимо присылать число с учетом максимального количества знаков после запятой – можно получить в запросе /api/v1/p2p/client/market в параметре quoteCurrencyPrecision

  • side (string, required): Тип объявления – покупка или продажа (возможные значения: buy – купить, sell – продать). Важно: если создается объявление на покупку, то в списке объявлений другим тейкерам оно будет отображаться в корзине по продаже (и наоборот)

  • price (float, required): Цена объявления. Необходимо присылать число с учетом максимального количества знаков после запятой – можно получить в запросе /api/v1/p2p/client/market в параметре pricePrecision

  • methods (array of strings, required): Список ID методов оплаты объявления. Список всех методов оплаты можно получить через GET /api/v1/p2p/client/payment-method/list

  • marketId (string, required): ID торговой пары (возможные значения: USDTRUB, RUBRUB)

  • comment (string): Комментарий к объявлению

  • status (string, required): Статус, в котором необходимо создать объявление (возможные варианты: active – отобразить в списке объявлений, deactivated – неактивным)

  • externalId (string): Параметр для указания внутреннего ID объявления. Формат обязательно UUID. В случае, если уже есть объявление с таким ID – отдается ошибка, объявление не создается

Example Request

{
  "quote": "RUB",
  "base": "RUB",
  "availableAmount": 100000,
  "minLimit": 1000,
  "maxLimit": 10000,
  "side": "buy",
  "price": 1,
  "methods": [
    "695d8c6f-79ac-49bd-bf35-a883cde390f1",
    "3200ae4c-65e4-485e-b93d-60ff3c57292a"
  ],
  "marketId": "RUBRUB",
  "comment": "hehe",
  "status": "active"
}

Response

  • id (string) – ID созданного объявления

Example Response

{
    "id": "7064d706-11c0-4127-8023-83bfb9c2dadb"
}
Body Params
string
required

Котируемая валюта (возможные значения: RUB)

string
required

Базовая валюта (возможные значения: USDT, RUB)

float
required

Доступное количество к покупке/продаже (в базовой валюте). Необходимо присылать число с учетом максимального количества знаков после запятой – можно получить в запросе /api/v1/p2p/client/market в параметре baseCurrencyPrecision

float
required

Минимальная сумма сделки (в фиате). Необходимо присылать число с учетом максимального количества знаков после запятой – можно получить в запросе /api/v1/p2p/client/market в параметре quoteCurrencyPrecision

float
required

Максимальная сумма сделки (в фиате). Необходимо присылать число с учетом максимального количества знаков после запятой – можно получить в запросе /api/v1/p2p/client/market в параметре quoteCurrencyPrecision

string
required

Тип объявления – покупка или продажа (возможные значения: buy – купить, sell – продать). Важно: если создается объявление на покупку, то в списке объявлений другим тейкерам оно будет отображаться в корзине по продаже (и наоборот)

float
required

Цена объявления. Необходимо присылать число с учетом максимального количества знаков после запятой – можно получить в запросе /api/v1/p2p/client/market в параметре pricePrecision

methods
array of strings
required

Список ID методов оплаты объявления. Список всех методов оплаты можно получить через GET /api/v1/p2p/client/payment-method/list

methods*
string
required

ID торговой пары (возможные значения: USDTRUB, RUBRUB)

string

Комментарий к объявлению

string
required

Статус, в котором необходимо создать объявление (возможные варианты: active – отобразить в списке объявлений, deactivated – неактивным)

string

Параметр для указания внутреннего ID объявления. Формат обязательно UUID. В случае, если уже есть объявление с таким ID – отдается ошибка, объявление не создается

Responses

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json