Cryptex logotype

Документация API cryptex.net

Общее описание команд (запросов)

 

url — https://cryptex.net/api/v1

key — API ключ cryptex.net

sign — Подписанный nonce) и имя пользователя с секретным ключом и ключом API от cryptex.net

method — Одно из названий методов API ‘Info’, ‘AcriveOrders’, ‘OrderInfo’, ‘CancelOrder’, ‘TradeHistory’, ‘Trade’

nonce — Дополнительный одноразовый номер. Целое число. Должен быть больше, чем номер из предыдущего запроса.  Min: 0. 0 -> 1 -> 2 -> 3 -> 4 -> 5


 

API Методы:

Info — Вернуть общую информацию о балансах валют и кол-ве открытых ордеров, для заданного пользователя

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

with_reserves - опциональный флаг указывающий на необходимость учета резервов баланса (0|1|TRUE|FALSE|YES|NO)

Пример ответа от сервера


  
    {
      'status': 'ok',
      'data': {
          'balances': {'BTC': 1000},
          'open_orders': 1000,
      },
    }


GetNewAddress - Получить новый адрес для депозита

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

currency - код валюты в формате “XXX” (BTC)

Пример ответа от сервера


  
    {
      'status': 'ok',
      'data': {
          'address': '1BvBMSEYstWetqTFn5Au4m4GFg7xJaNVN2',
      },
    }


DepositInfo - Получение информации о депозите

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

address - крипто адрес депозита.

Пример ответа от сервера


  
    {
      'status': 'ok',
      'data': {
          'status': 0,
          'amount': 100,
          'confirmations': 3,
          'txid': 'a4c5c72984d8cd9d34e9caf5538d6dcfaf20aabae45c7c09d2794027704b729c',
      },
    }


Withdraw - Вывод средств на указанный адрес

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

amount - крипто адрес депозита.
address - крипто адрес получения.
currency - код валюты в формате “XXX” (BTC).

Пример ответа от сервера


  
    {
      'status': 'ok',
      'data': 'Opened'
    }


ActiveOrders - Вернуть информацию об активных ордерах пользователя в виде словаря

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

pair - опциональный фильтр по торговой валютной паре в виде строки “XXX_YYY”
order - опциональный режим сортировки результата, строка из списка [“ASC”, “DESC”]

Пример ответа от сервера


  
    {
      'status': 'ok',
      'data': [
          {
              "order_id":1,
              "timestamp":20140812003842,
              "pair":"BTC_USD",
              "type":"sell",
              "price":2500,
              "amount":10,
              "filled": 3,
              "status": 1
          },
      ]
    }


UnconfirmedTransactions - Вернуть сведения о последней 1000 неподтвержденных транзакций пользователя, для указанных крипто-валют

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

pair - опциональный фильтр по торговой валютной паре в виде строки “XXX_YYY”
order - опциональный режим сортировки результата, строка из списка [“ASC”, “DESC”]

Пример ответа от сервера


  
    {
      'status': 'ok',
      'data': {
          'BTC': [
              {
              'id':100,
              'address': '1BvBMSEYstWetqTFn5Au4m4GFg7xJaNVN2',
              'txid': 'a4c5c72984d8cd9d34e9caf5538d6dcfaf20aabae45c7c09d2794027704b729c',
              'amount': 100.00,
              'confirmations': 3,
              'timestamp': 31556926,
              },
          ]
      },
    }


OrderInfo - Вернуть информацию об указанном ордере пользователя в виде словаря

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

order_id - обязательный идентификатор ордера

Пример ответа от сервера


  
    {
      'status': 'ok',
      'data': {
          1: {
              "order_id":1,
              "timestamp":20140812003842,
              "pair":"BTC_USD",
              "type":"sell",
              "price":2500,
              "amount":10,
              "filled": 3,
              "status": 1
          }
      }
    }


CancelOrder - Отменить указанный ордер пользователя и вернуть информацию об отмененном ордере и обновленных балансах валют

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

order_id - обязательный идентификатор ордера

Пример ответа от сервера


  
    {
      'status': 'ok',
      'data': {
          'order_id': 1,
          'balances': {'BTC': 1000},
      },
    }


TradeHistory - Вернуть историю торгов

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

pair - опциональный фильтр по торговой валютной паре в виде строки “XXX_YYY”
since - опциональный фильтр начала временного отрезка истории
end - опциональный фильтр конца временного отрезка истории
count - опциональный фильтр количества получаемых записей истории (до 1000 записей max)
order - опциональный признак упорядочивания результата (“ASC” | “DESC”)

Пример ответа от сервера


  
    {
      'status': 'ok',
      'data': [
          {
              "transaction_id":1,
              "buy_order_id":1,
              "sell_order_id":2,
              "timestamp":20140812003842,
              "pair":"USD_BTC",
              "type":"sell",
              "price":2500,
              "amount":10,
              "is_instant_buy":0
          },
          {
              "transaction_id":2,
              "buy_order_id":3,
              "sell_order_id":4,
              "timestamp":20140812003842,
              "pair":"BTC_USD",
              "type":"buy",
              "price":2500,
              "amount":10,
              "is_instant_buy":1
          }
      ],
    }


Trade - Разместить торговый ордер по валютной паре для заданного пользователя, и вернуть информацию о балансах

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

pair - торговая валютная пара в виде строки “XXX_YYY”
type - тип ордера (“sell” | “buy”)
price - цена (> 0)
amount - сумма (> 0)

Пример ответа от сервера


  
    {
      'status': 'ok',
      'data': {
          'balances': {'BTC': 100,'USD': 10000,}
          'order': 1,
      },
    }


CouponCreate - Выписать cryptex-code купон и вернуть его сумму и код

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

currency - код валюты в формате “XXX”
amount - сумма в валюте купона
recipient - опциональный идентификатор получателя купона

Пример ответа от сервера


  
    {
      'status': 'ok',
      'data': {
          'amount': '100',
          'code': 'CTX-USD-AnrNiDs1-YuXvcE31-GfurFFvt-I5f1QnQE',
      },
    }

    {
      'status': 'ok',
      'data': 'send_to_moderation',
    }


CouponRedeem - Погасить cryptex-code купон и вернуть его сумму

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

code - код cryptex-code купона

Пример ответа от сервера


  
    {
      'status': 'ok',
      'data': {
          'amount': '100',
      },
    }

Python Example


  
      import requests
      import hmac
      import hashlib

      auth = {
      'key': YOUR_KEY,
      'secret': YOUR_SECRET,
      'nonce': 109,
      }

      def get_sign():
      message = str(auth['nonce']) + 'username' + auth['key']
      return hmac.new(auth['secret'].encode(), msg=message.encode(),
      digestmod=hashlib.sha256).hexdigest().upper()

      res = requests.post(
        url='https://cryptex.net/api/v1',
        data={
          'method': 'Info',
          'nonce': auth['nonce'],
        },
        headers={
          'Key': auth['key'],
          'Sign': get_sign(),
        },
      )

      print(res.json())

Output:


  
    {
      'status': 'ok', 
      'data': {
        'balances': {
          RUR': 500.0,
          'EUR': 50.0,
          'LTC': 50.0,
          'BTC': 5.4004,
          'USD': 900.33
        },
        'open_orders': 3
      }
    }
Olark Chat with us