Wallet API
Все запросы должны содержать следующие заголовки:
-
Authorization: Bearer {API Token}
-
Signature: {signature}
{API Token}
Вы можете найти в настройках кошелька (например: 7ehgTCkenq28YjwhDwtwclaerocvhOw4IodUVvtz53lU8ZHDCnjwT2kmxqTRmCrg)
.
{signature}
- это передаваемые данные, зашифрованные методом HMAC-SHA512 с использованием секретного ключа кошелька;
секретный ключ также можно найти в настройках кошелька (API Secret
).
<?php
$api_token = "F3wDLLYoCzTkd1yOpezA1np1tVS09qKyt2UNS3RYERLE9r8WT3cDL8ls4oqfZmN6";
$api_secret = "rKPepNp2PhLpELk6OSN14FgfGPEq6TSx54ObfcKaA92IoLxwGAEZXH8VweIz6S9jQUvClzCVkh5";
$data = [];
$signature = hash_hmac("sha512", http_build_query($data, "", "&"), $api_secret);
?>
Request:
GET
https://homelesslovecraft.xyz/api/v1/wallet/btc/info
Response:
{"result":{"balances":{"trusted":0.021,"untrusted_pending":0.0041}}}
-
result.balances.trusted
– Подтвержденный баланс кошелька -
result.balances.untrusted_pending
– Неподтвержденный баланс кошелька
Request:
GET
https://homelesslovecraft.xyz/api/v1/wallet/btc/address/new
Response:
{"result":"tb1qesp5k85xat3zav47lqr7zpeljaj2nvqgqhyhjy"}
-
result
– Новый адрес кошелька
Request:
GET
https://homelesslovecraft.xyz/api/v1/wallet/btc/address/#ADDRESS#/info
-
#ADDRESS#
– Запрашиваемый адрес
Response:
{"result":{"amount":"0.01831916","transactions":[{"txid":"29f7c3b7f35b88576569ffb2853869a32aa29b0c393f","amount":"0.01831916","confirmed":true,"confirmations":3,"time":1664967282,"timereceived":1664967293}]}}
-
result.amount
– Подтвержденный баланс адреса, сумма поступивших средств -
result.transactions
– Список входящих транзакций на адрес, отсортированный по time -
result.transactions.0.txid
– ID транзакции -
result.transactions.0.amount
– Сумма -
result.transactions.0.confirmed
– Статус подтверждения -
result.transactions.0.time
– Время создания (публикации в сеть) -
result.transactions.0.timereceived
– Время получения транзакции от сети
Request:
POST
https://homelesslovecraft.xyz/api/v1/wallet/btc/coins/send
{"destinations":[{"address":"tb1qcqtp8netqzdrxwvxh7x25zg40dhyw77wfvwt8m","amount":0.00025}]}
-
destinations
– Список адресов и сумм -
destinations.0.address
– Адрес назначения -
destinations.0.amount
– Сумма
Response:
{"result":{"txid":"5d9ef693d41cb3bb4c6d98e70ea8b2cc91be29a804245a06ec8761d9cddc103c"}}
-
result.txid
– ID транзакции