/mergeUtxos
1 min
POST
http://1.1.1.1/mergeUtxos
Query Parameters
- coin_typestringrequiredExampleDescriptionDefaultBTC
- account_idintegerrequiredExampleDescriptionDefault1
- min_amountstringrequiredExampleDescriptionDefault2
- max_amountstringrequiredExampleDescriptionDefault200
- feeintegerrequiredExampleDescriptionDefault10
- max_utxos_per_transactionintegerrequiredExampleDescriptionDefault10
Body Parameters
- bodymergeUtxosRequestRequestDescription
- AccountIdintegerExampleDescriptionDefault1
- CoinTypestringExampleDescriptionDefaultBTC
- FeeintegerExampleDescriptionDefault1
- MaxAmountstringExampleDescriptionDefault200
- MaxUtxosPerTransactionintegerExampleDescriptionDefault10
- MinAmountstringExampleDescriptionDefault2
- MetaMetaTokenmergeUtxosRequest
- FunctionNamestringExampleDescriptionDefaultmergeUtxosRequest
- RandomDatastringExampleDescriptionDefault288cd49d4b8bf00e7d6114b78d5668d5581d6b953fafef779133caa844cd4229
- DestinationstringDescriptionDefaultb9cb8afe52f1d52521cf2b62dfe12146156ad5328f83c62c20c7da81b263356a61340de745c858998544c041798b01c2f4fac31bebe52a19280a32cd57d6d374ea
- TimestringExampleDescriptionDefault2021-02-07T18:37:46.948Z
- SourcestringDescriptionDefault048b99461a70a49abe63fd585cb224177a22a92d2e9e4ddfbc0027887bee9d1843388f42a3eb2e740565e115ad8b7981abf59e3b03b771f4b063b53c517d7a9d99
- AccessTokenstringExampleDescriptionDefault51311c84d2c8fd2fafbe56ceb1fb30a99d3417abfc55769577338ab286798087
Responses
200
- mergeUtxosRequestResponse
- FunctionDataobject
- AccountIdintegerExampleDescriptionDefault1
- CurrencySymbolstringExampleDescriptionDefaultBTC
- DateintegerExampleDescriptionDefault1627308971
- FeeintegerExampleDescriptionDefault1
- MergeUtxosRequestIdstringExampleDescriptionDefault4e3c785375637a5b0176d2e1716ad04927cac7413116101cdd4f1f82fe316873
- MergeUtxosRequestTypestringExampleDescriptionDefaultMerge Utxos
- MergeUtxosRequestTypeKeyintegerExampleDescriptionDefault1
- MergeUtxosRequestOptionsobject
- MaxAmountForUtxoToCollectstringExampleDescriptionDefault200000000
- MaxUtxosPerTransactionintegerExampleDescriptionDefault10
- MinAmountForUtxoToCollectstringExampleDescriptionDefault4
- MergeUtxosTransactionsRequestsobject[]
- BaseForMergeUtxosTransactionRequestIdstringExampleDescriptionDefaultnull
- BasedOnMergeUtxosTransactionRequestIdstringExampleDescriptionDefault4e3c785375657a5b01nad2e1716ad0492acac7413116101cdd4f1fz2fe316873
- FailureDescriptionstringExampleDescriptionDefaultnull
- MergeUtxosRequestIdstringExampleDescriptionDefault4e3c785375637a5b0176d2e1716ad04927cac7413116101cdd4f1f82fe316873
- ReplaceableTransactionsChainCountintegerExampleDescriptionDefault1
- StatusstringExampleDescriptionDefaultConfirmed
- StatusKeyintegerExampleDescriptionDefault13
- TransactionSerialNumberintegerExampleDescriptionDefault1
- TxIdstringExampleDescriptionDefault74d2b52157c20442ca3232155b92e8251a97134f56d99d99d9be23f52547900b
- UtxosIdsobject[]
- TxIdstringExampleDescriptionDefault214c86f6391caa262909d8e9baa80692dee7b474a8a45157936b75abfc7ccae7
- VoutIndexintegerDescriptionDefault0
- MetaMetaResponse
- AccessTokenstringExampleDescriptionDefaulta3e816b5bc04302d99da94705ec2309a4a63fe10d6aed3c5f6fc9e7ff27c6be6
- DestinationstringExampleDescriptionDefault042c671aeb148d9b2bb4918399c4c925f3764248c5ab2d5194ab0f32664132834692699a75e7fafb5af35f183b7d8a68bdc3b3e6ebfaff8ab555b9a3caf8090622
- SourcestringExampleDescriptionDefaultdf4b76a23067a9d782d09a7372ed526ec713cf6d771fac4dbdb9610f7af36d570a157eed76986b8e85afde12888d10d10bef461399e490f3d7e4db44cde1b6e355
- TimestringExampleDescriptionDefault2021-02-14 09:58:52.320
curl
curl --request POST \
--url 'http://1.1.1.1/mergeUtxos?coin_type=BTC&account_id=1&min_amount=2&max_amount=200&fee=10&max_utxos_per_transaction=10' \
--header 'accept: application/json' \
--header 'content-type: application/json' \
--data '{
"AccountId": 1,
"CoinType": "BTC",
"Fee": 1,
"MaxAmount": "200",
"MaxUtxosPerTransaction": 10,
"MinAmount": "2",
"Meta": {
"FunctionName": "mergeUtxosRequest",
"RandomData": "288cd49d4b8bf00e7d6114b78d5668d5581d6b953fafef779133caa844cd4229",
"Destination": "b9cb8afe52f1d52521cf2b62dfe12146156ad5328f83c62c20c7da81b263356a61340de745c858998544c041798b01c2f4fac31bebe52a19280a32cd57d6d374ea",
"Time": "2021-02-07T18:37:46.948Z",
"Source": "048b99461a70a49abe63fd585cb224177a22a92d2e9e4ddfbc0027887bee9d1843388f42a3eb2e740565e115ad8b7981abf59e3b03b771f4b063b53c517d7a9d99",
"AccessToken": "51311c84d2c8fd2fafbe56ceb1fb30a99d3417abfc55769577338ab286798087"
}
}'javascript
var myHeaders = new Headers();
myHeaders.append("accept", "application/json");
myHeaders.append("content-type", "application/json");
var raw = JSON.stringify({
"AccountId": 1,
"CoinType": "BTC",
"Fee": 1,
"MaxAmount": "200",
"MaxUtxosPerTransaction": 10,
"MinAmount": "2",
"Meta": {
"FunctionName": "mergeUtxosRequest",
"RandomData": "288cd49d4b8bf00e7d6114b78d5668d5581d6b953fafef779133caa844cd4229",
"Destination": "b9cb8afe52f1d52521cf2b62dfe12146156ad5328f83c62c20c7da81b263356a61340de745c858998544c041798b01c2f4fac31bebe52a19280a32cd57d6d374ea",
"Time": "2021-02-07T18:37:46.948Z",
"Source": "048b99461a70a49abe63fd585cb224177a22a92d2e9e4ddfbc0027887bee9d1843388f42a3eb2e740565e115ad8b7981abf59e3b03b771f4b063b53c517d7a9d99",
"AccessToken": "51311c84d2c8fd2fafbe56ceb1fb30a99d3417abfc55769577338ab286798087"
}
});
var requestOptions = {
method: 'POST',
headers: myHeaders,
body: raw,
redirect: 'follow'
};
fetch("http://1.1.1.1/mergeUtxos?coin_type=BTC&account_id=1&min_amount=2&max_amount=200&fee=10&max_utxos_per_transaction=10", requestOptions)
.then(response => response.text())
.then(result => console.log(result))
.catch(error => console.log('error', error));ruby
require "uri"
require "json"
require "net/http"
url = URI("http://1.1.1.1/mergeUtxos?coin_type=BTC&account_id=1&min_amount=2&max_amount=200&fee=10&max_utxos_per_transaction=10")
http = Net::HTTP.new(url.host, url.port);
request = Net::HTTP::Post.new(url)
request["accept"] = "application/json"
request["content-type"] = "application/json"
request.body = JSON.dump({
"AccountId": 1,
"CoinType": "BTC",
"Fee": 1,
"MaxAmount": "200",
"MaxUtxosPerTransaction": 10,
"MinAmount": "2",
"Meta": {
"FunctionName": "mergeUtxosRequest",
"RandomData": "288cd49d4b8bf00e7d6114b78d5668d5581d6b953fafef779133caa844cd4229",
"Destination": "b9cb8afe52f1d52521cf2b62dfe12146156ad5328f83c62c20c7da81b263356a61340de745c858998544c041798b01c2f4fac31bebe52a19280a32cd57d6d374ea",
"Time": "2021-02-07T18:37:46.948Z",
"Source": "048b99461a70a49abe63fd585cb224177a22a92d2e9e4ddfbc0027887bee9d1843388f42a3eb2e740565e115ad8b7981abf59e3b03b771f4b063b53c517d7a9d99",
"AccessToken": "51311c84d2c8fd2fafbe56ceb1fb30a99d3417abfc55769577338ab286798087"
}
})
response = http.request(request)
puts response.read_body
python
import requests
import json
url = "http://1.1.1.1/mergeUtxos?coin_type=BTC&account_id=1&min_amount=2&max_amount=200&fee=10&max_utxos_per_transaction=10"
payload = json.dumps({
"AccountId": 1,
"CoinType": "BTC",
"Fee": 1,
"MaxAmount": "200",
"MaxUtxosPerTransaction": 10,
"MinAmount": "2",
"Meta": {
"FunctionName": "mergeUtxosRequest",
"RandomData": "288cd49d4b8bf00e7d6114b78d5668d5581d6b953fafef779133caa844cd4229",
"Destination": "b9cb8afe52f1d52521cf2b62dfe12146156ad5328f83c62c20c7da81b263356a61340de745c858998544c041798b01c2f4fac31bebe52a19280a32cd57d6d374ea",
"Time": "2021-02-07T18:37:46.948Z",
"Source": "048b99461a70a49abe63fd585cb224177a22a92d2e9e4ddfbc0027887bee9d1843388f42a3eb2e740565e115ad8b7981abf59e3b03b771f4b063b53c517d7a9d99",
"AccessToken": "51311c84d2c8fd2fafbe56ceb1fb30a99d3417abfc55769577338ab286798087"
}
})
headers = {
'accept': 'application/json',
'content-type': 'application/json'
}
response = requests.request("POST", url, headers=headers, data=payload)
print(response.text)
200
// success
{
"FunctionData": {
"AccountId": 1,
"CurrencySymbol": "BTC",
"Date": 1627308971,
"Fee": 1,
"MergeUtxosRequestId": "4e3c785375637a5b0176d2e1716ad04927cac7413116101cdd4f1f82fe316873",
"MergeUtxosRequestType": "Merge Utxos",
"MergeUtxosRequestTypeKey": 1,
"MergeUtxosRequestOptions": {
"MaxAmountForUtxoToCollect": "200000000",
"MaxUtxosPerTransaction": 10,
"MinAmountForUtxoToCollect": "4"
},
"MergeUtxosTransactionsRequests": [
{
"BaseForMergeUtxosTransactionRequestId": "null",
"BasedOnMergeUtxosTransactionRequestId": "4e3c785375657a5b01nad2e1716ad0492acac7413116101cdd4f1fz2fe316873",
"FailureDescription": "null",
"MergeUtxosRequestId": "4e3c785375637a5b0176d2e1716ad04927cac7413116101cdd4f1f82fe316873",
"ReplaceableTransactionsChainCount": 1,
"Status": "Confirmed",
"StatusKey": 13,
"TransactionSerialNumber": 1,
"TxId": "74d2b52157c20442ca3232155b92e8251a97134f56d99d99d9be23f52547900b",
"UtxosIds": [
{
"TxId": "214c86f6391caa262909d8e9baa80692dee7b474a8a45157936b75abfc7ccae7",
"VoutIndex": 0
}
]
}
]
},
"Meta": {
"AccessToken": "a3e816b5bc04302d99da94705ec2309a4a63fe10d6aed3c5f6fc9e7ff27c6be6",
"Destination": "042c671aeb148d9b2bb4918399c4c925f3764248c5ab2d5194ab0f32664132834692699a75e7fafb5af35f183b7d8a68bdc3b3e6ebfaff8ab555b9a3caf8090622",
"Source": "df4b76a23067a9d782d09a7372ed526ec713cf6d771fac4dbdb9610f7af36d570a157eed76986b8e85afde12888d10d10bef461399e490f3d7e4db44cde1b6e355",
"Time": "2021-02-14 09:58:52.320"
}
}- This function is used to merge separate UTXOs within an account.
- return - Merges separate utxos depending on the parameters
*NOTE: this function can only be called for accounts who are configured as omnibus accounts.
example:
*mergeUtxos("BTC",1,"1","100000000",1,20)