История кошелька

Просматривайте историю транзакций в кошельке, включая возможности фильтрации по адресу, дате совершения перевода (календарному периоду), а также типу перевода (платеж или поступление).

Bitcoin QR code icon

Contents

Запрос:

Параметры

{WalletID}, string Идентификатор Кошелька. Обязательное поле
{limit}, integer Максимальное количество транзакций, отображаемых на странице. Значение по умолчанию: 10. Опциональное поле
{offset}, integer Порядковый номер элемента, с которого начинается отсчет. Значение по умолчанию: 0. Опциональное поле
{q}, string Содержит список переменных фильтра: адрес, тип перевода, диапазон календарных дат. Опциональное поле

Фильтр {q} собирается в строку простым перечислением переменных в строке через запятую. В качестве разделителя между названием параметра и значением используется двоеточие.

Пример строки {q}:

item_type:receipt,address:35Gnk75DbehHXkshBX1QzpKdq4AJDW6KKv,date_from:2021-02-01T00:00:01+01:00,date_to:2021-03-01T23:59:59+01:00

Фильтры {q}:

{filter: address},
string
Криптовалютный адрес (или его часть), по которому совершена транзакция. Обязательное поле
{filter: date_from},
string
Дата начала календарного периода, в который совершен перевод. Содержит полную дату, часы, минуты, секунды, десятичную часть секунды: гггг-мм-ддTчч:мм:сс.с Пример даты: 2021-01-01T23:59:59+04:00 Обязательное поле
{filter: date_to},
string
Дата окончания календарного периода. Аналогична {filter: date_from} Опциональное поле
{filter: item_type},
string
Тип данных: "payment" или "receipt" Опциональное поле
Пример запроса

curl 'https://apirone.com/api/v2/wallets/btc-c70afacf0b7d7808e8be36bfd7ceed71/history?limit=10&offset=0'

Пример запроса с фильтрацией по временному интервалу и типу элемента:

curl 'https://apirone.com/api/v2/wallets/btc-c70afacf0b7d7808e8be36bfd7ceed71/history?limit=10&offset=0&q=date_from:2021-01-01T00:00:01+04:00,date_to:2021-01-31T23:59:59+04:00,item_type:payment'

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

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

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

{wallet},
string
Идентификатор кошелька. Кошелек содержит биткоин адреса. Обязательное поле
{items},
array of objects
Массив элементов. Обязательное поле
{pagination},
array
Массив (Список) страниц. Опциональное поле

Элементы {items}:

{items: date},
string
Дата совершения перевода. Обязательное поле
{items: type},
string
Тип перевода: платеж или поступление. Обязательное поле
{items: txs},
string
Идентификатор транзакции. Опциональное поле
{items: id},
string
Идентификатор платежа или поступления. Опциональное поле
{items: is_confirmed},
boolean
Элемент, обозначающий подтверждение транзакции true (если транзакция подтверждена) или false (если транзакция не подтверждена). Опциональное поле
{items: amount},
integer
Сумма перевода. Опциональное поле

Нумерация страниц {pagination}:

{pagination: total},
integer
Общее количество страниц. Обязательное поле
{pagination: offset},
integer
Порядковый номер элемента, с которого начинается отсчет. Обязательное поле
{pagination: limit},
integer
Количество элементов, отображаемое на странице. Опциональное поле
Пример результата выполнения для типа "Платеж":
    {
      "wallet": "btc-c70afacf0b7d7808e8be36bfd7ceed71",
      "items": [ 
        {
          "date": "2021-01-12T18:15:10.237846",
          "type": "payment",
          "txs": [
            "48563c8ad8339798bc0f6d7ee0fe3f42f5721e5f989269d035ba9be0e2fd8658"
          ],
          "id": "9a5a81bcaeec9dd361bfbbdeb768d35027392301fb61b876f638f08ad58a647f",
          "is_confirmed": true,
          "amount": -10165
        }
      ],
      "pagination": {
        "total": 14,
        "offset": 0,
        "limit": 10
      }
    }
    
  
Пример результата выполнения для типа "Поступление":
    {
      "wallet": "btc-c70afacf0b7d7808e8be36bfd7ceed71",
      "items": [
      {
        "date": "2021-02-03T18:17:50.450469",
        "type": "receipt",
        "id": "bd1e0268f5e482146a7f672d37f2936c93088e499adbd0f428561321f48f2b97",
        "is_confirmed": true,
        "amount": 100000
      },
      {
        "date": "2021-02-02T06:20:01.623701",
        "type": "payment",
        "id": "6cc5842c7a2d9c236721726311a32ceb124f83c4553b999ae2bdda8c8cc43359",
        "is_confirmed": true,
        "amount": -10165
      },
      ... ],
      "pagination": {
        "total": 9,
        "offset": 0,
        "limit": 10
      }
    }
    
  

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