BITStorage Finance REST API Документация

Добро пожаловать в раздел BITStorage Finance REST API документации. Этот API (интерфейс программирования приложений) позволит вам получить доступ к функциональности этого обмена посредством HTTP запросов, делая интеграцию с Вашими собственными приложениями возможной.

Соединение с API

Вы можете получить доступ к API в следующем URL:

https://bitstorage.finance/api

Допускается выполнять до 60 запросов в минуту.

Использование

Чтобы использовать общедоступный метод API (Public API), вы должны выполнить запрос HTTP к надлежащей конечной точке для этого определенного метода, посылая соответствующие GET или POST параметры для этого метода. Вы также можете отправить их в PAYLOAD- запросе в формате JSON.

Для доступа к защищенным методам API (protected API methods), необходимо получить ключ API / секретную пару. Их использование объясняется дальше в этом документе.

Вот несколько основных примеров использования:

# Example request using CURL on the command line
curl "https://bitstorage.finance/api/transactions" \
-d currency="ISK" \
-d limit=5	
// Example valid response
{"transactions": {
	"0":{"id":"131","date":"2014-11-13 10:42:46","aur":"1.00000000","maker_type":"buy","price":"10.00","amount":"10.00","currency":"ISK"},
	"1":{"id":"129","date":"2014-11-11 11:14:12","aur":"0.50000000","maker_type":"buy","price":"11.27","amount":"5.63","currency":"ISK"},
	"2":{"id":"128","date":"2014-11-11 11:13:49","aur":"0.50000000","maker_type":"buy","price":"10.91","amount":"5.46","currency":"ISK"},
	"3":{"id":"127","date":"2014-11-10 18:29:15","aur":"0.50000000","maker_type":"buy","price":"11.20","amount":"5.60","currency":"ISK"},
	"4":{"id":"126","date":"2014-11-10 18:25:21","aur":"0.50000000","maker_type":"buy","price":"11.20","amount":"5.60","currency":"ISK"},
	"request_currency":"ISK"
	}
}
// Example error response
{"errors":[{"message":"Invalid currency.","code":"INVALID_CURRENCY"}]}

Общедоступные методы API

К этим методам можно получить доступ без ключа API или учетной записи.

Статистика

Статистика возвратов о текущем состоянии обмена.

GET https://bitstorage.finance/api/stats

Параметры:

  • currency (string) - Код валюты в формате 3 буквы. Значение по умолчанию - "USD". Должна быть валюта, поддерживаемая обменом.

Ответ:

  • bid (float) - Текущая цена bid .
  • ask (float) - Текущая цена ask.
  • last_price (float) - Цена последней транзакции.
  • last_transaction_type (string) - Действие, выполненное берущим (инициатор) последнюю транзакцию. Может быть " BUY " или " SELL ".
  • last_transaction_currency (string) - Код валюты в формате 3 буквы, в которой была последняя транзакция.
  • daily_change (float) - Сумма, на которую текущая цена упала или поднялась с последнего закрытия.
  • daily_change_percent (float) - Процент текущей цены по сравнению с последним закрытием.
  • max (float) - Сегодняшняя максимальная цена транзакции.
  • min (float) - Сегодняшняя минимальная цена транзакции.
  • open (float) - Сегодняшняя цена открытия (примечание: так как рынок всегда открыт, это - также вчерашняя окончательная цена).
  • total_btc_traded (int) - Общий объем сделок BTC за последние 24 часа.
  • total_btc (int) - Всего BTC существующих в мире.
  • market_cap (int) - Глобальная рыночная капитализация Bitcoin.
  • trade_volume (int) - Объем мировой торговли Bitcoin.
  • request_currency (string) - Валюта, в которой представлена эта информация.

Исторические Цены

Дает ежедневные цены закрытия рынка для выбранного периода.

GET https://bitstorage.finance/api/historical-prices

Параметры:

  • currency (string)- Код валюты в формате 3 буквы. Значение по умолчанию - "USD". Должна быть валюта, поддерживаемая обменом.
  • timeframe (string) - Сроки для вашего запроса. Допустимые значения: "1mon", "3mon", "6mon", "1year" и " ytd". Значение по умолчанию "1mon".

Ответ:

  • date (string) - Строка даты в формате YYYY-MM-DD.
  • price (float) - Цена закрытия для заданной даты.
  • request_currency (string) - Валюта, в которой эта информация представлена.

Книга Заявок

Возвращает информацию со всех заявок в настоящее время в книгу заявок. Возвраты будут сгруппированы в два различных массива для покупки и продажи соответственно.

GET https://bitstorage.finance/api/order-book

Параметры:

  • currency (string) - Код валюты в формате 3 буквы. Значение по умолчанию - "USD". Должна быть валюта, поддерживаемая обменом.

Ответ:

  • price (float) – Предельная цена заявки.
  • order_amount (float) - Оставшаяся сумма в BTC.
  • order_value (float) - Остаточная стоимость заявки в вашей запрашиваемой валюте.
  • converted_from (string) - Первоначальная валюта, в которой была сделана заявка, если не равно запрашиваемой валюте.
  • request_currency (string) - Валюта, в которой эта информация представлена.

Транзакции

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

GET https://bitstorage.finance/api/transactions

Параметры:

  • currency (string) - Код валюты в формате 3 буквы. Обратите внимание: вы можете опустить этот параметр, чтобы получать все цены в их родной валюте!

  • limit (int) - Получить количество записей. По умолчанию 10.

Ответ:

  • id (int) - Уникальный идентификатор для транзакции.
  • date (string) - Строка даты в формате YYYY-MM-DD.
  • btc (float) - Сумма транзакции в BTC.
  • price (float) - Цена, по которой произошла транзакция. Будет возвращена в оригинальной валюте, если никакой параметр валюты не отправлен в запросе.
  • price1 (float)Только если никакой параметр валюты не отправлен в запросе - Цена, по которой транзакция произошла для второй стороны (производителя), в оригинальной валюте.
  • amount (float) - Сумма сделки в запрашиваемой валюте. Будет возвращена в своей оригинальной валюте, если ни один параметр валюты не отправляется в запросе.
  • amount1 (float) - Только если никакой параметр валюты не отправлен в запросе -Сумма транзакции в оригинальной валюте второй стороны (производителя).
  • currency (string) - Валюта, в которой произошла транзакция. Будет возвращена в своей оригинальной валюте, если ни один параметр валюты не отправляется в запросе.
  • currency1 (string) - Только если никакой параметр валюты не отправлен в запросе - Оригинальная валюта второй стороны (производителя).
  • request_currency (string) - Валюта, в которой эта информация представлена. Вернется 'ORIGINAL', если сумма в оригинальной валюте.

 

Защищенные методы API

Для того, чтобы получить доступ к этим методам, вы должны получить пару ключ/секрет API для проверки подлинности вашего запроса.

Получение Ключа API

Чтобы получить доступ к нашему API, необходимо сгенерировать ключ API на странице API доступа. Вы должны включить двухфакторную аутентификацию на вашем счету, чтобы иметь возможность просмотра этой страницы. После создания нового ключа API, вам будет предоставлен секретный код API. Это значение покажут вам только один раз. Пожалуйста, храните его в безопасном месте, поскольку Вам он будет нужен, чтобы использовать его вместе с вашим ключом API.

После создания ключа API, вы можете разрешить или ограничить доступ его владельцу к функциональности родительского счета, установив или сняв флажки в строке «разрешения» под ключом API.

Аутентификация Вашего Запроса

Для проверки подлинности запроса с вашей парой ключ/секрет API, вы должны включить следующие параметры в ваши параметры POST или JSON PAYLOAD вашего запроса:

  • api_key (string) - Ключ API, который вы сгенерировали.
  • nonce (int) - Случайное целое число. Каждый запрос должен иметь nonce выше, чем прошлый. Вы можете использовать текущую метку времени UNIX, например.
  • signature (string) - Подпись HMAC-SHA256 закодированных в JSON параметров запроса, подписанного с использованием API secret, который был сгенерирован вместе с api_key. Эти параметры включают в себя api_key и nonce. Эта подпись затем должна быть добавлена к параметрам запроса.

Мы знаем, что создание подписи может быть немного пугающим, если вы делаете это в первый раз, так что рассмотрите, пожалуйста, следующие примеры:

// Javascript Example
	
// Uses http://crypto-js.googlecode.com/svn/tags/3.0.2/build/rollups/hmac-sha256.js
// ...and http://crypto-js.googlecode.com/svn/tags/3.0.2/build/components/enc-base64-min.js

// we add our public key and nonce to whatever parameters we are sending
var params = {};
params.currency = "eur";
params.price = 200;
params.api_key = api_key;
params.nonce = Math.round(new Date().getTime() / 1000);
	
// create the signature
var hash = CryptoJS.HmacSHA256(CryptoJS.enc.Base64.stringify(CryptoJS.enc.Utf8.parse(JSON.stringify(data))), api_secret).toString()
	
// add signature to request parameters
params.signature = hash;
// PHP Example
	
// we add our public key and nonce to whatever parameters we are sending
$commands['side'] = 'sell';
$commands['type'] = 'stop';
$commands['api_key'] = $api_key;
$commands['nonce'] = time();
	
// create the signature
$signature = hash_hmac('sha256', base64_encode(json_encode($commands)), $api_secret);
	
// add signature to request parameters
$commands['signature'] = $signature;
# Python Example
	
import hashlib
import hmac
	
// we add our public key and nonce to whatever parameters we are sending
params = {'currency': 'eur', 'price': 200, 'api_key': api_key, 'nonce': time.time()}

// create the signature
message = bytes(json.dumps(params)).encode('utf-8')
secret = bytes(api_secret).encode('utf-8')
signature = hmac.new(secret, message, digestmod=hashlib.sha256).hexdigest()
	
// add signature to request parameters	
params['signature'] = signature	
// C# Example
	
using System.Security.Cryptography;

// we add our public key and nonce to whatever parameters we are sending
var params1 = new List>();
params1.Add(new KeyValuePair("api_key", api_key));
params1.Add(new KeyValuePair("nonce", (Int32)(DateTime.UtcNow.Subtract(new DateTime(1970, 1, 1))).TotalSeconds));
	
// create the signature
JavaScriptSerializer serializer = new JavaScriptSerializer();
var message = serializer.Serialize(params1);
	
secret = secret ?? "";
var encoding = new System.Text.ASCIIEncoding();
byte[] keyByte = encoding.GetBytes(secret);
byte[] messageBytes = encoding.GetBytes(message);
using (var hmacsha256 = new HMACSHA256(keyByte))
{
	byte[] hashmessage = hmacsha256.ComputeHash(messageBytes);
	var signature = BitConverter.ToString(hashmessage);
	signature = signature.Replace("-", "");
	
	// add signature to request parameters
	params1.Add(new KeyValuePair("signature", signature));
}
/* Java Example */
	
/* Dependent on Apache Commons Codec to encode in base64. */
import javax.crypto.Mac;
import javax.crypto.spec.SecretKeySpec;
import org.apache.commons.codec.binary.Hex;

/* we add our public key and nonce to whatever parameters we are sending */
Map params = new HashMap();
params.put("api_key", "demo");
params.put("nonce", ((int) (System.currentTimeMillis() / 1000L)));
	
/* create the signature */
String secret = "secret";
String message = new JSONObject(params).toString();

Mac sha256_HMAC = Mac.getInstance("HmacSHA256");
SecretKeySpec secret_key = new SecretKeySpec(secret.getBytes(), "HmacSHA256");
sha256_HMAC.init(secret_key);

String hash = Hex.encodeHexString(sha256_HMAC.doFinal(message.getBytes()));

/* add signature to request parameters */
params.put("signature", hash);

Балансы и Информация

Получить балансы аккаунтов и уровни сборов:

POST https://bitstorage.finance/api/balances-and-info

Ответ:

  • on_hold[currency][withdrawal] (float) – Количество валюты, ожидающей снятие.
  • on_hold[currency][order] (float) - Количество валюты в открытых заявках.
  • on_hold[currency][total] (float) - Общая сумма валюты, которая находится на удержании - сумма последних двух пунктов.
  • available[currency] (float) - Количество этой конкретной валюты, доступной в настоящее время.
  • usd_volume (float) - 30-дневный объем торговли учетной записи, преобразованный в доллар США.
  • fee_bracket[maker] (float) - Уровень платежа за транзакцию аккаунта (в процентах), если не инициирует транзакцию (т.е. выступает в качестве производителя).
  • fee_bracket[taker] (float) - Уровень платежа за транзакцию аккаунта (в процентах), если не инициирует транзакцию (т.е. выступает в качестве приобретателя).
  • global_btc_volume (float) –Обмен всего 24-часового объема транзакций в BTC.

Открытые Заявки

Получить текущие открытые заявки аккаунта, сгруппированные по стороне заказа (bid или ask).

POST https://bitstorage.finance/api/open-orders

Параметры:

  • currency (string) - Код валюты в формате 3 буквы. Будет фильтровать по заявкам этой валюты. Когда пропущен, все открытые заявки будут выведены на экран.

Ответ:

  • id (int) - Уникальный идентификатор для заявки.
  • side (string) - "buy" или "sell".
  • type (string) - "market", "limit" или "stop".
  • amount (float) - Сумма первоначальной заявки в BTC.
  • amount_remaining (float) - Сумма, которая еще не была заполнена в BTC.
  • price (float) - Текущая цена заявки а в национальной валюте.
  • avg_price_executed (float) - Средневзвешенная цена, по которой заявка была заполнена, в его национальной валюте. Ноль означает, что еще не сгенерировано никаких сделок.
  • stop_price (float) –Цена, при которой будет срабатывать стоп, если есть заявка стоп-ордер.
  • currency (string) - Национальная валюта заявки.
  • status (string) - Текущий статус заявки. Возможные значения 'ACTIVE','FILLED','CANCELLED_USER','OUT_OF_FUNDS','REPLACED'.
  • replaced (int) - Если заявка была отредактирована, она замещается.
  • replaced_by (int) - Если заявка была заменена, id заявки замещается.

Сделки Пользователей

Получить список транзакций учетной записи, упорядоченных по дате, в порядке убывания.

POST https://bitstorage.finance/api/user-transactions

Параметры:

  • currency (string) - Код валюты в формате 3 буквы. Будет фильтровать по транзакциям, включающим эту валюту. Когда пропущено, все транзакции будут выведены на экран.
  • limit (int) - Количество транзакций на возврат.
  • side (string) - Фильтры сделок по типу ("buy" или "sell").

Ответ:

  • id (int) - Уникальный идентификатор для транзакции.
  • date (string) - Строка даты в формате YYYY-MM-DD.
  • btc (float) - Сумма транзакции в BTC.
  • side (string) – Может быть "buy" или "sell".
  • price (float) – Цена, по которой произошла транзакция, в национальной валюте.
  • amount (float) – Сумма транзакции в национальной валюте.
  • fee (float) - Платеж за транзакцию в национальной валюте.
  • currency (string) - Валюта , в которой произошла транзакция.

Существующие Биткойн Адреса Для Депозита

Получить список существующих адресов учетной записи для получения биткоинов.

POST https://bitstorage.finance/api/btc-deposit-address/get

Параметры:

  • limit (int) - Количество адресов для возврата.

Ответ:

  • address (string) - Адрес для ввода биткоинов.
  • date (string) - Строка даты в формате YYYY-MM-DD HH:MM:SS.

Получить Новые Биткойн Адреса Для Депозита

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

POST https://bitstorage.finance/api/btc-deposit-address/new

Ответ:

  • address (string) – Адреса для внесения Bitcoin.

Получить Депозиты

Получить список депозитов (BTC или fiat) внесенных на счет, упорядочены по дате в порядке убывания.

POST https://bitstorage.finance/api/deposits/get

Параметры:

  • currency (string) - Код валюты в формате 3 буквы. Будет фильтровать по депозитам, включающим эту валюту. Когда пропущено, все депозиты будут выведены на экран.
  • limit (int) - Количество депозитов на возврат.
  • status (string) – Фильтры депозитов со статусом ("pending", "completed" или "cancelled").

Ответ:

  • id (int) - Уникальный идентификатор для депозита.

  • date (string) - Строка даты в формате YYYY-MM-DD HH:MM:SS.
  • currency (string) – Валюта депозита.
  • amount (float) – Сумма депозита, в валюте ввода.
  • status (string) – Текущий статус транзакции. Может быть "PENDING", "COMPLETED" или "CANCELLED".
  • account_number (int) – Номер аккаунта, с которого был совершен депозит (только для фиатных депозитов).
  • address (string) - Bitcoin адрес, с которого был совершен депозит (только для BTC депозитов).

Получить Вывод

Получить список выводов (BTC или fiat) со счета, упорядоченных по дате, в порядке убывания.

POST https://bitstorage.finance/api/withdrawals/get

Параметры:

  • currency (string) - Код валюты в формате 3 буквы. Будет фильтровать по выводам, включающим эту валюту. Когда пропущено, все выводы будут выведены на экран.
  • limit (int) – Сумма выводов на возврат.
  • status (string) – Фильтры вывода со статусом ("pending", "completed" или "cancelled").

Ответ:

  • id (int) - Уникальный идентификатор для вывода.
  • date (string) - Строка даты в формате YYYY-MM-DD HH:MM:SS.
  • currency (string) – Валюта вывода.
  • amount (float) –Сумма вывода, в валюте вывода.
  • status (string) - Текущий статус транзакции. Может быть "PENDING", "COMPLETED" или "CANCELLED".
  • account_number (int) – Номер аккаунта на который был сделан вывод (только для fiat вывода).
  • address (string) - Bitcoin адрес , на который был сделан вывод (только для BTC выводов).

Разместить Одну (или Несколько) Новых Заявок

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

POST https://bitstorage.finance/api/orders/new

Параметры:

  • side (string) – Может быть "buy" или "sell".
  • type (string) – Может быть "market", "limit" или "stop". "stop" заявки могут содержать как stop_price, так и limit_price - они будут обработаны в OCO виде (One Cancels the Other-исполнение одной заявки отменяет другую или взаимоотменяющие заявки).
  • currency (string) - Код валюты в формате 3 буквы. Валюта, в которой будет сделана заявка.
  • limit_price (float) - Предельная цена для заявки, в валюте заявки.
  • stop_price (float) - Стоп-цена для заявки, в валюте заявки. "Stop" заявка может иметь и stop и limit цены, как описано в " type ".
  • amount (float) - Количество BTC для покупки или продажи.
  • orders (array) - Этот параметр используется, только если Вы намереваетесь разместить многократные заявки в одном запросе API. Это должен быть массив или JSON строка, содержащая все предыдущие параметры для каждого элемента, такие как заявки [n] = ['side'=>x,'type'=>y,...]. Это может быть простым массивом HTTP параметров или может быть отформатировано как JSON.

Ответ:

  • ​transactions (int) - Количество сделок что произошло после размещения заявки.

  • new_order (int) – Количество размещенных новых заказов (вернется 2, если стоп-ордер имеет как limit_price, так и stop_price).
  • id (int) - Уникальный идентификатор для вывода.
  • side (string) – Может быть "buy" или "sell".
  • type (string) – Может быть "market", "limit" или "stop".
  • amount (float) – Оригинальная сумма BTC для продажи или покупки.
  • amount_remaining (float) - Непогашенная сумма BTC (но должно быть выполнено) по заявке.
  • price (float) - Текущая цена заявки в своей родной валюте.
  • avg_price_executed (float) - Средневзвешенная из цен, по которым заявка была заполнена, в ее валюте. Ноль означает, что он еще не генерируется никаких сделок.
  • stop_price (float) - Если есть заявка стоп-ордер, цена, при которой будет срабатывать стоп.
  • currency (string) – Национальная валюта заявки.
  • status (string) - Текущий статус заявки. Возможные значения 'ACTIVE','FILLED','CANCELLED_USER','OUT_OF_FUNDS','REPLACED'.
  • oco (boolean) - Если стоп-ордер имеет и стоп и лимит цены, это будет верно т.к. тот, который будет выполняться певым отменит другой.

Редактировать Одну (или Несколько) Заявок

Редактировать одну или несколько заявок, которые вы разместили. Чтобы изменить несколько заявок, вы можете отправить многомерный массив, называемый заявки, который должен содержать все параметры в каждом элементе массива, как указано ниже.

POST https://bitstorage.finance/api/orders/edit

Параметры:

  • id (int) - Уникальный идентификатор заявки, которую вы хотите отредактировать.
  • type (string) - Может быть "market", "limit" или "stop". "stop" заявки могут содержать как stop_price, так и limit_price - они будут обработаны в OCO виде (One Cancels the Other-исполнение одной заявки отменяет другую или взаимоотменяющие заявки).
  • limit_price (float) - Предельная цена для заявки, в валюте заявки.
  • stop_price (float) - Стоп-цена для заявки, в валюте заявки. "Stop" заявка может иметь и stop и limit цены, как описано в " type ".
  • amount (float) - Сумма BTC для продажи или покупки.
  • orders (array) - Этот параметр используется, только если Вы намереваетесь разместить многократные заявки в одном запросе API. Это должен быть массив или JSON строка, содержащая все предыдущие параметры для каждого элемента, такие как заявки[n] = ['id'=>x,'type'=>y,...]. Это может быть простым массивом HTTP параметров или может быть отформатировано как JSON.

Ответ:

  • transactions (int) - Количество сделок что произошло после редактирования заявки.
  • edit_order (int) - Количество новых размещенных заявок (вернется 2, если стоп-приказ содержит как limit_price так и stop_price).
  • id (int) - Новый id для заявки (в предыдущей заявке id будет отмечен "REPLACED"). Это позволяет отслеживать пользовательские изменения к заявке.
  • side (string) - Может быть "buy" или "sell".
  • type (string) -Может быть "market", "limit" или "stop".
  • amount (float) - Количество BTC, оставшееся в заявке во время редактирования.
  • amount_remaining (float) - Непогашенная сумма BTC (но должно быть выполнено) по заявке.
  • price (float) - Текущая цена заявки в своей родной валюте.
  • avg_price_executed (float) - Средневзвешенная из цен, по которым заявка была заполнена, в ее валюте. Ноль означает, что он еще не генерируется никаких сделок.
  • stop_price (float) - Если есть заявка стоп-ордер, цена, при которой будет срабатывать стоп.
  • currency (string) - Валюта заявки.
  • status (string) - Текущий статус заявки. Возможные значения 'ACTIVE','FILLED','CANCELLED_USER','OUT_OF_FUNDS','REPLACED'.
  • replaced (int) - Заявка заменит эту.
  • oco (boolean) - Если стоп-ордер имеет и стоп и лимит цены, это будет верно т.к. тот, который будет выполняться певым отменит другой.

Отменить Одну, Многие или Все заявки

Отменить одну или несколько активных заявок. Чтобы отменить несколько заказов, вы можете отправить многомерный массив называемый orders, который должен содержать все параметры в каждом элементе массива, как указано ниже. Чтобы отменить ВСЕ заявки, просто отправьте параметр, называемый all - нет никакой необходимости посылать что-нибудь еще.

POST https://bitstorage.finance/api/orders/cancel

Параметры:

  • id (int) - Уникальный идентификатор заявки, который вы хотите редактировать.
  • orders (array) - Этот параметр используется, только если вы намерены получить статус нескольких заявок в одном вызове API. Он должен быть массивом или строкой JSON, содержащей параметр id для каждого элемента, например, как такие заявки [n] = ['id' => x]. Это может быть простой массив параметров HTTP, или может быть отформатирован как JSON.
  • all (bool)- Отправка этого параметра отменит ВСЕ заявки. Используйте с осторожностью!

Ответ:

  • id (int) – Уникальный идентификатор для заявки.
  • side (string) – Может быть "buy" или "sell".
  • type (string) – Может быть"market", "limit" или "stop".
  • amount (float) - Первоначальная сумма BTC, когда заявка была размещена или отредактирована.
  • amount_remaining (float) – Непогашенная сумма BTC (но должно быть выполнено) по заявке.
  • price (float) - Текущая цена заявки в национальной валюте.
  • avg_price_executed (float) - Средневзвешенная из цен, по которой заявка была заполнена, в ее валюте. Ноль означает, что еще не генерируется никаких операций.
  • stop_price (float) - Если есть заявка стоп-ордер, цена, при которой будет срабатывать стоп.
  • currency (string) – Валюта заявки.
  • status (string) - Текущий статус заявки. Возможные значения 'ACTIVE','FILLED','CANCELLED_USER','OUT_OF_FUNDS','REPLACED'.
  • replaced (int) - Заявка заменит эту, если была отредактирована.
  • replaced_by (int) – Заявка, которая заменит эту, если "REPLACED".

Статус Одной (или Нескольких) Заявок

Получить текущее состояние одной или нескольких заявок, которые были размещены на счете. Чтобы получить несколько заявок, вы можете отправить многомерный массив, именуемый заявки, который должен содержать все параметры в каждом элементе массива, как указано ниже.

POST https://bitstorage.finance/api/orders/status

Параметры:

  • id (int) - Уникальный идентификатор заявки, который вы хотите редактировать.
  • orders (array) - Этот параметр используется, только если вы намерены получить статус нескольких заявок в одном вызове API. Он должен быть массивом или строкой JSON, содержащей параметр id для каждого элемента, например, как такие заявки [n] = ['id' => x]. Это может быть простой массив параметров HTTP, или может быть отформатирован как JSON.

Ответ:

  • id (int) – Уникальный идентификатор для заявки.
  • side (string) – Может быть "buy" или "sell".
  • type (string) – Может быть"market", "limit" или "stop".
  • amount (float) - Первоначальная сумма BTC, когда заявка была размещена или отредактирована.
  • amount_remaining (float) – Непогашенная сумма BTC (но должно быть выполнено) по заявке.
  • price (float) - Текущая цена заявки в национальной валюте.
  • avg_price_executed (float) - Средневзвешенная из цен, по которой заявка была заполнена, в ее валюте. Ноль означает, что еще не генерируется никаких операций.
  • stop_price (float) - Если есть заявка стоп-ордер, цена, при которой будет срабатывать стоп.
  • currency (string) – Валюта заявки.
  • status (string) - Текущий статус заявки. Возможные значения 'ACTIVE','FILLED','CANCELLED_USER','OUT_OF_FUNDS','REPLACED'.
  • replaced (int) - Заявка заменит эту, если была отредактирована.
  • replaced_by (int) – Заявка, которая заменит эту, если "REPLACED".

Сделать Вывод Средств

Чтобы вывести средства из аккаунта на существующий Bitcoin адрес или банковский fiat счет. Пожалуйста, обратите внимание, Вы должны соединить желаемый номер банковского счета со своей учетной записью на странице банковских счетов для того, чтобы эта функция работала. В противном случае, ваше снятие не удастся.

POST https://bitstorage.finance/api/withdrawals/new

Параметры:

  • currency (string) - Код валюты в формате 3 буквы, которую вы хотите снять. Она должна совпадать с валютой на счете, если вы снимаете fiat.
  • amount (float) - Сумма, которую вы хотите снять, в приведенной выше валюте.
  • address (string) – Для вывода BTC, Bitcoin адрес, по которому вы хотите вывести.
  • account_number (int) – Для вывода фиатных денег, банковский счет, на который Вы хотели бы вывести валюту.

Ответ:

  • id (int) – Уникальный идентификатор для вывода.
  • date (string) - Строка даты в формате YYYY-MM-DD HH:MM:SS.
  • currency (string) – Валюта вывода.
  • amount (float) – Сумма вывода, в валюте вывода.
  • status (string) - Текущий статус сделки. Может быть"PENDING", "COMPLETED" или "CANCELLED".
  • account_number (int) - Номер счета, на который был сделан вывод (только для вывода fiat).
  • address (string) - Адрес Bitcoin, на который был сделан вывод (только для вывода BTC).