где:https://api.matbea.net/method?param[]=VALUE&token=YOUR_TOKEN
Элемент | Тип |
---|---|
method | название метода |
param, token | название параметров запроса |
VALUE, YOUR_TOKEN | значения параметров |
Параметры запроса, не являющиеся массивами передаются в GET строке.
Массивы могут
передаваться
методами GET и POST.
В каждый метод нужно передавать token в get-строке. В случае, если не будет передан параметр
token,
будет возвращен ответ
{
"error": {
"code": 401,
"message": "no token passed"
},
"success": 0
}
В случае, если передан пустой token или такой token, которого нет в БД, будет возвращен ответ
{
"error": {
"code": 401,
"message": "Incorrect token"
},
"success": 0
}
В случае, если запрос включает некорректные данные, возвращается ошибка в формате:{
"error": {
"code": 1,
"message": "Transactions are not specified"
},
"result": {}
}
Поле | Тип | Назначение |
---|---|---|
code | integer | Код ошибки |
message | string | Текст ошибки |
Функции работы с данными представлены следующими методами:
Информация о транзакциях
Информация о блоках
Информация об адресах
Информация о владельцах
Проксирование
Возвращает информацию о транзакции по заданному хешу
Вызов метода:Параметры запроса:https://api.matbea.net/transaction/TRANSACTION_HASH?holder_data=HOLDER_DATA
Значение | Тип | Назначение | Метод передачи |
---|---|---|---|
TRANSACTION_HASH | string | Хеш транзакции о которой необходимо получить информацию | URI |
HOLDER_DATA | integer | Флаг вывода информации о владельце адреса. Принимаемые значения 1 или 0. Значение по умолчанию 0 | URI |
Результат запроса возвращается в следующем json формате:
{
"error": {},
"result": {
"block_hash": "0000000066356691a4353dd8bdc2c60da20d68ad34fff93d8839a133b2a6d42a",
"block_height": 221,
"block_time": 1231770060,
"coinbase": false,
"confirmations": 507882,
"double_spend": false,
"hash": "298ca2045d174f8a158961806ffc4ef96fad02d71a6b84d9fa0491813a776160",
"lock_time": 0,
"num_in_block": 2,
"size": 201,
"time": 1231770060,
"txin": [
{
"addresses": [
"1LzBzVqEeuQyjD2mRWHes3dgWrT9titxvq"
],
"holder_address_count": 1,
"holder_name": "holder2",
"holder_rootaddress": "1LzBzVqEeuQyjD2mRWHes3dgWrT9titxvq",
"n": 0,
"output_block_height": 221,
"output_txid": "591e91f809d716912ca1d4a9295e70c3e78bab077683f79350f101da64588073",
"script_type": "pubkey",
"value": 100000000,
"vout": 0
}
],
"txout": [
{
"addresses": [
"1BDvQZjaAJH4ecZ8aL3fYgTi7rnn3o2thE"
],
"holder_address_count": null,
"holder_name": null,
"holder_rootaddress": null,
"input_n": null,
"input_tx_block_height": null,
"input_txid": null,
"script_type": "pubkey",
"value": 100000000,
"vout": 0
}
]
}
}
Информация о транзакции представлена следующими полями:
Поле | Тип | Назначение | ||||||
---|---|---|---|---|---|---|---|---|
block_hash | string | Хеш блока | ||||||
block_height | integer | Высота блока | ||||||
block_time | integer | Время создания блока | ||||||
coinbase | boolean | Признак coinbase-транзакции | ||||||
confirmations | integer | Число подтверждений транзакции | ||||||
double_spend | boolean | Признак двойной траты средств | ||||||
hash | string | Хеш транзакции | ||||||
lock_time | integer | Высота блока или время в которое транзакция будет разблокирована.
|
||||||
num_in_block | integer | Номер транзакции в блоке | ||||||
size | integer | Размер транзакции в байтах | ||||||
time | integer | Время создания транзакции | ||||||
txin | array | Массив данных о входах транзакции | ||||||
txout | array | Массив данных о выходах транзакции |
Поле | Тип | Назначение |
---|---|---|
addresses | array | Массив адресов. Тип элементов массива - string |
holder_name | string | Имя владельца адреса/адресов, используемых в данном входе |
holder_rootaddress | string | Первичный адрес владельца |
holder_address_count | integer | Число адресов у данного владельца |
n | integer | Номер входа транзакции |
output_block_height | integer | Высота блока транзакции |
output_txid | string | Хеш транзакции, в которой создан потраченный выход |
script_type | string | Тип подписи |
value | integer | Объем средств на данном входе |
vout | integer | Номер выхода, в котором потрачены средства |
Поле | Тип | Назначение |
---|---|---|
addresses | array | Массив адресов, на которые перечислены средства |
holder_address_count | integer | Число адресов у данного владельца |
holder_name | string | Имя владельца адреса/адресов, используемых в данном выходе |
holder_rootaddress | string | Первичный адрес владельца |
input_n | integer | Номер входа транзакции, в которой потрачен текущий output |
input_tx_block_height | integer | Высота блока транзакции, в которой потрачен текущий output |
input_txid | string | Хеш транзакции, в которой потрачен текущий output |
script_type | string | Тип подписи |
value | integer | Объем средств на выходе |
vout | integer | Номер выхода |
Если в запросе параметр holder_data незадан или равен 0, то
поля
holder_name, holder_address_count,
holder_rootaddress в результате отсутствуют.
В случае, если хеш передан в некорректной форме, то возвращается ошибка
404 Not found
Пример:
curl
curl -g -H "Content-Type: application/json" -H "Accept: application/json" "https://api.matbea.net/transaction/298ca2045d174f8a158961806ffc4ef96fad02d71a6b84d9fa0491813a776160?holder_data=1&token=YOUR_TOKEN"
PHP
$hash = '298ca2045d174f8a158961806ffc4ef96fad02d71a6b84d9fa0491813a776160';
$url = 'https://api.matbea.net';
$tok = 'token=YOUR_TOKEN';
$GETparam = '/transaction/'.$hash.'?holder_data=1&'.$tok;
$POSTparam=[];
$rsh = curl_init();
if ($rsh) {
curl_setopt($rsh, CURLOPT_URL, $url . $GETparam);
curl_setopt($rsh, CURLOPT_HTTPHEADER, ['Content-Type:application/json']);
curl_setopt($rsh, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($rsh, CURLOPT_POST, 0);
$r=curl_exec($rsh);
if (!$r) {
printf("[E]\t%s (%s)\n", curl_error($rsh), curl_errno($rsh));
} else {
printf("%s\n", $r);
}
curl_close($rsh);
}
javascript
hash = '298ca2045d174f8a158961806ffc4ef96fad02d71a6b84d9fa0491813a776160';
tok = 'token=YOUR_TOKEN';
url = 'https://api.matbea.net/transaction/' + hash + '?holder_data=1&' + tok;
fetch(url)
.then((response) => {
return response.json();
}).then((data) => {
console.log(data);
});
Результат:
{
"error": {},
"result": {
"block_hash": "0000000066356691a4353dd8bdc2c60da20d68ad34fff93d8839a133b2a6d42a",
"block_height": 221,
"block_time": 1231770060,
"coinbase": false,
"confirmations": 507882,
"double_spend": false,
"hash": "298ca2045d174f8a158961806ffc4ef96fad02d71a6b84d9fa0491813a776160",
"lock_time": 0,
"num_in_block": 2,
"size": 201,
"time": 1231770060,
"txin": [
{
"addresses": [
"1LzBzVqEeuQyjD2mRWHes3dgWrT9titxvq"
],
"holder_address_count": 1,
"holder_name": "holder2",
"holder_rootaddress": "1LzBzVqEeuQyjD2mRWHes3dgWrT9titxvq",
"n": 0,
"output_block_height": 221,
"output_txid": "591e91f809d716912ca1d4a9295e70c3e78bab077683f79350f101da64588073",
"script_type": "pubkey",
"value": 100000000,
"vout": 0
}
],
"txout": [
{
"addresses": [
"1BDvQZjaAJH4ecZ8aL3fYgTi7rnn3o2thE"
],
"holder_address_count": null,
"holder_name": null,
"holder_rootaddress": null,
"input_n": null,
"input_tx_block_height": null,
"input_txid": null,
"script_type": "pubkey",
"value": 100000000,
"vout": 0
}
]
}
}
Наверх
Возвращает информацию о транзакциях по заданным хешам
Вызов метода:Параметры запроса:https://api.matbea.net/transactions?txid[]=TRANSACTION_HASH?holder_data=HOLDER_DATA
Значение | Тип | Назначение | Метод передачи |
---|---|---|---|
TRANSACTION_HASH | string | Хеш транзакции о которой необходимо получить информацию. | URI, POST |
HOLDER_DATA | integer | Флаг вывода информации о владельце адреса. Принимаемые значения 1 или 0. Значение по умолчанию 0 | URI |
Результат запроса возвращается в следующем json формате:
{
"error": {},
"result": {
"transactions": [
{
"block_hash": "0000000066356691a4353dd8bdc2c60da20d68ad34fff93d8839a133b2a6d42a",
"block_height": 221,
"block_time": 1231770060,
"coinbase": false,
"confirmations": 510202,
"double_spend": false,
"hash": "298ca2045d174f8a158961806ffc4ef96fad02d71a6b84d9fa0491813a776160",
"lock_time": 0,
"num_in_block": 2,
"size": 201,
"time": 1231770060,
"txin": [
{
"addresses": [
"1LzBzVqEeuQyjD2mRWHes3dgWrT9titxvq"
],
"holder_address_count": 1,
"holder_name": "holder2",
"holder_rootaddress": "1LzBzVqEeuQyjD2mRWHes3dgWrT9titxvq",
"n": 0,
"output_block_height": 221,
"output_txid": "591e91f809d716912ca1d4a9295e70c3e78bab077683f79350f101da64588073",
"script_type": "pubkey",
"value": 100000000,
"vout": 0
}
],
"txout": [
{
"addresses": [
"1BDvQZjaAJH4ecZ8aL3fYgTi7rnn3o2thE"
],
"holder_address_count": null,
"holder_name": "",
"holder_rootaddress": null,
"input_n": null,
"input_tx_block_height": null,
"input_txid": null,
"script_type": "pubkey",
"value": 100000000,
"vout": 0
}
]
},
{
"block_hash": "000000000000000000c4913c9a4c9c34289eaf8cd9ddfedc71c708b38ed61bc3",
"block_height": 495585,
"block_time": 1511352853,
"coinbase": true,
"confirmations": 14838,
"double_spend": false,
"hash": "d9620012dd61f8cee4e42f730231af09334889c5a1d6e52172952f27561b573f",
"lock_time": 0,
"num_in_block": 1,
"size": 248,
"time": 1511352853,
"txin": [
{
"value": 1250000000
}
],
"txout": [
{
"addresses": [
"1Sjj2cPC3rTWcSTEYDeu2f3BavLosog4T"
],
"holder_address_count": 214,
"holder_name": "",
"holder_rootaddress": "1NS4gbx1G2D5rc9PnvVsPys12nKxGiQg72",
"input_n": 18,
"input_tx_block_height": 495969,
"input_txid": "fe7d0cd7a843d0654a6be1fc7a16b3b661c60bf3dd7725e460868eeb7cba60b6",
"script_type": "pubkeyhash",
"value": 1340680951,
"vout": 0
},
{
"addresses": [],
"holder_address_count": null,
"holder_name": "",
"holder_rootaddress": null,
"input_n": null,
"input_tx_block_height": null,
"input_txid": null,
"script_type": "nulldata",
"value": 0,
"vout": 1
}
]
}
]
}
}
Информация о транзакции представлена следующими полями:
Поле | Тип | Назначение | ||||||
---|---|---|---|---|---|---|---|---|
block_hash | string | Хеш блока | ||||||
block_height | integer | Высота блока | ||||||
block_time | integer | Время создания блока | ||||||
coinbase | boolean | Признак coinbase-транзакции | ||||||
confirmations | integer | Число подтверждений транзакции | ||||||
double_spend | boolean | Признак двойной траты средств | ||||||
hash | string | Хеш транзакции | ||||||
lock_time | integer | Высота блока или время в которое транзакция будет разблокирована.
|
||||||
num_in_block | integer | Номер транзакции в блоке | ||||||
size | integer | Размер транзакции в байтах | ||||||
time | integer | Время создания транзакции | ||||||
txin | array | Массив данных о входах транзакции | ||||||
txout | array | Массив данных о выходах транзакции |
Поле | Тип | Назначение |
---|---|---|
addresses | array | Массив адресов. Тип элементов массива - string |
holder_name | string | Имя владельца адреса/адресов, используемых в данном входе |
holder_rootaddress | string | Первичный адрес владельца |
holder_address_count | integer | Число адресов у данного владельца |
n | integer | Номер входа транзакции |
output_block_height | integer | Высота блока транзакции |
output_txid | string | Хеш транзакции, в которой создан потраченный выход |
script_type | string | Тип подписи |
value | integer | Объем средств на данном входе |
vout | integer | Номер выхода, в котором потрачены средства |
Поле | Тип | Назначение |
---|---|---|
addresses | array | Массив адресов, на которые перечислены средства |
holder_name | string | Имя владельца адреса/адресов, используемых в данном выходе |
holder_rootaddress | string | Первичный адрес владельца |
holder_address_count | integer | Число адресов у данного владельца |
input_n | integer | Номер входа транзакции, в которой потрачен текущий output |
input_tx_block_height | integer | Высота блока транзакции, в которой потрачен текущий output |
input_txid | string | Хеш транзакции, в которой потрачен текущий output |
script_type | string | Тип подписи |
value | integer | Объем средств на выходе |
vout | integer | Номер выхода |
Если в запросе параметр holder_data незадан или равен 0, то
поля
holder_name, holder_address_count,
holder_rootaddress в результате отсутствуют.
Примеры:
Получение информации о транзакциях без данных о владельце методом GET:
curl
curl -g -H "Content-Type: application/json" -H "Accept: application/json" "https://api.matbea.net/transactions?txid[]=298ca2045d174f8a158961806ffc4ef96fad02d71a6b84d9fa0491813a776160&txid[]=d9620012dd61f8cee4e42f730231af09334889c5a1d6e52172952f27561b573f&token=matbea"
PHP
$hash1 = '298ca2045d174f8a158961806ffc4ef96fad02d71a6b84d9fa0491813a776160';
$hash2 = 'd9620012dd61f8cee4e42f730231af09334889c5a1d6e52172952f27561b573f';
$url = 'https://api.matbea.net';
$tok = 'token=matbea';
$GETparam = '/transactions?txid[]='.$hash1.'&txid[]='.$hash2.'&'.$tok;
$POSTparam=[];
$rsh = curl_init();
if ($rsh) {
curl_setopt($rsh, CURLOPT_URL, $url . $GETparam);
curl_setopt($rsh, CURLOPT_HTTPHEADER, ['Content-Type:application/json']);
curl_setopt($rsh, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($rsh, CURLOPT_POST, 0);
$r=curl_exec($rsh);
if (!$r) {
printf("[E]\t%s (%s)\n", curl_error($rsh), curl_errno($rsh));
} else {
printf("%s\n", $r);
}
curl_close($rsh);
}
javascript
hash1 = '298ca2045d174f8a158961806ffc4ef96fad02d71a6b84d9fa0491813a776160';
hash2 = 'd9620012dd61f8cee4e42f730231af09334889c5a1d6e52172952f27561b573f';
tok = 'token=matbea';
url = 'https://api.matbea.net/transactions?txid[]=' + hash1 + '&txid[]=' + hash2 + '&' + tok;
fetch(url)
.then((response) => {
return response.json();
}).then((data) => {
console.log(data);
});
Результат:
{
"error": {},
"result": {
"transactions": [
{
"block_hash": "0000000066356691a4353dd8bdc2c60da20d68ad34fff93d8839a133b2a6d42a",
"block_height": 221,
"block_time": 1231770060,
"coinbase": false,
"confirmations": 510202,
"double_spend": false,
"hash": "298ca2045d174f8a158961806ffc4ef96fad02d71a6b84d9fa0491813a776160",
"lock_time": 0,
"num_in_block": 2,
"size": 201,
"time": 1231770060,
"txin": [
{
"addresses": [
"1LzBzVqEeuQyjD2mRWHes3dgWrT9titxvq"
],
"holder_address_count": 1,
"holder_name": "holder2",
"holder_rootaddress": "1LzBzVqEeuQyjD2mRWHes3dgWrT9titxvq",
"n": 0,
"output_block_height": 221,
"output_txid": "591e91f809d716912ca1d4a9295e70c3e78bab077683f79350f101da64588073",
"script_type": "pubkey",
"value": 100000000,
"vout": 0
}
],
"txout": [
{
"addresses": [
"1BDvQZjaAJH4ecZ8aL3fYgTi7rnn3o2thE"
],
"holder_address_count": null,
"holder_name": "",
"holder_rootaddress": null,
"input_n": null,
"input_tx_block_height": null,
"input_txid": null,
"script_type": "pubkey",
"value": 100000000,
"vout": 0
}
]
},
{
"block_hash": "000000000000000000c4913c9a4c9c34289eaf8cd9ddfedc71c708b38ed61bc3",
"block_height": 495585,
"block_time": 1511352853,
"coinbase": true,
"confirmations": 14838,
"double_spend": false,
"hash": "d9620012dd61f8cee4e42f730231af09334889c5a1d6e52172952f27561b573f",
"lock_time": 0,
"num_in_block": 1,
"size": 248,
"time": 1511352853,
"txin": [
{
"value": 1250000000
}
],
"txout": [
{
"addresses": [
"1Sjj2cPC3rTWcSTEYDeu2f3BavLosog4T"
],
"holder_address_count": 214,
"holder_name": "",
"holder_rootaddress": "1NS4gbx1G2D5rc9PnvVsPys12nKxGiQg72",
"input_n": 18,
"input_tx_block_height": 495969,
"input_txid": "fe7d0cd7a843d0654a6be1fc7a16b3b661c60bf3dd7725e460868eeb7cba60b6",
"script_type": "pubkeyhash",
"value": 1340680951,
"vout": 0
},
{
"addresses": [],
"holder_address_count": null,
"holder_name": "",
"holder_rootaddress": null,
"input_n": null,
"input_tx_block_height": null,
"input_txid": null,
"script_type": "nulldata",
"value": 0,
"vout": 1
}
]
}
]
}
}
Получение информации о транзакциях с данными о владельце методом POST:
curl
curl -g -H "Content-Type: application/json" -H "Accept: application/json" -X POST -d "{\"txid\":[\"298ca2045d174f8a158961806ffc4ef96fad02d71a6b84d9fa0491813a776160\",\"d9620012dd61f8cee4e42f730231af09334889c5a1d6e52172952f27561b573f\"]}" "https://api.matbea.net/transactions?holder_data=1&token=matbea"
PHP
$hash1 = '298ca2045d174f8a158961806ffc4ef96fad02d71a6b84d9fa0491813a776160';
$hash2 = 'd9620012dd61f8cee4e42f730231af09334889c5a1d6e52172952f27561b573f';
$url = 'https://api.matbea.net';
$tok = 'token=matbea';
$GETparam = '/transactions?holder_data=1&'.$tok;
$POSTparam=['txid'=>[$hash1,$hash2]];
$rsh = curl_init();
if ($rsh) {
curl_setopt($rsh, CURLOPT_URL, $url . $GETparam);
curl_setopt($rsh, CURLOPT_HTTPHEADER, ['Content-Type:application/json']);
curl_setopt($rsh, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($rsh, CURLOPT_POST, 1);
curl_setopt($rsh, CURLOPT_POSTFIELDS, json_encode($POSTparam));
$r=curl_exec($rsh);
if (!$r) {
printf("[E]\t%s (%s)\n", curl_error($rsh), curl_errno($rsh));
} else {
printf("%s\n", $r);
}
curl_close($rsh);
}
javascript
hash1 = '298ca2045d174f8a158961806ffc4ef96fad02d71a6b84d9fa0491813a776160';
hash2 = 'd9620012dd61f8cee4e42f730231af09334889c5a1d6e52172952f27561b573f';
tok = 'token=matbea';
url = 'https://api.matbea.net/transactions?holder_data=1&' + tok;
fetch(url, {
method: 'post',
body: JSON.stringify({txid: [hash1, hash2] }) })
.then((response) => {
return response.json();
}).then((data) => {
console.log(data);
});
Результат:
{
"error": {},
"result": {
"transactions": [
{
"block_hash": "0000000066356691a4353dd8bdc2c60da20d68ad34fff93d8839a133b2a6d42a",
"block_height": 221,
"block_time": 1231770060,
"coinbase": false,
"confirmations": 510202,
"double_spend": false,
"hash": "298ca2045d174f8a158961806ffc4ef96fad02d71a6b84d9fa0491813a776160",
"lock_time": 0,
"num_in_block": 2,
"size": 201,
"time": 1231770060,
"txin": [
{
"addresses": [
"1LzBzVqEeuQyjD2mRWHes3dgWrT9titxvq"
],
"holder_address_count": 1,
"holder_name": "holder2",
"holder_rootaddress": "1LzBzVqEeuQyjD2mRWHes3dgWrT9titxvq",
"n": 0,
"output_block_height": 221,
"output_txid": "591e91f809d716912ca1d4a9295e70c3e78bab077683f79350f101da64588073",
"script_type": "pubkey",
"value": 100000000,
"vout": 0
}
],
"txout": [
{
"addresses": [
"1BDvQZjaAJH4ecZ8aL3fYgTi7rnn3o2thE"
],
"holder_address_count": null,
"holder_name": "",
"holder_rootaddress": null,
"input_n": null,
"input_tx_block_height": null,
"input_txid": null,
"script_type": "pubkey",
"value": 100000000,
"vout": 0
}
]
},
{
"block_hash": "000000000000000000c4913c9a4c9c34289eaf8cd9ddfedc71c708b38ed61bc3",
"block_height": 495585,
"block_time": 1511352853,
"coinbase": true,
"confirmations": 14838,
"double_spend": false,
"hash": "d9620012dd61f8cee4e42f730231af09334889c5a1d6e52172952f27561b573f",
"lock_time": 0,
"num_in_block": 1,
"size": 248,
"time": 1511352853,
"txin": [
{
"value": 1250000000
}
],
"txout": [
{
"addresses": [
"1Sjj2cPC3rTWcSTEYDeu2f3BavLosog4T"
],
"holder_address_count": 214,
"holder_name": "",
"holder_rootaddress": "1NS4gbx1G2D5rc9PnvVsPys12nKxGiQg72",
"input_n": 18,
"input_tx_block_height": 495969,
"input_txid": "fe7d0cd7a843d0654a6be1fc7a16b3b661c60bf3dd7725e460868eeb7cba60b6",
"script_type": "pubkeyhash",
"value": 1340680951,
"vout": 0
},
{
"addresses": [],
"holder_address_count": null,
"holder_name": "",
"holder_rootaddress": null,
"input_n": null,
"input_tx_block_height": null,
"input_txid": null,
"script_type": "nulldata",
"value": 0,
"vout": 1
}
]
}
]
}
}
Получение информации об одной транзакции с данными о владельце методом POST:
curl
curl -g -H "Content-Type: application/json" -H "Accept: application/json" -X POST -d "{\"txid\":\"298ca2045d174f8a158961806ffc4ef96fad02d71a6b84d9fa0491813a776160\"}" "https://api.matbea.net/transactions?holder_data=1&token=matbea"
PHP
$hash1 = '298ca2045d174f8a158961806ffc4ef96fad02d71a6b84d9fa0491813a776160';
$url = 'https://api.matbea.net';
$tok = 'token=matbea';
$GETparam = '/transactions?holder_data=1&'.$tok;
$POSTparam=['txid'=>$hash1];
$rsh = curl_init();
if ($rsh) {
curl_setopt($rsh, CURLOPT_URL, $url . $GETparam);
curl_setopt($rsh, CURLOPT_HTTPHEADER, ['Content-Type:application/json']);
curl_setopt($rsh, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($rsh, CURLOPT_POST, 1);
curl_setopt($rsh, CURLOPT_POSTFIELDS, json_encode($POSTparam));
$r=curl_exec($rsh);
if (!$r) {
printf("[E]\t%s (%s)\n", curl_error($rsh), curl_errno($rsh));
} else {
printf("%s\n", $r);
}
curl_close($rsh);
}
javascript
hash1 = '298ca2045d174f8a158961806ffc4ef96fad02d71a6b84d9fa0491813a776160';
tok = 'token=matbea';
url = 'https://api.matbea.net/transactions?holder_data=1&' + tok;
fetch(url, {
method: 'post',
body: JSON.stringify({txid: hash1 }) })
.then((response) => {
return response.json();
}).then((data) => {
console.log(data);
});
Результат:
{
"error": {},
"result": {
"transactions": [
{
"block_hash": "0000000066356691a4353dd8bdc2c60da20d68ad34fff93d8839a133b2a6d42a",
"block_height": 221,
"block_time": 1231770060,
"coinbase": false,
"confirmations": 510202,
"double_spend": false,
"hash": "298ca2045d174f8a158961806ffc4ef96fad02d71a6b84d9fa0491813a776160",
"lock_time": 0,
"num_in_block": 2,
"size": 201,
"time": 1231770060,
"txin": [
{
"addresses": [
"1LzBzVqEeuQyjD2mRWHes3dgWrT9titxvq"
],
"holder_address_count": 1,
"holder_name": "holder2",
"holder_rootaddress": "1LzBzVqEeuQyjD2mRWHes3dgWrT9titxvq",
"n": 0,
"output_block_height": 221,
"output_txid": "591e91f809d716912ca1d4a9295e70c3e78bab077683f79350f101da64588073",
"script_type": "pubkey",
"value": 100000000,
"vout": 0
}
],
"txout": [
{
"addresses": [
"1BDvQZjaAJH4ecZ8aL3fYgTi7rnn3o2thE"
],
"holder_address_count": null,
"holder_name": "",
"holder_rootaddress": null,
"input_n": null,
"input_tx_block_height": null,
"input_txid": null,
"script_type": "pubkey",
"value": 100000000,
"vout": 0
}
]
}
]
}
}
Наверх
Возвращает данные об адресах и их владельцах включенных в запрашиваемую транзакцию
Вызов метода:https://api.matbea.net/transactionsholders
Хеш транзакции передается в переменной txid POST методом.
Параметры запроса:Параметр | Тип | Назначение | Метод передачи |
---|---|---|---|
txid | string | В параметре передается хеш транзакции о которой необходимо получить информацию. Передача более одного хеша выполняется в массиве. Один хеш может быть передан как строковый параметр. |
POST |
Результат запроса возвращается в следующем json формате:
{
"error": {},
"result": {
"inputs": [
{
"holder_address_count": 1,
"holder_name": "MyNameIs12S4",
"holder_rootaddress": "12S42ZEw2741DHrivgZHLfX8M58mxb7bFy",
"transactions": [
"d8bebbfaac4b21778a21834b7263bb247216b3f60c5f2dbee9c4fb95a70b8962"
]
}
],
"outputs": [
{
"holder_address_count": 1,
"holder_name": "",
"holder_rootaddress": "1MN3cT9Ro927h4kgpSZ5V7SfYjrwTysXv7",
"transactions": [
"d8bebbfaac4b21778a21834b7263bb247216b3f60c5f2dbee9c4fb95a70b8962"
]
},
{
"holder_address_count": 1,
"holder_name": "MyNameIs12S4",
"holder_rootaddress": "12S42ZEw2741DHrivgZHLfX8M58mxb7bFy",
"transactions": [
"d8bebbfaac4b21778a21834b7263bb247216b3f60c5f2dbee9c4fb95a70b8962"
]
}
]
}
}
Результат содержит массив inputs с данными входов и массив outputs с данными выходов.
Информация о входах inputs представлена следующими полями:Поле | Тип | Назначение |
---|---|---|
holder_address_count | integer | Число адресов владельца |
holder_name | string | Имя владельца |
holder_rootaddress | string | Первичный адрес владельца |
transactions | array | Массив хешей транзакций, в которых данный адрес был входом |
Поле | Тип | Назначение |
---|---|---|
holder_address_count | integer | Число адресов владельца |
holder_name | string | Имя владельца |
holder_rootaddress | string | Первичный адрес владельца |
transactions | array | Массив хешей транзакций, в которых данный адрес был выходом |
Пример:
curl
curl -g -H "Content-Type: application/json" -H "Accept: application/json" -X POST -d "{\"txid\":[\"7722cee32dde81a29d4940d28b178b0914e7e8ac5ee52547538e954f4f5ee71a\",\"c07ca408706788c9e916b5c446fb93f064de90d21049b206608fbd5f45e2bdb3\"]}" "https://api.matbea.net/transactionsholders?token=YOUR_TOKEN"
PHP
$hash1 = '7722cee32dde81a29d4940d28b178b0914e7e8ac5ee52547538e954f4f5ee71a';
$hash2 = 'c07ca408706788c9e916b5c446fb93f064de90d21049b206608fbd5f45e2bdb3';
$url = 'https://api.matbea.net';
$tok = 'token=YOUR_TOKEN';
$GETparam = '/transactionsholders?'.$tok;
$POSTparam=['txid'=>[$hash1,$hash2]];
$rsh = curl_init();
if ($rsh) {
curl_setopt($rsh, CURLOPT_URL, $url . $GETparam);
curl_setopt($rsh, CURLOPT_HTTPHEADER, ['Content-Type:application/json']);
curl_setopt($rsh, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($rsh, CURLOPT_POST, 1);
curl_setopt($rsh, CURLOPT_POSTFIELDS, json_encode($POSTparam));
$r=curl_exec($rsh);
if (!$r) {
printf("[E]\t%s (%s)\n", curl_error($rsh), curl_errno($rsh));
} else {
printf("%s\n", $r);
}
curl_close($rsh);
}
javascript
hash1 = '7722cee32dde81a29d4940d28b178b0914e7e8ac5ee52547538e954f4f5ee71a';
hash2 = 'c07ca408706788c9e916b5c446fb93f064de90d21049b206608fbd5f45e2bdb3';
tok = 'token=YOUR_TOKEN';
url = 'https://api.matbea.net/transactionsholders?' + tok;
fetch(url, {
method: 'post',
body: JSON.stringify({txid: [hash1, hash2] }) })
.then((response) => {
return response.json();
}).then((data) => {
console.log(data);
});
Результат:
{
"error": {},
"result": {
"inputs": [
{
"holder_address_count": 1,
"holder_name": "",
"holder_rootaddress": "1MN3cT9Ro927h4kgpSZ5V7SfYjrwTysXv7",
"transactions": [
"c07ca408706788c9e916b5c446fb93f064de90d21049b206608fbd5f45e2bdb3"
]
},
{
"holder_address_count": 1,
"holder_name": "",
"holder_rootaddress": "1FGaCR3k9B8ZifGc8FWcYY5yS7FXZgbMFF",
"transactions": [
"7722cee32dde81a29d4940d28b178b0914e7e8ac5ee52547538e954f4f5ee71a"
]
}
],
"outputs": [
{
"holder_address_count": 1,
"holder_name": "",
"holder_rootaddress": "1BdxBor4JG76RKLAwJZfHC58fWbgidYukz",
"transactions": [
"c07ca408706788c9e916b5c446fb93f064de90d21049b206608fbd5f45e2bdb3"
]
},
{
"holder_address_count": 1,
"holder_name": "",
"holder_rootaddress": "1MN3cT9Ro927h4kgpSZ5V7SfYjrwTysXv7",
"transactions": [
"c07ca408706788c9e916b5c446fb93f064de90d21049b206608fbd5f45e2bdb3"
]
},
{
"holder_address_count": 1,
"holder_name": "MyNameIs12S4",
"holder_rootaddress": "12S42ZEw2741DHrivgZHLfX8M58mxb7bFy",
"transactions": [
"7722cee32dde81a29d4940d28b178b0914e7e8ac5ee52547538e954f4f5ee71a"
]
}
]
}
}
curl
curl -g -H "Content-Type: application/json" -H "Accept: application/json" -X POST -d "{\"txid\":\"7722cee32dde81a29d4940d28b178b0914e7e8ac5ee52547538e954f4f5ee71a\"}" "https://api.matbea.net/transactionsholders?token=YOUR_TOKEN"
PHP
$hash1 = '7722cee32dde81a29d4940d28b178b0914e7e8ac5ee52547538e954f4f5ee71a';
$url = 'https://api.matbea.net';
$tok = 'token=YOUR_TOKEN';
$GETparam = '/transactionsholders?'.$tok;
$POSTparam=['txid'=>$hash1];
$rsh = curl_init();
if ($rsh) {
curl_setopt($rsh, CURLOPT_URL, $url . $GETparam);
curl_setopt($rsh, CURLOPT_HTTPHEADER, ['Content-Type:application/json']);
curl_setopt($rsh, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($rsh, CURLOPT_POST, 1);
curl_setopt($rsh, CURLOPT_POSTFIELDS, json_encode($POSTparam));
$r=curl_exec($rsh);
if (!$r) {
printf("[E]\t%s (%s)\n", curl_error($rsh), curl_errno($rsh));
} else {
printf("%s\n", $r);
}
curl_close($rsh);
}
javascript
hash1 = '7722cee32dde81a29d4940d28b178b0914e7e8ac5ee52547538e954f4f5ee71a';
tok = 'token=YOUR_TOKEN';
url = 'https://api.matbea.net/transactionsholders?' + tok;
fetch(url, {
method: 'post',
body: JSON.stringify({txid: hash1 }) })
.then( (response) => {
return response.json();
}).then( (data) => {
console.log(data);
});
Результат:
{
"error": {},
"result": {
"inputs": [
{
"holder_address_count": 1,
"holder_name": "",
"holder_rootaddress": "1FGaCR3k9B8ZifGc8FWcYY5yS7FXZgbMFF",
"transactions": [
"7722cee32dde81a29d4940d28b178b0914e7e8ac5ee52547538e954f4f5ee71a"
]
}
],
"outputs": [
{
"holder_address_count": 1,
"holder_name": "MyNameIs12S4",
"holder_rootaddress": "12S42ZEw2741DHrivgZHLfX8M58mxb7bFy",
"transactions": [
"7722cee32dde81a29d4940d28b178b0914e7e8ac5ee52547538e954f4f5ee71a"
]
}
]
}
}
Наверх
Возвращает информацию о блоке по его хешу или высоте.
Возможны два варианта вызова метода:Параметры запроса:1) https://api.matbea.net/block/BLOCKHASH
2) https://api.matbea.net/block/BLOCKHEIGHT
Значение | Тип | Назначение | Метод передачи |
---|---|---|---|
BLOCKHASH | string | Хеш блока | URI |
BLOCKHEIGHT | string | Высота блока | URI |
Результат запроса возвращается в следующем json формате:
{
"error": {},
"result": {
"block_difficulty": 1,
"block_hash": "0000000066356691a4353dd8bdc2c60da20d68ad34fff93d8839a133b2a6d42a",
"block_height": 221,
"block_size": 417,
"block_time": 1231770060,
"block_version": 1,
"confirmations": 505809,
"tx_count": 2
}
}
Информация о блоке представлена следующими полями:
Поле | Тип | Назначение |
---|---|---|
block_difficulty | double | Сложность блока |
block_hash | string | Хеш блока |
block_height | integer | Высота блока |
block_size | integer | Размер блока в байта |
block_time | integer | Время создания блока |
block_version | integer | Версия |
confirmations | integer | Число подтверждений |
tx_count | integer | Число транзакций в блоке |
Пример:
curl
curl -g -H "Content-Type: application/json" -H "Accept: application/json" "https://api.matbea.net/block/0000000066356691a4353dd8bdc2c60da20d68ad34fff93d8839a133b2a6d42a?token=YOUR_TOKEN"
PHP
$block_hash = '0000000066356691a4353dd8bdc2c60da20d68ad34fff93d8839a133b2a6d42a';
$url = 'https://api.matbea.net';
$tok = 'token=YOUR_TOKEN';
$GETparam = '/block/'.$block_hash.'?'.$tok;
$POSTparam=[];
$rsh = curl_init();
if ($rsh) {
curl_setopt($rsh, CURLOPT_URL, $url . $GETparam);
curl_setopt($rsh, CURLOPT_HTTPHEADER, ['Content-Type:application/json']);
curl_setopt($rsh, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($rsh, CURLOPT_POST, 0);
$r=curl_exec($rsh);
if (!$r) {
printf("[E]\t%s (%s)\n", curl_error($rsh), curl_errno($rsh));
} else {
printf("%s\n", $r);
}
curl_close($rsh);
}
javascript
blockhash = '0000000066356691a4353dd8bdc2c60da20d68ad34fff93d8839a133b2a6d42a';
tok = 'token=YOUR_TOKEN';
url = 'https://api.matbea.net/block/' + blockhash + '?' + tok;
fetch(url)
.then(function (response) {
return response.json();
}).then(function (data) {
console.log(data);
});
Результат:
{
"error": {},
"result": {
"block_difficulty": 1,
"block_hash": "0000000066356691a4353dd8bdc2c60da20d68ad34fff93d8839a133b2a6d42a",
"block_height": 221,
"block_size": 417,
"block_time": 1231770060,
"block_version": 1,
"confirmations": 505809,
"tx_count": 2
}
}
curl
curl -g -H "Content-Type: application/json" -H "Accept: application/json" "https://api.matbea.net/block/221?token=YOUR_TOKEN"
PHP
$block_id = 221;
$url = 'https://api.matbea.net';
$tok = 'token=YOUR_TOKEN';
$GETparam = '/block/' . $block_id . '?' . $tok;
$POSTparam=[];
$rsh = curl_init();
if ($rsh) {
curl_setopt($rsh, CURLOPT_URL, $url . $GETparam);
curl_setopt($rsh, CURLOPT_HTTPHEADER, ['Content-Type:application/json']);
curl_setopt($rsh, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($rsh, CURLOPT_POST, 0);
$r=curl_exec($rsh);
if (!$r) {
printf("[E]\t%s (%s)\n", curl_error($rsh), curl_errno($rsh));
} else {
printf("%s\n", $r);
}
curl_close($rsh);
}
javascript
blockid = 221;
tok = 'token=YOUR_TOKEN';
url = 'https://api.matbea.net/block/' + blockid + '?' + tok;
fetch(url)
.then(function (response) {
return response.json();
}).then(function (data) {
console.log(data);
});
Результат:
{
"error": {},
"result": {
"block_difficulty": 1,
"block_hash": "0000000066356691a4353dd8bdc2c60da20d68ad34fff93d8839a133b2a6d42a",
"block_height": 221,
"block_size": 417,
"block_time": 1231770060,
"block_version": 1,
"confirmations": 505809,
"tx_count": 2
}
}
Наверх
Возвращает информацию о блоках по заданным номерам блоков.
Вызов метода:Параметры запроса:https://api.matbea.net/blocks?blockid[]=BLOCKID
Параметр | Тип | Назначение | Метод передачи |
---|---|---|---|
BLOCKID | integer | Высота блока или массива высот блоков о которых необходимо получить информацию | URI, POST |
Результат запроса возвращается в следующем json формате:
{
"error": {},
"result": {
"blocks": [
{
"block_difficulty": 1,
"block_hash": "00000000839a8e6886ab5951d76f411475428afc90947ee320161bbf18eb6048",
"block_height": 1,
"block_size": 215,
"block_time": 1231469665,
"block_version": 1,
"confirmations": 506029,
"tx_count": 1
}
]
}
}
Информация о блоке представлена следующими полями:
Поле | Тип | Назначение |
---|---|---|
block_difficulty | double | Сложность блока |
block_hash | string | Хеш блока |
block_height | integer | Высота блока |
block_size | integer | Размер блока в байта |
block_time | integer | Время создания блока |
block_version | integer | Версия |
confirmations | integer | Число подтверждений |
tx_count | integer | Число транзакций в блоке |
Примеры:
curl
curl -g -H "Content-Type: application/json" -H "Accept: application/json" "https://api.matbea.net/blocks?blockid[]=1&blockid[]=5000&token=YOUR_TOKEN"
PHP
$url = 'https://api.matbea.net';
$tok = 'token=YOUR_TOKEN';
$GETparam = '/blocks?blockid[]=1&blockid[]=5000&'.$tok;
$POSTparam=[];
$rsh = curl_init();
if ($rsh) {
curl_setopt($rsh, CURLOPT_URL, $url . $GETparam);
curl_setopt($rsh, CURLOPT_HTTPHEADER, ['Content-Type:application/json']);
curl_setopt($rsh, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($rsh, CURLOPT_POST, 0);
$r=curl_exec($rsh);
if (!$r) {
printf("[E]\t%s (%s)\n", curl_error($rsh), curl_errno($rsh));
} else {
printf("%s\n", $r);
}
curl_close($rsh);
}
javascript
id1 = '1';
id2 = '5000';
tok = 'token=YOUR_TOKEN';
url = 'https://api.matbea.net/blocks?blockid[]=' + id1 + '&blockid[]=' + id2 + '&' + tok;
fetch(url)
.then(function (response) {
return response.json();
}).then(function (data) {
console.log(data);
});
Результат:
{
"error": {},
"result": {
"blocks": [
{
"block_difficulty": 1,
"block_hash": "00000000839a8e6886ab5951d76f411475428afc90947ee320161bbf18eb6048",
"block_height": 1,
"block_size": 215,
"block_time": 1231469665,
"block_version": 1,
"confirmations": 506029,
"tx_count": 1
},
{
"block_difficulty": 1,
"block_hash": "000000004d78d2a8a93a1d20a24d721268690bebd2b51f7e80657d57e226eef9",
"block_height": 5000,
"block_size": 216,
"block_time": 1235135895,
"block_version": 1,
"confirmations": 501030,
"tx_count": 1
}
]
}
}
curl
curl -g -H "Content-Type: application/json" -H "Accept: application/json" -X POST -d "{\"blockid\":[1,5000]}" "https://api.matbea.net/blocks?token=YOUR_TOKEN"
PHP
$url = 'https://api.matbea.net';
$tok = 'token=YOUR_TOKEN';
$GETparam = '/blocks?'.$tok;
$POSTparam=['blockid'=>[1,5000]];
$rsh = curl_init();
if ($rsh) {
curl_setopt($rsh, CURLOPT_URL, $url . $GETparam);
curl_setopt($rsh, CURLOPT_HTTPHEADER, ['Content-Type:application/json']);
curl_setopt($rsh, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($rsh, CURLOPT_POST, 1);
curl_setopt($rsh, CURLOPT_POSTFIELDS, json_encode($POSTparam));
$r=curl_exec($rsh);
if (!$r) {
printf("[E]\t%s (%s)\n", curl_error($rsh), curl_errno($rsh));
} else {
printf("%s\n", $r);
}
curl_close($rsh);
}
javascript
id1 = 1;
id2 = 5000;
tok = 'token=YOUR_TOKEN';
url = 'https://api.matbea.net/blocks?' + tok;
fetch(url, {
method: 'post',
body: JSON.stringify({blockid: [id1, id2] }) })
.then(function (response) {
return response.json();
}).then(function (data) {
console.log(data);
});
Результат:
{
"error": {},
"result": {
"blocks": [
{
"block_difficulty": 1,
"block_hash": "00000000839a8e6886ab5951d76f411475428afc90947ee320161bbf18eb6048",
"block_height": 1,
"block_size": 215,
"block_time": 1231469665,
"block_version": 1,
"confirmations": 506029,
"tx_count": 1
},
{
"block_difficulty": 1,
"block_hash": "000000004d78d2a8a93a1d20a24d721268690bebd2b51f7e80657d57e226eef9",
"block_height": 5000,
"block_size": 216,
"block_time": 1235135895,
"block_version": 1,
"confirmations": 501030,
"tx_count": 1
}
]
}
}
Наверх
Возвращает информацию о последних добавленных блоках.
Вызов метода:Параметры запроса:https://api.matbea.net/lastblocks?count=COUNT
Значание | Тип | Назначение | Метод передачи |
---|---|---|---|
COUNT | integer | Число последних блоков в результате | URI |
Результат:
{
"error": {},
"result": {
"blocks": [
{
"block_difficulty": 2603077300218.6,
"block_hash": "00000000000000000059c15d5e0ac4c813714bb6b8e9792c8e213844b9754e0e",
"block_height": 506029,
"block_size": 1003238,
"block_time": 1516871154,
"block_version": 536870912,
"confirmations": 1,
"tx_count": 432
}
]
}
}
Информация о блоке представлена следующими полями:
Поле | Тип | Назначение |
---|---|---|
block_difficulty | double | Сложность блока |
block_hash | string | Хеш блока |
block_height | integer | Высота блока |
block_size | integer | Размер блока в байта |
block_time | integer | Время создания блока |
block_version | integer | Версия |
confirmations | integer | Число подтверждений |
tx_count | integer | Число транзакций в блоке |
Пример:
curl
curl -g -H "Content-Type: application/json" -H "Accept: application/json" "https://api.matbea.net/lastblocks?count=3&token=YOUR_TOKEN"
PHP
$url = 'https://api.matbea.net';
$tok = 'token=YOUR_TOKEN';
$GETparam = '/lastblocks?count=3&'.$tok;
$POSTparam=[];
$rsh = curl_init();
if ($rsh) {
curl_setopt($rsh, CURLOPT_URL, $url . $GETparam);
curl_setopt($rsh, CURLOPT_HTTPHEADER, ['Content-Type:application/json']);
curl_setopt($rsh, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($rsh, CURLOPT_POST, 0);
$r=curl_exec($rsh);
if (!$r) {
printf("[E]\t%s (%s)\n", curl_error($rsh), curl_errno($rsh));
} else {
printf("%s\n", $r);
}
curl_close($rsh);
}
javascript
c = '3';
tok = 'token=YOUR_TOKEN';
url = 'https://api.matbea.net/lastblocks?count=' + c + '&' + tok;
fetch(url)
.then(function (response) {
return response.json();
}).then(function (data) {
console.log(data);
});
Результат:
{
"error": {},
"result": {
"blocks": [
{
"block_difficulty": 2603077300218.6,
"block_hash": "00000000000000000059c15d5e0ac4c813714bb6b8e9792c8e213844b9754e0e",
"block_height": 506029,
"block_size": 1003238,
"block_time": 1516871154,
"block_version": 536870912,
"confirmations": 1,
"tx_count": 432
},
{
"block_difficulty": 2603077300218.6,
"block_hash": "00000000000000000064ad4a4839abefd2e4e3d2a75c2bd1fadead59ad9c32b8",
"block_height": 506028,
"block_size": 1046102,
"block_time": 1516871116,
"block_version": 536870912,
"confirmations": 2,
"tx_count": 1036
},
{
"block_difficulty": 2603077300218.6,
"block_hash": "0000000000000000003133c567a511c15ae1da565ff9ca7601dcf1532291b282",
"block_height": 506027,
"block_size": 1037188,
"block_time": 1516870806,
"block_version": 536870912,
"confirmations": 3,
"tx_count": 1911
}
]
}
}
Наверх
Возвращает информацию о транзакциях в блоке с заданной высотой.
Вызов метода:Параметры запроса:https://api.matbea.net/blocktransactions?block=BLOCK&page=PAGE&limit=LIMIT
Значение | Тип | Назначение | Метод передачи |
---|---|---|---|
BLOCK | integer | Высота блока. Положительное число, больше 0 | URI |
PAGE | integer | Номер страницы | URI |
LIMIT | integer | Число записей на странице | URI |
Результат запроса возвращается в следующем json формате:
{
"error": {},
"result": {
"confirmations": 61719,
"current_page": 5,
"per_page": 2,
"total": 2072,
"txs": [
{
"inputs_count": 1,
"outputs_count": 2,
"transaction_time": 1482335740,
"tx_hash": "f64dbcd3c69ef5c1e08dbab1a0365c260cb7675bcc7e8c6b6552b17228a92a79"
},
{
"inputs_count": 1,
"outputs_count": 2,
"transaction_time": 1482335740,
"tx_hash": "3ffa38f6718ea9a8f35b02f96620ccf1e55395544339aa8587ae28b823295927"
},
]
}
}
Информация о транзакциях в блоке содержит следующие поля:
Поле | Тип | Назначение |
---|---|---|
confirmations | integer | Число подтверждений |
current_page | integer | Номер возвращенной странцы. Определяет параметр page |
per_page | integer | Число записей на странице. Определяет параметр limit |
total | integer | Число записей в блоке |
txs | array | Массив данных о транзакциях входящих в блок |
Поле | Тип | Назначение |
---|---|---|
inputs_count | integer | Число входов |
outputs_count | integer | Число выходов |
transaction_time | integer | Время проведения транзакции |
tx_hash | string | Хеш транзакции |
Пример:
curl
curl -g -H "Content-Type: application/json" -H "Accept: application/json" "https://api.matbea.net/blocktransactions?block=444444&page=5&limit=3&token=YOUR_TOKEN"
PHP
$block = 444444;
$page = 5;
$limit = 3;
$url = 'https://api.matbea.net';
$tok = 'token=YOUR_TOKEN';
$GETparam = '/blocktransactions?block=' . $block . '&page=' . $page . '&limit=' . $limit . '&' . $tok;
$POSTparam=[];
$rsh = curl_init();
if ($rsh) {
curl_setopt($rsh, CURLOPT_URL, $url . $GETparam);
curl_setopt($rsh, CURLOPT_HTTPHEADER, ['Content-Type:application/json']);
curl_setopt($rsh, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($rsh, CURLOPT_POST, 0);
$r=curl_exec($rsh);
if (!$r) {
printf("[E]\t%s (%s)\n", curl_error($rsh), curl_errno($rsh));
} else {
printf("%s\n", $r);
}
curl_close($rsh);
}
javascript
block = 444444;
page = 5;
limit = 3;
tok = 'token=YOUR_TOKEN';
url = 'https://api.matbea.net/blocktransactions?block=' + block + '&page=' + page + '&limit=' + limit + '&' + tok;
fetch(url)
.then(function (response) {
return response.json();
}).then(function (data) {
console.log(data);
});
Результат:
{
"error": {},
"result": {
"confirmations": 61719,
"current_page": 5,
"per_page": 3,
"total": 2072,
"txs": [
{
"inputs_count": 1,
"outputs_count": 2,
"transaction_time": 1482335740,
"tx_hash": "f64dbcd3c69ef5c1e08dbab1a0365c260cb7675bcc7e8c6b6552b17228a92a79"
},
{
"inputs_count": 1,
"outputs_count": 2,
"transaction_time": 1482335740,
"tx_hash": "3ffa38f6718ea9a8f35b02f96620ccf1e55395544339aa8587ae28b823295927"
},
{
"inputs_count": 1,
"outputs_count": 2,
"transaction_time": 1482335740,
"tx_hash": "0d9cfe5c852cfb60b4e0b77f2c63da5ec9f7c75437946f68a194994a0eef6e0c"
}
]
}
}
Наверх
Возвращает информацию о балансе указанного адреса/адресов для заданного числа подтверждений.
Вызов метода:Параметры запроса:https://api.matbea.net/confirmedBalance?address[]=ADDRESS&confirmations=CONFIRMATIONS
Значение | Тип | Назначение | Метод передачи |
---|---|---|---|
ADDRESS | string | Адрес или несколько адресов для которых запрошена информация. Адреса передаются в массиве | URI, POST |
CONFIRMATIONS | integer | Число подтверждений. Если параметр не передан, то confirmations принимается равным 1 | URI |
Результат запроса возвращается в следующем json формате:
{
"error": {},
"result": {
"balances": [
{
"address": "1MN3cT9Ro927h4kgpSZ5V7SfYjrwTysXv7",
"balance": 6500
}
],
"confirmations": 1
}
}
Информация о подтвержденном балансе представлена следующими полями:
Поле | Тип | Назначение |
---|---|---|
address | string | Запрошенный адрес |
balance | integer | Баланс запрошенного адреса |
confirmations | integer | Число подтверждений |
Если в запросе передан неверный адрес или адрес который не использовался в транзакциях, то содержимое массива balances будет пустым:
{
"error": {},
"result": {
"balances": []
}
}
Примеры:
curl
curl -g -H "Content-Type: application/json" -H "Accept: application/json" "https://api.matbea.net/confirmedBalance?address[]=1MN3cT9Ro927h4kgpSZ5V7SfYjrwTysXv7&address[]=1BdxBor4JG76RKLAwJZfHC58fWbgidYukz&confirmations=50&token=YOUR_TOKEN"
PHP
$addr1 = '1MN3cT9Ro927h4kgpSZ5V7SfYjrwTysXv7';
$addr2 = '1BdxBor4JG76RKLAwJZfHC58fWbgidYukz';
$url = 'https://api.matbea.net';
$tok = 'token=YOUR_TOKEN';
$GETparam = '/confirmedBalance?address[]='.$addr1.'&address[]='.$addr2.'&confirmations=50&'.$tok;
$POSTparam=[];
$rsh = curl_init();
if ($rsh) {
curl_setopt($rsh, CURLOPT_URL, $url . $GETparam);
curl_setopt($rsh, CURLOPT_HTTPHEADER, ['Content-Type:application/json']);
curl_setopt($rsh, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($rsh, CURLOPT_POST, 0);
$r=curl_exec($rsh);
if (!$r) {
printf("[E]\t%s (%s)\n", curl_error($rsh), curl_errno($rsh));
} else {
printf("%s\n", $r);
}
curl_close($rsh);
}
javascript
addr1 = '1MN3cT9Ro927h4kgpSZ5V7SfYjrwTysXv7';
addr2 = '1BdxBor4JG76RKLAwJZfHC58fWbgidYukz';
n = 50;
tok = 'token=YOUR_TOKEN';
url = 'https://api.matbea.net/confirmedBalance?address[]=' + addr1 + '&address[]=' + addr2 + '&confirmations=' + n + '&' + tok;
fetch(url)
.then(function (response) {
return response.json();
}).then(function (data) {
console.log(data);
});
Результат:
{
"error": {},
"result": {
"balances": [
{
"address": "1MN3cT9Ro927h4kgpSZ5V7SfYjrwTysXv7",
"balance": 6500
},
{
"address": "1BdxBor4JG76RKLAwJZfHC58fWbgidYukz",
"balance": 5500
}
],
"confirmations": 50
}
}
curl
curl -g -k -H "Content-Type: application/json" -H "Accept: application/json" -X POST -d "{\"address\":[\"1MN3cT9Ro927h4kgpSZ5V7SfYjrwTysXv7\",\"1BdxBor4JG76RKLAwJZfHC58fWbgidYukz\"]}" "https://api.matbea.net/confirmedBalance?confirmations=50&token=YOUR_TOKEN"
PHP
$addr1 = '1MN3cT9Ro927h4kgpSZ5V7SfYjrwTysXv7';
$addr2 = '1BdxBor4JG76RKLAwJZfHC58fWbgidYukz';
$url = 'https://api.matbea.net';
$tok = 'token=YOUR_TOKEN';
$GETparam = '/confirmedBalance?confirmations=50&'.$tok;
$POSTparam=['address'=>[$addr1,$addr2]];
$rsh = curl_init();
if ($rsh) {
curl_setopt($rsh, CURLOPT_URL, $url . $GETparam);
curl_setopt($rsh, CURLOPT_HTTPHEADER, ['Content-Type:application/json']);
curl_setopt($rsh, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($rsh, CURLOPT_POST, 1);
curl_setopt($rsh, CURLOPT_POSTFIELDS, json_encode($POSTparam));
$r=curl_exec($rsh);
if (!$r) {
printf("[E]\t%s (%s)\n", curl_error($rsh), curl_errno($rsh));
} else {
printf("%s\n", $r);
}
curl_close($rsh);
}
javascript
addr1 = '1MN3cT9Ro927h4kgpSZ5V7SfYjrwTysXv7';
addr2 = '1BdxBor4JG76RKLAwJZfHC58fWbgidYukz';
n = 50;
tok = 'token=YOUR_TOKEN';
url = 'https://api.matbea.net/confirmedBalance?confirmations=' + n + '&' + tok;
fetch(url, {
method: 'post',
body: JSON.stringify({address: [addr1, addr2] }) })
.then(function (response) {
return response.json();
}).then(function (data) {
console.log(data);
});
Результат:
{
"error": {},
"result": {
"balances": [
{
"address": "1MN3cT9Ro927h4kgpSZ5V7SfYjrwTysXv7",
"balance": 6500
},
{
"address": "1BdxBor4JG76RKLAwJZfHC58fWbgidYukz",
"balance": 5500
}
],
"confirmations": 50
}
}
curl
curl -g -k -H "Content-Type: application/json" -H "Accept: application/json" "https://api.matbea.net/confirmedBalance?address[]=1MN3cT9Ro927h4kgpSZ5V7SfYjrwTysXv7&token=YOUR_TOKEN"
PHP
$addr1 = '1MN3cT9Ro927h4kgpSZ5V7SfYjrwTysXv7';
$url = 'https://api.matbea.net';
$tok = 'token=YOUR_TOKEN';
$GETparam = '/confirmedBalance?address[]='.$addr1.'&'.$tok;
$POSTparam=[];
$rsh = curl_init();
if ($rsh) {
curl_setopt($rsh, CURLOPT_URL, $url . $GETparam);
curl_setopt($rsh, CURLOPT_HTTPHEADER, ['Content-Type:application/json']);
curl_setopt($rsh, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($rsh, CURLOPT_POST, 0);
$r=curl_exec($rsh);
if (!$r) {
printf("[E]\t%s (%s)\n", curl_error($rsh), curl_errno($rsh));
} else {
printf("%s\n", $r);
}
curl_close($rsh);
}
javascript
addr1 = '1MN3cT9Ro927h4kgpSZ5V7SfYjrwTysXv7';
tok = 'token=YOUR_TOKEN';
url = 'https://api.matbea.net/confirmedBalance?address[]=' + addr1 + '&' + tok;
fetch(url)
.then(function (response) {
return response.json();
}).then(function (data) {
console.log(data);
});
Результат:
{
"error": {},
"result": {
"balances": [
{
"address": "1MN3cT9Ro927h4kgpSZ5V7SfYjrwTysXv7",
"balance": 6500
}
],
"confirmations": 1
}
}
Наверх
Возвращает информацию о неподвтержденном балансе указанного адреса/адресов.
Вызов метода:Параметры запроса:https://api.matbea.net/unconfirmedBalance?address[]=ADDRESS
Значение | Тип | Назначение | Метод передачи |
---|---|---|---|
ADDRESS | string | Адрес или массив адресов информацию о которых необоходимо получить. | URI, POST |
Результат запроса возвращается в следующем json формате:
{
"error": {},
"result": {
"balances": [
{
"address": "1MN3cT9Ro927h4kgpSZ5V7SfYjrwTysXv7",
"balance": 0
}
]
}
}
Информация о неподтвержденном балансе представлена следующими полями:
Поле | Тип | Назначение |
---|---|---|
address | string | Запрошенный адрес |
balance | integer | Неподтвержденный баланс запрошенного адреса |
Если в запросе передан неверный адрес или адрес который не использовался в транзакциях, то содержимое массива balances будет пустым:
{
"error": {},
"result": {
"balances": []
}
}
Пример:
curl
curl -g -H "Content-Type: application/json" -H "Accept: application/json" "https://api.matbea.net/unconfirmedBalance?address[]=1MN3cT9Ro927h4kgpSZ5V7SfYjrwTysXv7&address[]=1BdxBor4JG76RKLAwJZfHC58fWbgidYukz&token=YOUR_TOKEN"
PHP
$addr1 = '1MN3cT9Ro927h4kgpSZ5V7SfYjrwTysXv7';
$addr2 = '1BdxBor4JG76RKLAwJZfHC58fWbgidYukz';
$url = 'https://api.matbea.net';
$tok = 'token=YOUR_TOKEN';
$GETparam = '/unconfirmedBalance?address[]='.$addr1.'&address[]='.$addr2.'&'.$tok;
$POSTparam=[];
$rsh = curl_init();
if ($rsh) {
curl_setopt($rsh, CURLOPT_URL, $url . $GETparam);
curl_setopt($rsh, CURLOPT_HTTPHEADER, ['Content-Type:application/json']);
curl_setopt($rsh, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($rsh, CURLOPT_POST, 0);
$r=curl_exec($rsh);
if (!$r) {
printf("[E]\t%s (%s)\n", curl_error($rsh), curl_errno($rsh));
} else {
printf("%s\n", $r);
}
curl_close($rsh);
}
javascript
addr1 = '1MN3cT9Ro927h4kgpSZ5V7SfYjrwTysXv7';
addr2 = '1BdxBor4JG76RKLAwJZfHC58fWbgidYukz';
tok = 'token=YOUR_TOKEN';
url = 'https://api.matbea.net/unconfirmedBalance?address[]=' + addr1 + '&address[]=' + addr2 + '&' + tok;
fetch(url)
.then(function (response) {
return response.json();
}).then(function (data) {
console.log(data);
});
Результат:
{
"error": {},
"result": {
"balances": [
{
"address": "1MN3cT9Ro927h4kgpSZ5V7SfYjrwTysXv7",
"balance": 0
},
{
"address": "1BdxBor4JG76RKLAwJZfHC58fWbgidYukz",
"balance": 0
}
]
}
}
curl
curl -g -H "Content-Type: application/json" -H "Accept: application/json" -X POST -d "{\"address\":[\"1MN3cT9Ro927h4kgpSZ5V7SfYjrwTysXv7\",\"1BdxBor4JG76RKLAwJZfHC58fWbgidYukz\"]}" "https://api.matbea.net/unconfirmedBalance?token=YOUR_TOKEN"
PHP
$addr1 = '1MN3cT9Ro927h4kgpSZ5V7SfYjrwTysXv7';
$addr2 = '1BdxBor4JG76RKLAwJZfHC58fWbgidYukz';
$url = 'https://api.matbea.net';
$tok = 'token=YOUR_TOKEN';
$GETparam = '/unconfirmedBalance?'.$tok;
$POSTparam=['address'=>[$addr1,$addr2]];
$rsh = curl_init();
if ($rsh) {
curl_setopt($rsh, CURLOPT_URL, $url . $GETparam);
curl_setopt($rsh, CURLOPT_HTTPHEADER, ['Content-Type:application/json']);
curl_setopt($rsh, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($rsh, CURLOPT_POST, 1);
curl_setopt($rsh, CURLOPT_POSTFIELDS, json_encode($POSTparam));
$r=curl_exec($rsh);
if (!$r) {
printf("[E]\t%s (%s)\n", curl_error($rsh), curl_errno($rsh));
} else {
printf("%s\n", $r);
}
curl_close($rsh);
}
javascript
addr1 = '1MN3cT9Ro927h4kgpSZ5V7SfYjrwTysXv7';
addr2 = '1BdxBor4JG76RKLAwJZfHC58fWbgidYukz';
tok = 'token=YOUR_TOKEN';
url = 'https://api.matbea.net/unconfirmedBalance?' + tok;
fetch(url, {
method: 'post',
body: JSON.stringify({address: [addr1, addr2] }) })
.then(function (response) {
return response.json();
}).then(function (data) {
console.log(data);
});
Результат:
{
"error": {},
"result": {
"balances": [
{
"address": "1MN3cT9Ro927h4kgpSZ5V7SfYjrwTysXv7",
"balance": 0
},
{
"address": "1BdxBor4JG76RKLAwJZfHC58fWbgidYukz",
"balance": 0
}
]
}
}
Наверх
Возвращает информацию о нахождении указанного адреса/адресов в списке подтвержденных/неподтвержденных транзакций.
Вызов метода:Параметры запроса:https://api.matbea.net/countTransactions?address[]=ADDRESS&confirmed=CONFIRMED
Значение | Тип | Назначение | Метод передачи |
---|---|---|---|
ADDRESS | string | Адрес или массив адресов информацию о которых необходимо получить. | URI, POST |
CONFIRMED | boolean | true - поиск адреса в подтвержденных транзакциях, false - поиск адреса в неподтвержденных транзакциях. Если параметр не задан поиск во всех транзакциях |
URI |
Результат запроса возвращается в следующем json формате:
{
"error": {},
"result": {
"addresses": [
{
"1MN3cT9Ro927h4kgpSZ5V7SfYjrwTysXv7": true
},
{
"АДРЕС": ЗНАЧЕНИЕ
}
],
"confirmed": true
}
}
Информация об адресах представлена следующими полями:
Поле | Тип | Назначение |
---|---|---|
АДРЕС | string | Запрошенный адрес |
ЗНАЧЕНИЕ | boolean | true - адрес найден, false - адрес не найден |
confirmed | boolean | Режим поиска |
Если в запросе передан неверный адрес или адрес который не использовался в транзакциях, то содержимое массива addresses будет пустым:
{
"error": {},
"result": {
"addresses": []
}
}
Пример:
curl
curl -g -H "Content-Type: application/json" -H "Accept: application/json" "https://api.matbea.net/countTransactions?address[]=1MN3cT9Ro927h4kgpSZ5V7SfYjrwTysXv7&address[]=1BdxBor4JG76RKLAwJZfHC58fWbgidYukz&token=YOUR_TOKEN"
PHP
$addr1 = '1MN3cT9Ro927h4kgpSZ5V7SfYjrwTysXv7';
$addr2 = '1BdxBor4JG76RKLAwJZfHC58fWbgidYukz';
$url = 'https://api.matbea.net';
$tok = 'token=YOUR_TOKEN';
$GETparam = '/countTransactions?address[]='.$addr1.'&address[]='.$addr2.'&'.$tok;
$POSTparam=[];
$rsh = curl_init();
if ($rsh) {
curl_setopt($rsh, CURLOPT_URL, $url . $GETparam);
curl_setopt($rsh, CURLOPT_HTTPHEADER, ['Content-Type:application/json']);
curl_setopt($rsh, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($rsh, CURLOPT_POST, 0);
$r=curl_exec($rsh);
if (!$r) {
printf("[E]\t%s (%s)\n", curl_error($rsh), curl_errno($rsh));
} else {
printf("%s\n", $r);
}
curl_close($rsh);
}
javascript
addr1 = '1MN3cT9Ro927h4kgpSZ5V7SfYjrwTysXv7';
addr2 = '1BdxBor4JG76RKLAwJZfHC58fWbgidYukz';
tok = 'token=YOUR_TOKEN';
url = 'https://api.matbea.net/countTransactions?address[]=' + addr1 + '&address[]=' + addr2 + '&' + tok;
fetch(url)
.then(function (response) {
return response.json();
}).then(function (data) {
console.log(data);
});
Результат:
{
"error": {},
"result": {
"addresses": [
{
"1MN3cT9Ro927h4kgpSZ5V7SfYjrwTysXv7": true
},
{
"1BdxBor4JG76RKLAwJZfHC58fWbgidYukz": true
}
]
}
}
curl
curl -g -H "Content-Type: application/json" -H "Accept: application/json" "https://api.matbea.net/countTransactions?address[]=1MN3cT9Ro927h4kgpSZ5V7SfYjrwTysXv7&address[]=1BdxBor4JG76RKLAwJZfHC58fWbgidYukz&confirmed=true&token=YOUR_TOKEN"
PHP
$addr1 = '1MN3cT9Ro927h4kgpSZ5V7SfYjrwTysXv7';
$addr2 = '1BdxBor4JG76RKLAwJZfHC58fWbgidYukz';
$url = 'https://api.matbea.net';
$tok = 'token=YOUR_TOKEN';
$GETparam = '/countTransactions?address[]='.$addr1.'&address[]='.$addr2.'&confirmed=true&'.$tok;
$POSTparam=[];
$rsh = curl_init();
if ($rsh) {
curl_setopt($rsh, CURLOPT_URL, $url . $GETparam);
curl_setopt($rsh, CURLOPT_HTTPHEADER, ['Content-Type:application/json']);
curl_setopt($rsh, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($rsh, CURLOPT_POST, 0);
$r=curl_exec($rsh);
if (!$r) {
printf("[E]\t%s (%s)\n", curl_error($rsh), curl_errno($rsh));
} else {
printf("%s\n", $r);
}
curl_close($rsh);
}
javascript
addr1 = '1MN3cT9Ro927h4kgpSZ5V7SfYjrwTysXv7';
addr2 = '1BdxBor4JG76RKLAwJZfHC58fWbgidYukz';
tok = 'token=YOUR_TOKEN';
url = 'https://api.matbea.net/countTransactions?address[]=' + addr1 + '&address[]=' + addr2 + '&confirmed=true&' + tok;
fetch(url)
.then(function (response) {
return response.json();
}).then(function (data) {
console.log(data);
});
Результат:
{
"error": {},
"result": {
"addresses": [
{
"1MN3cT9Ro927h4kgpSZ5V7SfYjrwTysXv7": true
},
{
"1BdxBor4JG76RKLAwJZfHC58fWbgidYukz": true
}
],
"confirmed": true
}
}
curl
curl -g -H "Content-Type: application/json" -H "Accept: application/json" -X POST -d "{\"address\":[\"1MN3cT9Ro927h4kgpSZ5V7SfYjrwTysXv7\",\"1BdxBor4JG76RKLAwJZfHC58fWbgidYukz\"]}" "https://api.matbea.net/countTransactions?&confirmed=false&token=YOUR_TOKEN"
PHP
$addr1 = '1MN3cT9Ro927h4kgpSZ5V7SfYjrwTysXv7';
$addr2 = '1BdxBor4JG76RKLAwJZfHC58fWbgidYukz';
$url = 'https://api.matbea.net';
$tok = 'token=YOUR_TOKEN';
$GETparam = '/countTransactions?confirmed=false&'.$tok;
$POSTparam=['address'=>[$addr1,$addr2]];
$rsh = curl_init();
if ($rsh) {
curl_setopt($rsh, CURLOPT_URL, $url . $GETparam);
curl_setopt($rsh, CURLOPT_HTTPHEADER, ['Content-Type:application/json']);
curl_setopt($rsh, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($rsh, CURLOPT_POST, 1);
curl_setopt($rsh, CURLOPT_POSTFIELDS, json_encode($POSTparam));
$r=curl_exec($rsh);
if (!$r) {
printf("[E]\t%s (%s)\n", curl_error($rsh), curl_errno($rsh));
} else {
printf("%s\n", $r);
}
curl_close($rsh);
}
javascript
addr1 = '1MN3cT9Ro927h4kgpSZ5V7SfYjrwTysXv7';
addr2 = '1BdxBor4JG76RKLAwJZfHC58fWbgidYukz';
tok = 'token=YOUR_TOKEN';
url = 'https://api.matbea.net/countTransactions?confirmed=false&' + tok;
fetch(url, {
method: 'post',
body: JSON.stringify({address: [addr1, addr2] }) })
.then(function (response) {
return response.json();
}).then(function (data) {
console.log(data);
});
Результат:
{
"error": {},
"result": {
"addresses": [
{
"1MN3cT9Ro927h4kgpSZ5V7SfYjrwTysXv7": false
},
{
"1BdxBor4JG76RKLAwJZfHC58fWbgidYukz": false
}
],
"confirmed": false
}
}
Наверх
Возвращает информацию о подтвержденном балансе указанного адреса/адресов.
Вызов метода:Параметры запроса:https://api.matbea.net/unspentConfirmed?address[]=ADDRESS&confirmations=CONFIRMATIONS
Значение | Тип | Назначение | Метод передачи |
---|---|---|---|
ADDRESS | string | Адрес или адреса о которых запрашивается информация. Параметр перадается в массиве | URI, POST |
CONFIRMATIONS | integer | Число подтверждений. Если параметр не передан, то confirmations принимается равным 1 | URI |
Результат запроса возвращается в следующем json формате:
{
"error": {},
"result": {
"confirmations": 50,
"outputs": [
{
"address": "1MN3cT9Ro927h4kgpSZ5V7SfYjrwTysXv7",
"unspent": [
{
"amount": 5500,
"block_height": 456429,
"confirmations": 49751,
"confirmed": 1489052276,
"tx_hash": "97c078f4b762bc0027a4405fb73d6b029c2deddc80e3465e5951503536d65965",
"vout": 0
},
{
"amount": 1000,
"block_height": 492803,
"confirmations": 13377,
"confirmed": 1509630924,
"tx_hash": "e3994bf9556d70a7a402aae3ed62e6c427f2bd881a06f841f262596dc64b78cb",
"vout": 0
}
]
},
{
"address": "1BdxBor4JG76RKLAwJZfHC58fWbgidYukz",
"unspent": [
{
"amount": 5500,
"block_height": 450229,
"confirmations": 55951,
"confirmed": 1485507176,
"tx_hash": "d637117f6ccfbbc147a2bcfa0b492b273e3462d1ed8db3521a0967f0abecea27",
"vout": 0
}
]
}
]
}
}
Информация о подтвержденном непотраченном балансе представлена следующими полями:
Поле | Тип | Назначение |
---|---|---|
confirmations | integer | Число подтверждений |
outputs | array | Массив с данными об адресе и подтвержденном балансе |
Поле | Тип | Назначение |
---|---|---|
address | string | запрошенный адрес |
unspent | array | Массив с данными о подтвержденных непотраченных выходах |
Поле | Тип | Назначение |
---|---|---|
amount | integer | Средства |
block_height | integer | Высота блока |
confirmations | integer | Число подтверждений |
confirmed | integer | Время подтверждения |
tx_hash | string | Хеш входной транзакции |
vout | integer | Номер выхода |
Если в запросе передан неверный адрес или адрес который не использовался в транзакциях, то содержимое массива outputs будет пустым:
{
"error": {},
"result": {
"confirmations": 1,
"outputs": []
}
}
Примеры:
curl
curl -g -H "Content-Type: application/json" -H "Accept: application/json" "https://api.matbea.net/unspentConfirmed?address[]=1MN3cT9Ro927h4kgpSZ5V7SfYjrwTysXv7&address[]=1BdxBor4JG76RKLAwJZfHC58fWbgidYukz&confirmations=50&token=YOUR_TOKEN"
PHP
$addr1 = '1MN3cT9Ro927h4kgpSZ5V7SfYjrwTysXv7';
$addr2 = '1BdxBor4JG76RKLAwJZfHC58fWbgidYukz';
$url = 'https://api.matbea.net';
$tok = 'token=YOUR_TOKEN';
$GETparam = '/unspentConfirmed?address[]='.$addr1.'&address[]='.$addr2.'&confirmations=50&'.$tok;
$POSTparam=[];
$rsh = curl_init();
if ($rsh) {
curl_setopt($rsh, CURLOPT_URL, $url . $GETparam);
curl_setopt($rsh, CURLOPT_HTTPHEADER, ['Content-Type:application/json']);
curl_setopt($rsh, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($rsh, CURLOPT_POST, 0);
$r=curl_exec($rsh);
if (!$r) {
printf("[E]\t%s (%s)\n", curl_error($rsh), curl_errno($rsh));
} else {
printf("%s\n", $r);
}
curl_close($rsh);
}
javascript
addr1 = '1MN3cT9Ro927h4kgpSZ5V7SfYjrwTysXv7';
addr2 = '1BdxBor4JG76RKLAwJZfHC58fWbgidYukz';
n = 50;
tok = 'token=YOUR_TOKEN';
url = 'https://api.matbea.net/unspentConfirmed?address[]=' + addr1 + '&address[]=' + addr2 + '&confirmations=' + n + '&' + tok;
fetch(url)
.then(function (response) {
return response.json();
}).then(function (data) {
console.log(data);
});
Результат:
{
"error": {},
"result": {
"confirmations": 50,
"outputs": [
{
"address": "1MN3cT9Ro927h4kgpSZ5V7SfYjrwTysXv7",
"unspent": [
{
"amount": 5500,
"block_height": 456429,
"confirmations": 49751,
"confirmed": 1489052276,
"tx_hash": "97c078f4b762bc0027a4405fb73d6b029c2deddc80e3465e5951503536d65965",
"vout": 0
},
{
"amount": 1000,
"block_height": 492803,
"confirmations": 13377,
"confirmed": 1509630924,
"tx_hash": "e3994bf9556d70a7a402aae3ed62e6c427f2bd881a06f841f262596dc64b78cb",
"vout": 0
}
]
},
{
"address": "1BdxBor4JG76RKLAwJZfHC58fWbgidYukz",
"unspent": [
{
"amount": 5500,
"block_height": 450229,
"confirmations": 55951,
"confirmed": 1485507176,
"tx_hash": "d637117f6ccfbbc147a2bcfa0b492b273e3462d1ed8db3521a0967f0abecea27",
"vout": 0
}
]
}
]
}
}
curl
curl -g -H "Content-Type: application/json" -H "Accept: application/json" -X POST -d "{\"address\":[\"1MN3cT9Ro927h4kgpSZ5V7SfYjrwTysXv7\",\"1BdxBor4JG76RKLAwJZfHC58fWbgidYukz\"]}" "https://api.matbea.net/unspentConfirmed?confirmations=50&token=YOUR_TOKEN"
PHP
$addr1 = '1MN3cT9Ro927h4kgpSZ5V7SfYjrwTysXv7';
$addr2 = '1BdxBor4JG76RKLAwJZfHC58fWbgidYukz';
$url = 'https://api.matbea.net';
$tok = 'token=YOUR_TOKEN';
$GETparam = '/unspentConfirmed?confirmations=50&'.$tok;
$POSTparam=['address'=>[$addr1,$addr2]];
$rsh = curl_init();
if ($rsh) {
curl_setopt($rsh, CURLOPT_URL, $url . $GETparam);
curl_setopt($rsh, CURLOPT_HTTPHEADER, ['Content-Type:application/json']);
curl_setopt($rsh, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($rsh, CURLOPT_POST, 1);
curl_setopt($rsh, CURLOPT_POSTFIELDS, json_encode($POSTparam));
$r=curl_exec($rsh);
if (!$r) {
printf("[E]\t%s (%s)\n", curl_error($rsh), curl_errno($rsh));
} else {
printf("%s\n", $r);
}
curl_close($rsh);
}
javascript
addr1 = '1MN3cT9Ro927h4kgpSZ5V7SfYjrwTysXv7';
addr2 = '1BdxBor4JG76RKLAwJZfHC58fWbgidYukz';
n = 50;
tok = 'token=YOUR_TOKEN';
url = 'https://api.matbea.net/unspentConfirmed?confirmations=' + n + '&' + tok;
fetch(url, {
method: 'post',
body: JSON.stringify({address: [addr1, addr2] }) })
.then(function (response) {
return response.json();
}).then(function (data) {
console.log(data);
});
Результат:
{
"error": {},
"result": {
"confirmations": 50,
"outputs": [
{
"address": "1MN3cT9Ro927h4kgpSZ5V7SfYjrwTysXv7",
"unspent": [
{
"amount": 5500,
"block_height": 456429,
"confirmations": 49751,
"confirmed": 1489052276,
"tx_hash": "97c078f4b762bc0027a4405fb73d6b029c2deddc80e3465e5951503536d65965",
"vout": 0
},
{
"amount": 1000,
"block_height": 492803,
"confirmations": 13377,
"confirmed": 1509630924,
"tx_hash": "e3994bf9556d70a7a402aae3ed62e6c427f2bd881a06f841f262596dc64b78cb",
"vout": 0
}
]
},
{
"address": "1BdxBor4JG76RKLAwJZfHC58fWbgidYukz",
"unspent": [
{
"amount": 5500,
"block_height": 450229,
"confirmations": 55951,
"confirmed": 1485507176,
"tx_hash": "d637117f6ccfbbc147a2bcfa0b492b273e3462d1ed8db3521a0967f0abecea27",
"vout": 0
}
]
}
]
}
}
curl
curl -g -H "Content-Type: application/json" -H "Accept: application/json" -X POST -d "{\"address\":\"1MN3cT9Ro927h4kgpSZ5V7SfYjrwTysXv7\"}" "https://api.matbea.net/unspentConfirmed?token=YOUR_TOKEN"
PHP
$addr1 = '1MN3cT9Ro927h4kgpSZ5V7SfYjrwTysXv7';
$url = 'https://api.matbea.net';
$tok = 'token=YOUR_TOKEN';
$GETparam = '/unspentConfirmed?'.$tok;
$POSTparam=['address'=>$addr1];
$rsh = curl_init();
if ($rsh) {
curl_setopt($rsh, CURLOPT_URL, $url . $GETparam);
curl_setopt($rsh, CURLOPT_HTTPHEADER, ['Content-Type:application/json']);
curl_setopt($rsh, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($rsh, CURLOPT_POST, 1);
curl_setopt($rsh, CURLOPT_POSTFIELDS, json_encode($POSTparam));
$r=curl_exec($rsh);
if (!$r) {
printf("[E]\t%s (%s)\n", curl_error($rsh), curl_errno($rsh));
} else {
printf("%s\n", $r);
}
curl_close($rsh);
}
javascript
addr1 = '1MN3cT9Ro927h4kgpSZ5V7SfYjrwTysXv7';
tok = 'token=YOUR_TOKEN';
url = 'https://api.matbea.net/unspentConfirmed?' + tok;
fetch(url, {
method: 'post',
body: JSON.stringify({address: addr1}) })
.then(function (response) {
return response.json();
}).then(function (data) {
console.log(data);
});
Результат:
{
"error": {},
"result": {
"confirmations": 1,
"outputs": [
{
"address": "1MN3cT9Ro927h4kgpSZ5V7SfYjrwTysXv7",
"unspent": [
{
"amount": 5500,
"block_height": 456429,
"confirmations": 49751,
"confirmed": 1489052276,
"tx_hash": "97c078f4b762bc0027a4405fb73d6b029c2deddc80e3465e5951503536d65965",
"vout": 0
},
{
"amount": 1000,
"block_height": 492803,
"confirmations": 13377,
"confirmed": 1509630924,
"tx_hash": "e3994bf9556d70a7a402aae3ed62e6c427f2bd881a06f841f262596dc64b78cb",
"vout": 0
}
]
}
]
}
}
Наверх
Возвращает информацию о неподтвержденном балансе указанного адреса/адресов.
Вызов метода:Параметры запроса:https://api.matbea.net/unspentUnconfirmed?address[]=ADDRESS
Значение | Тип | Назначение | Метод передачи |
---|---|---|---|
ADDRESS | string | Адрес/адреса о которых запрашивается информация. Параметр перадается в массиве | URI, POST |
Результат запроса возвращается в следующем json формате:
{
"error": {},
"result": {
"outputs": [
{
"address": "1MN3cT9Ro927h4kgpSZ5V7SfYjrwTysXv7",
"unspent": []
},
{
"address": "1BdxBor4JG76RKLAwJZfHC58fWbgidYukz",
"unspent": []
}
]
}
}
Информация о неподтвержденном балансе представлена следующими полями:
Поле | Тип | Назначение |
---|---|---|
address | string | Запрошенный адрес |
unspent | array | Массив данных о неподтвержденном непотраченном балансе запрошенного адреса |
Если на указанном адресе есть неподтвержденные непотраченные срества, то результат запроса возвращается в
следующем json формате:
{
"error": {},
"result": {
"outputs": [
{
"address": "1GNSokHELdoxaXfUfhQqkqz3j9NkxtMcYB",
"unspent": [
{
"amount": 263077,
"double_spend": true,
"time": 1513515545,
"tx_hash": "638f27cf5874de68a062c81793bb004aa66550e0015ab819ae8530f99af95d46",
"vout": 0
}
]
}
]
}
}
Массив unspent представлен следующими полями:
Поле | Тип | Назначение |
---|---|---|
amount | integer | Объем средств |
double_spend | boolean | Флаг двойной траты средств |
time | integer | Время транзакции |
tx_hash | string | Хеш входной транзакции |
vout | integer | Номер выхода |
Если в запросе передан неверный адрес или адрес который не использовался в транзакциях, то содержимое массива outputs будет пустым:
{
"error": {},
"result": {
"outputs": []
}
}
Примеры:
curl
curl -g -H "Content-Type: application/json" -H "Accept: application/json" "https://api.matbea.net/unspentUnconfirmed?address[]=1MN3cT9Ro927h4kgpSZ5V7SfYjrwTysXv7&address[]=1BdxBor4JG76RKLAwJZfHC58fWbgidYukz&token=YOUR_TOKEN"
PHP
$addr1 = '1MN3cT9Ro927h4kgpSZ5V7SfYjrwTysXv7';
$addr2 = '1BdxBor4JG76RKLAwJZfHC58fWbgidYukz';
$url = 'https://api.matbea.net';
$tok = 'token=YOUR_TOKEN';
$GETparam = '/unspentUnconfirmed?address[]='.$addr1.'&address[]='.$addr2.'&'.$tok;
$POSTparam=[];
$rsh = curl_init();
if ($rsh) {
curl_setopt($rsh, CURLOPT_URL, $url . $GETparam);
curl_setopt($rsh, CURLOPT_HTTPHEADER, ['Content-Type:application/json']);
curl_setopt($rsh, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($rsh, CURLOPT_POST, 0);
$r=curl_exec($rsh);
if (!$r) {
printf("[E]\t%s (%s)\n", curl_error($rsh), curl_errno($rsh));
} else {
printf("%s\n", $r);
}
curl_close($rsh);
}
javascript
addr1 = '1MN3cT9Ro927h4kgpSZ5V7SfYjrwTysXv7';
addr2 = '1BdxBor4JG76RKLAwJZfHC58fWbgidYukz';
tok = 'token=YOUR_TOKEN';
url = 'https://api.matbea.net/unspentUnconfirmed?address[]=' + addr1 + '&address[]=' + addr2 + '&' + tok;
fetch(url)
.then(function (response) {
return response.json();
}).then(function (data) {
console.log(data);
});
Результат:
{
"error": {},
"result": {
"outputs": [
{
"address": "1MN3cT9Ro927h4kgpSZ5V7SfYjrwTysXv7",
"unspent": []
},
{
"address": "1BdxBor4JG76RKLAwJZfHC58fWbgidYukz",
"unspent": []
}
]
}
}
curl
curl -g -H "Content-Type: application/json" -H "Accept: application/json" -X POST -d "{\"address\":[\"1MN3cT9Ro927h4kgpSZ5V7SfYjrwTysXv7\",\"1BdxBor4JG76RKLAwJZfHC58fWbgidYukz\"]}" "https://api.matbea.net/unspentUnconfirmed?token=YOUR_TOKEN"
PHP
$addr1 = '1MN3cT9Ro927h4kgpSZ5V7SfYjrwTysXv7';
$addr2 = '1BdxBor4JG76RKLAwJZfHC58fWbgidYukz';
$url = 'https://api.matbea.net';
$tok = 'token=YOUR_TOKEN';
$GETparam = '/unspentUnconfirmed?'.$tok;
$POSTparam=['address'=>[$addr1,$addr2]];
$rsh = curl_init();
if ($rsh) {
curl_setopt($rsh, CURLOPT_URL, $url . $GETparam);
curl_setopt($rsh, CURLOPT_HTTPHEADER, ['Content-Type:application/json']);
curl_setopt($rsh, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($rsh, CURLOPT_POST, 1);
curl_setopt($rsh, CURLOPT_POSTFIELDS, json_encode($POSTparam));
$r=curl_exec($rsh);
if (!$r) {
printf("[E]\t%s (%s)\n", curl_error($rsh), curl_errno($rsh));
} else {
printf("%s\n", $r);
}
curl_close($rsh);
}
javascript
addr1 = '1MN3cT9Ro927h4kgpSZ5V7SfYjrwTysXv7';
addr2 = '1BdxBor4JG76RKLAwJZfHC58fWbgidYukz';
tok = 'token=YOUR_TOKEN';
url = 'https://api.matbea.net/unspentUnconfirmed?' + tok;
fetch(url, {
method: 'post',
body: JSON.stringify({address: [addr1, addr2] }) })
.then(function (response) {
return response.json();
}).then(function (data) {
console.log(data);
});
Результат:
{
"error": {},
"result": {
"outputs": [
{
"address": "1MN3cT9Ro927h4kgpSZ5V7SfYjrwTysXv7",
"unspent": []
},
{
"address": "1BdxBor4JG76RKLAwJZfHC58fWbgidYukz",
"unspent": []
}
]
}
}
curl
curl -g -H "Content-Type: application/json" -H "Accept: application/json" -X POST -d "{\"address\":\"1MN3cT9Ro927h4kgpSZ5V7SfYjrwTysXv7\"}" "https://api.matbea.net/unspentUnconfirmed?token=YOUR_TOKEN"
PHP
$addr1 = '1MN3cT9Ro927h4kgpSZ5V7SfYjrwTysXv7';
$url = 'https://api.matbea.net';
$tok = 'token=YOUR_TOKEN';
$GETparam = '/unspentUnconfirmed?'.$tok;
$POSTparam=['address'=>$addr1];
$rsh = curl_init();
if ($rsh) {
curl_setopt($rsh, CURLOPT_URL, $url . $GETparam);
curl_setopt($rsh, CURLOPT_HTTPHEADER, ['Content-Type:application/json']);
curl_setopt($rsh, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($rsh, CURLOPT_POST, 1);
curl_setopt($rsh, CURLOPT_POSTFIELDS, json_encode($POSTparam));
$r=curl_exec($rsh);
if (!$r) {
printf("[E]\t%s (%s)\n", curl_error($rsh), curl_errno($rsh));
} else {
printf("%s\n", $r);
}
curl_close($rsh);
}
javascript
addr1 = '1MN3cT9Ro927h4kgpSZ5V7SfYjrwTysXv7';
tok = 'token=YOUR_TOKEN';
url = 'https://api.matbea.net/unspentUnconfirmed?' + tok;
fetch(url, {
method: 'post',
body: JSON.stringify({address: addr1 }) })
.then(function (response) {
return response.json();
}).then(function (data) {
console.log(data);
});
Результат:
{
"error": {},
"result": {
"outputs": [
{
"address": "1MN3cT9Ro927h4kgpSZ5V7SfYjrwTysXv7",
"unspent": []
}
]
}
}
Наверх
Возвращает информацию о транзакциях по заданному адресу ADDRESSHASH.
Вызов метода:Параметры запроса:https://api.matbea.net/address/ADDRESSHASH/transactions?holder_data=HOLDERDATA&limit=LIMIT&starttxid=STARTTXID&type=TYPE
Значение | Тип | Назначение | Метод передачи |
---|---|---|---|
ADDRESSHASH | string | Адрес для которого необходимо получить информацию о проведенных транзакциях | URI |
HOLDERDATA | integer | Флаг вывода информации о владельце адреса. Принимаемые значения 1 или 0. Значение по умолчанию 0 | URI |
LIMIT | integer | Максимальное число транзакций выводимых в результате. Значение по умолчанию 10 | URI |
STARTTXID | string | Хеш транзакции, после которой начинается вывод результатов. Параметр опциональный | URI |
TYPE | string | Тип выводимых транзакций. Значение по умолчанию all | URI |
all - транзакции, в которых на заданном адресе были поступления или траты средств | URI | ||
in - транзакции, в которых на заданный адрес поступили средства | URI | ||
out - транзакции, в которых с заданного адреса были потрачены средства | URI |
Результат запроса возвращается в следующем json формате:
{
"error": {},
"result": {
"address": "12S42ZEw2741DHrivgZHLfX8M58mxb7bFy",
"holder": {
"holder_address_count": 1,
"holder_name": "MyNameIs12S4",
"holder_rootaddress": "12S42ZEw2741DHrivgZHLfX8M58mxb7bFy"
},
"per_page": 2,
"total": 10,
"transactions": [
{
"block_hash": "0000000000000000005dbb38b1f39af707bb28425c2db6d1a11c7ceab80ee5b9",
"block_height": 504885,
"block_time": 1516307736,
"coinbase": false,
"confirmations": 3954,
"double_spend": false,
"hash": "5c838a768bc339f12fe59786850f87410281559f6209512756df04b776f1d814",
"lock_time": 0,
"num_in_block": 831,
"size": 191,
"time": 1516300600,
"txin": [
{
"addresses": [
"12S42ZEw2741DHrivgZHLfX8M58mxb7bFy"
],
"holder_address_count": 1,
"holder_name": "MyNameIs12S4",
"holder_rootaddress": "12S42ZEw2741DHrivgZHLfX8M58mxb7bFy",
"n": 0,
"output_block_height": 504885,
"output_txid": "cbf1bba98082f23889f79364ae146b6cbbfb1767a20c0e2bc210fee43561ee1d",
"script_type": "pubkeyhash",
"value": 1000000,
"vout": 1
}
],
"txout": [
{
"addresses": [
"19EZqpVaxH342So7iVmcrR6BNxayY6jMxD"
],
"holder_address_count": 110616,
"holder_name": "",
"holder_rootaddress": "13CNH2fnCDNXSJgNLqScqn1ZA1BBxdwyAC",
"input_n": 42,
"input_tx_block_height": 505424,
"input_txid": "90e98fb67e730748bd16f862b3a17b7c2fca86354c5421652b89f36300ff1c36",
"script_type": "pubkeyhash",
"value": 968715,
"vout": 0
}
]
}
],
"type": "all"
}
}
Результат запроса представлен следующими полями:
Поле | Тип | Назначение |
---|---|---|
address | string | Адрес |
holder | array | Информация о владельце адреса |
starttxid | string | Хеш транзакции после которой начинается вывод |
per_page | integer | Число транзакций на стрнице |
total | integer | Всего транзакций |
transactions | array | Информация транзакциях |
type | string | Тип выводимых транзакций |
Поле | Тип | Назначение | ||||||
---|---|---|---|---|---|---|---|---|
block_hash | string | Хеш блока | ||||||
block_height | integer | Высота блока | ||||||
block_time | integer | Время создания блока | ||||||
coinbase | boolean | Признак coinbase-транзакции | ||||||
confirmations | integer | Число подтверждений транзакции | ||||||
double_spend | boolean | Признак двойной траты средств | ||||||
hash | string | Хеш транзакции | ||||||
lock_time | integer | Высота блока или время в которое транзакция будет разблокирована.
|
||||||
num_in_block | integer | Номер транзакции в блоке | ||||||
size | integer | Размер блока | ||||||
time | integer | Время создания транзакции | ||||||
txin | array | Массив данных о входах | ||||||
txout | array | Массив данных о выходах |
Поле | Тип | Назначение |
---|---|---|
addresses | array | Массив адресов. Тип элементов массива - string |
holder_name | string | Имя владельца адреса/адресов, используемых в данном входе |
holder_address_count | integer | Число адресов у данного владельца |
holder_rootaddress | string | Основной адрес владельца |
n | integer | Номер входа транзакции |
output_block_height | integer | Высота блока транзакции |
output_txid | string | Хеш транзакции, в которой создан потраченный выход |
script_type | string | Тип подписи |
value | integer | Объем средств на данном входе |
vout | integer | Номер выхода, в котором потрачены средства |
Поле | Тип | Назначение |
---|---|---|
addresses | array | Массив адресов, на которые перечислены средства |
holder_name | string | Имя владельца адреса/адресов, используемых в данном выходе |
holder_address_count | integer | Число адресов у данного владельца |
holder_rootaddress | string | Основной адрес владельца |
input_n | integer | Номер входа транзакции, в которой потрачен текущий output |
input_tx_block_height | integer | Высота блока транзакции, в которой потрачен текущий output |
input_txid | string | Хеш транзакции, в которой потрачен текущий output |
script_type | string | Тип подписи |
value | integer | Объем средств на выходе |
vout | integer | Номер выхода |
Поле | Тип | Назначение |
---|---|---|
holder_address_count | integer | Число адрессов принадлежащих владельцу запрошенного адреса |
holder_name | string | Имя владельца |
holder_rootaddress | string | Основной адрес владельца |
Если в запросе параметр holder_data отсутствует или равен 0, то массив
holder и
поля
holder_name, holder_address_count,
holder_rootaddress в результате отсутствуют.
Если в запросе передан неверный адрес или адрес который не использовался в транзакциях, то содержимое массива transactions будет пустым:
{
"error": {},
"result": {
"address": "2BdxBor4JG76RKLAwJZfHC58fWbgidYukz",
"per_page": 2,
"total": 0,
"transactions": [],
"type": "all"
}
}
Пример
curl
curl -g -H "Content-Type: application/json" -H "Accept: application/json" "https://api.matbea.net/address/12S42ZEw2741DHrivgZHLfX8M58mxb7bFy/transactions?limit=2&holder_data=1&token=YOUR_TOKEN"
PHP
$addr1='12S42ZEw2741DHrivgZHLfX8M58mxb7bFy';
$url = 'https://api.matbea.net';
$tok = 'token=YOUR_TOKEN';
$GETparam = '/address/'.$addr1.'/transactions?limit=2&holder_data=1&' . $tok;
$POSTparam=[];
$rsh = curl_init();
if ($rsh) {
curl_setopt($rsh, CURLOPT_URL, $url . $GETparam);
curl_setopt($rsh, CURLOPT_HTTPHEADER, ['Content-Type:application/json']);
curl_setopt($rsh, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($rsh, CURLOPT_POST, 0);
$r=curl_exec($rsh);
if (!$r) {
printf("[E]\t%s (%s)\n", curl_error($rsh), curl_errno($rsh));
} else {
printf("%s\n", $r);
}
curl_close($rsh);
}
javascript
addr1='12S42ZEw2741DHrivgZHLfX8M58mxb7bFy';
tok = 'token=YOUR_TOKEN';
url = 'https://api.matbea.net/address/' + addr1 + '/transactions?limit=2&holder_data=1&' + tok;
fetch(url)
.then((response) => {
return response.json();
}).then((data) => {
console.log(data);
});
Результат:
{
"error": {},
"result": {
"address": "12S42ZEw2741DHrivgZHLfX8M58mxb7bFy",
"holder": {
"holder_address_count": 1,
"holder_name": "MyNameIs12S4",
"holder_rootaddress": "12S42ZEw2741DHrivgZHLfX8M58mxb7bFy"
},
"per_page": 2,
"total": 10,
"transactions": [
{
"block_hash": "0000000000000000005dbb38b1f39af707bb28425c2db6d1a11c7ceab80ee5b9",
"block_height": 504885,
"block_time": 1516307736,
"coinbase": false,
"confirmations": 3954,
"double_spend": false,
"hash": "5c838a768bc339f12fe59786850f87410281559f6209512756df04b776f1d814",
"lock_time": 0,
"num_in_block": 831,
"size": 191,
"time": 1516300600,
"txin": [
{
"addresses": [
"12S42ZEw2741DHrivgZHLfX8M58mxb7bFy"
],
"holder_address_count": 1,
"holder_name": "MyNameIs12S4",
"holder_rootaddress": "12S42ZEw2741DHrivgZHLfX8M58mxb7bFy",
"n": 0,
"output_block_height": 504885,
"output_txid": "cbf1bba98082f23889f79364ae146b6cbbfb1767a20c0e2bc210fee43561ee1d",
"script_type": "pubkeyhash",
"value": 1000000,
"vout": 1
}
],
"txout": [
{
"addresses": [
"19EZqpVaxH342So7iVmcrR6BNxayY6jMxD"
],
"holder_address_count": 110616,
"holder_name": "",
"holder_rootaddress": "13CNH2fnCDNXSJgNLqScqn1ZA1BBxdwyAC",
"input_n": 42,
"input_tx_block_height": 505424,
"input_txid": "90e98fb67e730748bd16f862b3a17b7c2fca86354c5421652b89f36300ff1c36",
"script_type": "pubkeyhash",
"value": 968715,
"vout": 0
}
]
},
{
"block_hash": "0000000000000000007ed574c66a420d7e8d504f28a6492523bff8c0ea7a6f68",
"block_height": 497334,
"block_time": 1512291088,
"coinbase": false,
"confirmations": 11505,
"double_spend": false,
"hash": "7722cee32dde81a29d4940d28b178b0914e7e8ac5ee52547538e954f4f5ee71a",
"lock_time": 0,
"num_in_block": 340,
"size": 192,
"time": 1512290943,
"txin": [
{
"addresses": [
"1FGaCR3k9B8ZifGc8FWcYY5yS7FXZgbMFF"
],
"holder_address_count": 1,
"holder_name": "",
"holder_rootaddress": "1FGaCR3k9B8ZifGc8FWcYY5yS7FXZgbMFF",
"n": 0,
"output_block_height": 497334,
"output_txid": "5ce44e0c7083277402f81ef7192c80a09186bd3416e76c6631c9ad60e06a6778",
"script_type": "pubkeyhash",
"value": 25476,
"vout": 1
}
],
"txout": [
{
"addresses": [
"12S42ZEw2741DHrivgZHLfX8M58mxb7bFy"
],
"holder_address_count": 1,
"holder_name": "MyNameIs12S4",
"holder_rootaddress": "12S42ZEw2741DHrivgZHLfX8M58mxb7bFy",
"input_n": null,
"input_tx_block_height": null,
"input_txid": null,
"script_type": "pubkeyhash",
"value": 5500,
"vout": 0
}
]
}
],
"type": "all"
}
}
curl
curl -g -H "Content-Type: application/json" -H "Accept: application/json" "https://api.matbea.net/address/12S42ZEw2741DHrivgZHLfX8M58mxb7bFy/transactions?limit=2&holder_data=1&type=in&token=YOUR_TOKEN"
PHP
$addr1='12S42ZEw2741DHrivgZHLfX8M58mxb7bFy';
$url = 'https://api.matbea.net';
$tok = 'token=YOUR_TOKEN';
$GETparam = '/address/'.$addr1.'/transactions?limit=2&holder_data=1&type=in&'. $tok;
$POSTparam=[];
$rsh = curl_init();
if ($rsh) {
curl_setopt($rsh, CURLOPT_URL, $url . $GETparam);
curl_setopt($rsh, CURLOPT_HTTPHEADER, ['Content-Type:application/json']);
curl_setopt($rsh, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($rsh, CURLOPT_POST, 0);
$r=curl_exec($rsh);
if (!$r) {
printf("[E]\t%s (%s)\n", curl_error($rsh), curl_errno($rsh));
} else {
printf("%s\n", $r);
}
curl_close($rsh);
}
javascript
addr1='12S42ZEw2741DHrivgZHLfX8M58mxb7bFy';
tok = 'token=YOUR_TOKEN';
url = 'https://api.matbea.net/address/' + addr1 + '/transactions?limit=2&holder_data=1&type=in&' + tok;
fetch(url)
.then((response) => {
return response.json();
}).then((data) => {
console.log(data);
});
Результат:
{
"error": {},
"result": {
"address": "12S42ZEw2741DHrivgZHLfX8M58mxb7bFy",
"holder": {
"holder_address_count": 1,
"holder_name": "MyNameIs12S4",
"holder_rootaddress": "12S42ZEw2741DHrivgZHLfX8M58mxb7bFy"
},
"per_page": 2,
"total": 10,
"transactions": [
{
"block_hash": "0000000000000000007ed574c66a420d7e8d504f28a6492523bff8c0ea7a6f68",
"block_height": 497334,
"block_time": 1512291088,
"coinbase": false,
"confirmations": 11505,
"double_spend": false,
"hash": "7722cee32dde81a29d4940d28b178b0914e7e8ac5ee52547538e954f4f5ee71a",
"lock_time": 0,
"num_in_block": 340,
"size": 192,
"time": 1512290943,
"txin": [
{
"addresses": [
"1FGaCR3k9B8ZifGc8FWcYY5yS7FXZgbMFF"
],
"holder_address_count": 1,
"holder_name": "",
"holder_rootaddress": "1FGaCR3k9B8ZifGc8FWcYY5yS7FXZgbMFF",
"n": 0,
"output_block_height": 497334,
"output_txid": "5ce44e0c7083277402f81ef7192c80a09186bd3416e76c6631c9ad60e06a6778",
"script_type": "pubkeyhash",
"value": 25476,
"vout": 1
}
],
"txout": [
{
"addresses": [
"12S42ZEw2741DHrivgZHLfX8M58mxb7bFy"
],
"holder_address_count": 1,
"holder_name": "MyNameIs12S4",
"holder_rootaddress": "12S42ZEw2741DHrivgZHLfX8M58mxb7bFy",
"input_n": null,
"input_tx_block_height": null,
"input_txid": null,
"script_type": "pubkeyhash",
"value": 5500,
"vout": 0
}
]
},
{
"block_hash": "0000000000000000007c225ae8af1286e6fe2bb448c7202e0af0ddd974f1a62f",
"block_height": 493899,
"block_time": 1510311879,
"coinbase": false,
"confirmations": 14940,
"double_spend": false,
"hash": "cbf1bba98082f23889f79364ae146b6cbbfb1767a20c0e2bc210fee43561ee1d",
"lock_time": 0,
"num_in_block": 127,
"size": 223,
"time": 1510311484,
"txin": [
{
"addresses": [
"12S42ZEw2741DHrivgZHLfX8M58mxb7bFy"
],
"holder_address_count": 1,
"holder_name": "MyNameIs12S4",
"holder_rootaddress": "12S42ZEw2741DHrivgZHLfX8M58mxb7bFy",
"n": 0,
"output_block_height": 493899,
"output_txid": "d1789305f1ae4a39c045e0c67a024048cda0990297dc863e4caac546c6c32b86",
"script_type": "pubkeyhash",
"value": 1102678,
"vout": 1
}
],
"txout": [
{
"addresses": [
"3P6sVMdtiqSwPuruSMguJQmmvFba3groVh"
],
"holder_address_count": null,
"holder_name": "",
"holder_rootaddress": null,
"input_n": null,
"input_tx_block_height": null,
"input_txid": null,
"script_type": "scripthash",
"value": 5500,
"vout": 0
},
{
"addresses": [
"12S42ZEw2741DHrivgZHLfX8M58mxb7bFy"
],
"holder_address_count": 1,
"holder_name": "MyNameIs12S4",
"holder_rootaddress": "12S42ZEw2741DHrivgZHLfX8M58mxb7bFy",
"input_n": 0,
"input_tx_block_height": 504885,
"input_txid": "5c838a768bc339f12fe59786850f87410281559f6209512756df04b776f1d814",
"script_type": "pubkeyhash",
"value": 1000000,
"vout": 1
}
]
}
],
"type": "in"
}
}
curl
curl -g -H "Content-Type: application/json" -H "Accept: application/json" "https://api.matbea.net/address/12S42ZEw2741DHrivgZHLfX8M58mxb7bFy/transactions?limit=2&holder_data=1&starttxid=d8bebbfaac4b21778a21834b7263bb247216b3f60c5f2dbee9c4fb95a70b8962&token=YOUR_TOKEN"
PHP
$addr1='12S42ZEw2741DHrivgZHLfX8M58mxb7bFy';
$hash1 = 'd8bebbfaac4b21778a21834b7263bb247216b3f60c5f2dbee9c4fb95a70b8962'; // return trans: all=11, in=9, out=3,
$url = 'https://api.matbea.net';
$tok = 'token=YOUR_TOKEN';
$GETparam = '/address/'.$addr1.'/transactions?limit=2&holder_data=1&starttxid=' . $hash1 . '&'. $tok;
$POSTparam=[];
$rsh = curl_init();
if ($rsh) {
curl_setopt($rsh, CURLOPT_URL, $url . $GETparam);
curl_setopt($rsh, CURLOPT_HTTPHEADER, ['Content-Type:application/json']);
curl_setopt($rsh, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($rsh, CURLOPT_POST, 0);
$r=curl_exec($rsh);
if (!$r) {
printf("[E]\t%s (%s)\n", curl_error($rsh), curl_errno($rsh));
} else {
printf("%s\n", $r);
}
curl_close($rsh);
}
javascript
addr1='12S42ZEw2741DHrivgZHLfX8M58mxb7bFy';
hash1 = 'd8bebbfaac4b21778a21834b7263bb247216b3f60c5f2dbee9c4fb95a70b8962';
tok = 'token=YOUR_TOKEN';
url = 'https://api.matbea.net/address/' + addr1 + '/transactions?limit=2&holder_data=1&starttxid=' + hash1 + '&' + tok;
fetch(url)
.then((response) => {
return response.json();
}).then((data) => {
console.log(data);
});
Результат:
{
"error": {},
"result": {
"address": "12S42ZEw2741DHrivgZHLfX8M58mxb7bFy",
"holder": {
"holder_address_count": 1,
"holder_name": "MyNameIs12S4",
"holder_rootaddress": "12S42ZEw2741DHrivgZHLfX8M58mxb7bFy"
},
"per_page": 2,
"starttxid": "d8bebbfaac4b21778a21834b7263bb247216b3f60c5f2dbee9c4fb95a70b8962",
"total": 10,
"transactions": [
{
"block_hash": "0000000000000000005e223fa18463ef66e0b8b1f6f7d7c141abecb9c06f6d9a",
"block_height": 454156,
"block_time": 1487752366,
"coinbase": false,
"confirmations": 54683,
"double_spend": false,
"hash": "9841765cfd07e6a1439ce24fca88f1d83da1e30e66fca96e93cfa45f4cb1a8d6",
"lock_time": 454155,
"num_in_block": 178,
"size": 225,
"time": 1487752366,
"txin": [
{
"addresses": [
"1q3Urbm5Y2eud3ZZd7uX28E12n2ehLWRm"
],
"holder_address_count": 1,
"holder_name": "",
"holder_rootaddress": "1q3Urbm5Y2eud3ZZd7uX28E12n2ehLWRm",
"n": 0,
"output_block_height": 454156,
"output_txid": "4761efd5c7153bf1114c9e08d2e20c3b307b32e51dd9e3f333055fc536bb3c8e",
"script_type": "pubkeyhash",
"value": 6026728,
"vout": 0
}
],
"txout": [
{
"addresses": [
"12S42ZEw2741DHrivgZHLfX8M58mxb7bFy"
],
"holder_address_count": 1,
"holder_name": "MyNameIs12S4",
"holder_rootaddress": "12S42ZEw2741DHrivgZHLfX8M58mxb7bFy",
"input_n": 0,
"input_tx_block_height": 455165,
"input_txid": "d8bebbfaac4b21778a21834b7263bb247216b3f60c5f2dbee9c4fb95a70b8962",
"script_type": "pubkeyhash",
"value": 1436521,
"vout": 0
},
{
"addresses": [
"14kC8dAxrsHg2bedV1wJExy8RpsDTNofpA"
],
"holder_address_count": 1,
"holder_name": "",
"holder_rootaddress": "14kC8dAxrsHg2bedV1wJExy8RpsDTNofpA",
"input_n": 0,
"input_tx_block_height": 454156,
"input_txid": "9f24c501ceda43fb8e7d542ae905c09c79c05ee3849d10a903357efa69871689",
"script_type": "pubkeyhash",
"value": 4535332,
"vout": 1
}
]
}
],
"type": "all"
}
}
curl
curl -g -H "Content-Type: application/json" -H "Accept: application/json" "https://136.243.32.19/address/12S42ZEw2741DHrivgZHLfX8M58mxb7bFy/transactions?limit=2&holder_data=1&type=in&starttxid=7722cee32dde81a29d4940d28b178b0914e7e8ac5ee52547538e954f4f5ee71a&token=matbea"
PHP
$addr1='12S42ZEw2741DHrivgZHLfX8M58mxb7bFy';
$hash1 = '7722cee32dde81a29d4940d28b178b0914e7e8ac5ee52547538e954f4f5ee71a'; // return trans: all=11, in=9, out=3,
$url = 'https://api.matbea.net';
$tok = 'token=YOUR_TOKEN';
$GETparam = '/address/'.$addr1.'/transactions?limit=2&holder_data=1&type=in&starttxid=' . $hash1 . '&'. $tok;
$POSTparam=[];
$rsh = curl_init();
if ($rsh) {
curl_setopt($rsh, CURLOPT_URL, $url . $GETparam);
curl_setopt($rsh, CURLOPT_HTTPHEADER, ['Content-Type:application/json']);
curl_setopt($rsh, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($rsh, CURLOPT_POST, 0);
$r=curl_exec($rsh);
if (!$r) {
printf("[E]\t%s (%s)\n", curl_error($rsh), curl_errno($rsh));
} else {
printf("%s\n", $r);
}
curl_close($rsh);
}
javascript
addr1='12S42ZEw2741DHrivgZHLfX8M58mxb7bFy';
hash1 = '7722cee32dde81a29d4940d28b178b0914e7e8ac5ee52547538e954f4f5ee71a';
tok = 'token=YOUR_TOKEN';
url = 'https://api.matbea.net/address/' + addr1 + '/transactions?limit=2&holder_data=1&type=in&starttxid=' + hash1 + '&' + tok;
fetch(url)
.then((response) => {
return response.json();
}).then((data) => {
console.log(data);
});
Результат:
{
"error": {},
"result": {
"address": "12S42ZEw2741DHrivgZHLfX8M58mxb7bFy",
"holder": {
"holder_address_count": 1,
"holder_name": "MyNameIs12S4",
"holder_rootaddress": "12S42ZEw2741DHrivgZHLfX8M58mxb7bFy"
},
"per_page": 2,
"starttxid": "7722cee32dde81a29d4940d28b178b0914e7e8ac5ee52547538e954f4f5ee71a",
"total": 10,
"transactions": [
{
"block_hash": "0000000000000000007c225ae8af1286e6fe2bb448c7202e0af0ddd974f1a62f",
"block_height": 493899,
"block_time": 1510311879,
"coinbase": false,
"confirmations": 14943,
"double_spend": false,
"hash": "cbf1bba98082f23889f79364ae146b6cbbfb1767a20c0e2bc210fee43561ee1d",
"lock_time": 0,
"num_in_block": 127,
"size": 223,
"time": 1510311484,
"txin": [
{
"addresses": [
"12S42ZEw2741DHrivgZHLfX8M58mxb7bFy"
],
"holder_address_count": 1,
"holder_name": "MyNameIs12S4",
"holder_rootaddress": "12S42ZEw2741DHrivgZHLfX8M58mxb7bFy",
"n": 0,
"output_block_height": 493899,
"output_txid": "d1789305f1ae4a39c045e0c67a024048cda0990297dc863e4caac546c6c32b86",
"script_type": "pubkeyhash",
"value": 1102678,
"vout": 1
}
],
"txout": [
{
"addresses": [
"3P6sVMdtiqSwPuruSMguJQmmvFba3groVh"
],
"holder_address_count": null,
"holder_name": "",
"holder_rootaddress": null,
"input_n": null,
"input_tx_block_height": null,
"input_txid": null,
"script_type": "scripthash",
"value": 5500,
"vout": 0
},
{
"addresses": [
"12S42ZEw2741DHrivgZHLfX8M58mxb7bFy"
],
"holder_address_count": 1,
"holder_name": "MyNameIs12S4",
"holder_rootaddress": "12S42ZEw2741DHrivgZHLfX8M58mxb7bFy",
"input_n": 0,
"input_tx_block_height": 504885,
"input_txid": "5c838a768bc339f12fe59786850f87410281559f6209512756df04b776f1d814",
"script_type": "pubkeyhash",
"value": 1000000,
"vout": 1
}
]
},
{
"block_hash": "00000000000000000060db556b634305ee64e542810a5ac1f2d174294a738ca3",
"block_height": 493897,
"block_time": 1510310573,
"coinbase": false,
"confirmations": 14945,
"double_spend": false,
"hash": "d1789305f1ae4a39c045e0c67a024048cda0990297dc863e4caac546c6c32b86",
"lock_time": 0,
"num_in_block": 355,
"size": 223,
"time": 1510309760,
"txin": [
{
"addresses": [
"12S42ZEw2741DHrivgZHLfX8M58mxb7bFy"
],
"holder_address_count": 1,
"holder_name": "MyNameIs12S4",
"holder_rootaddress": "12S42ZEw2741DHrivgZHLfX8M58mxb7bFy",
"n": 0,
"output_block_height": 493897,
"output_txid": "4989efcec28faedc86ee309a0cb1ba1319987d5c214fcb39d709538576e79342",
"script_type": "pubkeyhash",
"value": 1179178,
"vout": 1
}
],
"txout": [
{
"addresses": [
"3Jc4v7eo9rptPj4277c9cCjgJmWSQmBiwj"
],
"holder_address_count": null,
"holder_name": "",
"holder_rootaddress": null,
"input_n": null,
"input_tx_block_height": null,
"input_txid": null,
"script_type": "scripthash",
"value": 5500,
"vout": 0
},
{
"addresses": [
"12S42ZEw2741DHrivgZHLfX8M58mxb7bFy"
],
"holder_address_count": 1,
"holder_name": "MyNameIs12S4",
"holder_rootaddress": "12S42ZEw2741DHrivgZHLfX8M58mxb7bFy",
"input_n": 0,
"input_tx_block_height": 493899,
"input_txid": "cbf1bba98082f23889f79364ae146b6cbbfb1767a20c0e2bc210fee43561ee1d",
"script_type": "pubkeyhash",
"value": 1102678,
"vout": 1
}
]
}
],
"type": "in"
}
}
Наверх
Возвращает информацию о владельце адреса.
Вызов метода:Параметры запроса:https://api.matbea.net/getholder/ADDRESS?address_data=ADRESS_DATA
Значение | Тип | Назначение | Метод передачи |
---|---|---|---|
ADDRESS | string | Адрес задается в url строке | URI |
ADRESS_DATA | integer | Флаг вывода информации о других адресах владельца. Принимаемые значения 1 или 0 | URI |
Результат запроса возвращается в следующем json формате:
{
"error": {},
"result": {
"holder_address_count": 1,
"addresses": [
"12S42ZEw2741DHrivgZHLfX8M58mxb7bFy"
],
"download_type": "direct",
"holder_name": "MyNameIs12S4",
"holder_rootaddress": "12S42ZEw2741DHrivgZHLfX8M58mxb7bFy"
}
}
Информация представлена следующими полями:
Поле | Тип | Назначение |
---|---|---|
holder_address_count | integer | Число адресов |
addresses | array | Массив адресов |
download_type | string | Способ получения адресов. Зависит от количества адресов в поле addresses |
Более или равно 10000000 "by_support_email". Получение по запросу | ||
Более 200, но меньше 10000000 "by_link". Адреса можно скачать по ссылке | ||
Меньше или равно 200 "direct". Адреса представлены в текущем ответе | ||
holder_name | string | Имя владельца |
holder_rootaddress | string | Основной адрес владельца |
Если параметр address_data не задан или равен 0, то результат возвращается в следующем json
формате:
{
"error": {},
"result": {
"holder_address_count": 1,
"holder_name": "MyNameIs12S4",
"holder_rootaddress": "12S42ZEw2741DHrivgZHLfX8M58mxb7bFy"
}
}
Если информация о владельце адреса отсутствует, то возвращается следующий результат:
{
"error": {
"code": 2,
"message": "No such holder"
},
"result": {}
}
Пример:
curl
curl -g -H "Content-Type: application/json" -H "Accept: application/json" "https://api.matbea.net/getholder/12S42ZEw2741DHrivgZHLfX8M58mxb7bFy?address_data=1&token=YOUR_TOKEN"
PHP
$addr1 = '12S42ZEw2741DHrivgZHLfX8M58mxb7bFy';
$url = 'https://api.matbea.net';
$tok = 'token=YOUR_TOKEN';
$GETparam = '/getholder/'.$addr1.'?address_data=1&' . $tok;
$POSTparam=[];
$rsh = curl_init();
if ($rsh) {
curl_setopt($rsh, CURLOPT_URL, $url . $GETparam);
curl_setopt($rsh, CURLOPT_HTTPHEADER, ['Content-Type:application/json']);
curl_setopt($rsh, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($rsh, CURLOPT_POST, 0);
$r=curl_exec($rsh);
if (!$r) {
printf("[E]\t%s (%s)\n", curl_error($rsh), curl_errno($rsh));
} else {
printf("%s\n", $r);
}
curl_close($rsh);
}
javascript
addr1 = '12S42ZEw2741DHrivgZHLfX8M58mxb7bFy';
tok = 'token=YOUR_TOKEN';
url = 'https://api.matbea.net//getholder/' + addr1 + '?address_data=1&' + tok;
fetch(url)
.then(function (response) {
return response.json();
}).then(function (data) {
console.log(data);
});
Результат:
{
"error": {},
"result": {
"holder_address_count": 1,
"addresses": [
"12S42ZEw2741DHrivgZHLfX8M58mxb7bFy"
],
"download_type": "direct",
"holder_name": "MyNameIs12S4",
"holder_rootaddress": "12S42ZEw2741DHrivgZHLfX8M58mxb7bFy"
}
}
curl
curl -g -H "Content-Type: application/json" -H "Accept: application/json" "https://api.matbea.net/getholder/12S42ZEw2741DHrivgZHLfX8M58mxb7bFy?token=YOUR_TOKEN"
PHP
$addr1 = '12S42ZEw2741DHrivgZHLfX8M58mxb7bFy';
$url = 'https://api.matbea.net';
$tok = 'token=YOUR_TOKEN';
$GETparam = '/getholder/'.$addr1.'?' . $tok;
$POSTparam=[];
$rsh = curl_init();
if ($rsh) {
curl_setopt($rsh, CURLOPT_URL, $url . $GETparam);
curl_setopt($rsh, CURLOPT_HTTPHEADER, ['Content-Type:application/json']);
curl_setopt($rsh, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($rsh, CURLOPT_POST, 0);
$r=curl_exec($rsh);
if (!$r) {
printf("[E]\t%s (%s)\n", curl_error($rsh), curl_errno($rsh));
} else {
printf("%s\n", $r);
}
curl_close($rsh);
}
javascript
addr1 = '12S42ZEw2741DHrivgZHLfX8M58mxb7bFy';
tok = 'token=YOUR_TOKEN';
url = 'https://api.matbea.net/getholder/' + addr1 + '?' + tok;
fetch(url)
.then(function (response) {
return response.json();
}).then(function (data) {
console.log(data);
});
Результат:
{
"error": {},
"result": {
"holder_address_count": 1,
"holder_name": "MyNameIs12S4",
"holder_rootaddress": "12S42ZEw2741DHrivgZHLfX8M58mxb7bFy"
}
}
Наверх
Возвращает информацию о балансе и владельцах адресов.
Вызов метода:Параметры запроса:https://api.matbea.net/getholders?address[]=ADDRESS&confirmations=CONFIRMATIONS
Значение | Тип | Назначение | Метод передачи |
---|---|---|---|
ADDRESS | string | Адрес/адреса для которых запрашивается информация. Параметр передается в массиве | URI, POST |
CONFIRMATIONS | integer | Число подтверждений баланса. Если параметр не задан, то он принимается равным 1 | URI |
Результат запроса возвращается в следующем json формате:
{
"error": {},
"result": [
{
"address_balance": 5340,
"address_hash": "111111111111111111112xT3273",
"holder_address_count": null,
"holder_name": null,
"holder_rootaddress": null
},
{
"address_balance": 5500,
"address_hash": "12S42ZEw2741DHrivgZHLfX8M58mxb7bFy",
"holder_address_count": 1,
"holder_name": "MyNameIs12S4",
"holder_rootaddress": "12S42ZEw2741DHrivgZHLfX8M58mxb7bFy"
}
]
}
Информация о балансе и владельце представлена следующими полями:
Поле | Тип | Назначение |
---|---|---|
address_balance | integer | Баланс адреса |
address_hash | string | Запрошенный адрес |
holder_address_count | integer | Число адрессов принадлежащих владельцу запрошенного адреса |
holder_name | string | Имя владельца |
holder_rootaddress | string | Основной адрес владельца |
Если информация о владельце адреса отсутствует, то holder_address_count, holder_name, holder_rootaddress равны null
Если в запросе передан неверный адрес или адрес который не использовался в транзакциях, то содержимое массива result будет пустым:
{
"error": {},
"result": []
}
Пример:
curl
curl -g -H "Content-Type: application/json" -H "Accept: application/json" "https://api.matbea.net/getholders?address[]=12S42ZEw2741DHrivgZHLfX8M58mxb7bFy&address[]=1MN3cT9Ro927h4kgpSZ5V7SfYjrwTysXv7&confirmations=10&token=YOUR_TOKEN"
PHP
$addr1 = '12S42ZEw2741DHrivgZHLfX8M58mxb7bFy';
$addr2 = '1MN3cT9Ro927h4kgpSZ5V7SfYjrwTysXv7';
$c=10;
$url = 'https://api.matbea.net';
$tok = 'token=YOUR_TOKEN';
$GETparam = '/getholders?address[]='.$addr1.'&address[]='.$addr2.'&confirmations=' . $c . '&'.$tok;
$POSTparam=[];
$rsh = curl_init();
if ($rsh) {
curl_setopt($rsh, CURLOPT_URL, $url . $GETparam);
curl_setopt($rsh, CURLOPT_HTTPHEADER, ['Content-Type:application/json']);
curl_setopt($rsh, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($rsh, CURLOPT_POST, 0);
$r=curl_exec($rsh);
if (!$r) {
printf("[E]\t%s (%s)\n", curl_error($rsh), curl_errno($rsh));
} else {
printf("%s\n", $r);
}
curl_close($rsh);
}
javascript
addr1 = '12S42ZEw2741DHrivgZHLfX8M58mxb7bFy';
addr2 = '1MN3cT9Ro927h4kgpSZ5V7SfYjrwTysXv7';
c = 10;
tok = 'token=YOUR_TOKEN';
url = 'https://api.matbea.net/getholders?address[]=' + addr1 + '&address[]=' + addr2 + '&confirmations=' + c + '&' + tok;
fetch(url)
.then(function (response) {
return response.json();
}).then(function (data) {
console.log(data);
});
Результат:
{
"error": {},
"result": [
{
"address_balance": 5500,
"address_hash": "12S42ZEw2741DHrivgZHLfX8M58mxb7bFy",
"holder_address_count": 1,
"holder_name": "MyNameIs12S4",
"holder_rootaddress": "12S42ZEw2741DHrivgZHLfX8M58mxb7bFy"
},
{
"address_balance": 6500,
"address_hash": "1MN3cT9Ro927h4kgpSZ5V7SfYjrwTysXv7",
"holder_address_count": 1,
"holder_name": "",
"holder_rootaddress": "1MN3cT9Ro927h4kgpSZ5V7SfYjrwTysXv7"
}
]
}
curl
curl -g -H "Content-Type: application/json" -H "Accept: application/json" -X POST -d "{\"address\":[\"12S42ZEw2741DHrivgZHLfX8M58mxb7bFy\",\"1MN3cT9Ro927h4kgpSZ5V7SfYjrwTysXv7\"]}" "https://api.matbea.net/getholders?confirmations=1000000&token=YOUR_TOKEN"
PHP
$addr1 = '12S42ZEw2741DHrivgZHLfX8M58mxb7bFy';
$addr2 = '1MN3cT9Ro927h4kgpSZ5V7SfYjrwTysXv7';
$c = 1000000;
$url = 'https://api.matbea.net';
$tok = 'token=YOUR_TOKEN';
$GETparam = '/getholders?confirmations=' . $c . '&'.$tok;
$POSTparam=['address'=>[$addr1,$addr2]];
$rsh = curl_init();
if ($rsh) {
curl_setopt($rsh, CURLOPT_URL, $url . $GETparam);
curl_setopt($rsh, CURLOPT_HTTPHEADER, ['Content-Type:application/json']);
curl_setopt($rsh, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($rsh, CURLOPT_POST, 1);
curl_setopt($rsh, CURLOPT_POSTFIELDS, json_encode($POSTparam));
$r=curl_exec($rsh);
if (!$r) {
printf("[E]\t%s (%s)\n", curl_error($rsh), curl_errno($rsh));
} else {
printf("%s\n", $r);
}
curl_close($rsh);
}
javascript
addr1 = '12S42ZEw2741DHrivgZHLfX8M58mxb7bFy';
addr2 = '1MN3cT9Ro927h4kgpSZ5V7SfYjrwTysXv7';
c = 1000000;
tok = 'token=YOUR_TOKEN';
url = 'https://api.matbea.net/getholders?confirmations=' + c + '&' + tok;
fetch(url, {
method: 'post',
body: JSON.stringify({address: [addr1, addr2] }) })
.then(function (response) {
return response.json();
}).then(function (data) {
console.log(data);
});
Результат:
{
"error": {},
"result": [
{
"address_balance": 0,
"address_hash": "12S42ZEw2741DHrivgZHLfX8M58mxb7bFy",
"holder_address_count": 1,
"holder_name": "MyNameIs12S4",
"holder_rootaddress": "12S42ZEw2741DHrivgZHLfX8M58mxb7bFy"
},
{
"address_balance": 0,
"address_hash": "1MN3cT9Ro927h4kgpSZ5V7SfYjrwTysXv7",
"holder_address_count": 1,
"holder_name": "",
"holder_rootaddress": "1MN3cT9Ro927h4kgpSZ5V7SfYjrwTysXv7"
}
]
}
curl
curl -g -H "Content-Type: application/json" -H "Accept: application/json" -X POST -d "{\"address\":\"12S42ZEw2741DHrivgZHLfX8M58mxb7bFy\"}" "https://api.matbea.net/getholders?token=YOUR_TOKEN"
PHP
$addr1 = '12S42ZEw2741DHrivgZHLfX8M58mxb7bFy';
$url = 'https://api.matbea.net';
$tok = 'token=YOUR_TOKEN';
$GETparam = '/getholders?'.$tok;
$POSTparam=['address'=>$addr1];
$rsh = curl_init();
if ($rsh) {
curl_setopt($rsh, CURLOPT_URL, $url . $GETparam);
curl_setopt($rsh, CURLOPT_HTTPHEADER, ['Content-Type:application/json']);
curl_setopt($rsh, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($rsh, CURLOPT_POST, 1);
curl_setopt($rsh, CURLOPT_POSTFIELDS, json_encode($POSTparam));
$r=curl_exec($rsh);
if (!$r) {
printf("[E]\t%s (%s)\n", curl_error($rsh), curl_errno($rsh));
} else {
printf("%s\n", $r);
}
curl_close($rsh);
}
javascript
addr1 = '12S42ZEw2741DHrivgZHLfX8M58mxb7bFy';
tok = 'token=YOUR_TOKEN';
url = 'https://api.matbea.net/getholders?' + tok;
fetch(url, {
method: 'post',
body: JSON.stringify({address: addr1 }) })
.then(function (response) {
return response.json();
}).then(function (data) {
console.log(data);
});
Результат:
{
"error": {},
"result": [
{
"address_balance": 5500,
"address_hash": "12S42ZEw2741DHrivgZHLfX8M58mxb7bFy",
"holder_address_count": 1,
"holder_name": "MyNameIs12S4",
"holder_rootaddress": "12S42ZEw2741DHrivgZHLfX8M58mxb7bFy"
}
]
}
Наверх
Возвращает список других адресов владельца, которому принадлежит запрошенный адрес, в формате csv.
Вызов метода:Параметры запроса:https://api.matbea.net/downloadholder/ADDRESS
Значение | Тип | Назначение | Метод передачи |
---|---|---|---|
ADDRESS | string | Адрес для которого запрашивается информация | URI |
Если в результате число адресов меньше или равно 1000000, то данные возвращаются в csv формате:
1HWG2aqZDzZtVRqmgwz6QHgkfxJZeWPo7N 1NmsU8zp3nUPXxyJhn5bBrhjb3hbdVcHSd 12QNrdmontwYN79C3eqj8ur6xuhfJVTKQC 1Py5rpPiJ95uXsooiG7AjTjh6TfbGT4WHg 1Du1MzGDiukhmnUive2cni97YcUrTy1HBb 1JSzx6zB5wynSyhkGYrRV1NRpoE27Rm5r5
Если результат содержит более 1000000 адресов возвращается ошибка:
{
"error": {
"code": 1,
"message": "Holder is too big for downloading. Contact support service, please."
},
"result": {}
}
Пример:
curl
curl -g -H "Content-Type: application/json" -H "Accept: application/json" "https://api.matbea.net/downloadholder/132aSc15WmoPwtMbqRVzouZKNnjWL1YTVb?token=YOUR_TOKEN"
PHP
$addr1 = '132aSc15WmoPwtMbqRVzouZKNnjWL1YTVb';
$url = 'https://api.matbea.net';
$tok = 'token=YOUR_TOKEN';
$GETparam = '/downloadholder/'.$addr1.'?' . $tok;
$POSTparam=[];
$rsh = curl_init();
if ($rsh) {
curl_setopt($rsh, CURLOPT_URL, $url . $GETparam);
curl_setopt($rsh, CURLOPT_HTTPHEADER, ['Content-Type:application/json']);
curl_setopt($rsh, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($rsh, CURLOPT_POST, 0);
$r=curl_exec($rsh);
if (!$r) {
printf("[E]\t%s (%s)\n", curl_error($rsh), curl_errno($rsh));
} else {
printf("%s\n", $r);
}
curl_close($rsh);
}
javascript
addr1 = '132aSc15WmoPwtMbqRVzouZKNnjWL1YTVb';
tok = 'token=YOUR_TOKEN';
url = 'https://api.matbea.net/downloadholder/' + addr1 + '?' + tok;
fetch(url)
.then((response) => {
return response.text();
}).then((data) => {
console.log(data);
});
Результат:
132aSc15WmoPwtMbqRVzouZKNnjWL1YTVb
17oofDoUGPaTi7xEP3StP1sU1YxEMDfQa6
Наверх
Возвращает информацию о рекомендуемой комисси для включения транзакции в заданый блок.
Вызов метода:Параметры запроса:https://api.matbea.net/transaction/estimatefee?blocks=BLOCKS
Значение | Тип | Назначение | Метод передачи |
---|---|---|---|
BLOCKS | integer | Номер блока в который планируется включить транзакцию. Значения от 1 до 25. Если параметр не задан, то значение принимается равным 2 |
URI |
Результат запроса возвращается в следующем json формате:
{
"error": {},
"result": {
"blocks": 1,
"estimatefee": 0.00695622
}
}
Информация о комиссии представлена следующими полями:
Поле | Тип | Назначение |
---|---|---|
blocks | integer | Высота блока |
estimatefee | double | Рекомендуемая комиссия |
Если рассчитать комиссию невозможно, то возвращается следующий результат:
{
"error": {},
"result": {
"blocks": 1000,
"estimatefee": -1
}
}
Пример:
curl
curl -g -H "Content-Type: application/json" -H "Accept: application/json" "https://api.matbea.net/transaction/estimatefee?token=YOUR_TOKEN"
PHP
$url = 'https://api.matbea.net';
$tok = 'token=YOUR_TOKEN';
$GETparam = '/transaction/estimatefee?' . $tok;
$POSTparam=[];
$rsh = curl_init();
if ($rsh) {
curl_setopt($rsh, CURLOPT_URL, $url . $GETparam);
curl_setopt($rsh, CURLOPT_HTTPHEADER, ['Content-Type:application/json']);
curl_setopt($rsh, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($rsh, CURLOPT_POST, 0);
$r=curl_exec($rsh);
if (!$r) {
printf("[E]\t%s (%s)\n", curl_error($rsh), curl_errno($rsh));
} else {
printf("%s\n", $r);
}
curl_close($rsh);
}
javascript
tok = 'token=YOUR_TOKEN';
url = 'https://api.matbea.net/transaction/estimatefee?' + tok;
fetch(url)
.then(function (response) {
return response.json();
}).then(function (data) {
console.log(data);
});
Результат:
{
"error": {},
"result": {
"blocks": 2,
"estimatefee": 0.00463748
}
}
curl
curl -g -H "Content-Type: application/json" -H "Accept: application/json" "https://api.matbea.net/transaction/estimatefee?blocks=3&token=YOUR_TOKEN"
PHP
$blocks = 3;
$url = 'https://api.matbea.net';
$tok = 'token=YOUR_TOKEN';
$GETparam = '/transaction/estimatefee?blocks=' . $blocks . '&' . $tok;
$POSTparam=[];
$rsh = curl_init();
if ($rsh) {
curl_setopt($rsh, CURLOPT_URL, $url . $GETparam);
curl_setopt($rsh, CURLOPT_HTTPHEADER, ['Content-Type:application/json']);
curl_setopt($rsh, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($rsh, CURLOPT_POST, 0);
$r=curl_exec($rsh);
if (!$r) {
printf("[E]\t%s (%s)\n", curl_error($rsh), curl_errno($rsh));
} else {
printf("%s\n", $r);
}
curl_close($rsh);
}
javascript
blocks = 3;
tok = 'token=YOUR_TOKEN';
url = 'https://api.matbea.net/transaction/estimatefee?blocks=' + blocks + '&' + tok;
fetch(url)
.then(function (response) {
return response.json();
}).then(function (data) {
console.log(data);
});
Результат:
{
"error": {},
"result": {
"blocks": 3,
"estimatefee": 0.00389181
}
}
Наверх
Возвращает информацию о транзакции в формате raw transaction.
Вызов метода:Параметры запроса:https://api.matbea.net/getrawtransaction/TXID
Значение | Тип | Назначение | Метод передачи |
---|---|---|---|
TXID | string | Идентификатор транзакции | URI |
Результат:
{
"error": null,
"id": "1",
"result": {
"blockhash": "00000000000000bde803f93f8d9832aca482cf80d1f46530d75b73f4e0b19ef2",
"blocktime": 1366601333,
"confirmations": 273834,
"hash": "000000329877c7141c6e50b04ed714a860abcb15135611f6ac92609cb392ef60",
"hex": "010000000179936f0ea31acd9801904d9da2a1061252664c877e9c19b5543e7c08682b6688010000006b4830450220395c119dfe52c38f83b9f5c28e2d6e597dc5cf244c5080ce25dfbe08560630e3022100d63bbd40ff43f0c45d2c84dc7df64ab41bd151d868e4f8c3d02259cdea6ea686012103d84c8403be88b2549a5e6d6792df08ef262f3172c62e6077c8849879d2345c6bffffffff02380b0000000000001976a91432ba382cf668657bae15ee0a97fa87f12e1bc89f88ac40420f00000000001976a91406f1b66ffe49df7fce684df16c62f59dc9adbd3f88ac00000000",
"locktime": 0,
"size": 226,
"time": 1366601333,
"txid": "000000329877c7141c6e50b04ed714a860abcb15135611f6ac92609cb392ef60",
"version": 1,
"vin": [
{
"scriptSig": {
"asm": "30450220395c119dfe52c38f83b9f5c28e2d6e597dc5cf244c5080ce25dfbe08560630e3022100d63bbd40ff43f0c45d2c84dc7df64ab41bd151d868e4f8c3d02259cdea6ea686[ALL] 03d84c8403be88b2549a5e6d6792df08ef262f3172c62e6077c8849879d2345c6b",
"hex": "4830450220395c119dfe52c38f83b9f5c28e2d6e597dc5cf244c5080ce25dfbe08560630e3022100d63bbd40ff43f0c45d2c84dc7df64ab41bd151d868e4f8c3d02259cdea6ea686012103d84c8403be88b2549a5e6d6792df08ef262f3172c62e6077c8849879d2345c6b"
},
"sequence": 4294967295,
"txid": "88662b68087c3e54b5199c7e874c66521206a1a29d4d900198cd1aa30e6f9379",
"vout": 1
}
],
"vout": [
{
"n": 0,
"scriptPubKey": {
"addresses": [
"15dDsLzoxHnoZYbab18mxcD5gjc8CLTyEe"
],
"asm": "OP_DUP OP_HASH160 32ba382cf668657bae15ee0a97fa87f12e1bc89f OP_EQUALVERIFY OP_CHECKSIG",
"hex": "76a91432ba382cf668657bae15ee0a97fa87f12e1bc89f88ac",
"reqSigs": 1,
"type": "pubkeyhash"
},
"value": 2.872e-05
},
{
"n": 1,
"scriptPubKey": {
"addresses": [
"1dice8EMZmqKvrGE4Qc9bUFf9PX3xaYDp"
],
"asm": "OP_DUP OP_HASH160 06f1b66ffe49df7fce684df16c62f59dc9adbd3f OP_EQUALVERIFY OP_CHECKSIG",
"hex": "76a91406f1b66ffe49df7fce684df16c62f59dc9adbd3f88ac",
"reqSigs": 1,
"type": "pubkeyhash"
},
"value": 0.01
}
],
"vsize": 226
}
}
Результат представлен следующими полями:
Поле | Тип | Назначение |
---|---|---|
error | При успешеном выполнении равен null | |
id | integer | Номер запроса, равен 1 |
result | array | Информация о транзакции |
Поле | Тип | Назначение |
---|---|---|
blockhash | string | Хеш блока |
blocktime | integer | Время создания блока |
confirmations | integer | Число подтверждений |
hash | string | Хеш |
hex | string | Хеш в шестнадцатеричном виде |
locktime | integer | Время блокировки |
size | integer | Размер транзакции |
time | integer | Время |
txid | string | Идентификатор транзакции |
version | integer | Версия |
vin | array | Массив входов |
vout | array | Массив выходов |
vsize | integer | Размер |
Поле | Тип | Назначение |
---|---|---|
scriptSig | array | Массив, описывающий скрипт подписи. Отсутствует в coinbase-транзакциях |
asm | string | Скрипт подписи в декодированной форме с кодами операций без данных |
hex | string | Скрипт подписи в шестнадцатеричной закодированной форме |
sequence | integer | Число очерёдности. Число определённое для каждого входа транзакции, определяющее какое время (выраженное количеством 512 секундных интервалов времени или количеством блоков) должно пройти с момента подтверждения расходуемого входа до того момента, когда транзакция имеет возможность быть принятой в блокчейн |
txid | string | Хеш входа |
vout | integer | Номер выхода, в котором потрачены средства. Отсутствует в coinbase-транзакциях |
Поле | Тип | Назначение |
---|---|---|
n | integer | Номер |
scriptPubKey | array | Массив содержащий информацию о публичной подписи |
addresses | array | Массив адресов используемых в транзакции |
asm | string | Скрипт публичной подписи в декодированной форме с кодами операций без данных |
hex | string | Скрипт публичной подписи в шестнадцатеричной закодированной форме |
reqSigs | integer | Требуемое количество подписей. Всегда равно 1. Может быть больше 2 в случае multisig |
type | string | Тип подписи |
value | double | Номер выхода |
Примеры:
curl
curl -g -H "Content-Type: application/json" -H "Accept: application/json" "https://api.matbea.net/getrawtransaction/000000329877c7141c6e50b04ed714a860abcb15135611f6ac92609cb392ef60?token=YOUR_TOKEN"
PHP
$tx_hash = '000000329877c7141c6e50b04ed714a860abcb15135611f6ac92609cb392ef60';
$url = 'https://api.matbea.net';
$tok = 'token=YOUR_TOKEN';
$GETparam = '/getrawtransaction/' . $tx_hash . '?' . $tok;
$POSTparam=[];
$rsh = curl_init();
if ($rsh) {
curl_setopt($rsh, CURLOPT_URL, $url . $GETparam);
curl_setopt($rsh, CURLOPT_HTTPHEADER, ['Content-Type:application/json']);
curl_setopt($rsh, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($rsh, CURLOPT_POST, 0);
$r=curl_exec($rsh);
if (!$r) {
printf("[E]\t%s (%s)\n", curl_error($rsh), curl_errno($rsh));
} else {
printf("%s\n", $r);
}
curl_close($rsh);
}
javascript
tx_hash = '000000329877c7141c6e50b04ed714a860abcb15135611f6ac92609cb392ef60';
tok = 'token=YOUR_TOKEN';
url = 'https://api.matbea.net/getrawtransaction/' + tx_hash + '?' + tok;
fetch(url)
.then((response) => {
return response.json();
}).then((data) => {
console.log(data);
});
Наверх
Отправляет транзакцию в формате raw transaction
Данные транзакции передаются в параметре txhash POST методом.
Параметры запроса:https://api.matbea.net/sendrawtransaction
Значение | Тип | Назначение | Метод передачи |
---|---|---|---|
txhash | string | Сериализированная и hex-закодированная форма raw транзакции | POST |
Результат:
{
"result": "6d32b5f707ed5dc7272396b1b0410ba5ebaf516b00bbdd726f3863e793186324",
"error": null,
"id": "1"
}
Результат представлен следующими полями:
Поле | Тип | Назначение |
---|---|---|
result | string | Хеш транзакции |
error | При успешеном выполнении равен null | |
id | integer | Номер запроса, равен 1 |
Примеры:
curl
curl -g -H "Content-Type: application/json" -H "Accept: application/json" -X POST -d "{\"txhash\":\"0100000001997ae2a654ddb2432ea2fece72bc71d3dbd371703a0479592efae21bf6b7d5100100000000ffffffff01e00f9700000000001976a9142a495afa8b8147ec2f01713b18693cb0a85743b288ac00000000\"}" "https://api.matbea.net/sendrawtransaction?token=YOUR_TOKEN"
PHP
$tx_hash = 'SERIALIZED AND HEX-ENCODED RAW TRANSACTION';
$url = 'https://api.matbea.net';
$tok = 'token=YOUR_TOKEN';
$GETparam = '/sendrawtransaction?'.$tok;
$POSTparam = ['txhash' => $tx_hash];
$rsh = curl_init();
if ($rsh) {
curl_setopt($rsh, CURLOPT_URL, $url . $GETparam);
curl_setopt($rsh, CURLOPT_HTTPHEADER, ['Content-Type:application/json']);
curl_setopt($rsh, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($rsh, CURLOPT_POST, 1);
curl_setopt($rsh, CURLOPT_POSTFIELDS, http_build_query($POSTparam) );
$r=curl_exec($rsh);
if (!$r) {
printf("[E]\t%s (%s)\n", curl_error($rsh), curl_errno($rsh));
} else {
printf("%s\n", $r);
}
curl_close($rsh);
}
javascript
tx_hash = 'SERIALIZED AND HEX-ENCODED RAW TRANSACTION';
tok = 'token=YOUR_TOKEN';
url = 'https://api.matbea.net/sendrawtransaction?' + tok;
fetch(url, {
method: 'post',
body: 'txhash=' + tx_hash})
.then((response) => {
return response.json();
}).then((data) => {
console.log(data);
});
Наверх