# createTrade

> POST /trades/createTrade створює обмін і повертає адресу для оплати та дані угоди. Параметри, СБП і RUB, тестовий режим, приклади.

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

Створює нову угоду та повертає інформацію про угоду

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

## Заголовки

| Назва | Значення |
| --- | --- |
| Content-Type | application/json |
| Y_API_KEY | Публічний API ключ |
| [Signature](https://docs.yellowchanger.com/uk/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/uk/calculateTrade.md): Повертає курс та деталі обміну для конкретної валютної пари
- [Перевірка адреси](https://docs.yellowchanger.com/uk/validateAddress.md): Ми використовуємо ці методи для перевірки адрес, але якщо ви не хочете перевіряти їх через наш сервер, ви можете перевірити їх самостійно цим кодом.
- [getInfo](https://docs.yellowchanger.com/uk/getInfo.md): Повертає всю інформацію про транзакцію
- [cancelTrade](https://docs.yellowchanger.com/uk/cancelTrade.md): Скасувати обмін
- [Інформація про статуси](https://docs.yellowchanger.com/uk/statusInfo.md): Опис статусів у методах createTrade та getInfo
- [Підпис](https://docs.yellowchanger.com/uk/signature.md): Заголовок "Signature" — це тіло, перетворене з JSON в рядок і підписане HMAC SHA256 за допомогою Private API Key.

---

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