Список ордерів
Отримання історії ордерів.
Запит
Щоб отримати список ордерів, використовуйте наступний запит до API:
POST /v2/order/list
POST /v2/order/list HTTP/1.1
Content-Type: application/json
Accept: application/json; charset=utf-8
Api-key: {publicApiKey}
Signature: {signature}
{
"currency_from": "usdt", //optional
"network_from": "trc20", //optional
"currency_to": "btc", //optional
"network_to": "btc", //optional
"date_from": "1970-01-01 00:00:00", //optional
"date_to": "2030-01-01 00:00:00", //optional
"order_type": "deposit", //optional
"status": "new", //optional
"limit": 100, //optional, from 1 to 1000
"page": 1, //optional
"order_id": "merchant_unique_order_id", //optional
"order_ids": ["merchant_unique_order_id"] //optional, array of order ids
}
Примітка
Усі параметри опціональні, відповідь може містити до 1000 ордерів.
Опис параметрів у запиті:
currency_from
– Валюта депозиту чи обмінуnetwork_from
– Мережа депозитуcurrency_to
– Валюта виплати чи результату обмінуnetwork_to
– Мережа виплатиdate_from
– Вибрати починаючи з цієї дати створення ордераdate_to
– Вибрати до цієї дати створення ордераorder_type
– Тип ордераstatus
– Статус ордера (см. раздел статус ордера )order_id
– Унікальний ідентифікатор платежу у системі мерчантаorder_ids
– Масив унікальних ідентифікаторів платежу у системі мерчантаlimit
– Кількість ордерів у відповіді доступна від 1 до 1000 (за замовчуванням 100)page
– Номер сторінки, з якої починати видачу результатів, 1 і більше (одна сторінка міститьlimit
ордерів)
Відповідь
RESPONSE
HTTP/1.1 200 OK
Content-Type: application/json
{
"status": "success",
"data": [
{
"order_uuid":"3e7d0f84-d655-4069-991c-ad4739874ca5",
"order_type":"deposit_exchange_withdraw",
"user_order_id":"merchant_unique_order_id",
"description": null,
"expected_amount_from":"29",
"amount_from":null,
"currency_from":"usdt",
"network_from":"trc20",
"deposit_from_user": null,
"wallet_from":null,
"wallet_memo_from":null,
"expected_amount_to":"0.00103988",
"amount_to":null,
"strict_withdrawal_amount": false | true,
"currency_to":"btc",
"network_to":"btc",
"withdraw_to_user": null,
"wallet_to":"2N9MQVd2rQZF9TEE3SXHzjvBUNgFWr2qf6V",
"wallet_memo_to":null,
"wallet_to_details": null | {},
"wallet_to_transactions": [],
"amount_from_fee":null,
"amount_to_fee":"0",
"deposit_url":null,
"deposit_address":"TVb4KtWABb9vyzMhiLm3cgFaE11MCZfvQu",
"deposit_memo":null,
"blockchain_deposit_hash": null,
"blockchain_withdrawal_hash": null,
"exchange_rate_initial":"0.000035858",
"exchange_rate_actual":null,
"status":"new",
"error_code":0,
"error_message":"",
"created_at":"1970-01-01 19:17:37",
"updated_at":"1970-01-01 19:17:38",
"finalized_at":null,
"start_order_at": null,
"currency_from_precision": 2,
"currency_to_precision": 8,
"balance_changes": [
{
"currency": "usdt",
"amount_before": "1013",
"amount_change": "-13",
"amount_after": "1000",
"created_at": "1970-01-01 19:17:38"
}
]
}
]
}
Поле data
у відповіді містить масив знайдених ордерів.
Дивіться розділ статус ордера з описом полів даних окремого ордера у відповіді.
Додатковий параметр у відповіді
balance_changes
- У разі змін у балансах гаманців користувача під час виконання ордера, зміни відображаються тут у вигляді масиву об'єктів з полями currency
, amount_before
, amount_change
, amount_after
, created_at