Menu

Документация API биржи

Документация API биржи

Здесь вы узнаете как использовать API биржи для торговли, приема криптовалюты в обмен

Начало

Работа по API доступна по всем валютным парам, которые есть на криптовалютной бирже BTC TRADE UA

.

Название валютной пары в url-е формируется по аналогии

btc_uah - пара BitCoin(BTC) к гривне(UAH)

ltc_uah - пара LitCoin(LTC) к гривне(UAH)

ppc_btc - пара Peercoin(PPC) к BitCoin(BTC)

.

Наша реализация всех API вызовов( SDK ) на языке python так же доступна для скачивания btc_trade_ua.py

Авторизация

Для приватных операций на бирже необходимо быть авторизированным.

Механизм авторизации запроса производится путем добавления в запрос

HTTP-заголовка(header) - api_sign и public_key,

public_key - это публичный ключ из вашего личного кабинета ,

api_sign SHA256 хеш от строки - конкатенации вашего post запроса и вашего private_key из личного кабинета,

Типовый запрос баланса из командной строки при помощи команды curl :

curl -k   -i -H "api_sign: 9925916858e6361ffb88fc0b71d763355ea979e3ac62a6acaa8fe4a8ba548abf" -H "public_key: 9e6ea26cc7314d6dea8359f8ed5de68b2b5f0ec8daa0d5eac96b86d2b44ada38"  --data "out_order_id=2&nonce=1" -v  https://btc-trade.com.ua/api/balance                                    
                                    

Получение баланса

Необходимо cформировать POST запрос на url: https://btc-trade.com.ua/api/balance

С POST параметром out_order_id равным произвольному значению и параметром nonce равный любому целочисленному числу,

большем, чем значение, которое вы использовали в прошлом запросе.

Авторизация происходит путем добавление HTTP загаловков public_key и api_sign.

Формирование этих заголовков описано здесь.

Типовый запрос из командной строки при помощи команды curl:

curl -k   -i -H "api_sign: 9925916858e6361ffb88fc0b71d763355ea979e3ac62a6acaa8fe4a8ba548abf" -H "public_key: 9e6ea26cc7314d6dea8359f8ed5de68b2b5f0ec8daa0d5eac96b86d2b44ada38"  --data "out_order_id=2&nonce=1" -v  https://btc-trade.com.ua/api/balance
                                

Результатом запроса будет :

{"msg_count": 0, "accounts": [{"currency": "UAH", "balance": "1744.2104180000"}, {"currency": "BTC", "balance": "0.1205538600"}, {"currency": "LTC", "balance": "1.0266850207"}, {"currency": "NVC", "balance": "0.0000000000"}, {"currency": "DRK", "balance": "0.0000000000"}, {"currency": "VTC", "balance": "0.0000000000"}, {"currency": "PPC", "balance": "0.0000000000"}, {"currency": "HIRO", "balance": "999.5000000000"}],  "notify_count": 0}
                                

JSON - объект с полем accounts, содержащим список счетов по каждой ваюте. Внимание! Параметр out_order_id является обязательным и должен быть добавлен к каждому POST запросу, он должен быть уникальным.

Создание заявки на продажу

Для этого необходимо cформировать POST запрос на url на нужный рынок вам. Например url для

продажи на валютной паре LiteCoin/Гривна https://btc-trade.com.ua/api/sell/ltc_uah

,

С POST параметрами:

count: 0.8851641964

price: 55

out_order_id: 5

nonce : 10

Где :

nonce - целочисленней инкремент, больше чем предыдущее значение

count - количество монет для продажи

price - цена из расчета за одну монету

out_order_id - внешний идентификатор, принимающий произвольное значение уникальное значение

И HTTP загаловками :

public_key - публичный ключ

api_sign - хеш SHA256 от тела POST запроса с добавлением приватного ключа в конце:

count=0.8851641964&nonce=10&price=55&out_order_id=5$privat_key

$privat_key - ваш приватный ключ из личного кабинет

Запрос при помощи команды curl:

curl -k   -i -H "api_sign: 652167fcdc3d0f55cacd4f2eea27e2f2512669126b2ddf5b5cbdbd8e18c23592" -H "public_key: 9e6ea26cc7314d6dea8359f8ed5de68b2b5f0ec8daa0d5eac96b86d2b44ada38"  --data "count=0.8851641964&price=55&out_order_id=5&nonce=10" -v https://btc-trade.com.ua/api/sell/ltc_uah
                            

В случае успеха ответом будет JSON объект вида :

{"status": true, "description": "The order has been created", "order_id": 1 }
                            

order_id - будет содержать внутренний идентификатор в системе, по которому можно будет проверить состояние вашей заявки

В случае неуспешного запроса ответом будет JSON объект вида :

{"status": false, "description": "Not enough funds"}
                            

description - будет содержать описание ошибки,


Создание заявки на покупку

Для этого необходимо cформировать POST запрос на url на нужный вам рынок. Например url для

покупки на валютной паре LiteCoin/Гривна https://btc-trade.com.ua/api/buy/ltc_uah,

С POST параметрами:

count: 1

price: 60

out_order_id: 6

nonce : 11

Где :

nonce - целочисленней инкремент, больше чем предыдущее значение

count - количество монет для продажи

price - цена из расчета за одну монету

out_order_id - внешний идентификатор, принимающий произвольное значение уникальное значение

И HTTP загаловками :

public_key - публичный ключ

api_sign - хеш SHA256 от тела POST запроса с добавлением приватного ключа в конце:

count=1&nonce=11&price=60&out_order_id=6$privat_key, аглоритм описан выше

Запрос при помощи команды curl:

curl -k   -i -H "api_sign: 652167fcdc3d0f55cacd4f2eea27e2f2512669126b2ddf5b5cbdbd8e18c23592" -H "public_key: 9e6ea26cc7314d6dea8359f8ed5de68b2b5f0ec8daa0d5eac96b86d2b44ada38"  --data "count=1&price=60&out_order_id=11&nonce=11" -v https://btc-trade.com.ua/api/sell/ltc_uah
                            

В случае успеха ответом будет JSON объект вида :

{"status": true, "description": "The order has been created", "order_id": 1 }
                            

order_id - будет содержать внутренний идентификатор в системе, по которому можно будет проверить состояние вашей заявки

В случае неуспешного запроса ответом будет JSON объект вида :

{"status": false, "description": "Not enough funds"}
                            

description - будет содержать описание ошибки,


Статуса выполнения заявки

Для провеки статуса выполнения заявок необходимо сформировать POST запрос на url:

https://btc-trade.com.ua/api/order/status/$order_id, где $order_id - внутренний идентификатор, который вы получили при создании заявки.

out_order_id: 7777

nonce : 13

Где :

nonce - целочисленней инкремент, больше чем предыдущее значение

out_order_id - внешний идентификатор, принимающий произвольное значение уникальное значение

И HTTP загаловками :

public_key - публичный ключ

api_sign - хеш SHA256 от тела POST запроса с добавлением приватного ключа в конце:

nonce=13&out_order_id=7777$privat_key, аглоритм также описан выше

Запрос при помощи команды curl:

curl -k   -i -H "api_sign: 652167fcdc3d0f55cacd4f2eea27e2f2512669126b2ddf5b5cbdbd8e18c23592" -H "public_key: 9e6ea26cc7314d6dea8359f8ed5de68b2b5f0ec8daa0d5eac96b86d2b44ada38"  --data "out_order_id=7777&nonce=13" -v https://btc-trade.com.ua/api/order/status/$order_id
                                    

В случае успеха ответом будет JSON объект вида :


{"status": "processing", "sum2_history": "1538.2358440000",
"currency1": "BTC", "sum2": "1538.2358440000", "sum1": "0.2848584896",
"currency2": "UAH", "sum1_history": "0.2848584896", "pub_date": "2014-10-18 19:40:20", "id": "4624"}
                                    

status - принимает значение processing - в работе, processed - выполнена, canceled - отменена

sum1_history - заявочная сумма продажи

sum2_history - заявочная сумма покупки

sum1 - оставшаяся сумма продажи

sum2 - оставшаяся сумма покупки

currency1 - валюта продажи

currency2 - валюта покупки

id - идентификатор заявки

pub_date - дата формирование заявки

unixtime - дата формирования заявки в формате unixtime


Удаление заявки на продажу/покупку

Для провеки статуса выполнения заявок необходимо сформировать запрос на url:

https://btc-trade.com.ua/api/remove/order/$order_id, где $order_id - внутренний идентификатор, который вы получили при создании заявки.

С POST параметрами

out_order_id: 90

nonce: 14

Где :

out_order_id - внешний идентификатор, принимающий произвольное значение

nonce - целочисленней инкремент

И HTTP загаловками :

public_key - публичный ключ

api_sign - хеш SHA256 от тела POST запроса с добавлением приватного ключа в конце:

nonce=14&out_order_id=90$privat_key

Запрос при помощи команды curl:

curl -k   -i -H "api_sign: 652167fcdc3d0f55cacd4f2eea27e2f2512669126b2ddf5b5cbdbd8e18c23592" -H "public_key: 9e6ea26cc7314d6dea8359f8ed5de68b2b5f0ec8daa0d5eac96b86d2b44ada38"  --data "out_order_id=90&nonce=14" -v https://btc-trade.com.ua/remove/order/$order_id
                            

В случае успеха ответом будет JSON объект вида :

{"status": true}

В случае неуспешного запроса

{"status": false, "description":"somethin interesting"}
                                    


Список ваших открытых заявок

Для получения ваших заявок на покупку и продажу на рынке LTC/UAH необходимо сформировать POST запрос на url :

https://btc-trade.com.ua/api/my_orders/ltc_uah

С POST параметрами

out_order_id: 91

nonce: 15

Где :

out_order_id - внешний идентификатор, принимающий произвольное значение

nonce - целочисленней инкремент

И HTTP загаловками :

public_key - публичный ключ

api_sign - хеш SHA256 от тела POST запроса с добавлением приватного ключа в конце:

nonce=15&out_order_id=91$privat_key

Запрос при помощи команды curl:

curl -k   -i -H "api_sign: 652167fcdc3d0f55cacd4f2eea27e2f2512669126b2ddf5b5cbdbd8e18c23592" -H "public_key: 9e6ea26cc7314d6dea8359f8ed5de68b2b5f0ec8daa0d5eac96b86d2b44ada38"  --data "out_order_id=91&nonce=15" -v https://btc-trade.com.ua/api/my_orders/ltc_uah
                            

В случае успеха ответом будет JSON объект вида :

{"your_open_orders": [{"amnt_base": "1538.2358440000","unixtime": 1557839116,
    "pub_date": "Oct. 18, 2014, 7:40 p.m.", "price": "5400.0000000000",
    "sum2": "1538.2358440000", "sum1": "0.2848584896", "amnt_trade": "0.2848584896", "type": "sell", "id": 4624},
{"amnt_base": "1159.4200000000", "unixtime": 1557839116, "pub_date": "Oct. 14, 2014, 8:57 p.m.", "price": "5800.0000000000",
    "sum2": "1159.4200000000", "sum1": "0.1999000000", "amnt_trade": "0.1999000000", "type": "sell", "id": 4405},
{"amnt_base": "1258.3137610000","unixtime": 1557839116, "pub_date": "Oct. 10, 2014, 9:18 p.m.", "price": "6200.0000000000",
    "sum2": "1258.3137610000", "sum1": "0.2029538324", "amnt_trade": "0.2029538324", "type": "sell", "id": 4052}],
"balance_buy": "0.0000396100", "auth": true, "balance_sell": "0.0000000000"}
                                        
                                    

Поле your_open_orders содержит список ваших открытых заявок на покупку/продажу.

id - идентификатор заявки

type - типа покупка - buy, продажа - sell

amnt_trade - сумма в валюте торга

amnt_base - сумма в базовой валюте

price - цена из расчета за одну единицу валюты торга

unixtime - дата формирования заявки в формате unixtime


Список ваших сделок

Для получения ваших закрытых сделок на рынке LTC/UAH необходимо сформировать POST запрос на url :

https://btc-trade.com.ua/api/my_deals/ltc_uah

С POST/GET параметрами

out_order_id: 92

nonce: 16

ts: 2019-01-01

ts1: 2019-01-14

Где :

out_order_id - внешний идентификатор, принимающий произвольное значение

nonce - целочисленней инкремент

ts - стартовая дата поиска сделок в формате YYYY-MM-DD

ts1 - конечная дата поиска сделок в формате YYYY-MM-DD

* максимальный период поиска 14 дней!

И HTTP загаловками :

public_key - публичный ключ

api_sign - хеш SHA256 от тела POST запроса с добавлением приватного ключа в конце:

ts1=2019-01-01&ts1=2019-01-14&out_order_id=92$privat_key

Запрос при помощи команды curl:

curl -k   -i -H "api_sign: 652167fcdc3d0f55cacd4f2eea27e2f2512669126b2ddf5b5cbdbd8e18c23592" -H "public_key: 9e6ea26cc7314d6dea8359f8ed5de68b2b5f0ec8daa0d5eac96b86d2b44ada38"  --data "ts1=2019-01-01&ts1=2019-01-14&out_order_id=92" -v https://btc-trade.com.ua/api/my_deals/ltc_uah
                                

В случае успеха ответом будет JSON список вида :

[{"amnt_base": "1538.2358440000", "unixtime":123123124, "pub_date": "Oct. 18, 2014, 7:40 p.m.", "price": "5400.0000000000",
"sum2": "1538.2358440000", "amnt_trade": "0.2848584896","unixtime":123123114, "amnt_base": "2100.00", "type": "sell", "order_id": 4624},
{"amnt_base": "1159.4200000000", "pub_date": "Oct. 14,"unixtime":123123322, 2014, 8:57 p.m.", "price": "5800.0000000000",
"sum2": "1159.4200000000", "amnt_trade": "0.1999000000","unixtime":123124444, "amnt_base": "9990.00", "type": "sell", "order_id": 4405},
{"amnt_base": "1258.3137610000", "pub_date": "Oct. 10, 2014, 9:18 p.m.","unixtime":1235553124, "price": "6200.0000000000",
"sum2": "1258.3137610000", "amnt_trade": "0.2029538324", "amnt_base": "2029.00","unixtime":1235553124, "type": "sell", "order_id": 4052}]
                                    

Каждый элемент содержи:

order_id - идентификатор заявки в системе

unixtime - дата сделки в формате unixtime

pub_date - дата сделки в humanfriendly формате

type - тип сделки sell - продажа актива, покупка-актива

ts - стартовая дата поиска сделок в формате YYYY-MM-DD

ts1 - конечная дата поиска сделок в формате YYYY-MM-DD

amnt_trade - сумма актива

amnt_base - сумма в базовой валюте


Список сделок по валютной паре

Для получения закрытых сделок на рынке LTC/UAH необходимо сформировать POST/GET запрос на url :

https://btc-trade.com.ua/api/deals/ltc_uah

С параметрами

ts: 2019-01-01

ts1: 2019-01-14

Где

ts - стартовая дата поиска сделок в формате YYYY-MM-DD

ts1 - конечная дата поиска сделок в формате YYYY-MM-DD

* максимальный период поиска 3 дня!

Запрос при помощи команды curl:

                                curl -k   -i  -v https://btc-trade.com.ua/api/deals/ltc_uah?ts1=2019-01-01&ts1=2019-01-14
                                

В случае успеха ответом будет JSON список вида :

    [{"amnt_base": "1538.2358440000", "unixtime":123123124, "pub_date": "Oct. 18, 2014, 7:40 p.m.", "price": "5400.0000000000",
    "sum2": "1538.2358440000", "amnt_trade": "0.2848584896","unixtime":123123114, "amnt_base": "2100.00", "type": "sell", "order_id": 4624},
{"amnt_base": "1159.4200000000", "pub_date": "Oct. 14,"unixtime":123123322, 2014, 8:57 p.m.", "price": "5800.0000000000",
    "sum2": "1159.4200000000", "amnt_trade": "0.1999000000","unixtime":123124444, "amnt_base": "9990.00", "type": "sell", "order_id": 4405},
{"amnt_base": "1258.3137610000", "pub_date": "Oct. 10, 2014, 9:18 p.m.","unixtime":1235553124, "price": "6200.0000000000",
    "sum2": "1258.3137610000", "amnt_trade": "0.2029538324", "amnt_base": "2029.00","unixtime":1235553124, "type": "sell", "order_id": 4052}]
                                    

Каждый элемент содержи:

user - участник сделки

order_id - идентификатор заявки в системе

unixtime - дата сделки в формате unixtime

pub_date - дата сделки в humanfriendly формате

type - тип сделки sell - продажа актива, покупка-актива

ts - стартовая дата поиска сделок в формате YYYY-MM-DD

ts1 - конечная дата поиска сделок в формате YYYY-MM-DD

amnt_trade - сумма актива

amnt_base - сумма в базовой валюте


Получение рыночных цен на бирже(ticker)

GET или POST запрос на url https://btc-trade.com.ua/api/ticker или по конкретной валютной паре https://btc-trade.com.ua/api/ticker/btc_uah:

В случае успеха ответом будет JSON объект вида :

{"ppc_btc": {"sell": "0.0001000000", "currency_trade": "PPC", "buy_usd": "0.0000024242", "buy": "0.0000640000", "last": "0", "updated": 1557839625, "vol": "0", "sell_usd": "0.0000037879", "last_usd": "0", "currency_base": "BTC", "vol_cur": "0", "high": "0", "low": "0", "vol_cur_usd": "0", "avg": "0", "usd_rate": "26.4"}, "ltc_uah": {"sell": "2365.7900473179", "currency_trade": "LTC", "buy_usd": "89.0799242424", "buy": "2351.7100000000", "last": "2351.7000705788", "updated": 1557839624, "vol": "42.1833040200", "sell_usd": "89.6132593681", "last_usd": "89.0795481280", "currency_base": "UAH", "vol_cur": "98404.9326127300", "high": "2444.0000000000", "low": "2230.0120003353", "vol_cur_usd": "3727.4595686640", "avg": "88.3151128263", "usd_rate": "26.4"}, "dash_btc": {"sell": "0.0270000000", "currency_trade": "DASH", "buy_usd": "0.0006250000", "buy": "0.0165000000", "last": "0", "updated": 1557839625, "vol": "0", "sell_usd": "0.0010227273", "last_usd": "0", "currency_base": "BTC", "vol_cur": "0", "high": "0", "low": "0", "vol_cur_usd": "0", "avg": "0", "usd_rate": "26.4"}, "iti_uah": {"sell": "89.8880000000", "currency_trade": "ITI", "buy_usd": "2.4621212125", "buy": "65.0000000100", "last": "94.8999999200", "updated": 1557839628, "vol": "20.6572876800", "sell_usd": "3.4048484848", "last_usd": "3.5946969667", "currency_base": "UAH", "vol_cur": "1623.2445543400", "high": "95.0054288817", "low": "63.0500000000", "vol_cur_usd": "61.4865361492", "avg": "3.1432376235", "usd_rate": "26.4"}, "xrp_uah": {"sell": "10.1880000000", "currency_trade": "XRP", "buy_usd": "0.3712500045", "buy": "9.8010001200", "last": "10.2999999899", "updated": 1557839630, "vol": "39225.1470891700", "sell_usd": "0.3859090909", "last_usd": "0.3901515148", "currency_base": "UAH", "vol_cur": "372659.8772071400", "high": "10.4000000000", "low": "8.3029999972", "vol_cur_usd": "14115.9044396644", "avg": "0.3560413773", "usd_rate": "26.4"}, "xem_uah": {"sell": "1.7500000000", "currency_trade": "XEM", "buy_usd": "0.0613636385", "buy": "1.6200000570", "last": "1.7500000000", "updated": 1557839629, "vol": "6825.8230057700", "sell_usd": "0.0662878788", "last_usd": "0.0662878788", "currency_base": "UAH", "vol_cur": "11228.3680067100", "high": "1.7500000000", "low": "1.4800000000", "vol_cur_usd": "425.3169699511", "avg": "0.0623055556", "usd_rate": "26.4"}, "sib_uah": {"sell": "2.1997000000", "currency_trade": "SIB", "buy_usd": "0.0776515152", "buy": "2.0500000000", "last": "2.2000000001", "updated": 1557839627, "vol": "2854.2261699100", "sell_usd": "0.0833219697", "last_usd": "0.0833333333", "currency_base": "UAH", "vol_cur": "6222.7295729500", "high": "2.2000007851", "low": "2.1000009999", "vol_cur_usd": "235.7094535208", "avg": "0.0824191987", "usd_rate": "26.4"}, "nvc_btc": {"sell": "0.0001400000", "currency_trade": "NVC", "buy_usd": "0.0000038409", "buy": "0.0001014000", "last": "0", "updated": 1557839625, "vol": "0", "sell_usd": "0.0000053030", "last_usd": "0", "currency_base": "BTC", "vol_cur": "0", "high": "0", "low": "0", "vol_cur_usd": "0", "avg": "0", "usd_rate": "26.4"}, "btc_uah": {"sell": "210028.9300000000", "currency_trade": "BTC", "buy_usd": "7922.0632575758", "buy": "209142.4700000000", "last": "209142.4699987822", "updated": 1557839624, "vol": "13.6708084500", "sell_usd": "7955.6412878788", "last_usd": "7922.0632575296", "currency_base": "UAH", "vol_cur": "2788720.8108155299", "high": "265509.0000000000", "low": "102386.0000000000", "vol_cur_usd": "105633.3640460428", "avg": "7719.6795911582", "usd_rate": "26.4"}, "krb_uah": {"sell": "2.6600000000", "currency_trade": "KRB", "buy_usd": "0.0946973485", "buy": "2.5000100000", "last": "2.6599999996", "updated": 1557839628, "vol": "8988.9617412700", "sell_usd": "0.1007575758", "last_usd": "0.1007575757", "currency_base": "UAH", "vol_cur": "23167.1264527300", "high": "2.6800000148", "low": "2.3500000000", "vol_cur_usd": "877.5426686640", "avg": "0.0956165818", "usd_rate": "26.4"}, "btc_usdt": {"sell": "8400.0000000000", "currency_trade": "BTC", "buy_usd": "231.3636363636", "buy": "6108.0000000000", "last": "7900.0222080464", "updated": 1557839630, "vol": "0.0078239600", "sell_usd": "318.1818181818", "last_usd": "299.2432654563", "currency_base": "USDT", "vol_cur": "62.2888000000", "high": "8399.8803009576", "low": "7899.9796937252", "vol_cur_usd": "2.3594242424", "avg": "304.1657742631", "usd_rate": "26.4"}, "zec_uah": {"sell": "1749.8990000000", "currency_trade": "ZEC", "buy_usd": "65.7095833333", "buy": "1734.7330000000", "last": "1733.0000000000", "updated": 1557839629, "vol": "43.0883898600", "sell_usd": "66.2840530303", "last_usd": "65.6439393939", "currency_base": "UAH", "vol_cur": "70543.6647013700", "high": "1794.4402054692", "low": "1350.9999962279", "vol_cur_usd": "2672.1085114155", "avg": "62.0887967235", "usd_rate": "26.4"}, "dash_uah": {"sell": "3579.0000000000", "currency_trade": "DASH", "buy_usd": "130.9469696971", "buy": "3457.0000000033", "last": "3579.0000000000", "updated": 1557839626, "vol": "1.5562522100", "sell_usd": "135.5681818182", "last_usd": "135.5681818182", "currency_base": "UAH", "vol_cur": "5392.2563858000", "high": "3579.0002245842", "low": "3361.0000000000", "vol_cur_usd": "204.2521358258", "avg": "132.0318429949", "usd_rate": "26.4"}, "status": true, "ltc_btc": {"sell": "0.0124000000", "currency_trade": "LTC", "buy_usd": "0.0003939394", "buy": "0.0104000000", "last": "0", "updated": 1557839625, "vol": "0", "sell_usd": "0.0004696970", "last_usd": "0", "currency_base": "BTC", "vol_cur": "0", "high": "0", "low": "0", "vol_cur_usd": "0", "avg": "0", "usd_rate": "26.4"}, "bnb_uah": {"sell": "888.0000000000", "currency_trade": "BNB", "buy_usd": "21.2121212125", "buy": "560.0000000100", "last": "0", "updated": 1557839630, "vol": "0", "sell_usd": "33.6363636364", "last_usd": "0", "currency_base": "UAH", "vol_cur": "0", "high": "0", "low": "0", "vol_cur_usd": "0", "avg": "0", "usd_rate": "26.4"}, "doge_uah": {"sell": "0.0750000000", "currency_trade": "DOGE", "buy_usd": "0.0027958337", "buy": "0.0738100100", "last": "0.0750000000", "updated": 1557839626, "vol": "2348387.6437619701", "sell_usd": "0.0028409091", "last_usd": "0.0028409091", "currency_base": "UAH", "vol_cur": "169700.8997027500", "high": "0.0750000000", "low": "0.0684220000", "vol_cur_usd": "6428.0643826799", "avg": "0.0027296637", "usd_rate": "26.4"}, "tlr_uah": {"sell": "0.0560000000", "currency_trade": "TLR", "buy_usd": "0.0017803030", "buy": "0.0470000000", "last": "0.0560000000", "updated": 1557839629, "vol": "11331.7115229600", "sell_usd": "0.0021212121", "last_usd": "0.0021212121", "currency_base": "UAH", "vol_cur": "593.1616228500", "high": "0.0573000003", "low": "0.0430100000", "vol_cur_usd": "22.4682432898", "avg": "0.0019977919", "usd_rate": "26.4"}, "nvc_uah": {"sell": "26.0000000000", "currency_trade": "NVC", "buy_usd": "0.6439393965", "buy": "17.0000000670", "last": "20.3967620433", "updated": 1557839625, "vol": "33.2105202200", "sell_usd": "0.9848484848", "last_usd": "0.7726046229", "currency_base": "UAH", "vol_cur": "677.3870782600", "high": "20.3967620433", "low": "20.3967620433", "vol_cur_usd": "25.6586014492", "avg": "0.7726046229", "usd_rate": "26.4"}, "eth_uah": {"sell": "5349.3003744830", "currency_trade": "ETH", "buy_usd": "201.0375080411", "buy": "5307.3902122839", "last": "5327.2607392607", "updated": 1557839629, "vol": "278.7616986800", "sell_usd": "202.6250141850", "last_usd": "201.7901795175", "currency_base": "UAH", "vol_cur": "1452455.4387280999", "high": "5415.0000000000", "low": "4850.9999981297", "vol_cur_usd": "55017.2514669735", "avg": "197.9710251264", "usd_rate": "26.4"}, "fno_uah": {"sell": "0.0692990000", "currency_trade": "FNO", "buy_usd": "0.0023484848", "buy": "0.0620000000", "last": "0", "updated": 1557839630, "vol": "0", "sell_usd": "0.0026249621", "last_usd": "0", "currency_base": "UAH", "vol_cur": "0", "high": "0", "low": "0", "vol_cur_usd": "0", "avg": "0", "usd_rate": "26.4"}, "etc_uah": {"sell": "164.0000000000", "currency_trade": "ETC", "buy_usd": "5.9284469697", "buy": "156.5110000000", "last": "164.0000000607", "updated": 1557839629, "vol": "274.6719801200", "sell_usd": "6.2121212121", "last_usd": "6.2121212144", "currency_base": "UAH", "vol_cur": "44013.5389274400", "high": "171.9900000109", "low": "154.0010000000", "vol_cur_usd": "1667.1795048273", "avg": "6.0985680400", "usd_rate": "26.4"}, "bch_uah": {"sell": "10500.0000000000", "currency_trade": "BCH", "buy_usd": "364.6212121212", "buy": "9626.0000000000", "last": "9626.0000000000", "updated": 1557839629, "vol": "16.8839242600", "sell_usd": "397.7272727273", "last_usd": "364.6212121212", "currency_base": "UAH", "vol_cur": "169659.2393375500", "high": "10694.9989999333", "low": "9149.9999392638", "vol_cur_usd": "6426.4863385436", "avg": "379.3988679036", "usd_rate": "26.4"}, "doge_btc": {"sell": "0.0000003600", "currency_trade": "DOGE", "buy_usd": "0.0000000129", "buy": "0.0000003401", "last": "0", "updated": 1557839626, "vol": "0", "sell_usd": "0.0000000136", "last_usd": "0", "currency_base": "BTC", "vol_cur": "0", "high": "0", "low": "0", "vol_cur_usd": "0", "avg": "0", "usd_rate": "26.4"}, "usdt_uah": {"sell": "26.5789990000", "currency_trade": "USDT", "buy_usd": "0.9886360227", "buy": "26.0999910000", "last": "26.5789990031", "updated": 1557839630, "vol": "170.4257071000", "sell_usd": "1.0067802652", "last_usd": "1.0067802653", "currency_base": "UAH", "vol_cur": "4439.3437120500", "high": "26.5789990031", "low": "25.8200010095", "vol_cur_usd": "168.1569587898", "avg": "0.9869010320", "usd_rate": "26.4"}, "xmr_uah": {"sell": "2244.0000000000", "currency_trade": "XMR", "buy_usd": "76.6291666667", "buy": "2023.0100000000", "last": "2042.9396569810", "updated": 1557839629, "vol": "5.6877826700", "sell_usd": "85.0000000000", "last_usd": "77.3840779159", "currency_base": "UAH", "vol_cur": "11893.1605383500", "high": "2285.0000003383", "low": "1999.9997851836", "vol_cur_usd": "450.4985052405", "avg": "79.9384334811", "usd_rate": "26.4"}}

Объект с ключами -название рынка, а значение объект со значениями:

Цена продажи валюты торга -

"sell": "1600.0000000000",

Цена покупки валюты торга -

"buy": "1401.0000000000",

Цена последней сделки -

"last": "1421.0000000000",

Unixtime обновления данных -

"updated": 1517248441,

Цена продажи валюты торга в долларовом эквиваленте - "sell_usd": "57.1428571400",

Цена покупки валюты торга в долларовом эквиваленте -

"buy_usd": "50.0357142900",

Цена последней сделки в долларовом эквиваленте -

"last_usd": "50.0357142900",

Максимальная цена за 24 часа -

"high": "1769.0000000000",

Минимальная цена за 24 часа -

"low": "1401.0000000000",

Объем торгов в базовой валюте в долларовом эквиваленте - "vol_cur_usd": "188.7439966000",

Объем торгов в валюте торга за 24 часа

"vol": "3.7035610000",

Объем торгов в базовой валюте за 24 часа

"vol_cur": "5284.8319050000",

Валюта торга -

"currency_trade": "ITI",

Валюта базовая-

"currency_base": "UAH",

Средняя цена за 24 часа -

"avg": "53.6405328900",

Наш локальный курс :) -

"usd_rate": "28"


Список заявок на продажу валюты

Запрос на получение списка заявок на продажу валюты торга в выбраной валютной паре :

https://btc-trade.com.ua/api/trades/sell/btc_uah

Результатом работы данного запроса будет объект,содержащий информацию о заявках на продажу валюты торга( в данном случае валютной пары BitCoin/ Гривна) в формате JSON:

{"min_price": "4910.0000000000", "list": [{"currency_trade": "0.0092000000", "price": "4910.0000000000", "currency_base": "45.1720000000"},
{"currency_trade": "0.0323484400", "price": "5000.0000000000", "currency_base": "161.7422000000"},
{"currency_trade": "0.0400000000", "price": "5400.0000000000", "currency_base": "216.0000000000"},
{"currency_trade": "2.0797893000", "price": "5500.0000000000", "currency_base": "11438.8410000000"},
{"currency_trade": "1.5000000000", "price": "5678.0000000000", "currency_base": "8517.0000000000"},
{"currency_trade": "0.0023348400", "price": "6100.0000000000", "currency_base": "14.2425240000"},
{"currency_trade": "0.2029538324", "price": "6400.0000000000", "currency_base": "1298.9045270000"},
{"currency_trade": "3.4808297160", "price": "6600.0000000000", "currency_base": "22973.4761300000"},
{"currency_trade": "0.2431990000", "price": "7000.0000000000", "currency_base": "1702.3930000000"},
{"currency_trade": "0.1000000000", "price": "7400.0000000000", "currency_base": "740.0000000000"},
{"currency_trade": "0.1500000000", "price": "7600.0000000000", "currency_base": "1140.0000000000"},
{"currency_trade": "0.0700000000", "price": "9999.0000000000", "currency_base": "699.9300000000"},
{"currency_trade": "0.0020000000", "price": "40100.0000000000", "currency_base": "80.2000000000"}],
"orders_sum": "7.9126550000", "max_price": "40100.0000000000"}
                                    
                                

min_price - минимальная цена в списке заявок

list - список заявок на продажу содежащий объекты заявок.

orders_sum - сумма всех заявок на продажу в валюте торга

max_price - максимальная цена в списке заявок

Объект заявок состоит из:

currency_trade - сумма на продажу в валюте торга

price - цена из расчета за одну целую единицу валюты торга

currency_base - сумма сделки в базовой валюте


Список заявок на покупку валюты

Запрос на получение списка заявок на покупку валюты торга в выбраной валютной паре :

https://btc-trade.com.ua/api/trades/buy/btc_uah

Результатом работы данного запроса будет объект, содержащий информацию о заявках на покупку валюты торга( в данном случае валютной пары BitCoin/ Гривна) в формате JSON:

{"min_price": "4910.0000000000", "list": [{"currency_trade": "0.0092000000", "price": "4910.0000000000", "currency_base": "45.1720000000"},
{"currency_trade": "0.0323484400", "price": "5000.0000000000", "currency_base": "161.7422000000"},
{"currency_trade": "0.0400000000", "price": "5400.0000000000", "currency_base": "216.0000000000"},
{"currency_trade": "2.0797893000", "price": "5500.0000000000", "currency_base": "11438.8410000000"},
{"currency_trade": "1.5000000000", "price": "5678.0000000000", "currency_base": "8517.0000000000"},
{"currency_trade": "0.0023348400", "price": "6100.0000000000", "currency_base": "14.2425240000"},
{"currency_trade": "0.2029538324", "price": "6400.0000000000", "currency_base": "1298.9045270000"},
{"currency_trade": "3.4808297160", "price": "6600.0000000000", "currency_base": "22973.4761300000"},
{"currency_trade": "0.2431990000", "price": "7000.0000000000", "currency_base": "1702.3930000000"},
{"currency_trade": "0.1000000000", "price": "7400.0000000000", "currency_base": "740.0000000000"},
{"currency_trade": "0.1500000000", "price": "7600.0000000000", "currency_base": "1140.0000000000"},
{"currency_trade": "0.0700000000", "price": "9999.0000000000", "currency_base": "699.9300000000"},
{"currency_trade": "0.0020000000", "price": "40100.0000000000", "currency_base": "80.2000000000"}],
"orders_sum": "7.9126550000", "max_price": "40100.0000000000"}
                                

min_price - минимальная цена в списке заявок на покупку

list - список заявок на покупку содежащий объекты заявок.

orders_sum - сумма всех заявок на покупку в базовой валюте ( в данном случае Гривна)

max_price - максимальная цена в списке заявок на покупку

Объект заявок состоит из:

currency_trade - сумма покупки в валюте торга

price - цена из расчета за одну целую единицу валюты торга

currency_base - сумма сделки в базовой валюте


Получение стоимости покупки

Для получение стоимости покупки определенной суммы актива, исходя из текущих заявок на продажу

необходимо отправить GET/POST запрос на url https://btc-trade.com.ua/api/ask/btc_uah?is_api=1&amount=0.5

С POST/GET параметрами

amount: сумма покупки

В случае успеха ответом будет JSON объект вида :

{"status": true, "start_price": "209499.9899999999", "avarage_price": "209499.9992840095", "end_price": "209500.0000000000", "got_sum": "104749.9996420047", "buy_sum": "0.5000000000", "orders": [{"sum": "0.0238663500", "cost_sum": "5000.0000863365", "price": "209499.9899999999"}, {"sum": "0.0119331700", "cost_sum": "2499.9989956683", "price": "209499.9899999999"}, {"sum": "0.4642004800", "cost_sum": "97250.0005600000", "price": "209500.0000000000"}]}
                                    

status - результат запроса true или false

avarage_price - средневзвешенная цена покупки

min_price - минимальная цена в выборке

max_price - максимальная цена в выборке

got_sum - сумма к оплате в базовой валюте

buy_sum - сумма покупки актива валюты торга

orders - список ордеров которые покроет заявка


Получение стоимости продажи

Для получение стоимости продажи определенной суммы актива, исходя из текущих заявок на покупку

необходимо отправить GET/POST запрос на url https://btc-trade.com.ua/api/bid/btc_uah?is_api=1&amount=0.5

С POST/GET параметрами

amount: сумма продажи

В случае успеха ответом будет JSON объект вида :

{"status": true, "start_price": "207001.0299999999", "cost_sum": "102705.2711044534", "sell_sum": "0.5000000000", "avarage_price": "205410.5422089068", "avarate_price": "205410.5422089068", "end_price": "204004.5899999999", "orders": [{"sum": "0.0242011000", "price": "207001.0299999999", "got_sum": "5009.6526271330"}, {"sum": "0.0242011000", "price": "207001.0100000000", "got_sum": "5009.6521431110"}, {"sum": "0.0100000000", "price": "207001.0100000000", "got_sum": "2070.0101000000"}, {"sum": "0.0202536300", "price": "207001.0000000000", "got_sum": "4192.5216636300"}, {"sum": "0.0631255800", "price": "207000.0000000000", "got_sum": "13066.9950599999"}, {"sum": "0.0359089100", "price": "206602.2019999999", "got_sum": "7418.8598774198"}, {"sum": "0.0121400000", "price": "206000.0000000000", "got_sum": "2500.8400000000"}, {"sum": "0.0037307400", "price": "206000.0000000000", "got_sum": "768.5324400000"}, {"sum": "0.0085000000", "price": "205640.6520000000", "got_sum": "1747.9455420000"}, {"sum": "0.0158000000", "price": "205640.6300000000", "got_sum": "3249.1219540000"}, {"sum": "0.0100500000", "price": "205513.4400000000", "got_sum": "2065.4100720000"}, {"sum": "0.0350000000", "price": "205100.0000000000", "got_sum": "7178.5000000000"}, {"sum": "0.0300030000", "price": "205002.2019999999", "got_sum": "6150.6810666060"}, {"sum": "0.0020000000", "price": "205001.0000000000", "got_sum": "410.0020000000"}, {"sum": "0.0428929000", "price": "204600.0000000000", "got_sum": "8775.8873399999"}, {"sum": "0.0042500000", "price": "204600.0000000000", "got_sum": "869.5500000000"}, {"sum": "0.0100000000", "price": "204005.0000000000", "got_sum": "2040.0500000000"}, {"sum": "0.1479430400", "price": "204004.5899999999", "got_sum": "30181.0592185536"}]}

                                           
                                    

status - результат запроса true или false

avarage_price - средневзвешенная цена продажи из расчета за одну монету

min_price - минимальная цена в выборке заявок

max_price - максимальная цена в выборке заявок

sell_sum - сумма актива продажи

cost_sum - сумма вырученная за сделку

orders - список ордеров которые покроет заявка


Пополнения кошелька

Для получения адреса пополнения криптовалют необходимо сделать POST запрос на url:

https://btc-trade.com.ua/finance/crypto_currency/BTC

C POST параметрами:

out_order_id: 1931

nonce: 14

C HTTP заголовками:

public_key - публичный ключ

api_sign - хеш SHA256 от тела POST запроса с добавлением приватного ключа в конце, см. выше

В случае успеха метод вернет словарь с ключами:

ext_info - уникальный идентификатор обязательный для пополнения некоторых криптовалют(если такой нужен XMR)

status - True (если запрос успешен)

account - адрес кошелька для пополнения

help - информация о количестве подверждений сети необходимых для зачисления на баланс


API инвойсов

Это api преднозначено для создание инвойсов на оплату при помощи

криптовалюты с зачислением на ваш баланс на бирже

https://btc-trade.com.ua/checkout/invoice

может принимать как post параметры(по умолчанию) так и json,

при передачи json необходимо обязательно передать http заголовок content-type: application/json.

{
    "phone":"+380973426666",
    "email":"phpdev@gmail.com",
    "name":"bodgan chayja",
    "title":"test title",
    "description":"test title",
    "currency":"btc",
    "order":"test1",
    "flexible":0,
    "amnt":5.0,
    "server_url_notify":"https://yourserver.com/checkout_order",
    "url_return":"https://yourserver./checkout_order_page",
    "expire_date": “yyyy-mm-dd hh:mm:ss”
}
                                    
                                    

параметры запроса :

"phone" - телефон клиента, можно оставлять пустую строку

"email" - email клиента , можно оставлять пустую строку

"name" - имя клиента , можно оставлять пустую строку

"title" - название позиции продажи, можно оставлять пустую строку

"description" - описание продажи, можно оставлять пустую строку

"currency" - валюта, обязательное поле

"order" - идентификатор заказа мерчанта, должно быть уникальным для каждого заказа, обязательное поле

"flexible":0 - всегда 0, обязательное поле

"amnt": - сумма заказа , обязательное поле

"server_url_notify” - url для передачи данных об изменении состояния заказа, обязательное поле

"url_return" - url возврата клиента, обязательное поле

"expire_date": - дата истечении актуальности заказа, если не задано, то будет выставлена, как текущая дата плюс два часа.

и http загаловками :

api_sign - хеш сумма sha256, сформированная от тела post запроса будь то

данные application/json или application/x-www-form-urlencoded с добавлением приватного ключа в конце.

public_key - публичный ключ мерчанта

если запрос выполнился корректно то результатом работы будет http ответ

со статусом 200 и телом в формате json, если есть заголовок http

accept: application/json или в формате html страницы, если заголовок не передан.

объект json c полями :

"status" - статус состояния заказа может принимать значения

processing - заказ в работе,

canceled - заказ отменен - истекло время ожидания платежа

false - заказ не принят из-за ошибки, описание ошибки в поле

description, так же при статусе false все поля кроме

description будут отсутствовать...

"ref" - уникальный идентификатор запроса в системе

"invoice_page" - url html страницы заказа на сайте btc-trade.com.ua

"phone" - телефон клиента

"email" - email клиента

"name" - имя клиента

"title" - название заказа

"description" - описание заказа

"currency" - валюта

"order" - идентификатор заказа мерчанта

"flexible":0 - всегда 0

"amnt": - сумма заказа

"server_url_notify” - url для передачи данных об изменении состояния заказа

"url_return" - url возврата клиента

expire_date: - дата истечения актуальности заказа

pub_date: - дата формирования заказа

после удачного формирования заказа( status не false) в случае

оплаты или истечения времени ожидания оплаты, система посылает

http запросы в формат json на url, который был указан в поле server_url_notify.

"status" - статус состояния заказа может принимать значения

processing - заказ в работе,

canceled - заказ отменен - истекло время ожидания платежа

"ref" - уникальный идентификатор запроса в системе

"invoice_page" - url html страницы заказа на сайте btc-trade.com.ua

"phone" - телефон клиента

"email" - email клиента

"name" - имя клиента

"title" - название заказа

"description" - описание заказа

"currency" - валюта

"order" - идентификатор заказа мерчанта

"flexible":0 - всегда 0

"amnt": - сумма заказа

"server_url_notify” - url для передачи данных об изменении состояния заказа

"url_return" - url возврата клиента

expire_date: - дата истечения актуальности заказа

pub_date: - дата формирования заказа

И HTTP загаловками :

api_sign - хеш сумма sha256, сформированная от тела post запроса добавлением приватного ключа в конце.

пример подписи : ‘{“status”: “proсessing” ...}$private_key’

public_key: публичный ключ мерчанта


API вызов проверки статуса заказа

POST : https://btc-trade.com.ua/checkout/status

В качестве параметра передать $order - цифробуквенное значение, которое мерчант передал системе при формировании заказа.

И HTTP загаловками :

api_sign - хеш сумма sha256, сформированная от тела post запроса добавлением приватного ключа в конце.

пример подписи : ‘{“order”: “$order” ...}$private_key’ public_key: публичный ключ мерчанта


API Вывод криптовалюты

POST url:https://btc-trade.com.ua/checkout/send

Мы должны передать POST параметры:

out_order_id - внешний идентификатор, принимающий произвольное значение

nonce - целочисленней инкремент

currency - валюта для вывода

wallet - адрес кошелька на который хотим осуществить вывод

amnt - сумма перевода

payment_id - обязательный параметр для некоторых валют (KRB, XRP ,XEM, XMR)

И HTTP заголовками:

security_password: равен шестизначному цифровому коду, который является результатом функции от времени и дополнительного ключа для вывода, которая работает по алгоритму TOTP. Дополнительный ключ вывода можно получить в личном кабинете.

Внимание!!! Чтобы данное АПИ работало, необходимо настроить ip, с которых будет возможно обращаться к нему.

api_sign - хеш сумма sha256, сформированная от тела post запроса добавлением приватного ключа в конце.

public_key: публичный ключ мерчанта

В случае успешного добавления в очередь выводов вернется JSON: {"ref": order_id }


Проверка статуса вывода

POST url:https://btc-trade.com.ua/checkout/send/status

Мы должны передать POST параметры:

out_order_id - внешний идентификатор, принимающий произвольное значение

nonce - целочисленней инкремент

ref - id которая система присвоила выводу.

И HTTP заголовками:

security_password: равен шестизначному цифровому коду, который является результатом функции от времени и дополнительного ключа для вывода, которая работает по алгоритму TOTP. Дополнительный ключ вывода можно получить в личном кабинете.

Внимание!!! Чтобы данное АПИ работало, необходимо настроить ip, с которых будет возможно обращаться к нему.

api_sign - хеш сумма sha256, сформированная от тела post запроса добавлением приватного ключа в конце.

public_key: публичный ключ мерчанта

В случае успеха будет возвращен JSON, где:

account - адрес для вывода

confirms - количество подверждений сети

description - описание

crypto_txid - хеш транзакции

comission - комиссия

payment_id - уникальный идентификатор

amnt - сумма

currency - валюта

pub_date - дата вывода

status - статус


П
о
м
о
щ
ь
0