# createTrade

> POST /trades/createTrade создаёт обмен и возвращает адрес для оплаты и данные сделки. Параметры, СБП и RUB, тестовый режим, примеры.

Source: https://docs.yellowchanger.com/ru/createTrade

Создает новую сделку и возвращает информацию о сделке

**POST** `https://api.yellowchanger.com/trades/createTrade`

## Заголовки

| Название | Значение |
| --- | --- |
| Content-Type | application/json |
| Y_API_KEY | Публичный API ключ |
| [Signature](https://docs.yellowchanger.com/ru/signature.md) | HMAC SHA256 тела |

## Тело

| Название | Тип | Описание |  |  |  |  |  |
| --- | --- | --- | --- | --- | --- | --- | --- |
| send_name | string | Отправляемая валюта |  |  |  |  |  |
| get_name | string | Получаемая валюта |  |  |  |  |  |
| send_network | string | Сеть отправляемой валюты |  |  |  |  |  |
| get_network | string | Сеть получаемой валюты |  |  |  |  |  |
| send_value or get_value | number | Сумма обмена, которую вы получите или оплатите |  |  |  |  |  |
| get_creds | string | Кошелёк получения |  |  |  |  |  |
| uniq_id | _необязательно_ |  | string | Уникальный идентификатор сделки |  |  |  |
| sbpBank | _необязательно_ |  | string | Банк для получения через SBP |  |  |  |
| exch_type | string |  | yellow | или | green |  |  |
| commission | float | Дополнительная комиссия в процентах, которая считается вашей прибылью (по умолчанию 0.5) |  |  |  |  |  |
| get_memo | _необязательно_ |  | string | Параметр MEMO для отправки средств на кошелёк получателя |  |  |  |
| recipientName | _необязательно_ |  | string | Имя получателя |  |  |  |

## Ответ

**200**

```json
{
          "send_memo": null,
          "send_name": "USDT",
          "send_network": "TRC20",
          "get_network": "ERC20",
          "get_name": "USDT",
          "uniq_id": "nf4i3rh394h",
          "status": 1,
          "payment_wallet": "WalletForPay",
          "userPaidHash": null,
          "ourHash": null,
          "get_creds": "WalletForRecive",
          "network_commission": 0,
          "date": 1720120863,
          "time_expire": 1720142463,
          "send_value": "112",
          "get_value": "100",
          "sbpBank": null,
          "exch_type": "yellow",
          "percent_commission": 0.5
}
```

**40X**

```json
{
          "statusCode": 400,
          "message": "Some error message"
}
```

## Пример

**JavaScript**

```javascript
const fetch = require("node-fetch");
let url = "https://api.yellowchanger.com/trades/createTrade",
          options = {
                    method: "POST",
                    headers: {
                              "Content-Type": "application/json",
                              Y_API_KEY: "Your API Key",
                              Signature: "0002b135569a4a29b7e7bf9489114eca8fa31e7f61a9e8e26b89bb7dfd4dcf5c",
                    },
                    body: '{"send_name":"USDT","get_name":"USDT","send_value":100,"send_network":"TRC20","get_network":"ERC20", "uniq_id":"nf4i3rh394h", "get_creds":"address, card or number"}',
          };
fetch(url, options)
          .then((e) => e.json())
          .then((e) => console.log(e))
          .catch((e) => console.error("error:" + e));
```

**Python**

```python
import requests

url = "https://api.yellowchanger.com/trades/createTrade"

payload = {
    "send_name": "USDT",
    "get_name": "USDT",
    "send_value": 100,
    "send_network": "TRC20",
    "get_network": "ERC20", 
    "uniq_id": "nf4i3rh394h",
    "get_creds": "address, card or number"
}

headers = {
    "Content-Type": "application/json",
    "Y_API_KEY": "Your API Key",
    "Signature": "0002b135569a4a29b7e7bf9489114eca8fa31e7f61a9e8e26b89bb7dfd4dcf5c"
}

response = requests.request("POST", url, json=payload, headers=headers)

print(response.text)
```

## Связанные страницы

- [calculateTrade](https://docs.yellowchanger.com/ru/calculateTrade.md): Возвращает курс и детали обмена для конкретной валютной пары
- [Проверка адреса](https://docs.yellowchanger.com/ru/validateAddress.md): Мы используем эти методы для проверки адресов, но если вы не хотите проверять их через наш сервер, вы можете проверить их самостоятельно этим кодом.
- [getInfo](https://docs.yellowchanger.com/ru/getInfo.md): Возвращает всю информацию о транзакции
- [cancelTrade](https://docs.yellowchanger.com/ru/cancelTrade.md): Отменить обмен
- [Информация о статусах](https://docs.yellowchanger.com/ru/statusInfo.md): Описание статусов в методах createTrade и getInfo
- [Подпись](https://docs.yellowchanger.com/ru/signature.md): Заголовок "Signature" — это тело, преобразованное из JSON в строку и подписанное HMAC SHA256 с использованием Private API Key.

---

All methods: https://docs.yellowchanger.com/ru/introduction.md · Index: https://docs.yellowchanger.com/ru/llms.txt · Whole documentation in one file: https://docs.yellowchanger.com/ru/llms-full.txt
