Create and start a wallet and add to store.
Request Body schema: application/jsonrequired
Data to start the wallet
wallet-id required | string Defines the key of wallet that future requests will need to use as a reference. |
passphrase | string Passphrase of the wallet that will be created. |
seedKey required | string Key of the corresponding seed in the config file to create the wallet. |
seed | string 24-words seed separated with spaces. This parameter is incompatible with seedKey. Either seed or seedKey are required. |
xpubkey | string Account level xpubkey. This will be used to start wallet on readonly mode. |
multisig | boolean Start as a multisig wallet. Requires multisig configuration. |
multisigKey | string Key of the multisig wallet data in the config. This allow wallets to be started without a seedKey, e.g. with the seed on the parameters or from an xpubkey. |
scanPolicy | string Default: "gap-limit" Enum: "gap-limit" "index-limit" Address scanning policy to use. |
gapLimit | number Gap limit to use when scanning addresses. Only used when scanPolicy is set to 'gap-limit'. If not given the configured default will apply. |
policyStartIndex | number Default: 0 Load addresses starting from this index. Only used when scanPolicy is set to 'index-limit'. |
policyEndIndex | number Stop loading addresses at this index. Only used when scanPolicy is set to 'index-limit'. Defaults to policyStartIndex |
Responses
Request samples
- Payload
{- "wallet-id": "123",
- "passphrase": "Test",
- "seedKey": "default"
}
Response samples
- 200
{- "success": true
}
Create and start a read-only wallet through an HSM, then add it to store.
Request Body schema: application/jsonrequired
Data to start the wallet
wallet-id required | string Define the key of the corresponding wallet it will be executed the request. |
hsm-key required | string Key name containing the BIP32 xPriv on the HSM device. |
Responses
Request samples
- Payload
{- "wallet-id": "hardware-wallet-1",
- "hsm-key": "hathor_wallet_1"
}
Response samples
- 200
{- "success": true
}
Get MultiSig xpub for a seed.
Request Body schema: application/jsonrequired
seedKey required | string Key of the corresponding seed in the config file to create the wallet. |
passphrase | string Passphrase of the wallet. |
Responses
Request samples
- Payload
{- "seedKey": "default",
- "passphrase": "Test"
}
Response samples
- 200
{- "success": true,
- "xpubkey": "xpub...."
}
Return the balance of HTR
query Parameters
token | string Token uid. Optional parameter to get the balance from a token different than HTR. |
header Parameters
x-wallet-id required | string Defines the key of the wallet on which the request will be executed. |
Responses
Response samples
- 200
{- "available": 2,
- "locked": 0
}
Return the current address
query Parameters
mark_as_used | boolean Mark the current address as used. So, it will return a new address in the next call. |
index | integer Get the address in this specific derivation path index. |
header Parameters
x-wallet-id required | string Defines the key of the wallet on which the request will be executed. |
Responses
Response samples
- 200
{- "address": "H8bt9nYhUNJHg7szF32CWWi1eB8PyYZnbt"
}
Return all generated addresses of the wallet.
header Parameters
x-wallet-id required | string Defines the key of the wallet on which the request will be executed. |
Responses
Response samples
- 200
{- "addresses": [
- "H8bt9nYhUNJHg7szF32CWWi1eB8PyYZnbt",
- "HPxB4dKccUWbECh1XMWPEgZVZP2EC34BbB"
]
}
Send a transaction to exactly one output.
header Parameters
x-wallet-id required | string Defines the key of the wallet on which the request will be executed. |
Request Body schema: application/jsonrequired
Data to create the transaction
address required | string Address to send the tokens. |
value required | integer The value parameter must be an integer with the value in cents, i.e., 123 means 1.23 HTR. |
token | string Token uid to send the transaction, just in case is not HTR. |
object [DEPRECATED] Token to send the transaction, just in case is not HTR. This parameter is old and still works for compatibility reasons but will be removed soon, you should use the string format. | |
change_address | string Optional address to send the change amount. |
Responses
Request samples
- Payload
{- "address": "Wk2j7odPbC4Y98xKYBCFyNogxaRimU6BUj",
- "value": 100,
- "token": "006e18f3c303892076a12e68b5c9c30afe9a96a528f0f3385898001858f9c35d"
}
Response samples
- 200
{- "success": false,
- "error": "Token HTR: Insufficient amount of tokens"
}
Decode tx hex or serialized partial tx into human readable inputs and outputs with metadata to assist informed decision-making. To obtain input metadata, this method retrieves a transaction per input from the wallet's transaction history. If the required transaction is not located, the method queries the fullnode for the transaction details.
Request Body schema: application/jsonrequired
Transaction hex representation or a partial transaction serialization.
txHex | string Hex format of a Transaction instance. |
partial_tx | string Serialized PartialTx instance. |
Responses
Request samples
- Payload
{- "txHex": "string",
- "partial_tx": "string"
}
Response samples
- 200
{- "success": true,
- "tx": {
- "completeSignatures": false,
- "tokens": [ ],
- "outputs": [
- {
- "decoded": {
- "address": "Wk2j7odPbC4Y98xKYBCFyNogxaRimU6BUj",
- "timelock": null
}, - "token": "00",
- "value": 100,
- "tokenData": 0,
- "token_data": 0,
- "script": "dqkUISAnpOn9Vo269QBvOfBeWJTLx82IrA==",
- "type": "p2sh",
- "mine": true
}
], - "inputs": [
- {
- "decoded": {
- "type": "MultiSig",
- "address": "Wk2j7odPbC4Y98xKYBCFyNogxaRimU6BUj",
- "timelock": null
}, - "txId": "006e18f3c303892076a12e68b5c9c30afe9a96a528f0f3385898001858f9c35d",
- "index": 0,
- "token": "00",
- "value": 100,
- "tokenData": 0,
- "token_data": 0,
- "script": "dqkUISAnpOn9Vo269QBvOfBeWJTLx82IrA==",
- "signed": false,
- "mine": true
}
]
}, - "balance": {
- "00": {
- "tokens": {
- "available": 0,
- "locked": 0
}, - "authorities": {
- "melt": {
- "available": 0,
- "locked": 0
}, - "mint": {
- "available": 0,
- "locked": 0
}
}
}
}
}
Build a transaction with many outputs without sending. Will not include signatures.
header Parameters
x-wallet-id required | string Defines the key of the wallet on which the request will be executed. |
Request Body schema: application/jsonrequired
Data to create the transaction
required | Array of objects Outputs to create the transaction. |
Array of objects Inputs to create the transaction. | |
change_address | string Optional address to send the change amount. |
Responses
Request samples
- Payload
{- "outputs": [
- {
- "address": "Wk2j7odPbC4Y98xKYBCFyNogxaRimU6BUj",
- "value": 100,
- "token": "006e18f3c303892076a12e68b5c9c30afe9a96a528f0f3385898001858f9c35d"
}
], - "inputs": [
- {
- "hash": "006e18f3c303892076a12e68b5c9c30afe9a96a528f0f3385898001858f9c35d",
- "index": 0
}
]
}
Response samples
- 200
{- "success": false,
- "error": "Token HTR: Insufficient amount of tokens"
}
Get the hex representation of a melt tokens transaction without input data.
header Parameters
x-wallet-id required | string Defines the key of the wallet on which the request will be executed. |
Request Body schema: application/jsonrequired
Data to melt tokens.
token required | string UID of the token to melt. |
amount required | integer The amount of tokens to melt. It must be an integer with the value in cents, i.e., 123 means 1.23. |
deposit_address | string Optional deposit_address to send the deposit HTR received after the melt. |
change_address | string Optional address to send the change amount of custom tokens after melt. |
melt_authority_address | string Optional address to send the new melt authority output created. |
allow_external_melt_authority_address | boolean If the melt authority address is allowed to be from another wallet. Default is false. |
Responses
Request samples
- Payload
{- "token": "000016392ed330ed99ff0f74e4169a8d257fd1d07d3b38c4f8ecf21a78f10efa",
- "amount": 100
}
Response samples
- 200
{- "success": false,
- "error": "There aren't enough tokens in the inputs to melt."
}
Add signatures to the transaction and return the txHex with the signatures.
header Parameters
x-wallet-id required | string Defines the key of the wallet on which the request will be executed. |
Request Body schema: application/jsonrequired
Transaction hex and signatures
txHex required | string Transaction hex representation. |
required | Array of objects Signatures collected for the transaction. |
Responses
Request samples
- Payload
{- "txHex": "string",
- "signatures": [
- {
- "index": 0,
- "data": "string"
}
]
}
Response samples
- 200
{- "success": true,
- "txHex": "0123abc..."
}
Push a transaction from the txHex.
header Parameters
x-wallet-id required | string Defines the key of the wallet on which the request will be executed. |
Request Body schema: application/jsonrequired
Signed transaction hex
txHex required | string Transaction hex representation. |
Responses
Request samples
- Payload
{- "txHex": "string"
}
Response samples
- 200
{- "success": true,
- "tx": {
- "hash": "00000000059dfb65633acacc402c881b128cc7f5c04b6cea537ea2136f1b97fb",
- "nonce": 2455281664,
- "timestamp": 1594955941,
- "version": 1,
- "weight": 18.11897634891149,
- "parents": [
- "00000000556bbfee6d37cc099a17747b06f48ca3d9bf4af85c707aa95ad04b3f",
- "00000000e2e3e304e364edebff1c04c95cc9ef282463295f6e417b85fec361dd"
], - "inputs": [
- {
- "tx_id": "00000000caaa37ab729805b91af2de8174e3ef24410f4effc4ffda3b610eae65",
- "index": 1,
- "data": "RjBEAiAYR8jc+zqY596QyMp+K3Eag3kQB5aXdfYja19Fa17u0wIgCdhBQpjlBiAawP/9WRAqAzW85CJlBpzq+YVhUALg8IUhAueFQuEkAo+s2m7nj/hnh0nyphcUuxa2LoRBjOsEOHRQ"
}, - {
- "tx_id": "00000000caaa37ab729805b91af2de8174e3ef24410f4effc4ffda3b610eae65",
- "index": 2,
- "data": "RzBFAiEAofVXnCKNCEu4GRk7j+wHpQM6qmezRcfxHCe/PcUdbegCIE2nip27ZQtkpkEgNEhycqHM4CkLYMLVUgskphYsd/M9IQLHG6YJxXifQ6eMxPHbINFEJAUvrzKWe9V7AXXW4iywjg=="
}
], - "outputs": [
- {
- "value": 100,
- "token_data": 0,
- "script": "dqkUqdK8VisGSJuNItIBRYFfSHfHjPeIrA=="
}, - {
- "value": 200,
- "token_data": 0,
- "script": "dqkUISAnpOn9Vo269QBvOfBeWJTLx82IrA=="
}
], - "tokens": [ ]
}
}
Identify which inputs on the transaction are from the loaded wallet.
query Parameters
txHex required | string Transaction hex to identify. |
header Parameters
x-wallet-id required | string Defines the key of the wallet on which the request will be executed. |
Responses
Response samples
- 200
{- "inputs": [
- {
- "inputIndex": 0,
- "addressIndex": 1,
- "addressPath": "m/44'/280'/0'/0/1"
}
]
}
Build an input data from the ECDSA signature(s).
header Parameters
x-wallet-id required | string Defines the key of the wallet on which the request will be executed. |
Request Body schema: application/jsonrequired
Data required to build the input data
index required | number The bip32 path address index we will use. |
signature | string [P2PKH] The ECDSA signature in little endian, DER encoded in hex format. |
signatures | object [P2SH] Each key will be the signer xpubkey as used on the multisig configuration, the value will be the signature (ECDSA little endian, DER encoded in hex format). |
Responses
Request samples
- Payload
{- "index": 0,
- "signature": "string",
- "signatures": { }
}
Response samples
- 200
{- "success": true,
- "inputData": "abc123..."
}
Get the hex representation of a transaction without input data.
header Parameters
x-wallet-id required | string Defines the key of the wallet on which the request will be executed. |
Request Body schema: application/jsonrequired
Data to create the transaction
required | Array of objects Outputs to create the transaction. |
Array of objects Inputs to create the transaction. | |
change_address | string Optional address to send the change amount. |
Responses
Request samples
- Payload
{- "outputs": [
- {
- "address": "Wk2j7odPbC4Y98xKYBCFyNogxaRimU6BUj",
- "value": 100,
- "token": "006e18f3c303892076a12e68b5c9c30afe9a96a528f0f3385898001858f9c35d"
}
], - "inputs": [
- {
- "txId": "006e18f3c303892076a12e68b5c9c30afe9a96a528f0f3385898001858f9c35d",
- "index": 0
}
]
}
Response samples
- 200
{- "success": false,
- "error": "Token HTR: Insufficient amount of tokens"
}
Get the hex representation of a create a token transaction without input data.
header Parameters
x-wallet-id required | string Defines the key of the wallet on which the request will be executed. |
Request Body schema: application/jsonrequired
Data to create the token.
name required | string Name of the token. |
symbol required | string Symbol of the token. |
amount required | integer The amount of tokens to mint. It must be an integer with the value in cents, i.e., 123 means 1.23. |
address | string Optional destination address of the minted tokens. |
change_address | string Optional address to send the change amount. |
create_mint | boolean If should create mint authority for the created token. Default is true. |
mint_authority_address | string Optional address to send the mint authority output created. |
allow_external_mint_authority_address | boolean If the mint authority address is allowed to be from another wallet. Default is false. |
create_melt | boolean If should create melt authority for the created token. Default is true. |
melt_authority_address | string Optional address to send the melt authority output created. |
allow_external_melt_authority_address | boolean If the melt authority address is allowed to be from another wallet. Default is false. |
Responses
Request samples
- Payload
{- "name": "Test Coin",
- "symbol": "TSC",
- "amount": 100
}
Response samples
- 200
{- "success": false,
- "error": "Don't have enough HTR funds to mint this amount."
}
Get the hex representation of a mint tokens transaction without input data.
header Parameters
x-wallet-id required | string Defines the key of the wallet on which the request will be executed. |
Request Body schema: application/jsonrequired
Data to mint tokens.
token required | string UID of the token to mint. |
amount required | integer The amount of tokens to mint. It must be an integer with the value in cents, i.e., 123 means 1.23. |
address | string Optional destination address of the minted tokens. |
change_address | string Optional address to send the change amount. |
create_mint | boolean If should create another mint authority for the created token. Default is true. |
mint_authority_address | string Optional address to send the new mint authority output created. |
allow_external_mint_authority_address | boolean If the mint authority address is allowed to be from another wallet. Default is false. |
Responses
Request samples
- Payload
{- "token": "0000073b972162f70061f61cf0082b7a47263cc1659a05976aca5cd01b3351ee",
- "amount": 100
}
Response samples
- 200
{- "success": false,
- "error": "Don't have enough HTR funds to mint this amount."
}
Get the signatures for all inputs from the wallet
header Parameters
x-wallet-id required | string Defines the key of the wallet on which the request will be executed. |
Request Body schema: application/jsonrequired
Transaction hex representation
txHex required | string Transaction hex representation. |
Responses
Request samples
- Payload
{- "txHex": "string"
}
Response samples
- 200
{- "success": true,
- "signatures": "..."
}
Returns a transaction hex with input data calculated from the arguments
header Parameters
x-wallet-id required | string Defines the key of the wallet on which the request will be executed. |
Request Body schema: application/jsonrequired
Transaction hex and signatures
txHex required | string Transaction hex representation. |
signatures | Array of arrays Signatures collected for the transaction. |
Responses
Request samples
- Payload
{- "txHex": "string",
- "signatures": [ ]
}
Response samples
- 200
{- "success": true,
- "txHex": "0123abc..."
}
Send a transaction from the transaction hex and collected signatures
header Parameters
x-wallet-id required | string Defines the key of the wallet on which the request will be executed. |
Request Body schema: application/jsonrequired
Transaction hex and signatures
txHex required | string Transaction hex representation. |
signatures | Array of arrays Signatures collected for the transaction. |
Responses
Request samples
- Payload
{- "txHex": "string",
- "signatures": [ ]
}
Response samples
- 200
{- "success": true,
- "hash": "00000000059dfb65633acacc402c881b128cc7f5c04b6cea537ea2136f1b97fb",
- "nonce": 2455281664,
- "timestamp": 1594955941,
- "version": 1,
- "weight": 18.11897634891149,
- "parents": [
- "00000000556bbfee6d37cc099a17747b06f48ca3d9bf4af85c707aa95ad04b3f",
- "00000000e2e3e304e364edebff1c04c95cc9ef282463295f6e417b85fec361dd"
], - "inputs": [
- {
- "tx_id": "00000000caaa37ab729805b91af2de8174e3ef24410f4effc4ffda3b610eae65",
- "index": 1,
- "data": "RjBEAiAYR8jc+zqY596QyMp+K3Eag3kQB5aXdfYja19Fa17u0wIgCdhBQpjlBiAawP/9WRAqAzW85CJlBpzq+YVhUALg8IUhAueFQuEkAo+s2m7nj/hnh0nyphcUuxa2LoRBjOsEOHRQ"
}, - {
- "tx_id": "00000000caaa37ab729805b91af2de8174e3ef24410f4effc4ffda3b610eae65",
- "index": 2,
- "data": "RzBFAiEAofVXnCKNCEu4GRk7j+wHpQM6qmezRcfxHCe/PcUdbegCIE2nip27ZQtkpkEgNEhycqHM4CkLYMLVUgskphYsd/M9IQLHG6YJxXifQ6eMxPHbINFEJAUvrzKWe9V7AXXW4iywjg=="
}
], - "outputs": [
- {
- "value": 100,
- "token_data": 0,
- "script": "dqkUqdK8VisGSJuNItIBRYFfSHfHjPeIrA=="
}, - {
- "value": 200,
- "token_data": 0,
- "script": "dqkUISAnpOn9Vo269QBvOfBeWJTLx82IrA=="
}
], - "tokens": [ ]
}
Create or update an atomic-swap proposal.
header Parameters
x-wallet-id required | string Defines the key of the wallet on which the request will be executed. |
Request Body schema: application/jsonrequired
Data to create the proposal
partial_tx | string A proposal to update. If not present a new one will be created. |
object Create outputs receiving the tokens as described in this parameter. | |
object Create inputs to send tokens from this wallet as described here. May add change outputs if needed. | |
lock | boolean Default: true If the utxos chosen for this proposal should be locked so they are not spent on another call. Use with caution. |
change_address | string Optional address to send the change amount. |
object Property containing references for this proposal on the Atomic Swap Service |
Responses
Request samples
- Payload
{- "send": {
- "tokens": [
- {
- "value": 10,
- "token": "006e18f3c303892076a12e68b5c9c30afe9a96a528f0f3385898001858f9c35d"
}, - {
- "value": 100,
- "token": "00"
}
]
}
}
Response samples
- 200
{- "success": false,
- "error": "Token HTR: Insufficient amount of tokens"
}
Get this wallet signatures for a proposal.
header Parameters
x-wallet-id required | string Defines the key of the wallet on which the request will be executed. |
Request Body schema: application/jsonrequired
Get the requested wallet's signatures for an atomic-swap.
partial_tx required | string Proposal to sign. |
Responses
Request samples
- Payload
{- "partial_tx": "PartialTx|..."
}
Response samples
- 200
{- "success": true,
- "signatures": "PartialTxInputData|..."
}
Registers a proposal for the Headless Wallet to listen to and interact with the Atomic Swap Service
path Parameters
proposalId required | string Proposal identifier on the Atomic Swap Service |
header Parameters
x-wallet-id required | string Defines the key of the wallet on which the request will be executed. |
Request Body schema: application/jsonrequired
Request the registration of a proposal id with the service.
password required | string Proposal password on the Atomic Swap Service. |
Responses
Request samples
- Payload
{- "password": "abc123"
}
Response samples
- 200
{- "success": {
- "summary": "Successful registration",
- "value": {
- "success": true
}
}
}
Fetches a proposal data from the Atomic Swap Service
path Parameters
proposalId required | string Registered proposal identifier |
header Parameters
x-wallet-id required | string Defines the key of the wallet on which the request will be executed. |
Responses
Response samples
- 200
{- "success": {
- "summary": "Successful fetch",
- "value": {
- "success": true,
- "proposal": {
- "proposalId": "1a574e6c-73...",
- "version": 1,
- "timestamp": "Fri Mar 10 2023 23:13:...",
- "partialTx": "PartialTx|000100010...",
- "signatures": null,
- "history": [ ]
}
}
}
}
Fetches the list of listened proposals for this wallet
header Parameters
x-wallet-id required | string Defines the key of the wallet on which the request will be executed. |
Responses
Response samples
- 200
{- "success": {
- "summary": "Successful listing",
- "value": {
- "success": true,
- "proposals": [
- "1a574e6c-73...",
- "85585de5-67..."
]
}
}
}
Removes a proposal from the registered listened proposals
path Parameters
proposalId required | string Registered proposal identifier |
header Parameters
x-wallet-id required | string Defines the key of the wallet on which the request will be executed. |
Responses
Response samples
- 200
{- "success": {
- "summary": "Successful removal",
- "value": {
- "success": true
}
}
}
Add signatures to a proposal and return the signed transaction in hex format.
header Parameters
x-wallet-id required | string Defines the key of the wallet on which the request will be executed. |
Request Body schema: application/jsonrequired
Add signatures and return the txHex of the resulting transaction.
partial_tx required | string Proposal to add signatures. |
signatures required | Array of strings Signatures to add. |
object Property containing references for this proposal on the Atomic Swap Service |
Responses
Request samples
- Payload
{- "partial_tx": "PartialTx|...",
- "signatures": [
- "PartialTxInputData|...",
- "PartialTxInputData|..."
]
}
Response samples
- 200
{- "success": true,
- "txHex": "0123..."
}
Add signatures to a proposal and push the signed transaction.
header Parameters
x-wallet-id required | string Defines the key of the wallet on which the request will be executed. |
Request Body schema: application/jsonrequired
Add signatures and push the resulting transaction.
partial_tx required | string Proposal to add signatures. |
signatures required | Array of strings Signatures to add. |
Responses
Request samples
- Payload
{- "partial_tx": "PartialTx|...",
- "signatures": [
- "PartialTxInputData|...",
- "PartialTxInputData|..."
]
}
Response samples
- 200
{- "success": true,
- "tx": {
- "hash": "00001bc7043d0aa910e28aff4b2aad8b4de76c709da4d16a48bf713067245029",
- "nonce": 33440807,
- "timestamp": 1579656120,
- "version": 1,
- "weight": 16.827294220302488,
- "parents": [
- "000036e846dee9f58a724543cf5ee14cf745286e414d8acd9563963643f8dc34",
- "000000fe2da5f4cc462e8ccaac8703a38cd6e4266e227198f003dd5c68092d29"
], - "inputs": [
- {
- "tx_id": "000000fe2da5f4cc462e8ccaac8703a38cd6e4266e227198f003dd5c68092d29",
- "index": 0,
- "data": "RzBFAiEAyKKbtzdH7FjvjUopHFIXBf+vBcH+2CKirp0mEnLjjvMCIA9iSuW4B/UJMQld+c4Ch5lIwAcTbzisNUaCs+JpK8yDIQI2CLavb5spKwIEskxaVu0B2Tp52BXas3yjdX1XeMSGyw=="
}
], - "outputs": [
- {
- "value": 1,
- "token_data": 0,
- "script": "dqkUtK1DlS8IDGxtJBtRwBlzFWihbIiIrA=="
}
], - "tokens": [ ]
}
}
Unlock all inputs if they are marked as selected on the wallet storage.
header Parameters
x-wallet-id required | string Defines the key of the wallet on which the request will be executed. |
Request Body schema: application/jsonrequired
Unlock the inputs on the proposal.
partial_tx required | string Proposal to unlock. |
Responses
Request samples
- Payload
{- "partial_tx": "PartialTx|..."
}
Response samples
- 200
{- "success": true
}
Get all utxos marked selected as input on a transaction to be sent.
header Parameters
x-wallet-id required | string Defines the key of the wallet on which the request will be executed. |
Responses
Response samples
- 200
{- "success": true,
- "locked_utxos": [
- {
- "tx_id": "006e18f3c303892076a12e68b5c9c30afe9a96a528f0f3385898001858f9c35d",
- "outputs": [
- 0,
- 1
]
}
]
}
Extract input data from a txHex in an atomic-swap compliant format.
header Parameters
x-wallet-id required | string Defines the key of the wallet on which the request will be executed. |
Request Body schema: application/jsonrequired
Extract the input data on the given txHex as an atomic-swap signature.
txHex required | string Transaction hex to extract input data. |
Responses
Request samples
- Payload
{- "txHex": "0123..."
}
Response samples
- 200
{- "success": true,
- "signatures": "PartialTxInputData|..."
}
Send a transaction with many outputs.
header Parameters
x-wallet-id required | string Defines the key of the wallet on which the request will be executed. |
Request Body schema: application/jsonrequired
Data to create the transaction
required | Array of objects Outputs to create the transaction. |
Array of objects Inputs to create the transaction. | |
object Deprecated [DEPRECATED] Token to send the transaction, just in case is not HTR. This parameter is old and will be deprecated soon, you must preferably use the token parameter in the output object. | |
change_address | string Optional address to send the change amount. |
Responses
Request samples
- Payload
{- "outputs": [
- {
- "address": "Wk2j7odPbC4Y98xKYBCFyNogxaRimU6BUj",
- "value": 100,
- "token": "006e18f3c303892076a12e68b5c9c30afe9a96a528f0f3385898001858f9c35d"
}
], - "inputs": [
- {
- "hash": "006e18f3c303892076a12e68b5c9c30afe9a96a528f0f3385898001858f9c35d",
- "index": 0
}
]
}
Response samples
- 200
{- "success": false,
- "error": "Token HTR: Insufficient amount of tokens"
}
Create a token.
header Parameters
x-wallet-id required | string Defines the key of the wallet on which the request will be executed. |
Request Body schema: application/jsonrequired
Data to create the token.
name required | string Name of the token. |
symbol required | string Symbol of the token. |
amount required | integer The amount of tokens to mint. It must be an integer with the value in cents, i.e., 123 means 1.23. |
address | string Destination address of the minted tokens. |
change_address | string Optional address to send the change amount. |
create_mint | boolean If should create mint authority for the created token. Default is true. |
mint_authority_address | string Optional address to send the mint authority output created. |
allow_external_mint_authority_address | boolean If the mint authority address is allowed to be from another wallet. Default is false. |
create_melt | boolean If should create melt authority for the created token. Default is true. |
melt_authority_address | string Optional address to send the melt authority output created. |
allow_external_melt_authority_address | boolean If the melt authority address is allowed to be from another wallet. Default is false. |
data | Array of strings List of utf-8 encoded strings to create a data output for each. |
Responses
Request samples
- Payload
{- "name": "Test Coin",
- "symbol": "TSC",
- "amount": 100
}
Response samples
- 200
{- "success": false,
- "error": "Don't have enough HTR funds to mint this amount."
}
Mint tokens.
header Parameters
x-wallet-id required | string Defines the key of the wallet on which the request will be executed. |
Request Body schema: application/jsonrequired
Data to mint tokens.
token required | string UID of the token to mint. |
address required | string Destination address of the minted tokens. |
amount required | integer The amount of tokens to mint. It must be an integer with the value in cents, i.e., 123 means 1.23. |
change_address | string Optional address to send the change amount. |
mint_authority_address | string Optional address to send the new mint authority output created. |
allow_external_mint_authority_address | boolean If the mint authority address is allowed to be from another wallet. Default is false. |
Responses
Request samples
- Payload
{- "token": "006e18f3c303892076a12e68b5c9c30afe9a96a528f0f3385898001858f9c35d",
- "address": "Wk2j7odPbC4Y98xKYBCFyNogxaRimU6BUj",
- "amount": 100
}
Response samples
- 200
{- "success": false,
- "error": "Don't have enough HTR funds to mint this amount."
}
Melt tokens.
header Parameters
x-wallet-id required | string Defines the key of the wallet on which the request will be executed. |
Request Body schema: application/jsonrequired
Data to melt tokens.
token required | string UID of the token to melt. |
amount required | integer The amount of tokens to melt. It must be an integer with the value in cents, i.e., 123 means 1.23. |
change_address | string Optional address to send the change amount of custom tokens after melt. |
deposit_address | string Optional address to send the deposit HTR received after the melt. |
melt_authority_address | string Optional address to send the new melt authority output created. |
allow_external_melt_authority_address | boolean If the melt authority address is allowed to be from another wallet. Default is false. |
Responses
Request samples
- Payload
{- "token": "006e18f3c303892076a12e68b5c9c30afe9a96a528f0f3385898001858f9c35d",
- "amount": 100
}
Response samples
- 200
{- "success": false,
- "error": "There aren't enough inputs to melt."
}
Create an NFT.
header Parameters
x-wallet-id required | string Defines the key of the wallet on which the request will be executed. |
Request Body schema: application/jsonrequired
Data to create the token.
name required | string Name of the token. |
symbol required | string Symbol of the token. |
amount required | integer The amount of tokens to mint. It must be an integer. |
data required | string NFT data for the first output of the transaction. |
address | string Destination address of the minted tokens. |
change_address | string Optional address to send the change amount. |
create_mint | boolean If should create mint authority for the created NFT. Default is false. |
mint_authority_address | string Optional address to send the mint authority output created. |
allow_external_mint_authority_address | boolean If the mint authority address is allowed to be from another wallet. Default is false. |
create_melt | boolean If should create melt authority for the created NFT. Default is false. |
melt_authority_address | string Optional address to send the melt authority output created. |
allow_external_melt_authority_address | boolean If the melt authority address is allowed to be from another wallet. Default is false. |
Responses
Request samples
- Payload
{- "name": "Test Coin",
- "symbol": "TSC",
- "amount": 100,
- "data": "ipfs://ipfs/myNFTHash/filename"
}
Response samples
- 200
{- "success": false,
- "error": "Don't have enough HTR funds to mint this amount."
}
Return the data of a transaction, if it exists in the wallet
query Parameters
id required | string Transaction id (hash) to get data. |
header Parameters
x-wallet-id required | string Defines the key of the wallet on which the request will be executed. |
Responses
Response samples
- 200
{- "tx_id": "0000340349f9342c4e5eda6f818697f6c1748a81e2ff4b67bc2211d7f8761b11",
- "version": 1,
- "timestamp": 1578430704,
- "is_voided": false,
- "inputs": [
- {
- "value": 1,
- "token_data": 0,
- "script": "dqkU98E1NAiRn3fV4nBm1S3e5pPssF+IrA==",
- "decoded": {
- "type": "P2PKH",
- "address": "HV78k3MkUmt6no59cV1kCJzo2CfPXGNmRv",
- "timelock": null
}, - "token": "00",
- "tx_id": "00000a6d244e17e22969f2c2ef339a557bc96540bbbef1350c26c445291e5430",
- "index": 1
}, - {
- "value": 2,
- "token_data": 0,
- "script": "dqkUje1HF10tIOWS36q73Rpbud3BcAyIrA==",
- "decoded": {
- "type": "P2PKH",
- "address": "HKTZujeJEBeM22UmRWkuKJaDnzbAfFzwRe",
- "timelock": null
}, - "token": "00",
- "tx_id": "0000276ec988df605b56072065f1b9f2395966a3c7c17c692078b2bca43fad8c",
- "index": 1
}
], - "outputs": [
- {
- "value": 3,
- "token_data": 0,
- "script": "dqkUJdUWQm2UfnCXkwoSj7/2SNmjt5+IrA==",
- "decoded": {
- "type": "P2PKH",
- "address": "H9yAeyxwA7zbpovZZTkpqWJZYsE4hHnvmP",
- "timelock": null
}, - "token": "00",
- "spent_by": "000008d7e62d394be9b07c0fe9c69b289e44dbe1350e2100c169fc030ac936ff"
}
], - "parents": [
- "0000276ec988df605b56072065f1b9f2395966a3c7c17c692078b2bca43fad8c",
- "00000a6d244e17e22969f2c2ef339a557bc96540bbbef1350c26c445291e5430"
]
}
Return the number of blocks confirming the transaction, if it exists in the wallet
query Parameters
id required | string Transaction id (hash) to get blocks confirmation number. |
header Parameters
x-wallet-id required | string Defines the key of the wallet on which the request will be executed. |
Responses
Response samples
- 200
{- "success": true,
- "confirmationNumber": 15
}
Return the transaction history
query Parameters
limit | integer Sort and return only the quantity in limit. |
header Parameters
x-wallet-id required | string Defines the key of the wallet on which the request will be executed. |
Responses
Response samples
- 200
{- "0000340349f9342c4e5eda6f818697f6c1748a81e2ff4b67bc2211d7f8761b11": {
- "tx_id": "0000340349f9342c4e5eda6f818697f6c1748a81e2ff4b67bc2211d7f8761b11",
- "version": 1,
- "timestamp": 1578430704,
- "is_voided": false,
- "inputs": [
- {
- "value": 1,
- "token_data": 0,
- "script": "dqkU98E1NAiRn3fV4nBm1S3e5pPssF+IrA==",
- "decoded": {
- "type": "P2PKH",
- "address": "HV78k3MkUmt6no59cV1kCJzo2CfPXGNmRv",
- "timelock": null
}, - "token": "00",
- "tx_id": "00000a6d244e17e22969f2c2ef339a557bc96540bbbef1350c26c445291e5430",
- "index": 1
}, - {
- "value": 2,
- "token_data": 0,
- "script": "dqkUje1HF10tIOWS36q73Rpbud3BcAyIrA==",
- "decoded": {
- "type": "P2PKH",
- "address": "HKTZujeJEBeM22UmRWkuKJaDnzbAfFzwRe",
- "timelock": null
}, - "token": "00",
- "tx_id": "0000276ec988df605b56072065f1b9f2395966a3c7c17c692078b2bca43fad8c",
- "index": 1
}
], - "outputs": [
- {
- "value": 3,
- "token_data": 0,
- "script": "dqkUJdUWQm2UfnCXkwoSj7/2SNmjt5+IrA==",
- "decoded": {
- "type": "P2PKH",
- "address": "H9yAeyxwA7zbpovZZTkpqWJZYsE4hHnvmP",
- "timelock": null
}, - "token": "00",
- "spent_by": "000008d7e62d394be9b07c0fe9c69b289e44dbe1350e2100c169fc030ac936ff"
}
], - "parents": [
- "0000276ec988df605b56072065f1b9f2395966a3c7c17c692078b2bca43fad8c",
- "00000a6d244e17e22969f2c2ef339a557bc96540bbbef1350c26c445291e5430"
]
}, - "0000276ec988df605b56072065f1b9f2395966a3c7c17c692078b2bca43fad8c": {
- "tx_id": "0000276ec988df605b56072065f1b9f2395966a3c7c17c692078b2bca43fad8c",
- "version": 1,
- "timestamp": 1578430668,
- "is_voided": false,
- "inputs": [
- {
- "value": 4398,
- "token_data": 0,
- "script": "dqkUfZRahPx5JF7l8qFzwVjiV1tmhweIrA==",
- "decoded": {
- "type": "P2PKH",
- "address": "HHy8a7QvQmj727beKFuiYziGb7mi7CdrG3",
- "timelock": null
}, - "token": "00",
- "tx_id": "00000a6d244e17e22969f2c2ef339a557bc96540bbbef1350c26c445291e5430",
- "index": 0
}
], - "outputs": [
- {
- "value": 4396,
- "token_data": 0,
- "script": "dqkUJdUWQm2UfnCXkwoSj7/2SNmjt5+IrA==",
- "decoded": {
- "type": "P2PKH",
- "address": "H9yAeyxwA7zbpovZZTkpqWJZYsE4hHnvmP",
- "timelock": null
}, - "token": "00",
- "spent_by": "00000174753194de2affba45874ef36c92e0ae270442f2410207cf2ee3d06950"
}, - {
- "value": 2,
- "token_data": 0,
- "script": "dqkUje1HF10tIOWS36q73Rpbud3BcAyIrA==",
- "decoded": {
- "type": "P2PKH",
- "address": "HKTZujeJEBeM22UmRWkuKJaDnzbAfFzwRe",
- "timelock": null
}, - "token": "00",
- "spent_by": "0000340349f9342c4e5eda6f818697f6c1748a81e2ff4b67bc2211d7f8761b11"
}
], - "parents": [
- "00000a6d244e17e22969f2c2ef339a557bc96540bbbef1350c26c445291e5430",
- "000009fe61f75076b0c1abde1ee1881e4886bad80a09e699cb599b538934ce33"
]
}
}
Return utxos and some helpful information regarding it.
query Parameters
max_utxos | integer Maximum number of utxos to return. Default to MAX_INPUTS (255) |
token | string Token to filter the utxos. If not sent, we select only HTR utxos. |
filter_address | string Address to filter the utxos. |
amount_smaller_than | integer Maximum limit of utxo amount to filter the utxos list. We will return only utxos that have an amount lower than this value. Integer representation of decimals, i.e. 100 = 1.00. |
amount_bigger_than | integer Minimum limit of utxo amount to filter the utxos list. We will return only utxos that have an amount bigger than this value. Integer representation of decimals, i.e. 100 = 1.00. |
maximum_amount | integer Limit the maximum total amount to return summing all utxos. Integer representation of decimals, i.e. 100 = 1.00. |
only_available_utxos | boolean Get only available utxos, ignoring locked ones. Defaults to false. |
header Parameters
x-wallet-id required | string Defines the key of the wallet on which the request will be executed. |
Responses
Response samples
- 200
{- "total_amount_available": 12000,
- "total_utxos_available": 2,
- "total_amount_locked": 6000,
- "total_utxos_locked": 1,
- "utxos": [
- {
- "address": "HNnK9wgUVL6Cjzs1K3jpoGgqQTXCqpAnW8",
- "amount": 6000,
- "tx_id": "00fff7a3c6eb95ec3343bffcfca9a3a0d3e243462ae7de1f200cdd76716140fb",
- "locked": false,
- "index": 0
}, - {
- "address": "WYiD1E8n5oB9weZ8NMyM3KoCjKf1KCjWAZ",
- "amount": 6000,
- "tx_id": "0000002e785a6ab7cb9a863f66a862c86ca418025c92ef3bb9a7174d7fa31a20",
- "locked": true,
- "index": 0
}, - {
- "address": "WYiD1E8n5oB9weZ8NMyM3KoCjKf1KCjWAZ",
- "amount": 6000,
- "tx_id": "0000002940428f55b1bdc9346b6b253e4a904bd45cc129736028b32c1e9e5d23",
- "locked": false,
- "index": 0
}
]
}
Consolidates utxos to a given address.
header Parameters
x-wallet-id required | string Defines the key of the wallet on which the request will be executed. |
Request Body schema: application/jsonrequired
Data to consolidate utxos.
destination_address required | string Recipient to the consolidated utxos. |
max_utxos | integer Maximum number of utxos to aggregate. Default to MAX_INPUTS (255) |
token | string Token to filter the utxos. If not sent, we select only HTR utxos. |
filter_address | string Address to filter the utxos. |
amount_smaller_than | integer Maximum limit of utxo amount to filter the utxos list. We will consolidate only utxos that have an amount lower than this value. Integer representation of decimals, i.e. 100 = 1.00. |
amount_bigger_than | integer Minimum limit of utxo amount to filter the utxos list. We will consolidate only utxos that have an amount bigger than this value. Integer representation of decimals, i.e. 100 = 1.00. |
maximum_amount | integer Limit the maximum total amount to consolidate summing all utxos. Integer representation of decimals, i.e. 100 = 1.00. |
Responses
Request samples
- Payload
{- "destination_address": "HNnK9wgUVL6Cjzs1K3jpoGgqQTXCqpAnW8"
}
Response samples
- 200
{- "success": true,
- "total_utxos_consolidated": 8,
- "total_amount": 140800,
- "utxos": [
- {
- "address": "HNnK9wgUVL6Cjzs1K3jpoGgqQTXCqpAnW8",
- "amount": 96000,
- "tx_id": "00dc85e6c5e35525f3e85edebff3905267b48c190c21eaeec6e8e655fcbb5744",
- "locked": false,
- "index": 0
}, - {
- "address": "HNnK9wgUVL6Cjzs1K3jpoGgqQTXCqpAnW8",
- "amount": 6400,
- "tx_id": "0000000330f14db1af211f5f0210b3ccc4cb69bc1e7fff19b1e96e8f6b93292b",
- "locked": false,
- "index": 0
}, - {
- "address": "HNnK9wgUVL6Cjzs1K3jpoGgqQTXCqpAnW8",
- "amount": 6400,
- "tx_id": "00000012442813722351ab01bbc79bba992fffd16fa066764e491ffd0dbfe87e",
- "locked": false,
- "index": 0
}, - {
- "address": "HNnK9wgUVL6Cjzs1K3jpoGgqQTXCqpAnW8",
- "amount": 6400,
- "tx_id": "0000003b34abcb64fcc2999493f66d355bd853110a1a959d35856e598bc80568",
- "locked": false,
- "index": 0
}, - {
- "address": "HNnK9wgUVL6Cjzs1K3jpoGgqQTXCqpAnW8",
- "amount": 6400,
- "tx_id": "000000233f187b10ba54b093e0b4f391b27ce747e70f01d573d75ea31e8678a8",
- "locked": false,
- "index": 0
}, - {
- "address": "HNnK9wgUVL6Cjzs1K3jpoGgqQTXCqpAnW8",
- "amount": 6400,
- "tx_id": "0000000097cf83a6937199ece5d3ac96cfad239fcb142acc083789eb0c31d3e6",
- "locked": false,
- "index": 0
}, - {
- "address": "HNnK9wgUVL6Cjzs1K3jpoGgqQTXCqpAnW8",
- "amount": 6400,
- "tx_id": "0000003b6e6ab2cc751dc736a6a1502eeb2ecca48741f78c52bc27c04bf01412",
- "locked": false,
- "index": 0
}, - {
- "address": "HNnK9wgUVL6Cjzs1K3jpoGgqQTXCqpAnW8",
- "amount": 6400,
- "tx_id": "0000002b145f03de21c841b8e47c019989e16cafa55754bbea8bde00e5170f80",
- "locked": false,
- "index": 0
}
]
}
Get information of a given address.
query Parameters
address required | string Address to get information of |
token | string Filter the information to a custom token or HTR (default: HTR) |
header Parameters
x-wallet-id required | string Defines the key of the wallet on which the request will be executed. |
Responses
Response samples
- 200
{- "success": true,
- "total_amount_received": 9299200,
- "total_amount_sent": 6400,
- "total_amount_available": 9292800,
- "total_amount_locked": 0,
- "token": "00",
- "index": 0
}
Get state of a nano contract.
query Parameters
id required | string ID of the nano contract to get the state from. |
fields[] | Array of strings Examples:
List of fields to retrieve the state. |
balances[] | Array of strings Examples:
List of balances to retrieve from contract. |
calls[] | Array of strings Examples:
List of private method calls to execute and get result in the contract. |
header Parameters
x-wallet-id required | string Define the key of the corresponding wallet it will be executed the request. |
Responses
Response samples
- 200
{- "success": true,
- "nc_id": "3cb032600bdf7db784800e4ea911b10676fa2f67591f82bb62628c234e771595",
- "blueprint_name": "Bet",
- "fields": {
- "token_uid": {
- "value": "00"
}, - "total": {
- "value": 300
}, - "final_result": {
- "value": "1x0"
}, - "oracle_script": {
- "value": "76a91441c431ff7ad5d6ce5565991e3dcd5d9106cfd1e288ac"
}, - "withdrawals.a'Wi8zvxdXHjaUVAoCJf52t3WovTZYcU9aX6'": {
- "value": 300
}, - "address_details.a'Wi8zvxdXHjaUVAoCJf52t3WovTZYcU9aX6'": {
- "value": {
- "1x0": 100
}
}
}
}
Get the history of a nano contract.
query Parameters
id required | string ID of the nano contract to get the history from. |
count | integer Maximum number of items to be returned. Default is 100. |
after | string Hash of transaction to offset the result. |
header Parameters
x-wallet-id required | string Define the key of the corresponding wallet it will be executed the request. |
Responses
Response samples
- 200
{- "success": true,
- "count": 100,
- "history": {
- "hash": "5c02adea056d7b43e83171a0e2d226d564c791d583b32e9a404ef53a2e1b363a",
- "nonce": 0,
- "timestamp": 1572636346,
- "version": 4,
- "weight": 1,
- "signal_bits": 0,
- "parents": [
- "1234",
- "5678"
], - "inputs": [ ],
- "outputs": [ ],
- "metadata": {
- "hash": "5c02adea056d7b43e83171a0e2d226d564c791d583b32e9a404ef53a2e1b363a",
- "spent_outputs": [ ],
- "received_by": [ ],
- "children": [ ],
- "conflict_with": [ ],
- "voided_by": [ ],
- "twins": [ ],
- "accumulated_weight": 1,
- "score": 0,
- "height": 0,
- "min_height": 0,
- "feature_activation_bit_counts": null,
- "first_block": null,
- "validation": "full"
}, - "tokens": [ ],
- "nc_id": "5c02adea056d7b43e83171a0e2d226d564c791d583b32e9a404ef53a2e1b363a",
- "nc_method": "initialize",
- "nc_args": "0004313233340001000004654d8749",
- "nc_pubkey": "033f5d238afaa9e2218d05dd7fa50eb6f9e55431e6359e04b861cd991ae24dc655"
}
}
Get the oracle data.
query Parameters
oracle required | string The address in base58 that will be used as oracle or the oracle data itself in hex (in this case, it will just be returned the same). |
header Parameters
x-wallet-id required | string Define the key of the corresponding wallet it will be executed the request. |
Responses
Response samples
- 200
{- "success": true,
- "oracleData": "12345678"
}
Get the result signed by the oracle. Returns the string of the argument to be used in the method.
query Parameters
oracle_data required | string The oracle data. If it's not an address, we expect the full input data. |
required | string or integer or number or boolean The result to be signed. If the type is bytes, then we expect it in hex. |
type required | string The type of the result. |
header Parameters
x-wallet-id required | string Define the key of the corresponding wallet it will be executed the request. |
Responses
Response samples
- 200
{- "success": true,
- "oracleData": "12345678:1x0:str"
}
Create a nano contract of a blueprint.
header Parameters
x-wallet-id required | string Define the key of the corresponding wallet it will be executed the request. |
Request Body schema: application/jsonrequired
Data to create the nano contract.
blueprint_id required | string Blueprint ID of the new nano contract. |
address required | string Address caller that will sign the nano contract creation transaction. |
required | object Data of the method for the nano contract. |
Responses
Request samples
- Payload
{- "blueprint_id": "1234abcd",
- "address": "H8bt9nYhUNJHg7szF32CWWi1eB8PyYZnbt",
- "data": {
- "args": [
- "abc",
- "1234abcd"
], - "actions": [
- {
- "type": "deposit",
- "token": "00",
- "amount": 100
}, - {
- "type": "withdrawal",
- "token": "00",
- "amount": 100,
- "address": "H8bt9nYhUNJHg7szF32CWWi1eB8PyYZnbt"
}
]
}
}
Response samples
- 200
{- "success": true,
- "count": 100,
- "history": {
- "hash": "5c02adea056d7b43e83171a0e2d226d564c791d583b32e9a404ef53a2e1b363a",
- "nonce": 0,
- "timestamp": 1572636346,
- "version": 4,
- "weight": 1,
- "signal_bits": 0,
- "parents": [
- "1234",
- "5678"
], - "inputs": [ ],
- "outputs": [ ],
- "metadata": {
- "hash": "5c02adea056d7b43e83171a0e2d226d564c791d583b32e9a404ef53a2e1b363a",
- "spent_outputs": [ ],
- "received_by": [ ],
- "children": [ ],
- "conflict_with": [ ],
- "voided_by": [ ],
- "twins": [ ],
- "accumulated_weight": 1,
- "score": 0,
- "height": 0,
- "min_height": 0,
- "feature_activation_bit_counts": null,
- "first_block": null,
- "validation": "full"
}, - "tokens": [ ],
- "nc_id": "5c02adea056d7b43e83171a0e2d226d564c791d583b32e9a404ef53a2e1b363a",
- "nc_method": "initialize",
- "nc_args": "0004313233340001000004654d8749",
- "nc_pubkey": "033f5d238afaa9e2218d05dd7fa50eb6f9e55431e6359e04b861cd991ae24dc655"
}
}
Execute a nano contract method.
header Parameters
x-wallet-id required | string Define the key of the corresponding wallet it will be executed the request. |
Request Body schema: application/jsonrequired
Data to execute the nano contract method.
nc_id required | string ID of the nano contract that will have the method executed. |
method required | string Method to execute in the nano contract object. |
address required | string Address caller that will sign the nano contract transaction. |
required | object Data of the method for the nano contract. |
Responses
Request samples
- Payload
{- "nc_id": "1234abcd",
- "method": "method_name",
- "address": "H8bt9nYhUNJHg7szF32CWWi1eB8PyYZnbt",
- "data": {
- "args": [
- "abc",
- "1234abcd"
], - "actions": [
- {
- "type": "deposit",
- "token": "00",
- "amount": 100
}, - {
- "type": "withdrawal",
- "token": "00",
- "amount": 100,
- "address": "H8bt9nYhUNJHg7szF32CWWi1eB8PyYZnbt"
}
]
}
}
Response samples
- 200
{- "success": true,
- "count": 100,
- "history": {
- "hash": "5c02adea056d7b43e83171a0e2d226d564c791d583b32e9a404ef53a2e1b363a",
- "nonce": 0,
- "timestamp": 1572636346,
- "version": 4,
- "weight": 1,
- "signal_bits": 0,
- "parents": [
- "1234",
- "5678"
], - "inputs": [ ],
- "outputs": [ ],
- "metadata": {
- "hash": "5c02adea056d7b43e83171a0e2d226d564c791d583b32e9a404ef53a2e1b363a",
- "spent_outputs": [ ],
- "received_by": [ ],
- "children": [ ],
- "conflict_with": [ ],
- "voided_by": [ ],
- "twins": [ ],
- "accumulated_weight": 1,
- "score": 0,
- "height": 0,
- "min_height": 0,
- "feature_activation_bit_counts": null,
- "first_block": null,
- "validation": "full"
}, - "tokens": [ ],
- "nc_id": "5c02adea056d7b43e83171a0e2d226d564c791d583b32e9a404ef53a2e1b363a",
- "nc_method": "method_name",
- "nc_args": "0004313233340001000004654d8749",
- "nc_pubkey": "033f5d238afaa9e2218d05dd7fa50eb6f9e55431e6359e04b861cd991ae24dc655"
}
}
Get configuration string of a token.
query Parameters
token required | string Token to get the configuration string. |
Responses
Response samples
- 200
{- "success": true,
- "configurationString": "[Test 1:TST1:007c9d497135e10dcba984f0b893804d7cb06721c800064cfbe05fafc138faca:5dd518cc]"
}
Return the health of the wallet headless.
query Parameters
wallet_ids | string Wallet ids to check, comma-separated. If not provided, will not check any wallet. |
include_fullnode | boolean Whether fullnode health should be checked and included in the response. |
include_tx_mining | boolean Whether tx mining service health should be checked and included in the response. |
Responses
Response samples
- 200
- 400
- 503
{- "status": "pass",
- "description": "Wallet-headless health",
- "checks": {
- "Wallet <wallet-id>": [
- {
- "status": "pass",
- "componentType": "internal",
- "componentName": "Wallet <wallet-id>",
- "output": "Wallet is ready"
}
], - "Wallet <wallet-id-2>": [
- {
- "status": "pass",
- "componentType": "internal",
- "componentName": "Wallet <wallet-id-2>",
- "output": "Wallet is ready"
}
], - "fullnode": [
- {
- "status": "pass",
- "componentType": "fullnode",
- "componentName": "Fullnode <fullnode_url>",
- "output": "Fullnode is responding"
}
], - "txMining": [
- {
- "status": "pass",
- "componentType": "service",
- "componentName": "TxMiningService <tx_mining_url>",
- "output": "Tx Mining Service is healthy"
}
]
}
}
Load more addresses by pushing the end index of a wallet configured to index-limit scanning policy.
header Parameters
x-wallet-id required | string Defines the key of the wallet on which the request will be executed. |
Request Body schema: application/jsonrequired
Count of addresses to load.
count required | integer Count of addresses to load. |
Responses
Request samples
- Payload
{- "count": 10
}
Response samples
- 200
{- "success": true
}
Set the last address index of a wallet configured to index-limit scanning policy.
header Parameters
x-wallet-id required | string Defines the key of the wallet on which the request will be executed. |
Request Body schema: application/jsonrequired
Set the last loaded index on a wallet configured to index-limit scanning policy.
index required | integer Last address index to set. |
Responses
Request samples
- Payload
{- "index": 150
}
Response samples
- 200
{- "success": true
}