Matbea | Документация

API 2.0 Matbea предназначен для получения информации о биткойн транзакциях, балансе адресов и их владельцах. В документации представлены возможности API 2.0 Matbea, дано описание параметров запросов и возвращаемых значений. В описании методов приведены примеры использования API с помощью curl и на языках PHP и JS(fetch).

Вызов методов выполняется url адресом вида:

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	Текст ошибки

Функции работы с данными представлены следующими методами:

Информация о транзакциях

Метод transaction - получить информацию о транзакции по заданному хешу;
Метод transactions - получить информацию о транзакциях по нескольким хешам;
Метод transactionsholders - получить информацию об адресах и их владельцах, включенных в запрашиваемую транзакцию;

Информация о блоках

Метод block - получить информацию о блоке по его хешу или высоте;
Метод blocks - получить информацию о блоках по их высотам;
Метод lastblocks - получить информацию о последних добавленных блоках;
Метод blocktransactions - получить информацию о транзакциях в блоке с заданной высотой;

Информация об адресах

Метод confirmedBalance - получить информацию о балансе указанного адреса/адресов для заданного числа подтверждений;
Метод unconfirmedBalance - получить информацию о неподтвержденном балансе указанного адреса/адресов;
Метод countTransactions - получить информацию о наличии подтвержденных или неподтвержденных транзакций у указанного адреса/адресов;
Метод unspentConfirmed - получить информацию о подтвержденном балансе указанного адреса или нескольких адресов;
Метод unspentUnconfirmed - получить информацию о неподтвержденном балансе указанного адреса/адресов;
Метод address/ADDRESSHASH/transactions - получить информацию о транзакциях по заданному адресу;
Метод dumpxpub - получить информацию дочерних адресах, которые использовались в транзакциях, по заданному xpub или ypub;
Метод getpristineaddress - получить дочерний адрес, который не использовался в транзакциях, по заданному xpub или ypub;

Информация о владельцах

Метод getholder - получить информацию о владельце адреса;
Метод getholders - получить информацию о владельцах нескольких адресов;
Метод downloadholder - получить список адресов владельца в формате csv;

Проксирование

Метод estimatefee - получить информацию о рекомендуемой комиссии для включения транзакции в заданный блок;
Метод getrawtransaction - получить информацию транзакции в raw-формате;
Метод sendrawtransaction - отправить транзакцию в сеть.

Наверх

Метод transaction

Возвращает информацию о транзакции по заданному хешу

Вызов метода:

https://api.matbea.net/transaction/TRANSACTION_HASH?holder_data=D

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

Параметр	Значение	Тип	Назначение	Метод передачи
-	TRANSACTION_HASH	string	Хеш транзакции о которой необходимо получить информацию	URI
holder_data	D	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

Высота блока или время в которое транзакция будет разблокирована.

0	Не заблокирована
<500000000	Номер блока на котором эта транзакция будет разблокирована
=500000000	Временная метка UNIX в которое эта транзакция будет разблокирована

Транзакция не может быть добавлена в блок до значения lock_time

num_in_block

integer

Номер транзакции в блоке

size

integer

Размер транзакции в байтах

time

integer

Время создания транзакции

txin

array

Массив данных о входах транзакции

txout

array

Массив данных о выходах транзакции

Массив txin транзакции содержит следующие поля:

Поле	Тип	Назначение
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	Номер выхода, в котором потрачены средства

Массив txout транзакции содержит следующие поля:

Поле	Тип	Назначение
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

Пример:

Получение информации о транзакции с данными о владельце holder_data=1:

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
			}
		]
	}
}

Наверх

Метод transactions

Возвращает информацию о транзакциях по заданным хешам

Вызов метода:

https://api.matbea.net/transactions?txid[]=TH&holder_data=D

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

Параметр	Значение	Тип	Назначение	Метод передачи
txid	TH	string	Хеш или массив хешей транзакции о которой необходимо получить информацию.	URI, POST
holder_data	D	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

Высота блока или время в которое транзакция будет разблокирована.

0	Не заблокирована
<500000000	Номер блока на котором эта транзакция будет разблокирована
=500000000	Временная метка UNIX в которое эта транзакция будет разблокирована

Транзакция не может быть добавлена в блок до значения lock_time

num_in_block

integer

Номер транзакции в блоке

size

integer

Размер транзакции в байтах

time

integer

Время создания транзакции

txin

array

Массив данных о входах транзакции

txout

array

Массив данных о выходах транзакции

Массив txin транзакции содержит следующие поля:

Поле	Тип	Назначение
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	Номер выхода, в котором потрачены средства

Массив txout транзакции содержит следующие поля:

Поле	Тип	Назначение
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	Номер выхода

Примеры:
Получение информации о транзакциях без данных о владельце методом 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
					}
				]
			}
		]
	}
}

Наверх

Метод transactionsholders

Возвращает данные об адресах и их владельцах включенных в запрашиваемую транзакцию

Вызов метода:

https://api.matbea.net/transactionsholders

Хеш или массив хешей транзакций DATA передается в параметре txid POST методом.

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

Параметр	Значение	Тип	Назначение	Метод передачи
txid	DATA	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	Массив хешей транзакций, в которых данный адрес был входом

Информация о входах outputs представлена следующими полями:

Поле	Тип	Назначение
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"
				]
			}
		]
	}
}

Наверх

Метод block

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

Возможны два варианта вызова метода:

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
	}
}

Наверх

Метод blocks

Возвращает информацию о блоках по заданным номерам блоков.

Вызов метода:

https://api.matbea.net/blocks?blockid[]=B

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

Параметр	Значение	Тип	Назначение	Метод передачи
blockid	B	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	Число транзакций в блоке

Примеры:

Получение информации методом GET:

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
			}
		]
	}
}

Получение информации методом POST:

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
			}
		]
	}
}

Наверх

Метод lastblocks

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

Вызов метода:

https://api.matbea.net/lastblocks?count=C

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

Параметр	Значание	Тип	Назначение	Метод передачи
count	C	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
			}
		]
	}
}

Наверх

Метод blocktransactions

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

Вызов метода:

https://api.matbea.net/blocktransactions?block=B&page=P&limit=L

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

Параметр	Значение	Тип	Назначение	Метод передачи
block	B	integer	Высота блока. Положительное число, больше 0	URI
page	P	integer	Номер страницы	URI
limit	L	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	Массив данных о транзакциях входящих в блок

Массив txs содержит следующие поля о транзакциях:

Поле	Тип	Назначение
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"
			}
		]
	}
}

Наверх

Метод ConfirmedBalance

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

Вызов метода:

https://api.matbea.net/confirmedBalance?address[]=ADDR&confirmations=C

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

Параметр	Значение	Тип	Назначение	Метод передачи
address	ADDR	string	Адрес или несколько адресов для которых запрошена информация. Адреса передаются в массиве	URI, POST
confirmations	C	integer	Число подтверждений. Если параметр не передан, то confirmations принимается равным 1	URI

Результат запроса возвращается в следующем json формате:

{
	"error": {},
	"result": {
		"balances": [
			{
				"address": "1MN3cT9Ro927h4kgpSZ5V7SfYjrwTysXv7",
				"balance": 6500
			}
		],
		"confirmations": 1
	}
}

Информация о подтвержденном балансе представлена следующими полями:

Поле	Тип	Назначение
address	string	Запрошенный адрес
balance	integer	Баланс запрошенного адреса
confirmations	integer	Число подтверждений

Если в запросе передан неверный адрес или адрес который не использовался в транзакциях, то содержимое массива balances будет пустым:

{
	"error": {},
	"result": {
		"balances": []
	}
}

Примеры:

Баланс для двух адресов с 50 подтверждениями. Адреса передаются методом GET:

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
	}
}

Баланс для двух адресов с 50 подтверждениями. Адреса передаются методом POST:

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
	}
}

Баланс для одного адреса без указания числа подтверждений. Адрес передается методом GET:

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
	}
}

Наверх

Метод UnconfirmedBalance

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

Вызов метода:

https://api.matbea.net/unconfirmedBalance?address[]=ADDR

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

Параметр	Значение	Тип	Назначение	Метод передачи
address	ADDR	string	Адрес или массив адресов информацию о которых необоходимо получить.	URI, POST

Результат запроса возвращается в следующем json формате:

{
	"error": {},
	"result": {
		"balances": [
			{
				"address": "1MN3cT9Ro927h4kgpSZ5V7SfYjrwTysXv7",
				"balance": 0
			}
		]
	}
}

Информация о неподтвержденном балансе представлена следующими полями:

Поле	Тип	Назначение
address	string	Запрошенный адрес
balance	integer	Неподтвержденный баланс запрошенного адреса

{
	"error": {},
	"result": {
		"balances": []
	}
}

Пример:

Передача массива адресов методом GET:

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
			}
		]
	}
}

Передача массива адресов методом POST:

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
			}
		]
	}
}

Наверх

Метод CountTransactions

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

Вызов метода:

https://api.matbea.net/countTransactions?address[]=ADDR&confirmed=C

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

Параметр	Значение	Тип	Назначение	Метод передачи
address	ADDR	string	Адрес или массив адресов информацию о которых необходимо получить.	URI, POST
confirmed	C	boolean	true - поиск адреса в подтвержденных транзакциях, false - поиск адреса в неподтвержденных транзакциях. Если параметр не задан поиск во всех транзакциях	URI

Результат запроса возвращается в следующем json формате:

{
	"error": {},
	"result": {
		"addresses": [
			{
				"1MN3cT9Ro927h4kgpSZ5V7SfYjrwTysXv7": true
			},
			{
				"АДРЕС": ЗНАЧЕНИЕ
			}
		],
		"confirmed": true
	}
}

Информация об адресах представлена следующими полями:

Поле	Тип	Назначение
АДРЕС	string	Запрошенный адрес
ЗНАЧЕНИЕ	boolean	true - адрес найден, false - адрес не найден
confirmed	boolean	Режим поиска

Если в запросе передан неверный адрес или адрес который не использовался в транзакциях, то содержимое массива addresses будет пустым:

{
	"error": {},
	"result": {
		"addresses": []
	}
}

Пример:

Получение информации о двух адресах с поиском в подтвержденных и неподтвержденных транзакциях. Адреса передаются методом GET:

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
			}
		]
	}
}

Получение информации о двух адресах с поиском в подтвержденных транзакциях. Адреса передаются методом GET:

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
	}
}

Получение информации о двух адресах с поиском в подтвержденных и неподтвержденных транзакциях. Адреса передаются методом POST:

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
	}
}

Наверх

Метод unspentConfirmed

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

Вызов метода:

https://api.matbea.net/unspentConfirmed?address[]=ADDR&confirmations=C

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

Параметр	Значение	Тип	Назначение	Метод передачи
address	ADDR	string	Адрес или адреса о которых запрашивается информация. Данные перадаются в массиве	URI, POST
confirmations	C	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	Массив с данными об адресе и подтвержденном балансе

Массив outputs содержит следующие поля:

Поле	Тип	Назначение
address	string	запрошенный адрес
unspent	array	Массив с данными о подтвержденных непотраченных выходах

Массив unspent содержит следующие поля:

Поле	Тип	Назначение
amount	integer	Средства
block_height	integer	Высота блока
confirmations	integer	Число подтверждений
confirmed	integer	Время подтверждения
tx_hash	string	Хеш входной транзакции
vout	integer	Номер выхода

Если в запросе передан неверный адрес или адрес который не использовался в транзакциях, то содержимое массива outputs будет пустым:

{
	"error": {},
	"result": {
		"confirmations": 1,
		"outputs": []
	}
}

Примеры:

Подтвержденные непотраченные средства для двух адресов с 50 подтверждениями. Адреса передаются методом GET:

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
					}
				]
			}
		]
	}
}

Подтвержденные непотраченные средства для двух адресов с 50 подтверждениями. Адреса передаются методом POST:

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
					}
				]
			}
		]
	}
}

Подтвержденные непотраченные средства для одного адреса без указания числа подтверждений. Адрес передается методом POST:

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
					}
				]
			}
		]
	}
}

Наверх

Метод unspentUnconfirmed

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

Вызов метода:

https://api.matbea.net/unspentUnconfirmed?address[]=ADDR

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

Параметр	Значение	Тип	Назначение	Метод передачи
address	ADDR	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	Номер выхода

{
	"error": {},
	"result": {
		"outputs": []
	}
}

Примеры:

Неподтвержденные непотраченные средства для двух адресов с 50 подтверждениями. Адреса передаются методом GET:

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": []
			}
		]
	}
}

Неподтвержденные непотраченные средства для двух адресов с 50 подтверждениями. Адреса передаются методом POST:

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": []
			}
		]
	}
}

Неподтвержденные непотраченные средства для одного адреса. Адрес передается методом POST:

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": []
			}
		]
	}
}

Наверх

Метод address/ADDRESSHASH/transactions

Возвращает информацию о транзакциях по заданному адресу ADDRESSHASH.

Вызов метода:

https://api.matbea.net/address/ADDRESSHASH/transactions?holder_data=HD&limit=L&starttxid=STD&type=T

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

Параметр	Значение	Тип	Назначение	Метод передачи
-	ADDRESSHASH	string	Адрес для которого необходимо получить информацию о проведенных транзакциях	URI
holder_data	HD	integer	Флаг вывода информации о владельце адреса. Принимаемые значения 1 или 0. Значение по умолчанию 0	URI
limit	L	integer	Максимальное число транзакций выводимых в результате. Значение по умолчанию 10	URI
starttxid	STD	string	Хеш транзакции, после которой начинается вывод результатов. Параметр опциональный	URI
type	T	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

Высота блока или время в которое транзакция будет разблокирована.

0	Не заблокирована
<500000000	Номер блока на котором эта транзакция будет разблокирована
=500000000	Временная метка UNIX в которое эта транзакция будет разблокирована

Транзакция не может быть добавлена в блок до значения lock_time

num_in_block

integer

Номер транзакции в блоке

size

integer

Размер блока

time

integer

Время создания транзакции

txin

array

Массив данных о входах

txout

array

Массив данных о выходах

Массив txin транзакции содержит следующие поля:

Поле	Тип	Назначение
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	Номер выхода, в котором потрачены средства

Массив txout транзакции содержит следующие поля:

Поле	Тип	Назначение
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 представлен следующими полями:

Поле	Тип	Назначение
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" 
	}
}

Пример

Получение информации о транзакциях c данными о владельцах. Число выводимых транзакций 2:

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"
	}
}

Получение информации о транзакциях c данными о владельцах с выбором только из входных транзакций. Число выводимых транзакций 2:

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"
	}
}

Получение информации о транзакциях c данными о владельцах с указанием стартового хеша от которого выводятся данные. Число выводимых транзакций 2:

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"
	}
}

Получение информации о транзакциях c данными о владельцах с указанием стартового хеша от которого выводятся данные и фильтрацией по входным транзакциям. Число выводимых транзакций 2:

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"
	}
}

Наверх

Метод getholder

Возвращает информацию о владельце адреса.

Вызов метода:

https://api.matbea.net/getholder/ADDRESS?address_data=D

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

Параметр	Значение	Тип	Назначение	Метод передачи
-	ADDRESS	string	Адрес задается в url строке	URI
address_data	D	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"
	}
}

Наверх

Метод getholders

Возвращает информацию о балансе и владельцах адресов.

Вызов метода:

https://api.matbea.net/getholders?address[]=ADDR&confirmations=C

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

Параметр	Значение	Тип	Назначение	Метод передачи
address	ADDR	string	Адрес или массив адресов для которых запрашивается информация. Данные передаются в массиве.	URI, POST
confirmations	C	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": []
}

Если в запросе передается массив адресов, который содержит неверный адрес или адрес не использовавшийся в транзакциях, то результат будет возвращен только для корректных адресов и адресов с транзакциями.

Пример:

Получение информации о балансе и владельцах адресов, с заданным числом подтверждением баланса, методом GET:

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"
		}
	]
}

Получение информации о балансе и владельцах адресов, с заданным числом подтверждением баланса, методом POST:

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"
		}
	]
}

Получение информации о балансе и владельце одного адреса, без задания числа подтверждений, методом POST:

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"
		}
	]
}

Наверх

Метод downloadholder

Возвращает список других адресов владельца, которому принадлежит запрошенный адрес, в формате 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

Наверх

Метод estimatefee

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

Вызов метода:

https://api.matbea.net/transaction/estimatefee?blocks=B

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

Параметр	Значение	Тип	Назначение	Метод передачи
blocks	B	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
	}
}

Наверх

Метод getrawtransaction

Возвращает информацию о транзакции в формате 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	Информация о транзакции

Массив result представлен следующими полями:

Поле	Тип	Назначение
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	Размер

Массив vin представлен следующими полями:

Поле	Тип	Назначение
scriptSig	array	Массив, описывающий скрипт подписи. Отсутствует в coinbase-транзакциях
asm	string	Скрипт подписи в декодированной форме с кодами операций без данных
hex	string	Скрипт подписи в шестнадцатеричной закодированной форме
sequence	integer	Число очерёдности. Число определённое для каждого входа транзакции, определяющее какое время (выраженное количеством 512 секундных интервалов времени или количеством блоков) должно пройти с момента подтверждения расходуемого входа до того момента, когда транзакция имеет возможность быть принятой в блокчейн
txid	string	Хеш входа
vout	integer	Номер выхода, в котором потрачены средства. Отсутствует в coinbase-транзакциях

Массив vout представлен следующими полями:

Поле	Тип	Назначение
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);
});

Наверх

Метод sendrawtransaction

Отправляет транзакцию в формате raw transaction
Данные транзакции DATA передаются в параметре txhash POST методом.

Вызов метода:

https://api.matbea.net/sendrawtransaction

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

Параметр	Значение	Тип	Назначение	Метод передачи
txhash	DATA	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);
});

Наверх

Метод dumpxpub

Возвращает информацию о балансе и адресах, которые использовались в транзакциях, заданного xpub или ypub.

Вызов метода:

https://api.matbea.net/hdwallet/dumpxpub?pubkey=KEY&include_balance=B &include_addresses=A&gap=G&block_height=BH

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

Параметр	Значение	Тип	Назначение	Метод передачи
pubkey	KEY	string	Ключ xpub или ypub, для которого требуется информация.	URI
include_balance	B	integer	Вывод информации о балансе. Принимаемые значения: 1 (выводить) или 0 (не выводить). Значение по умолчанию 0.	URI
include_addresses	A	integer	Вывод адресов, которые использовались в транзакциях. Принимаемые значения: 1 (выводить) или 0 (не выводить). Значение по умолчанию 0.	URI
gap	G	integer	Допустимая разница между номером последнего использованного адреса и последним запрошенным адресом. Принимаемые значения: от 1 до 10000. Значение по умолчанию 20.	URI
block_height	BH	integer	Высота блока, с которого начинать поиск. Значение по умолчанию 1.	URI

Результат:

Результат возвращается в json формате:

{
	"error": {},
	"result": {
		"addresses": [
			{
				"address": "1EfgV2Hr5CDjXPavHDpDMjmU33BA2veHy6",
				"derivationPath": "m/0/0" 
			},
			{
				"address": "12iNxzdF6KFZ14UyRTYCRuptxkKSSVHzqF",
				"derivationPath": "m/0/1" 
			},
			{
				"address": "1CcEugXu9Yf9Qw5cpB8gHUK4X9683WyghM",
				"derivationPath": "m/0/2" 
			},
			{
				"address": "15xANZb5vJv5RGL263NFuh8UGgHT7noXeZ",
				"derivationPath": "m/0/3" 
			},
			{
				"address": "1PJMBXKBYEBMRDmpAoBRbDff26gHJrawSp",
				"derivationPath": "m/0/4" 
			},
			{
				"address": "16ZBYSHkLkRFHAuZvyzosXYgU1UDJxRV1R",
				"derivationPath": "m/0/5" 
			},
			{
				"address": "1EHeVKfjjq6FJpix86G2yzFeRbZ6RNg2Zm",
				"derivationPath": "m/0/6" 
			}
		],
		"balance": 8747,
		"block_height": 57165
	}
}

Результат представлен следующими полями:

Поле	Тип	Назначение
addresses	array	Массив адресов участвовавших в транзакциях.
address	string	Адрес, который использовался в транзакции.
derivationPath	string	Путь деривации.
balance	integer	Баланс заданного xpub или ypub.
block_height	integer	Высота блока, с которого рассчитан баланс. Данное поле выводится только при include_balance=1

Параметры include_balance, include_addresses, gap, block_height опциональные. Если параметры не указаны, то возвращается число дочерних адресов, участвовавших в транзакциях.

{
	"error": {},
	"result": {
		"countAddresses": 7
	}
}

Поле	Тип	Назначение
countAddresses	integer	число адресов участвовавших в транзакциях.

Пример

Получение информации о балансе и адресах по xpub:

curl

curl -g -H "Content-Type: application/json" -H "Accept: application/json" "https://api.matbea.net/hdwallet/dumpxpub?pubkey=xpub6CUGRUonZSQ4TWtTMmzXdrXDtypWKiKrhko4egpiMZbpiaQL2jkwSB1icqYh2cfDfVxdx4df189oLKnC5fSwqPfgyP3hooxujYzAu3fDVmz&include_balance=1&include_addresses=1&token=YOUR_TOKEN"

PHP

$url = 'https://api.matbea.net';
$tok = 'token=YOUR_TOKEN';
$GETparam = '/hdwallet/dumpxpub?pubkey='.$pubkey.'&include_balance=1&include_addresses=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

function DumpXpub()
{
pubkey='xpub6CUGRUonZSQ4TWtTMmzXdrXDtypWKiKrhko4egpiMZbpiaQL2jkwSB1icqYh2cfDfVxdx4df189oLKnC5fSwqPfgyP3hooxujYzAu3fDVmz';
tok = 'token=YOUR_TOKEN';
url = 'https://api.matbea.net/hdwallet/dumpxpub?pubkey=' + pubkey + '&include_balance=1&include_addresses=1&' + tok;
fetch(url)
	.then((response) => {
		return response.json();
	}).then((data) => {
		console.log(data);
	});
	return true;
}

Результат:

{
	"error": {},
	"result": {
		"addresses": [
			{
				"address": "1EfgV2Hr5CDjXPavHDpDMjmU33BA2veHy6",
				"derivationPath": "m/0/0" 
			},
			{
				"address": "12iNxzdF6KFZ14UyRTYCRuptxkKSSVHzqF",
				"derivationPath": "m/0/1" 
			},
			{
				"address": "1CcEugXu9Yf9Qw5cpB8gHUK4X9683WyghM",
				"derivationPath": "m/0/2" 
			},
			{
				"address": "15xANZb5vJv5RGL263NFuh8UGgHT7noXeZ",
				"derivationPath": "m/0/3" 
			},
			{
				"address": "1PJMBXKBYEBMRDmpAoBRbDff26gHJrawSp",
				"derivationPath": "m/0/4" 
			},
			{
				"address": "16ZBYSHkLkRFHAuZvyzosXYgU1UDJxRV1R",
				"derivationPath": "m/0/5" 
			},
			{
				"address": "1EHeVKfjjq6FJpix86G2yzFeRbZ6RNg2Zm",
				"derivationPath": "m/0/6" 
			}
		],
		"balance": 408747
	}
}

Получение информации о балансе по xpub с 57165 блока:

curl

curl -g -H "Content-Type: application/json" -H "Accept: application/json" "https://api.matbea.net/hdwallet/dumpxpub?pubkey=xpub6CUGRUonZSQ4TWtTMmzXdrXDtypWKiKrhko4egpiMZbpiaQL2jkwSB1icqYh2cfDfVxdx4df189oLKnC5fSwqPfgyP3hooxujYzAu3fDVmz&include_balance=1&include_addresses=0&block_height=57165&token=YOUR_TOKEN"

PHP

$url = 'https://api.matbea.net';
$tok = 'token=YOUR_TOKEN';
$GETparam = '/hdwallet/dumpxpub?pubkey='.$pubkey.'&include_balance=1&include_addresses=0&block_height=57165&' . $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

function DumpXpub()
{
pubkey='xpub6CUGRUonZSQ4TWtTMmzXdrXDtypWKiKrhko4egpiMZbpiaQL2jkwSB1icqYh2cfDfVxdx4df189oLKnC5fSwqPfgyP3hooxujYzAu3fDVmz';
tok = 'token=YOUR_TOKEN';
url = 'https://api.matbea.net/hdwallet/dumpxpub?pubkey=' + pubkey + '&include_balance=1&include_addresses=0&block_height=57165&' + tok;
fetch(url)
	.then((response) => {
		return response.json();
	}).then((data) => {
		console.log(data);
	});
	return true;
}

Результат:

{
	"error": {},
	"result": {
		"balance": 8747,
		"block_height": 57165
	}
}

Наверх

Метод getpristineaddress

Возвращает по заданному xpub или ypub адрес, который ранее не использовался в транзакциях.

Вызов метода:

https://api.matbea.net/hdwallet/getpristineaddress?pubkey=KEY&startfrom=START

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

Параметр	Значение	Тип	Назначение	Метод передачи
pubkey	KEY	string	Ключ xpub или ypub, для которого требуется адрес.	URI
startfrom	START	integer	Номер адреса в пути деривации (m/0/STARTFROM ), с которого начинать проверку. Значение по умолчанию 0.	URI

Результат:

Результат возвращается в json формате:

{
	"error": {},
	"result": {
		"address": "17BvBPGypT4nt1xc5QpdSDkQb54xoUuQkD",
		"derivationPath": "m/0/7",
		"number": 7
	}
}

Результат представлен следующими полями:

Поле	Тип	Назначение
address	string	Дочерний адрес заданного xpub или ypub.
derivationPath	string	Путь деривации.
number	integer	Номер адреса (m/0/number).

Пример

Получение адреса не используемого в транзакциях по заданному xpub. Поиск начинать с номера 11:

curl

curl -g -H "Content-Type: application/json" -H "Accept: application/json" "https://api.matbea.net/hdwallet/getpristineaddress?pubkey=xpub6CUGRUonZSQ4TWtTMmzXdrXDtypWKiKrhko4egpiMZbpiaQL2jkwSB1icqYh2cfDfVxdx4df189oLKnC5fSwqPfgyP3hooxujYzAu3fDVmz&&startfrom=11&token=YOUR_TOKEN"

PHP

$pubkey='xpub6CUGRUonZSQ4TWtTMmzXdrXDtypWKiKrhko4egpiMZbpiaQL2jkwSB1icqYh2cfDfVxdx4df189oLKnC5fSwqPfgyP3hooxujYzAu3fDVmz';
$url = 'https://api.matbea.net';
$tok = 'token=YOUR_TOKEN';
$GETparam = '/hdwallet/getpristineaddress?pubkey='.$pubkey.'&&startfrom=11&' . $tok;
$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

function getpristineaddress()
{
pubkey='xpub6CUGRUonZSQ4TWtTMmzXdrXDtypWKiKrhko4egpiMZbpiaQL2jkwSB1icqYh2cfDfVxdx4df189oLKnC5fSwqPfgyP3hooxujYzAu3fDVmz';
tok = 'token=YOUR_TOKEN';
url = 'https://api.matbea.net/hdwallet/getpristineaddress?pubkey=' + pubkey + '&startfrom=11&' + tok;
fetch(url)
	.then((response) => {
		return response.json();
	}).then((data) => {
		console.log(data);
	});
	return true;
}

Результат:

{
	"error": {},
	"result": {
		"address": "1JSAD9Z8cpcMkwv98eFNWRciAMDqrPYJTE",
		"derivationPath": "m/0/11",
		"number": 11
	}
}

Наверх