Элемент истории кошелька

Детальное отображение элемента истории содержит в себе полную информацию об операции - список транзакций, сумму комиссии, список отправителей/получателей.

Bitcoin QR code icon

Contents

Запрос:

Параметры

{WalletID}, string Идентификатор Кошелька. Обязательное поле
{historyItemId}
Идентификатор элемента истории (платежа или поступления). Обязательное поле
Пример запроса

curl 'https://apirone.com/api/v2/wallets/btc-c70afacf0b7d7808e8be36bfd7ceed71/history/bd1e0268f5e482146a7f672d37f2936c93088e499adbd0f428561321f48f2b97'

Платежи и поступления:

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

Успешный ответ сервера:

{WalletID}, string Идентификатор Кошелька. Обязательное поле
{created}, string Дата создания кошелька. Содержит полную дату, часы, минуты, секунды, десятичную часть секунды: гггг-мм-ддTчч:мм:сс.с Обязательное поле
{type}, string Тип перевода: платеж или поступление. Обязательное поле
{id}, string Идентификатор элемента. Обязательное поле
{items}, array of objects Содержит данные о транзакциях из блокчейна. Используется в отправлениях
{amount}, number Сумма перевода. Обязательное поле
{txs}, array of objects Содержит txid транзакций из блокчейна Используется в поступлениях
{destinations}, array of objects Содержит список получателей
address - адрес получателя
amount - сумма платежа.
Используется в поступлениях
{total}, number Общая сумма перевода. Включает в себя сумму всех комиссий и сумму перевода. Используется в поступлениях
{fee}, object Информация о комиссиях. Используется в поступлениях

Использование временной строки. Она имеет стандартный вид и при необходимости импортируется на большинство языков.

{items} у платежей содержит в себе следующие данные

{txid},
string
txid транзакции в блокчейне. Обязательное поле
{address},
string
Криптовалютный адрес кошелька. Обязательное поле
{amount},
number
Сумма перевода. Обязательное поле
{block},
object
Содержит данные о блоке:
hash - хэш блока
height - высота блока. Если высота блока равна 1, то данная транзакция находится в мемпуле и еще ни разу не подтверждена;
deleted - данный элемент поясняет удалена ли транзакция. Обычно имеет значение false, но, например, в случае двойной траты выхода может принимать значение true. Такой выход не будет учтен в общем балансе.
Обязательное поле
{is_confirmed},
bool
Показывает, прошло ли достаточное количество подтверждений транзакции в блокчейне. Если true, то количество подтверждений >= minimal-confirmations для конкретной криптовалюты (подробнее тут). Обязательное поле

{fee} у выплат содержит в себе следующие данные

{network},
number
Данные о комиссии сети
amount - сумма комиссии
rate - рейт, по которому была рассчитана комиссия криптовалютной сети. Используются разные единицы для каждой сети, например, в сети биткоина она измеряется в сатоши/байт;
strategy - стратегия по выбору комиссии. Подробнее можете узнать здесь.
Обязательное поле
{processing},
object
Содержит информацию о комиссии процессинга, если она была взята с платежа.
address - комиссионный адрес процессинга;
amount - сумма комиссии.
Опциональное поле
{subtract-from-amount},
boolean
Показывает, взималась ли комиссия пропорционально из конечных сумм перевода. Если значение переменной эквивалентно true, то комиссия распределялась на всех получателей, а если false, то не распределялась. Обязательное поле
Пример результата выполнения для типа "Поступление":
    {
      "wallet": "btc-c70afacf0b7d7808e8be36bfd7ceed71",
      "created": "2021-02-03T18:17:50.450469",
      "type": "receipt",
      "id": "bd1e0268f5e482146a7f672d37f2936c93088e499adbd0f428561321f48f2b97",
      "items": [
      {
        "txid": "bd1e0268f5e482146a7f672d37f2936c93088e499adbd0f428561321f48f2b97",
        "address": "3QSx5y7g5DZojZbGTsNSNJ5kPBTF56h6Kz",
        "amount": 100000,
        "block":
        {
          "hash": "00000000000000c081c282d2dfcc84e6e0ca0df03b30fe8641c9b3544fc0a0ba",
          "height": 1932798,
          "deleted": false
        },
        "is_confirmed": true
      } ],
      "amount": 100000
    }
    
  
Пример результата выполнения для типа "Платеж":
    {
      "wallet": "btc-c70afacf0b7d7808e8be36bfd7ceed71",
      "created": "2021-01-12T18:15:10.204587",
      "type": "payment",
      "id": "9a5a81bcaeec9dd361bfbbdeb768d35027392301fb61b876f638f08ad58a647f",
      "txs": [
        "48563c8ad8339798bc0f6d7ee0fe3f42f5721e5f989269d035ba9be0e2fd8658"
      ],
      "destinations": [ {
        "address": "3QSx5y7g5DZojZbGTsNSNJ5kPBTF56h6Kz",
        "amount": 10000
      },
      {
        "address": "35Gnk75DbehHXkshBX1QzpKdq4AJDW6KKv",
        "amount": 115182
      } ],
      "amount": 125347,
      "total": 125347,
      "fee": {
        "network": {
          "amount": 165,
          "rate": 1,
          "strategy": "normal"
        },
        "processing": {
          "address": "3QSx5y7g5DZojZbGTsNSNJ5kPBTF56h6Kz",
          "amount": 10000
        },
        "subtract-from-amount": true
      }
    }
    
  

Сообщение об ошибке: