Bitpost API
Bitpost API makes bitcoin transactions easier and cheaper for the end user. Server answers in JSend format.
- Documentation/tutorials: https://docs.bitpost.co
- Code examples: https://github.com/bitpostAPI/examples
- New features
API servers:
- Mainnet: api.bitpost.co , current version: 1.1.1 (2020-10-05)
- Testnet: testnet-api.bitpost.co, current version: 1.1.2 (2020-10-08)
Note: new code is tried on testnet first, so it's less stable but might have new features not deployed on mainnet . Testnet can't simulate the fee environment on mainnet, in 99.99% of cases, 1 sat/B transactions will be confirmed.
Contact:
- Email: support@bitpost.co
- Twitter: @bitpostAPI
- Telegram: @bitpostAPI and @bitpostHQ (group)
Manage requests
Create and update fee adjustment requests.
Create a new request
Code samples
# psts = ... (see below)
curl -X POST https://api.bitpost.co/request?target=1574280739 \
-d $psts
import requests
# psts = ... (see below)
r = requests.post('https://api.bitpost.co/request', params={
'target': '1574280739'
}, data = str(psts) )
print(r.json())
POST /request
Creates a new fee adjustment request with a set of pre-signed transactions.
Body parameter
[
"01000000000101a19b89486c6d413db237c069c913698d1dd049070b157f5dea8b30ea904cb132020000001716001488662a7c62fd438e16149360e4c9797c0f577587fdffffff02e80300000000000017a914a042ea3d101129bfcc91b72a00dda6738be7aa1487896904000000000017a914c587bd919615a2664d4515fd442b5f147d7500218702473044022056b705267661cef83c72b179e9a2e50f115127b9ed6f25e760bde9c5927501b2022069f205974d6384928ba7cbaf00da3cd33cb27589f0560d822dd53788cb76ae9b012102a82a20fbab79a0f4628c0256bead3444422ad99a721e69d97d254a77be715ddf00000000",
"01000000000101a19b89486c6d413db237c069c913698d1dd049070b157f5dea8b30ea904cb132020000001716001488662a7c62fd438e16149360e4c9797c0f577587fdffffff02e80300000000000017a914a042ea3d101129bfcc91b72a00dda6738be7aa14879d6604000000000017a914c587bd919615a2664d4515fd442b5f147d7500218702483045022100ec8d0cdadb0262764aeb6bf83ed0a82671dadb687a2317b5a29c218b9f34372302207ea3a5dd64be15575c58d4f6f042c3c7f70cd9bf830720f920544ccd0a181a60012102a82a20fbab79a0f4628c0256bead3444422ad99a721e69d97d254a77be715ddf00000000"
]
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
target | query | number | true | Unix epoch timestamp determining when the transactions should be executed (have at least one confirmation). |
wallettoken | query | string | false | Optional string identifying the wallet who is creating the request. Should contain at least 20 characters. |
changepos | query | integer | false | Index of the change address output of the transaction (starting with 0). This information can be retrieved later to make child transactions with the /getutxos endpoint. If absent, the change address will be deduced as the the output from which the fee is subtracted. To turn this off, set this parameter to a negative number. |
delay | query | string | false | Delays broadcasting any transaction until the specified timestamp, thus scheduling payments into the future. Can be set to 1, to allow the application to delay the initial broadcast as it deems fit. Setting it to 0 forces a transaction to be initially broadcasted. |
broadcast | query | string | false | TxID of the transaction tha was broadcasted or is intended to be broadcasted initially. Our servers will immedialty (re)broadcast this transaction. An index (starting from 0) of body of the request where the raw transaction is present is also accepted. |
body | body | PSTarray or PSTjson | true | Array of raw signed transactions that signal for RBF with different fees. |
Example responses
200 Response
{
"data": {
"devurl": "https://api.bitpost.co/request?query=AUFjkLDjNh6",
"id": "AUFjkLDjNh6",
"url": "https://localhost:8081/track?query=AUFjkLDjNh6"
},
"status": "success"
}
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | OK | Inline |
400 | Bad Request | Invalid request | None |
Response Schema
Change an active request
Code samples
curl -X PUT https://api.bitpost.co/request?id=R9RJJBLz8Kd&wallettoken=8f8978cc74c8d76325eef60aed31b5dbab5
import requests
r = requests.put('https://api.bitpost.co/request', params={
'id': 'R9RJJBLz8Kd', 'wallettoken': '8f8978cc74c8d76325eef60aed31b5dbab5'
})
print(r.json())
PUT /request
Change the parameters (target or delay) of an ongoing request or add additional transactions to it.
Body parameter
[
"01000000000101a19b89486c6d413db237c069c913698d1dd049070b157f5dea8b30ea904cb132020000001716001488662a7c62fd438e16149360e4c9797c0f577587fdffffff02e80300000000000017a914a042ea3d101129bfcc91b72a00dda6738be7aa1487896904000000000017a914c587bd919615a2664d4515fd442b5f147d7500218702473044022056b705267661cef83c72b179e9a2e50f115127b9ed6f25e760bde9c5927501b2022069f205974d6384928ba7cbaf00da3cd33cb27589f0560d822dd53788cb76ae9b012102a82a20fbab79a0f4628c0256bead3444422ad99a721e69d97d254a77be715ddf00000000",
"01000000000101a19b89486c6d413db237c069c913698d1dd049070b157f5dea8b30ea904cb132020000001716001488662a7c62fd438e16149360e4c9797c0f577587fdffffff02e80300000000000017a914a042ea3d101129bfcc91b72a00dda6738be7aa14879d6604000000000017a914c587bd919615a2664d4515fd442b5f147d7500218702483045022100ec8d0cdadb0262764aeb6bf83ed0a82671dadb687a2317b5a29c218b9f34372302207ea3a5dd64be15575c58d4f6f042c3c7f70cd9bf830720f920544ccd0a181a60012102a82a20fbab79a0f4628c0256bead3444422ad99a721e69d97d254a77be715ddf00000000"
]
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
id | query | string | true | id of the request to be changed. |
wallettoken | query | string | true | Wallettoken of the request. If not known, check the /wallettokens endpoint. |
target | query | number | false | Unix epoch timestamp determining when the transactions should be executed (have at least one confirmation). |
delay | query | string | false | Delays broadcasting any transaction until the specified timestamp, thus scheduling payments into the future. Can be set to 1, to allow the application to delay the initial broadcast as it deems fit. Setting it to 0 forces a transaction to be initially broadcasted. |
changepos | query | integer | false | Index of the change address output of the transaction (starting with 0). This information can be retrieved later to make child transactions with the /getutxos endpoint. If absent, the change address will be deduced as the the output from which the fee is subtracted. To turn this off, set this parameter to a negative number. |
body | body | PSTarray | false | Array of raw signed transactions that signal for RBF with different fees. |
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | OK | None |
Delete a request
Code samples
curl -X DELETE https://api.bitpost.co/request?wallettoken=8f8978cc74c8d76325eef60aed31b5dbab5&id=AUFjkLDjNh6
import requests
r = requests.delete('https://api.bitpost.co/request', params={
'wallettoken': '8f8978cc74c8d76325eef60aed31b5dbab5', 'id': 'AUFjkLDjNh6'
})
print(r.json())
DELETE /request
Cancels the fee adjustment of a request. Afterwards, this request is allowed to be double-spent.
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
wallettoken | query | string | true | Wallettoken of the request. If not known, check the /wallettokens endpoint. |
id | query | number | false | id of the request to be cancelled; required if txid parameter is missing |
txid | query | string | false | txID of a transaction of the request to be cancelled; required if id parameter is missing |
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | OK | None |
400 | Bad Request | Missing or invalid parameters. | None |
404 | Not Found | Request not found. | None |
Consult
Obtain information to create new requests or about existing requests.
Track an existing request
Code samples
curl -X GET https://api.bitpost.co/request?query=FmPGSR9L7nb
import requests
r = requests.get('https://api.bitpost.co/request', params={
'query': 'FmPGSR9L7nb'
})
print(r.json())
GET /request
Tracks an existing request, whether it's complete or not.
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
query | query | string | true | requestID or txID belonging to a request you want to track. |
Example responses
200 Response
{
"id": "R9RJJBLz8Kd",
"status": "ACTIVE",
"target": 1594752720,
"delay": 1594732720,
"created": 1594702720,
"mempool": "0629bc8c86d3dd72d883ee6aa78c0b39034327b54ef6ff0763545fa162b5e33f",
"parents": ["ZUaGsJZvLGq", "WQPF9bHeny7"],
"childs": ["cWc31ibkoxE"],
"events": [
{
"type": "BROADCAST",
"subtype": "EXTERNAL_BROADCAST",
"timestamp": 1594742720345
}
]
}
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | OK | TrackData |
400 | Bad Request | Invalid or missing requestID | None |
Track all requests
Code samples
curl -X GET https://api.bitpost.co/requests?wallettoken=8f8978cc74c8d76325eef60aed31b5dbab5
import requests
r = requests.get('https://api.bitpost.co/requests', params={
'wallettoken': '8f8978cc74c8d76325eef60aed31b5dbab5'
})
print(r.json())
GET /requests
Get summary information about all ongoing requests associated with a wallettoken.
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
wallettoken | query | string | true | Wallettoken of the request. If not known, check the /wallettokens endpoint. |
showall | query | boolean | false | Whether to show old requests that have been completed in the past. |
showevents | query | boolean | false | Whether to the list of events of each request. |
Example responses
200 Response
// array can be found under ['data']['requests']
[
{
"id": "R9RJJBLz8Kd",
"status": "ACTIVE",
"target": 1594752720,
"delay": 1594732720,
"created": 1594702720,
"mempool": "0629bc8c86d3dd72d883ee6aa78c0b39034327b54ef6ff0763545fa162b5e33f",
"parents": ["ZUaGsJZvLGq", "WQPF9bHeny7"],
"childs": ["cWc31ibkoxE"],
"events": [
{
"type": "BROADCAST",
"subtype": "EXTERNAL_BROADCAST",
"timestamp": 1594742720345
}
]
}
]
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | OK | Inline |
400 | Bad Request | Invalid parameters | None |
Response Schema
Status Code 200
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
anonymous | [TrackData] | false | none | [contains information about a request.] |
» id | string | false | none | id of the request. |
» status | string | false | none | Status of the request. |
» target | integer | false | none | deadline for first confirmation as an epoch timestamp in seconds. |
» delay | integer | false | none | Epoch timestamp in seconds until which the first broadcast should be delayed. A value of 0 means "don't delay at all", a value of 1 means "delay as bitpost sees fit". |
» created | integer | false | none | Epoch timestamp in milliseconds of when the request was originally received. |
» mempool | string(txid) | false | none | Current mempool transaction (if any) that is part of the reques. |
» parents | [string] | false | none | array of requestID of the parent requests (if any). |
» childs | [string] | false | none | array of requestID of the chils requests (if any). |
» events | [Event] | false | none | none |
»» type | string | false | none | type of event |
»» subtype | string | false | none | subtype of event (if any) |
»» timestamp | integer | false | none | epoch timestamp in milliseconds indicanting when the event occured. |
Enumerated Values
Property | Value |
---|---|
status | COMPLETE |
status | ACTIVE |
status | CANCELLED |
Get spendable UTXOs/transactions
Code samples
curl -X GET https://api.bitpost.co/utxos?wallettoken=8f8978cc74c8d76325eef60aed31b5dbab5
import requests
r = requests.get('https://api.bitpost.co/utxos', params={
'wallettoken': '8f8978cc74c8d76325eef60aed31b5dbab5'
})
print(r.json())
GET /utxos
Get pre-signed transactions or UTXOs relevant to your wallet. Can be used to sign child transactions.
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
wallettoken | query | string | true | Wallettoken of the request. If not known, check the /wallettokens endpoint. |
filter | query | boolean | false | Whether to filter the utxos shown so to help selection. UTXOs that were previously broadcasted are always shown. UTXOs that can't replace the ones on the mempool are omitted. |
showrawtx | query | boolean | false | Whether to show the raw transaction that created the UTXO or not. |
showunkownchange | query | boolean | false | Whether to show transactions where the change output is unknown or not. |
target | query | integer | false | The target (in UNIX epoch format) of the request to be added. Used when the filter option is true, otherwise is ignored. |
Example responses
200 Response
// array can be found under ['data']['utxos']
[
{
"used": [
{
"txid": "0629bc8c86d3dd72d883ee6aa78c0b39034327b54ef6ff0763545fa162b5e33f",
"vout": 0
}
],
"groupsize": 2,
"change": [
{
"id": "R9RJJBLz8Kd",
"target": 1594752720,
"broadcasts": 3,
"minamout": 0.01259,
"utxos": [
{
"txid": "0629bc8c86d3dd72d883ee6aa78c0b39034327b54ef6ff0763545fa162b5e33f",
"vout": 0,
"scriptPubKey": "76a9148f8978cc74c8d76325eef60aed31b5dbab5884ac88ac",
"amount": 0.06354
}
]
}
],
"verification": {
"05c2ba4a2633a6c5cbec0dc1397b08dbee7b7e2c92ccb95d89f193f61c7a7814": "02000000019f7dd31db699d0528c6659b3862f94e5d3ad4af07a62922b0e3f589fd811c710030000006a473044022064d1ad37bf080f7855904142d93d4e9462f74970688e47a7a0f080933b9cd13c02205c5fe2843d0f7886eeb2104b5fc945005b1fc1e5fc78866c75b217dc1b367b7101210359c83da5f7a1aa0a397e4eb72a698e1a6e80f63c26d49450f79719b3a1f2f580fdffffff029fad5b00000000001976a9145a34ea9f68fc08f668e2838e0484243b99582b4288ac21a969000000000017a914d74f1f37106a8ee3f581197530c67344d00fe214872cc10900"
}
}
]
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | OK | Inline |
400 | Bad Request | Invalid or missing wallettoken. | None |
Response Schema
Status Code 200
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
anonymous | [GroupChangeData] | false | none | none |
» used | [Outpoint] | false | none | Confirmed UTXOs used by the request group given as an array of outpoints. |
»» txid | string(hex) | false | none | txid of the transaction that contains the UTXO. |
»» vout | integer | false | none | index of the UTXO in the output array of the transaction. |
» groupsize | integer | false | none | number of requests in the request group. |
» change | [ChangeData] | false | none | array with change UTXOs of every child request. |
»» id | string | false | none | id of request. |
»» target | integer | false | none | deadline for first confirmation as an epoch timestamp in seconds. |
»» broadcasts | integer | false | none | number of transactions already broadcasted in this request. |
»» minamout | number | false | none | minimum amount of change for the whole set of utxos. |
»» utxos | [UTXO] | false | none | none |
»»» txid | string(hex) | false | none | txid of the transaction that contains the UTXO. |
»»» vout | integer | false | none | index of the UTXO in the output array of the transaction. |
»»» scriptPubKey | string | false | none | none |
»»» amount | number | false | none | none |
» verification | object | false | none | Transactions as txid:hex pair. |
»» additionalProperties | string | false | none | none |
Retrieve a wallettoken
Code samples
# signatureProofs = [...] (see below)
curl -X POST https://api.bitpost.co/wallettokens \
-d $signatureProofs
import requests
# signature_proofs = [...] (see below)
r = requests.post('https://api.bitpost.co/wallettokens', data = str(signature_proofs) )
print(r.json())
POST /wallettokens
Get wallettoken(s) by proving ownernship of address(es).
Body parameter
[
{
"signature": "H2w8lDM5dPYu/gHD/yPZglUgMHKy1V/Ov/mEijgtkjp8B7KxEZh2S2PH9lKkjt5SV5bD/zLtJAq6ozAL4sv8ej8=",
"publickey": "03348b681d8e60730b070dffb88b870f5c51b0dad3e8fcac80c932bad75493ec88"
}
]
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
body | body | SignatureProof | true | Array of signature proofs. |
Example responses
200 Response
{
"data": {
"wallettokens": {
"old": [],
"active": ["47738044da01a897843be68a2d5e5c7b"]
}
},
"status": "success"
}
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | OK | Inline |
400 | Bad Request | Invalid parameters | None |
404 | Not Found | Didn't found any ongoing requests for the address. | None |
Response Schema
Get a set of suitable feerates
Code samples
# You can also use wget
curl -X GET https://api.bitpost.co/feerateset?maxfeerate=90.2
import requests
r = requests.get('https://api.bitpost.co/feerateset', params={
'maxfeerate': '90.2'
})
print(r.json())
GET /feerateset
Get a good set of feerates for the pre-signed transactions relayed to bitpost taken into account the current fee environment. The use of this endpoint is totally optional.
Parameters
Name | In | Type | Required | Description |
---|---|---|---|---|
maxfeerate | query | number | true | the maximum feerate the owner is willing to pay in satoshis/byte. |
size | query | integer | false | the number of feerates in the set. It should be no greater than maxfeerate, otherwise it will be adjusted. |
canreducefee | query | boolean | false | whether or not the fee of the transaction can be reduced. This can happen if the transaction spends from a pending RBF transaction or the first transaction broadcast can be delayed. |
target | query | number | false | Unix epoch timestamp determining when the payment should be executed (have at least one confirmation). This parameter is required if 'canreducefee' is set to false. |
Example responses
200 Response
{
"data": {
"size": 10,
"minfeerate": 63.2,
"feerates": [63.2, 64.2, 65.2, 66.2, 67.2, 68.2, 69.2, 75.6, 84.9, 90],
"maxfeerate": 90
},
"status": "success"
}
Responses
Status | Meaning | Description | Schema |
---|---|---|---|
200 | OK | OK | Inline |
400 | Bad Request | Invalid parameters | None |
Response Schema
Schemas
PSTarray
[
"01000000000101a19b89486c6d413db237c069c913698d1dd049070b157f5dea8b30ea904cb132020000001716001488662a7c62fd438e16149360e4c9797c0f577587fdffffff02e80300000000000017a914a042ea3d101129bfcc91b72a00dda6738be7aa1487896904000000000017a914c587bd919615a2664d4515fd442b5f147d7500218702473044022056b705267661cef83c72b179e9a2e50f115127b9ed6f25e760bde9c5927501b2022069f205974d6384928ba7cbaf00da3cd33cb27589f0560d822dd53788cb76ae9b012102a82a20fbab79a0f4628c0256bead3444422ad99a721e69d97d254a77be715ddf00000000",
"01000000000101a19b89486c6d413db237c069c913698d1dd049070b157f5dea8b30ea904cb132020000001716001488662a7c62fd438e16149360e4c9797c0f577587fdffffff02e80300000000000017a914a042ea3d101129bfcc91b72a00dda6738be7aa14879d6604000000000017a914c587bd919615a2664d4515fd442b5f147d7500218702483045022100ec8d0cdadb0262764aeb6bf83ed0a82671dadb687a2317b5a29c218b9f34372302207ea3a5dd64be15575c58d4f6f042c3c7f70cd9bf830720f920544ccd0a181a60012102a82a20fbab79a0f4628c0256bead3444422ad99a721e69d97d254a77be715ddf00000000"
]
Array of pre-signed transactions that signal for RBF with different fees.
Properties
None
PSTjson
{
"rawtxs": [
"01000000000101a19b89486c6d413db237c069c913698d1dd049070b157f5dea8b30ea904cb132020000001716001488662a7c62fd438e16149360e4c9797c0f577587fdffffff02e80300000000000017a914a042ea3d101129bfcc91b72a00dda6738be7aa1487896904000000000017a914c587bd919615a2664d4515fd442b5f147d7500218702473044022056b705267661cef83c72b179e9a2e50f115127b9ed6f25e760bde9c5927501b2022069f205974d6384928ba7cbaf00da3cd33cb27589f0560d822dd53788cb76ae9b012102a82a20fbab79a0f4628c0256bead3444422ad99a721e69d97d254a77be715ddf00000000",
"01000000000101a19b89486c6d413db237c069c913698d1dd049070b157f5dea8b30ea904cb132020000001716001488662a7c62fd438e16149360e4c9797c0f577587fdffffff02e80300000000000017a914a042ea3d101129bfcc91b72a00dda6738be7aa14879d6604000000000017a914c587bd919615a2664d4515fd442b5f147d7500218702483045022100ec8d0cdadb0262764aeb6bf83ed0a82671dadb687a2317b5a29c218b9f34372302207ea3a5dd64be15575c58d4f6f042c3c7f70cd9bf830720f920544ccd0a181a60012102a82a20fbab79a0f4628c0256bead3444422ad99a721e69d97d254a77be715ddf00000000"
]
}
JSON with a pre-signed transactions array (PSTarray) and other optional information.
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
rawtxs | PSTarray | false | none | Array of pre-signed transactions that signal for RBF with different fees. |
TrackData
{
"id": "R9RJJBLz8Kd",
"status": "ACTIVE",
"target": 1594752720,
"delay": 1594732720,
"created": 1594702720,
"mempool": "0629bc8c86d3dd72d883ee6aa78c0b39034327b54ef6ff0763545fa162b5e33f",
"parents": ["ZUaGsJZvLGq", "WQPF9bHeny7"],
"childs": ["cWc31ibkoxE"],
"events": [
{
"type": "BROADCAST",
"subtype": "EXTERNAL_BROADCAST",
"timestamp": 1594742720345
}
]
}
contains information about a request.
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
id | string | false | none | id of the request. |
status | string | false | none | Status of the request. |
target | integer | false | none | deadline for first confirmation as an epoch timestamp in seconds. |
delay | integer | false | none | Epoch timestamp in seconds until which the first broadcast should be delayed. A value of 0 means "don't delay at all", a value of 1 means "delay as bitpost sees fit". |
created | integer | false | none | Epoch timestamp in milliseconds of when the request was originally received. |
mempool | string(txid) | false | none | Current mempool transaction (if any) that is part of the reques. |
parents | [string] | false | none | array of requestID of the parent requests (if any). |
childs | [string] | false | none | array of requestID of the chils requests (if any). |
events | [Event] | false | none | none |
Enumerated Values
Property | Value |
---|---|
status | COMPLETE |
status | ACTIVE |
status | CANCELLED |
Event
{
"type": "BROADCAST",
"subtype": "EXTERNAL_BROADCAST",
"timestamp": 1594742720345
}
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
type | string | false | none | type of event |
subtype | string | false | none | subtype of event (if any) |
timestamp | integer | false | none | epoch timestamp in milliseconds indicanting when the event occured. |
SignatureProof
{
"signature": "H2w8lDM5dPYu/gHD/yPZglUgMHKy1V/Ov/mEijgtkjp8B7KxEZh2S2PH9lKkjt5SV5bD/zLtJAq6ozAL4sv8ej8=",
"publickey": "03348b681d8e60730b070dffb88b870f5c51b0dad3e8fcac80c932bad75493ec88"
}
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
signature | string(base64) | false | none | Signature of the message "bitpost" appended with the current second epoch divided by 1000 (eg. "bitpost1594735"). The sighash should be prepared as in bitcoin core. More info - https://docs.bitpost.co/child-requests.html#retrieving-a-token |
publickey | string(hex) | false | none | compressed or uncompressed public key used for the signature and whose ownership wants to be proven. |
GroupChangeData
{
"used": [
{
"txid": "0629bc8c86d3dd72d883ee6aa78c0b39034327b54ef6ff0763545fa162b5e33f",
"vout": 0
}
],
"groupsize": 2,
"change": [
{
"id": "R9RJJBLz8Kd",
"target": 1594752720,
"broadcasts": 3,
"minamout": 0.01259,
"utxos": [
{
"txid": "0629bc8c86d3dd72d883ee6aa78c0b39034327b54ef6ff0763545fa162b5e33f",
"vout": 0,
"scriptPubKey": "76a9148f8978cc74c8d76325eef60aed31b5dbab5884ac88ac",
"amount": 0.06354
}
]
}
],
"verification": {
"05c2ba4a2633a6c5cbec0dc1397b08dbee7b7e2c92ccb95d89f193f61c7a7814": "02000000019f7dd31db699d0528c6659b3862f94e5d3ad4af07a62922b0e3f589fd811c710030000006a473044022064d1ad37bf080f7855904142d93d4e9462f74970688e47a7a0f080933b9cd13c02205c5fe2843d0f7886eeb2104b5fc945005b1fc1e5fc78866c75b217dc1b367b7101210359c83da5f7a1aa0a397e4eb72a698e1a6e80f63c26d49450f79719b3a1f2f580fdffffff029fad5b00000000001976a9145a34ea9f68fc08f668e2838e0484243b99582b4288ac21a969000000000017a914d74f1f37106a8ee3f581197530c67344d00fe214872cc10900"
}
}
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
used | [Outpoint] | false | none | Confirmed UTXOs used by the request group given as an array of outpoints. |
groupsize | integer | false | none | number of requests in the request group. |
change | [ChangeData] | false | none | array with change UTXOs of every child request. |
verification | object | false | none | Transactions as txid:hex pair. |
» additionalProperties | string | false | none | none |
ChangeData
{
"id": "R9RJJBLz8Kd",
"target": 1594752720,
"broadcasts": 3,
"minamout": 0.01259,
"utxos": [
{
"txid": "0629bc8c86d3dd72d883ee6aa78c0b39034327b54ef6ff0763545fa162b5e33f",
"vout": 0,
"scriptPubKey": "76a9148f8978cc74c8d76325eef60aed31b5dbab5884ac88ac",
"amount": 0.06354
}
]
}
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
id | string | false | none | id of request. |
target | integer | false | none | deadline for first confirmation as an epoch timestamp in seconds. |
broadcasts | integer | false | none | number of transactions already broadcasted in this request. |
minamout | number | false | none | minimum amount of change for the whole set of utxos. |
utxos | [UTXO] | false | none | none |
UTXO
{
"txid": "0629bc8c86d3dd72d883ee6aa78c0b39034327b54ef6ff0763545fa162b5e33f",
"vout": 0,
"scriptPubKey": "76a9148f8978cc74c8d76325eef60aed31b5dbab5884ac88ac",
"amount": 0.06354
}
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
txid | string(hex) | false | none | txid of the transaction that contains the UTXO. |
vout | integer | false | none | index of the UTXO in the output array of the transaction. |
scriptPubKey | string | false | none | none |
amount | number | false | none | none |
Outpoint
{
"txid": "0629bc8c86d3dd72d883ee6aa78c0b39034327b54ef6ff0763545fa162b5e33f",
"vout": 0
}
Properties
Name | Type | Required | Restrictions | Description |
---|---|---|---|---|
txid | string(hex) | false | none | txid of the transaction that contains the UTXO. |
vout | integer | false | none | index of the UTXO in the output array of the transaction. |