Общие данные

Этот API не требует использования авторизации и доступен с помощью GET или POST запроса.

В общем виде URL для доступа к API выглядит следующим образом https://binapex.com/api/{api_name}?{api_params} где api_name - это название API к которому происходит обращение, а api_params - входящие параметры запроса (если они необходимы)

GetMarketSummaries

Параметры

ПараметрОбязательныйОписание
format необязательный Если указан short - то в выводе будет только основная информация

Запрос

https://binapex.com/api/GetMarketSummaries

Ответ

  {
    "messages": "", 
    "result": [
        {
            "PrevDay": "3759.7095", 
            "Last": "3832.55804228", 
            "isLeverage": 1, 
            "MarketName": "BTC-USD", 
            "Low": "3681.455", 
            "isToken": 0, 
            "Volume": "24.00411263", 
            "fee": "0.00200000", 
            "MarketNameLong": "Bitcoin", 
            "High": "3937.47613344", 
            "BaseVolume": "87479.79937224"
        }, {
            "PrevDay": "127.7565", 
            "Last": "140.32975529", 
            "isLeverage": 1, 
            "MarketName": "ETH-USD", 
            "Low": "127.4295", 
            "isToken": 0, 
            "Volume": "62.26929758", 
            "fee": "0.00200000", 
            "MarketNameLong": "Ethereum", 
            "High": "142.76363583", 
            "BaseVolume": "6401.67652641"
        }
    ],
    "success": true
  }
  
GetMarketHistory

Параметры

ПараметрОбязательныйОписание
market обязательный наименование маркета (BTC-USD) для которого требуется сформировать историю торгов

Запрос

https://binapex.com/api/GetMarketHistory?pair=BTC-USD

Ответ

  {
    "messages": "", 
    "result": [
        {
        "Id": 237037, 
        "FillType": "PARTIAL_FILL", 
        "OrderType": "SELL", 
        "TimeStamp": 1545809473, 
        "Price": "0.00009945", 
        "Total": "0", 
        "Quantity": "36636.32412965"
        }, {
        "Id": 237036, 
        "Self": "", 
        "FillType": "PARTIAL_FILL", 
        "OrderType": "SELL", 
        "TimeStamp": 1545809472, 
        "Price": "0.00009945", 
        "Total": "0", 
        "Quantity": "40792.0324509"
        }
    ], "success": true
  }
  
GetTradePairChart

Параметры

ПараметрОбязательныйОписание
market обязательный маркет для которого формируются данные для графика
dataRange обязательный ID интервала за который выводятся данные (1 день, 2 дня, 1 неделя, 2 недели, 1 месяц, 3 месяца, 6 месяцев, все данные)
dataGroup обязательный ID интервал группировки данных (15 минут, 30 минут, 1 час, 2 часа, 4 часа, 12 часов, 1 день, 1 неделя)
timeStamp необязательный unix time stamp начиная с которого формируются данные

Запрос

https://binapex.com/api/GetTradePairChart?market=BTC-USD&dataRange=2&dataGroup=1

Ответ

  {
    "messages": "", 
    "result": {
        "BTC-USD": [
            [1543220100, "3930.50258608", "4054.84943184", "4054.84943184", "4006.05504742", "0.00000004", "4030.45223963"], 
            [1543221900, "3950.72492011", "4005.49624283", "4005.49624283", "3978.31195656", "0.00000004", "3991.90409969"], ...
        ]
    }, 
    "success": true
  }
  

Запросы с авторизацией пользователя

Для доступа к данному API требуется авторизация и необходимо использовать POST метод.

URL — необходимо использовать следующий адрес https://api.exmo.com/v1/{api_name} где api_name - это наименование API метода

Авторизация осуществляется с помощью отправки на сервер следующих заголовков:

Key — Публичный ключ, его нужно взять настройках профиля пользователя
(пример: K-7cc97c89aed2a2fd9ed7792d48d63f65800c447b)

Sign — POST данные (param=val&param1=val1), подписанные секретным ключом методом HMAC-SHA512, секретный ключ также нужно брать в настройках профиля пользователя

Дополнительно во всех запросах должен находиться обязательный параметр nonce с инкрементным числовым значением (>0). Это значение не должно повторяться или уменьшаться в рамках пользователя.

Данные пользователя

UserApiKeysGet

Параметры

ПараметрОбязательныйОписание
market обязательный наименование маркета (BTC-USD) для которого требуется сформировать историю торгов

Запрос

https://binapex.com/api/UserApiKeysGet

Ответ

  {
    "messages": "", 
    "result": [
        {
            "id": 20, 
            "isActive": 0, 
            "LastUpdate": "2018-12-20 08:35:42", 
            "Key": "ywSs/3X3Rcdgsdf37vGIcc0a11d7AV36659l10Ouq2RZ7cs5tc19UmIvlXped/Q2342+xlzFIGEqZGR/fCehpQ==", 
            "Sign": "WT8Y0u2115fto8MNzqce"
        }, {
            "id": 9, 
            "isActive": 0, 
            "LastUpdate": "2018-12-11 10:40:18", 
            "Key": "dTN3vUP323WJ6ssfEZjtI7tT/GicyNey0yT/n59QDiha13JDqaSbY854YGDPW6g3ITK5v9fuH1231v6EkxKosA==", 
            "Sign": "hJoavT23zrdxreXuWJRy"
        }
    ], 
    "success": true
  }
  
UserOrderList

Параметры

ПараметрОбязательныйОписание
complete необязательный если Y - то выводятся завершенные ордера, иначе только открытые активные ордера
limit необязательный количество отображаемых данных на странице
page необязательный номер начиная с которой выводятся записи, рассчитывается как page*limit

Запрос

https://binapex.com/api/UserOrderList

Ответ

  
  
UserWallet

Запрос

https://binapex.com/api/UserWallet

Ответ

  {
    "messages": "", 
    "result": [
        {
            "available": "9359.077922117943680000000000", 
            "fund": "9359.077922137943680000000000", 
            "MarketName": "USD", 
            "userId": 1
        }, {
            "available": "0.177497980000000000000000", 
            "fund": "0.177497980000000000000000", 
            "MarketName": "BTC", 
            "userId": 1
        }
    ], "success": true
  }
  
DepositeHistory

Запрос

https://binapex.com/api/DepositeHistory

Ответ

  {
    "messages": "", 
    "result": [
        {
            "Name": "BTC", 
            "Created": 1545738217, 
            "TimeStamp": 1545742682, 
            "IsComplete": 1, 
            "Access": 0, 
            "Valid": 0, 
            "TransactionId": "21af3e4f2cef66b3b772145a9bb89f16a2be745a59353752ebffb675da380f7a", 
            "Quantity": "0.00010000", 
            "Status": 0, 
            "Fee:": "0E-8", 
            "Address": "32rmSxEu4k9CcCoNE3pQYYYjdLHvaoMEdR", 
            "Id": 1, 
            "IsActive": 1
        }
    ], 
    "success": true
  }
  
WithdrawHistory

Запрос

https://binapex.com/api/WithdrawHistory

Ответ

  {
    "messages": "", 
        "result": [
            {
                "Name": "BTC", 
                "Created": 1545739237, 
                "TimeStamp": 1545747242, 
                "IsComplete": 1, 
                "Access": 0, 
                "Valid": 0, 
                "TransactionId": "003ee5c316ed24e770c92c819176e3f846b7818871da2d06e5a523cacc3ed235", 
                "Quantity": "0.00010000", 
                "Status": 1, 
                "Fee:": "0E-8", 
                "Address": "1pd52nsiF1q3nf9tWYeTKKP69k5i13QoL", 
                "Id": 2, 
                "IsActive": 1
            }
        ], 
        "success": true
  }
  

Работа с ордерами

OrderCreate

Параметры

ПараметрОбязательныйОписание
pair обязательный маркет создания ордера (пример BTC-USD)
quantity обязательный объем ордера
price обязательный цена ордера
type обязательный тип сделки (BUY или SELL)
l_stop необязательный стоп, цена при достижении которой отменяется текущий ордер, и выставляется новый с объемом l_amount и ценой l_limit
l_limit необязательный стоимость, с которой будет выставлен новый ордер при достижении цены l_stop
l_amount необязательный объем, с которым будет выставлен новый ордер при достижении цены l_stop
is_leverage не обязательный 1 - для маржинальное торговли, в противном случае обычная торговля
leverage не обязательный плечо в маржинальной торговле

Запрос

Ответ

  
  
OrderCancel

Параметры

ПараметрОбязательныйОписание
order_id обязательный ID ордера для закрытия

Запрос

Ответ

  
  

Маржинальная торговля

GetUserPosition

Запрос

Ответ

  
  
ClosePositions

Параметры

ПараметрОбязательныйОписание
position_id обязательный ID позиции
price обязательный Стоимость закрытия

Запрос

Ответ

  
  
ChangeMargin

Параметры

ПараметрОбязательныйОписание
position обязательный ID позиции
margin обязательный новое значение маржи для позиции

Запрос

Ответ