The Signum API

Signum API Documentation & Examples

*Examples follow each API request.

Description

The Signum API allows interaction with Signum nodes using HTTP requests to port 8125. Most HTTP requests can use either the GET or POST methods, but some API calls accept only the POST method for security reasons. Responses are returned as JSON objects.

Each API call is documented below, with definitions given for HTTP request parameters and JSON response fields, followed by an example:

The JSON response fields are each preceded by one of the following: S for ‘string’, A for ‘array’, O for ‘object’, N for ‘number’, or B for ‘boolean’. Note: This is a documentation convention only. These notations are not part of the API responses.
In the examples, the Signum node is represented as localhost and requests and responses are formatted for easy reading; line breaks and spaces are not used except in some parameter values. All requests are in URL format, which implies the HTTP GET method. When GET is allowed, the URL can be entered into a browser URL field, but proper URL encoding is usually required (e.g., spaces in a parameter value must be replaced by + or %20). Otherwise, the URL should be used as a guide to preparing an HTTP POST request using cURL, for example.

All API calls can be viewed and tested on the TestNet at https://wallet.dev.burst-test.net/test.

For specific API calls, use the ‘GET’ URL https://wallet.dev.burst-test.net/burst?requestType=specificRequestType.

Examples of Signum API calls follow each API call section.

Many API calls can be viewed and tested on the MainNet at: https://europe1.signum.network/

For specific API calls, use the ‘GET’ URL https://europe1.signum.network/burst?=specificRequestType

https://europe1.signum.network/burst?requestType=getAccountBlockIds&account=17001464071916561838&lastIndex=5

Genesis Block

Many API requests make reference to the Genesis Block.

Request:

https://europe1.signum.network/burst?requestType=getBlock&block=3444294670862540038

Response:

{“block”:”3444294670862540038″,”height”:0,”generator”:”8628161281313630310″,”generatorRS”:”S-NU58-Z4QR-XXKE-94DHH”,”generatorPublicKey”:”0000000000000000000000000000000000000000000000000000000000000000″,”nonce”:”0″,”scoopNum”:1689,”timestamp”:0,”numberOfTransactions”:0,”totalAmountNQT”:”0″,”totalFeeNQT”:”0″,”blockRewardNQT”:”0″,”blockReward”:”0″,”payloadLength”:0,”version”:-1,”baseTarget”:”18325193796″,”averageCommitmentNQT”:”100000000000″,”nextBlock”:”1265146016099430888″,”payloadHash”:”e3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855″,”generationSignature”:”0000000000000000000000000000000000000000000000000000000000000000″,”blockSignature”:”00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000″,”transactions”:[],”requestProcessingTime”:1}

See “Get Block” in Block Operations below.

Flexible Account IDs

All API requests that require an account ID accept either an account number or the corresponding Reed-Solomon Address.

Quantity Units Signa, NQT and QNT

The Signum system has a currency Signa used to quantify value in the system. Like all currencies, Signa circulates in the system, moving from one user to another by payments and purchases. Also, a small fee is required for every transaction, including those in which no Signa is transferred, such as simple messages. This fee goes to the owner of the node that forges (generates) the new block containing the transaction that is accepted onto the blockchain.

Yet internally, the currency is still stored in integer form in units of NQT or NxtQuant, where 1 Signa = 10⁸ NQT. All parameters and fields in the API involving a quantity of Signa are denominated in units of NQT, for example, feeNQT. The only exception is the field effectiveBalanceNXT, used in forging calculations.

Other assets can be created within Signum using Issue Asset API call.

The issuer must specify the number of decimal places to use in quantifying the asset, and the amount of the asset to create in generic units of QNT or Quant, distinct from NQT. Quantities of assets are stored internally as integers in units of QNT, and assets are priced in NQT per QNT.

Decimal (Signa)	Canonical Name	Alternate Name	NQT
1.00000000	SIGNA	Signa	100,000,000
0.01000000	cBURST	Bessie	1,000,000
0.00100000	mBURST	–	100,000
0.00001000	–	Maybel	1,000
0.00000100	uBURST	–	100
0.00000001	–	Planck	1
0.12345678	digit reference	–	–

Creating Unsigned Transactions

All API requests that create a new transaction will accept either a secretPhrase or a publicKey parameter:

If secretPhrase is supplied, a transaction is created, signed at the server, and broadcast by the server as usual.
If only a publicKey parameter is supplied as a 64-digit (32-byte) hex string, the transaction will be prepared by the server and returned in the JSON response as transactionJSON without a signature. This JSON object along with secretPhrase can then be supplied to Sign Transaction as unsignedTransactionJSON and the resulting signed transactionJSON can then be supplied to Broadcast Transaction. This sequence allows for offline transaction signing so that secretPhrase never needs to be exposed.
unsignedTransactionBytes may be used instead of unsigned transactionJSON when there is no encrypted message. Messages to be encrypted require the secretPhrase for encryption and so cannot be included in unsignedTransactionBytes.

Escrow Operations

All API requests that create a new transaction will accept an optional referencedTransactionFullHash parameter which creates a chained transaction, meaning that the new transaction cannot be confirmed unless the referenced transaction is also confirmed. This feature allows a simple way of transaction escrow:

Alice prepares and signs a transaction A, but doesn’t broadcast it by setting the broadcast parameter to false. She sends to Bob the unsignedTransactionBytes, the fullHash of the transaction, and the signatureHash. All of those are included in the JSON returned by the API request. (Warning: make sure not to send the signed transactionBytes, or the signature itself, as then Bob can just broadcast transaction A himself).
Bob prepares, signs and broadcasts transaction B, setting the referencedTransactionFullHash parameter to the fullHash of A provided by Alice. He can verify that this hash indeed belongs to the transaction he expects from Alice, by using Calculate Full Hash, which takes unsignedTransactionBytes and signatureHash (both of which Alice has also sent to Bob).
Transaction B is accepted in the unconfirmed transaction pool, but as long as A is still missing, B will not be confirmed, i.e. will not be included in the blockchain. If A is never submitted, B will eventually expire — so Bob should make sure to set a long enough deadline, such as the maximum of 1440 minutes.
Once in the unconfirmed transactions pool, Bob has no way of recalling B back. So now Alice can safely submit her transaction A, by just broadcasting the signedTransactionBytes she got in the first step. Transaction A will get included in the blockchain first, and in the next block, Bob’s transaction B will be included.

Note that while the above scheme is good enough for a simple escrow, the blockchain does not enforce that if A is included, B will also be included. It may happen due to forks and blockchain reorganization, that B never gets a chance to be included and expires unconfirmed, while A still remains in the blockchain. However, it is not practically possible for Bob to intentionally cause such a chain of events and to prevent B from being confirmed.

Prunable Data

Note: The following is legacy information from NXT. Signum does not have this functionality. This information will be adapted to Signum or archived.

Nxtinformation is legacy Prunable data can be removed from the blockchain without affecting the integrity of the blockchain. When a transaction containing prunable data is created, only the 32-byte sha256 hash of the prunable data is included in the transactionBytes, not the prunable data itself. The non-prunable signed transactionBytes are used to verify the signature and to generate the transaction’s fullHash and ID; when the prunable part of the transaction is removed at a later time, none of these operations are affected.

Prunable data has a predetermined minimum lifetime of two weeks (24 hours on the Testnet) from the timestamp of the transaction. Transactions and blocks received from peer nodes are not accepted if prunable data is missing before this time has elapsed. After this time has elapsed, prunable data is no longer included with transactions and blocks transmitted to peer nodes, and is no longer included in the transaction JSON returned by general-purpose API calls such as Get Transaction; the only way to retrieve it, if still available, is through special-purpose API calls such as Get Prunable Message.

Expired prunable data remains stored in the blockchain until removed at the same time derived tables are trimmed, which occurs automatically every 1000 blocks by default.

Prunable data can be preserved on a node beyond the predetermined minimum lifetime by setting the nxt.maxPrunableLifetime property to a larger value than two weeks or to -1 to preserve it indefinitely. To force the node to include such preserved prunable data when transactions and blocks are transmitted to peer nodes, set the nxt.includeExpiredPrunables property to true, thus making it an archival node.

Currently, there is only one variety of prunable data in the Signum system: prunable Arbitrary Messages. It has a maximum prunable data length of 42 kilobytes.

Properties Files

The behavior of some API calls is affected by property settings loaded from files in the brs/conf directory during Signum server intialization. This directory contains the brs-default.properties and logging-default.properties files, both of which contain default property settings along with documentation. A few of the property settings can be obtained while the server is running through the Get Blockchain Status and Get State calls.

It is recommended not to modify default properties files because they can be overwritten during software updates. Instead, properties in the default files can be overridden by including them in optional brs.properties and logging.properties files in the same directory. For example, a brs.properties file can be created with the content:

DEV.TestNet = yes

This causes the Signum server to connect to the TestNet instead of the MainNet.

Create Transaction

The following API calls create Signum transactions using HTTP POST requests. Follow the links for examples and HTTP POST request parameters specific to each call. Refer to the sections below for HTTP POST request parameters (See Create Transactions Request) and JSON response fields (see Create Transactions Response) common to all calls that create transactions.

Set Account Info

Set Account Info
Buy / Sell Alias
Set Alias
Send Message
Cancel Order
Issue Asset
Place Order
Transfer Asset
DGS Delisting
DGS Delivery
DGS Feedback
DGS Listing
DGS Purchase
DGS Quantity Change
DGS Refund
Lease Balance

Create Transaction Request

The following HTTP POST parameters are common to all API calls that create transactions:

secretPhrase is the secret passphrase of the account (optional, but transaction neither signed nor broadcast if omitted)
publicKey is the public key of the account (optional if secretPhrase provided)
feeNQT is the is the fee (in NQT) for the transaction
deadline deadline (in minutes) for the transaction to be confirmed, 1440 minutes maximum
broadcast is set to false to prevent broadcasting the transaction to the network (optional)
message is either UTF-8 text or a string of hex digits (perhaps previously encoded using an arbitrary algorithm) to be converted into a bytecode with a maximum length of one kilobyte
messageIsText is false if the message is a hex string, otherwise the message is text (optional)
messageToEncrypt is either UTF-8 text or a string of hex digits to be compressed and converted into a bytecode with a maximum length of one kilobyte, then encrypted using AES (optional)
messageToEncryptIsText is false if the message to encrypt is a hex string, otherwise, the message to encrypt is text (optional)
encryptedMessageData is already encrypted data which overrides messageToEncrypt if provided (optional)
encryptedMessageNonce is a unique 32-byte number which cannot be reused (optional unless encryptedMessageData is provided)
messageToEncryptToSelf is either UTF-8 text or a string of hex digits to be compressed and converted into a one-kilobyte maximum bytecode then encrypted with AES, then sent to the sending account (optional)
messageToEncryptToSelfIsText is false if the message to self-encrypt is a hex string, otherwise the message to encrypt is text (optional)
encryptToSelfMessageData is already encrypted data which overrides messageToEncryptToSelf if provided (optional)
encryptToSelfMessageNonce is a unique 32-byte number which cannot be reused (optional unless encryptToSelfMessageData is provided)
recipientPublicKey is the public key of the receiving account (optional, enhances the security of a new account)

For feeNQT, please refer to the following “rules”:

minimum 1000 Signa for Issue Asset, unless singleton asset is issued, for which the fee is 1 Signa
2 Signa in base fee for Set Alias, with 2 Signa additional fee for each 32 chars of name plus URI total length, after the first 32 chars
1 Signa for the first 32 bytes of an unencrypted non-prunable message, 1 Signa for each additional 32 bytes
2 Signa for the first 32 bytes of an encrypted non-prunable message, 1 Signa for each additional 32 bytes. The length is measured excluding the nonce and the 16 byte AES initialization vector.
1 Signa for the first 1024 bytes of a prunable message, 0.1 Signa for each additional 1024 prunable bytes
1 Signa for Set Account Info, including 32 chars, with 2 Signa additional fee for each 32 characters
2 Signa for DGS Listing, including 32 chars of name plus description. With 2 Signa additional fee for each 32 characters
1 Signa for DGS Delivery, including 32 bytes of encrypted goods data (AES initialization bytes and nonce excluded). With 2 Signa additional fee for each 32 bytes.
2 Signa for transactions that make use of referencedTransactionFullHash property when creating a new transaction.
Dynamic tx fee otherwise, where 1 Signa = 100000000 NQT

Progressive Tx fee reference
Tx no	Tx fees
1	0.00735
100	0.73500
255	1.87425
510	3.74850
765	5.62275
1020	7.49700

Note: A detailed explanation is available under Signum Transaction Types and Fees.

Note: An optional arbitrary message can be appended to any transaction by adding message-related parameters as in Send Message.

Create Transaction Response

Request:

https://europe1.signum.network/burst?requestType=getState

Response:

{
“numberOfPeers”: 2748,
“numberOfUnlockedAccounts”: 0,
“numberOfTransfers”: 56779,
“numberOfOrders”: 2974,
“numberOfTransactions”: 7528488,
“maxMemory”: 1431830528,
“isScanning”: false,
“cumulativeDifficulty”: “29365339954194811259”,
“numberOfAssets”: 371,
“freeMemory”: 617885288,
“availableProcessors”: 2,
“totalEffectiveBalanceNXT”: 1961368807,
“numberOfAccounts”: 147147,
“numberOfBlocks”: 502799,
“requestProcessingTime”: 6189,
“version”: “2.2.1”,
“numberOfBidOrders”: 397,
“lastBlock”: “10431007917907627236”,
“totalMemory”: 1167589376,
“application”: “BRS”,
“numberOfAliases”: 17008,
“lastBlockchainFeederHeight”: 502798,
“numberOfTrades”: 109663,
“time”: 121621202,
“numberOfAskOrders”: 2577,
“lastBlockchainFeeder”: “169.55.184.235”
}

Get Time

Get the current time.

Get an account ID given a secret passphrase or public key. POST only.

Request:
requestType is getAccountId
secretPhrase is the secret passphrase of the account (optional if publicKey provided)
publicKey is the public key of the account (optional if secretPhrase provided)

Response:

(S) accountRS is the Reed-Solomon address of the account
(S) publicKey is the public key of the account
(N) requestProcessingTime is the API request processing time (in millisec)
(S) account is the account number

Example:

Get Account Id

Request:

https://europe1.signum.network/burst?requestType=getAccountId&secretPhrase=IWontTellYou

Response:

{
“accountRS”: “Signa-L6FM-89WK-VK8P-FCRBB”,
“publicKey”: “57fb6f3a958e320bb49c4e81b4c2cf28b9f25d086c143b473beec228f79ff93c”,
“requestProcessingTime”: 0,
“account”: “15323192282528158131”
}

Get Account Lessors

Get the lessors to an account.

Request:
requestType is getAccountLessors
account is the account ID
height is the height of the blockchain to determine the lessors (option, default is the last block)
Note: If table trimming is enabled (default), the height must be within 1440 blocks of the last block.

Response:

(A) lessors is the array of lessor objects including the fields:

lessorRS (S)
lessor (S)
guaranteedBalanceNQT (S)

(S) accountRS is the Reed-Solomon address of the account
(N) requestProcessingTime is the API request processing time (in millisec)
(S) account is the account number
(N) height is the height of the blockchain

Example:

Request:

https://europe1.signum.network/burst?requestType=getAccountLessors&account=S-GBFG-HVQ4-8AMM-GPCWR

Response:

{
“lessors”: [],
“accountRS”: “S-GBFG-HVQ4-8AMM-GPCWR”,
“requestProcessingTime”: 0,
“account”: “17001464071916561838”,
“height”: 496781
}

Get Account Public Key

Get the public key associated with an account ID.

Request:
requestType is getAccountPublicKey
account is the account ID

Response:

(S) publicKey is the 32-byte public key associated with the account, returned as a hex string
(N) requestProcessingTime is the API request processing time (in millisec)

Example:

Request:

https://europe1.signum.network/burst?requestType=getAccountPublicKey&account=S-GBFG-HVQ4-8AMM-GPCWR’

{

“publicKey”: “f22d8aa787eddbf69caf6f5960f5972a4b73247eb3a9479ddddeda40224aca60”,
“requestProcessingTime”: 1
}

Get Account Transaction Ids

Get the transaction IDs associated with an account in reverse block timestamp order.

Request:
requestType is getAccountTransactionIds
account is the account ID
timestamp is the earliest block (in seconds since the genesis block) to retrieve (optional)
type is the type of transactions to retrieve (optional)
subtype is the subtype of transactions to retrieve (optional)
firstIndex is the a zero-based index to the first transaction ID to retrieve (optional)
lastIndex is the a zero-based index to the last transaction ID to retrieve (optional)
numberOfConfirmations is the required number of confirmations per transaction (optional)
Note: Refer to Get Constants for definitions of types and subtypes

Response:

(A) transactionIds is the array of transaction IDs
(S) lastBlock is the last block ID on the blockchain (applies if requireBlock is provided but not requireLastBlock)
(N) requestProcessingTime is the API request processing time (in millisec)

Example: Refer to Get Account Transaction Ids example. ===Get Account Transactions === Get the transactions associated with an account in reverse block timestamp order.

Request:
requestType is getAccountTransactions
account is the account ID
timestamp is the earliest block (in seconds since the genesis block) to retrieve (optional)
type is the type of transactions to retrieve (optional)
subtype is the subtype of transactions to retrieve (optional)
firstIndex is the a zero-based index to the first transaction ID to retrieve (optional)
lastIndex is the a zero-based index to the last transaction ID to retrieve (optional)
numberOfConfirmations is the required number of confirmations per transaction (optional)

Note: Refer to Get Constants for definitions of types and subtypes

Response:

(A) transaction is the array of transaction (refer to Get Transaction for details)
(N) requestProcessingTime is the API request processing time (in millisec)

Example:

Get Account Transaction Ids

Request:

https://europe1.signum.network/burst?requestType=getAccountTransactionIds&account=S-GBFG-HVQ4-8AMM-GPCWR

Response:

{
“transactionIds”: [
“14471919803527301514”,
“8408429517094397948”,
“7677510357080940908”,
“15605878519502379168”,
“13241821260511921007”,
“16748761036604486700”,
“6521866371443385678”
],
“requestProcessingTime”: 7

Get information regarding an escrow with the escrow transaction ID.

Send Signa to an account. POST only. Refer to Create Transaction Request for common parameters.

Request:
requestType is sendMoney
recipient is the account ID of the recipient.
amountNQT is the amount (in NQT) in the transaction

Response: Refer to Create Transaction Response.

Example:

Request:

https://europe1.signum.network/burst?requestType=sendMoney&secretPhrase=IWontTellYou&recipient=S-GBFG-HVQ4-8AMM-GPCWR&amountNQT=100000000&feeNQT=100000000&deadline=24

Response:

{
“signatureHash”: “b6bb90bac0d529d9ebc6771089f389c976db2a67d76867f7c9d2e1b90e00358a”,
“unsignedTransactionBytes”: “001092812d07180057fb6f3a958e320bb49c4e81b4c2cf28b9f25d086c143b473beec228f79ff93cae2527ec7e55f1eb00e1f5050000000000e1f505*”,
“transactionJSON”: {
“senderPublicKey”: “57fb6f3a958e320bb49c4e81b4c2cf28b9f25d086c143b473beec228f79ff93c”,
“signature”: “3b709a56a9a2308b2364cdb260cc8b08126b8ed13cfe891aa817c28760b0e90f108680db998938fd4747390a0ed9b3b3e25674b849e583dce011155f95ecaa3a”,
“feeNQT”: “100000000”,
“type”: 0,
“fullHash”: “808d5c32b12f4d4b963404c19523b6391ddf7a04a96ec4a495703aeead76c6ff”,
“version”: 1,
“ecBlockId”: “16622227543717857480”,
“signatureHash”: “b6bb90bac0d529d9ebc6771089f389c976db2a67d76867f7c9d2e1b90e00358a”,
“senderRS”: “Signum-L6FM-89WK-VK8P-FCRBB”,
“subtype”: 0,
“amountNQT”: “100000000”,
“sender”: “15323192282528158131”,
“recipientRS”: “Signum-GBFG-HVQ4-8AMM-GPCWR”,
“recipient”: “17001464071916561838”,
“ecBlockHeight”: 497841,
“deadline”: 24,
“transaction”: “5426045564151958912”,
“timestamp”: 120422802,
“height”: 2147483647
},
“broadcasted”: true,
“requestProcessingTime”: 4,
“transactionBytes”: “001092812d07180057fb6f3a958e320bb49c4e81b4c2cf28b9f25d086c143b473beec228f79ff93cae2527ec7e55f1eb00e1f5050000000000e1f505*”,
“fullHash”: “808d5c32b12f4d4b963404c19523b6391ddf7a04a96ec4a495703aeead76c6ff”,
“transaction”: “5426045564151958912”
}

Send Money Multi

Send individual amounts of BURSTCOIN to up to 64 recipients. POST only. Refer to Create Transaction Request for common parameters.

https://europe1.signum.network/burst?requestType=getTransactionBytes&transaction=3120851314369640207

Response:

{
“unsignedTransactionBytes”: “01104ec93f071800a61325eec9e83d7cac55544b8eca8ea8034559bafb5834b8a5d3b6d4efb85f12b31119f931eaa6d4000000000000000018370b*”,
“requestProcessingTime”: 0,
“confirmations”: 7,
“transactionBytes”: “01104ec93f071800a61325eec9e83d7cac55544b8eca8ea8034559bafb5834b8a5d3b6d4efb85f12b31119f931eaa6d4000000000000000018370b*”
}

Parse Transaction

Get a transaction object given a signed transaction bytecode, or re-parse a transaction object. Verify the signature.

Request:
requestType is parseTransaction
transactionBytes is the signed or unsigned bytecode of the transaction (optional)
transactionJSON is the transaction object (optional if transactionBytes is included)

Response: Refer to Get Transaction.

Example:

Request:

https://europe1.signum.network/burst?requestType=parseTransaction&transactionBytes=01104ec93f071800a61325eec9e83d7cac55544b8eca8ea8034559bafb5834b8a5d3b6d4efb85f12b31119f931eaa6d4000000000000000018370b00000000000000000000000000000000000000000000000000000000000000000000000000dc2503584a48e30ac62d62848f58461e0e9ff55070008743c24f380c24a9ef05525c70b5d40962566f3f4de2018277ba7956eb09d0aec84219784de7f3b76f6a0100000003ac07005ac8e8794cc6d21001210000805468697320697320612073656e644d65737361676520415049206578616d706c65

Response:

{
“senderPublicKey”: “a61325eec9e83d7cac55544b8eca8ea8034559bafb5834b8a5d3b6d4efb85f12”,
“signature”: “dc2503584a48e30ac62d62848f58461e0e9ff55070008743c24f380c24a9ef05525c70b5d40962566f3f4de2018277ba7956eb09d0aec84219784de7f3b76f6a”,
“feeNQT”: “735000”,
“requestProcessingTime”: 238,
“type”: 1,
“fullHash”: “0f37d045bc7d4f2bd85cb565a5c4e575464ac387b986f80fb8c31635cf03923e”,
“version”: 1,
“ecBlockId”: “1212249281481197658”,
“signatureHash”: “2bcbafeab7a0bae40337fe34adea84110b1f770a33841c95f3fe9e19dde41bae”,
“attachment”: {
“version.Message”: 1,
“messageIsText”: true,
“message”: “This is a sendMessage API example”
},
“senderRS”: “S-FRDJ-UPLH-MY9A-GUKQP”,
“subtype”: 0,
“amountNQT”: “0”,
“sender”: “16922903237994405232”,
“recipientRS”: “S-L6FM-89WK-VK8P-FCRBB”,
“recipient”: “15323192282528158131”,
“ecBlockHeight”: 502787,
“verify”: true,
“deadline”: 24,
“transaction”: “3120851314369640207”,
“timestamp”: 121620814,
“height”: 2147483647
}

Sign Escrow

Response:

{
“signatureHash”: “c59f26e0b40c306f5ecf0c222a51a83578a9f04165ff27d5f16a4f9f00fc63f7”,
“unsignedTransactionBytes”: “0111a2852d07180057fb6f3a958e320bb49c4e81b4c2cf28b9f25d086c143b473beec228f79ff93c0000000000000000000000000000000000e1f505*”,
“transactionJSON”: {
“senderPublicKey”: “57fb6f3a958e320bb49c4e81b4c2cf28b9f25d086c143b473beec228f79ff93c”,
“signature”: “c27bd8a00b7f8025f7d5054d855d019f939388b1bb52781d9e7d901a81da1a04c726069306f881c2676ae8445cb2bf943465ce32d7daa9fae97a02f597db50b1”,
“feeNQT”: “100000000”,
“type”: 1,
“fullHash”: “ebe26aea6b9996886b245485f6a5005cbd9c4e2584211cf0c5fc16548db7ba29”,
“version”: 1,
“ecBlockId”: “4323691795607025950”,
“signatureHash”: “c59f26e0b40c306f5ecf0c222a51a83578a9f04165ff27d5f16a4f9f00fc63f7”,
“attachment”: {
“alias”: “ApiExample”,
“version.AliasAssignment”: 1,
“uri”: “acct:[email protected]”
},
“senderRS”: “S-L6FM-89WK-VK8P-FCRBB”,
“subtype”: 1,
“amountNQT”: “0”,
“sender”: “15323192282528158131”,
“ecBlockHeight”: 497845,
“deadline”: 24,
“transaction”: “9842222724438221547”,
“timestamp”: 120423842,
“height”: 2147483647
},
“broadcasted”: true,
“requestProcessingTime”: 11,
“transactionBytes”: “0111a2852d07180057fb6f3a958e320bb49c4e81b4c2cf28b9f25d086c143b473beec228f79ff93c0000000000000000000000000000000000e1f505*”,
“transaction”: “9842222724438221547”
}

Get Alias

Get information about a given alias.

Request:
requestType is getAlias
alias is the alias ID (optional)
aliasName is the name of the alias (optional if alias provided)

Response:

(S) aliasURI is the what the alias points to, in URI format
(S) aliasName is the name of the alias
(S) accountRS is the Reed-Solomon address of the account that owns the alias
(S) alias is the alias ID
(N) requestProcessingTime is the API request processing time (in millisec)
(S) account is the number of the account that owns the alias
(N) timestamp is the time (in seconds since the genesis block) when the alias was created or last transferred

Example:

Request:

https://europe1.signum.network/burst?requestType=getAlias&aliasName=AliasTestSell

Response:

{
“aliasURI”: “acct:[email protected]”,
“aliasName”: “AliasTestSell”,
“accountRS”: “S-FRDJ-UPLH-MY9A-GUKQP”,
“alias”: “5747297803058313219”,
“requestProcessingTime”: 1,
“account”: “16922903237994405232”,
“timestamp”: 120675864
}

Get Aliases

Get information on aliases owned by a given account in alias name order.

Request:
requestType is getAliases
timestamp is the earliest creation time (in seconds since the genesis block) of the aliases (optional)
account is the ID of the account that owns the aliases
firstIndex is the zero-based index to the first alias to retrieve (optional)
lastIndex is the zero-based index to the last alias to retrieve (optional)
lastIndex is the zero-based index to the last alias to retrieve (optional)

Get current asset orders given an account ID in reverse block height order.

Request:
requestType is either getAccountCurrentBidOrders or getAccountCurrentAskOrders
account is the account ID
asset is an asset ID filter
firstIndex is a zero-based index to the first order ID to retrieve (optional)
lastIndex is a zero-based index to the last order ID to retrieve (optional)

Response:

(A) bidOrders or askOrders is the array of order objects (refer to Get Order for details)
(N) requestProcessingTime is the API request processing time (in millisec)

Example:

Request:

https://europe1.signum.network/burst?requestType=getAccountCurrentAskOrders&account=9582909050628712440

Response:

{
“askOrders”: [
{
“quantityQNT”: “100000”,
“priceNQT”: “195000”,
“accountRS”: “S-MBZS-2BCT-45QV-APCZB”,
“asset”: “3702027329806229573”,
“type”: “ask”,
“account”: “9582909050628712440”,
“order”: “4875748854378397140”,
“height”: 495658
},
{
“quantityQNT”: “260100”,
“priceNQT”: “200000”,
“accountRS”: “S-MBZS-2BCT-45QV-APCZB”,
“asset”: “3702027329806229573”,
“type”: “ask”,
“account”: “9582909050628712440”,
“order”: “109196327778941945”,
“height”: 494427
}
],
“requestProcessingTime”: 1
}

Get All Assets

Get all assets in the exchange in reverse block height of creation order.

Request:
requestType is getAllAssets
firstIndex is a zero-based index to the first asset to retrieve (optional)
lastIndex is a zero-based index to the last asset to retrieve (optional)

Response:

(A) assets is the array of asset objects (refer to Get Asset)
(N) requestProcessingTime is the API request processing time (in millisec)

Example:

Request:

https://europe1.signum.network/burst?requestType=getAllAssets&firstIndex=373

Response:

{
“assets”: [
{
“quantityQNT”: “10000000000”,
“numberOfAccounts”: 77,
“accountRS”: “S-8E8K-WQ2F-ZDZ5-FQWHX”,
“decimals”: 8,
“numberOfTransfers”: 26,
“name”: “BCPT”,
“description”: “Signum Cryptoport Pool Token, is an asset that backed by profit from MiningPool at http://burst-pool.cryptoport.io, i will pay dividend from 50% fund i got from pool fee (monthly). dividend will be proportional to BCPT owned”,
“numberOfTrades”: 510,
“asset”: “12791182347560578640”,
“account”: “16050713509424738513”
},
{
“quantityQNT”: “100000000”,
“numberOfAccounts”: 26,
“accountRS”: “S-H2ZW-3H4D-RJBS-FCVGV”,
“decimals”: 2,
“numberOfTransfers”: 36,
“name”: “SignumFund”,
“description”: “This asset will act as a stabilizer fund for Signum. This asset aims to assist in maintaining the value of Signum, providing market correction in the event of market manipulation. Each Quantity will be representative of 10 Signum at an initial market price of 0.00001000 each (or determined by asset market). This assets main focus will be ensuring Signum does not become another outdated and dead NXT clone…”,
“numberOfTrades”: 2,
“asset”: “673530795527425458”,
“account”: “15977480701804512252”
}
],
“requestProcessingTime”: 3
}

Get All Open Orders

Get all open bid/ask orders in reverse block height order.

Request:
requestType is either getAllOpenBidOrders or getAllOpenAskOrders
firstIndex is a zero-based index to the first order to retrieve (optional)
lastIndex is a zero-based index to the last order to retrieve (optional)

Response:

(N) requestProcessingTime is the API request processing time (in millisec)
(A) openOrders is the array of order objects (refer to Get Order for details)

Example:

Request:

https://europe1.signum.network/burst?requestType=getAllOpenAskOrders&firstIndex=2577

Response:

{
“requestProcessingTime”: 0,
“openOrders”: [
{
“quantityQNT”: “10”,
“priceNQT”: “10000000000000”,
“accountRS”: “S-359Q-QH73-4N5P-FP54C”,
“asset”: “15295227971848272658”,
“type”: “ask”,
“account”: “15350648744942013686”,
“order”: “14034527401109329159”,
“height”: 17901
},
{
“quantityQNT”: “1”,
“priceNQT”: “10000000000000”,
“accountRS”: “S-Q4TR-YKRW-6RAN-EDBC8”,
“asset”: “11375670541237055652”,
“type”: “ask”,
“account”: “14062819640288676663”,
“order”: “18379469307992717843”,
“height”: 11997
},
{
“quantityQNT”: “4392”,
“priceNQT”: “100000000000”,
“accountRS”: “S-SKL3-ACW8-DBN6-5M8VM”,
“asset”: “11375670541237055652”,
“type”: “ask”,
“account”: “4173943238181013057”,
“order”: “756014781951608408”,
“height”: 11257
}
]
}

Get All Trades

Get all trades since a given timestamp in reverse block height order.

Request:
requestType is getAllTrades
timestamp is the timestamp (in seconds since the genesis block) to begin retrieving trades (optional, default 0)
firstIndex is a zero-based index to the first trade to retrieve (optional)
lastIndex is a zero-based index to the last trade to retrieve (optional)
includeAssetInfo is true if asset information is to be included in the result (optional)

Note: If timestamp is omitted or zero, and no index is given, all trades in the entire blockchain will be retrieved, which may timeout or crash your system.

Response:

(A) trades is the array of trade objects (refer to Get Trades)
(N) requestProcessingTime is the API request processing time (in millisec)

Example:

Request:

https://europe1.signum.network/burst?requestType=getAllTrades&lastIndex=1

Response:

{
“trades”: [
{
“seller”: “2695253629713716937”,
“quantityQNT”: “7700”,
“bidOrder”: “17489219850997945774”,
“sellerRS”: “S-Q7QB-WPPC-6VE2-4QVTC”,
“buyer”: “14676337193484961173”,
“priceNQT”: “100000”,
“askOrder”: “7125231493760146086”,
“buyerRS”: “Signum-EKEP-XEYS-6YPW-EL8DR”,
“decimals”: 2,
“name”: “CryptoMaps”,
“block”: “10810208340839229954”,
“asset”: “3702027329806229573”,
“askOrderHeight”: 504189,
“tradeType”: “sell”,
“timestamp”: 122140342,
“height”: 504949
},
{
“seller”: “6905334832585552856”,
“quantityQNT”: “1000”,
“bidOrder”: “14942960390822608034”,
“sellerRS”: “Signum-BEYS-G8VQ-6SEK-7F7PZ”,
“buyer”: “17808054289263456125”,
“priceNQT”: “66500000”,
“askOrder”: “3461704332885328085”,
“buyerRS”: “Signum-QVVX-2TL8-WZ2C-HDRAG”,
“decimals”: 0,
“name”: “BTFGPool”,
“block”: “9914674296156980645”,
“asset”: “9036920395530551012”,
“askOrderHeight”: 504920,
“tradeType”: “buy”,
“timestamp”: 122132789,
“height”: 504920
}
],
“requestProcessingTime”: 447
}

Get Asset

Get asset information given an asset ID.

Request:
requestType is getAsset
asset is the asset ID

Response:

(S) quantityQNT is the total asset quantity (in QNT) in existence
(N) numberOfAccounts is the number of accounts that own the asset
(S) accountRS is the Reed-Solomon address of the account that issued the asset
(N) decimals is the number of decimal places used by the asset
(N) numberOfTransfers is the number of transfers of this asset
(S) name is the asset name
(S) description is the asset description
(N) numberOfTrades is the number of trades of this asset
(N) requestProcessingTime is the API request processing time (in millisec)
(N) asset is the asset ID
(S) account is the number of the account that issued the asset

Example:

Request:

https://europe1.signum.network/burst?requestType=getAsset&asset=3702027329806229573

Response:

{
“quantityQNT”: “20000000000”,
“numberOfAccounts”: 9210,
“accountRS”: “S-CMAP-ME5N-TFKP-6BCER”,
“decimals”: 2,
“numberOfTransfers”: 11869,
“name”: “CryptoMaps”,
“description”: “The official CryptoMaps Token, see more details at https://token.cryptomaps.me”,
“numberOfTrades”: 523,
“requestProcessingTime”: 0,
“asset”: “3702027329806229573”,
“account”: “5454221553913122069”
}

Get Asset Accounts

Get the accounts that own an asset given the asset ID in reverse quantity order.

Request:
requestType is getAssetAccounts
asset is the asset ID
height is the height of the blockchain to determine the accounts (optional, default is last block)
firstIndex is a zero-based index to the first account to retrieve (optional)
lastIndex is a zero-based index to the last account to retrieve (optional)

Note: If table trimming is enabled (default), the height must be within 1440 blocks of the last block.

Response:

(A) accountAssets is the array of asset objects with the following fields for each asset:

(S) quantityQNT is the quantity (in QNT) of the asset
(S) accountRS is the Reed-Solomon address of the account that owns the asset
(S) unconfirmedQuantityQNT is the unconfirmed quantity (in QNT) of the asset
(S) asset is the asset ID
(S) account is the number of the account that owns the asset

(N) requestProcessingTime is the API request processing time (in millisec)

Example:

Request:

https://europe1.signum.network/burst?requestType=getAssetAccounts&asset=3702027329806229573&lastIndex=1

Response:

{
“accountAssets”: [
{
“quantityQNT”: “5000000000”,
“accountRS”: “S-CMAP-AY84-2TV8-6F2QK”,
“unconfirmedQuantityQNT”: “5000000000”,
“asset”: “3702027329806229573”,
“account”: “5248959966645406997”
},
{
“quantityQNT”: “5000000000”,
“accountRS”: “S-CMSP-HRMP-ZBTM-9P4J7”,
“unconfirmedQuantityQNT”: “5000000000”,
“asset”: “3702027329806229573”,
“account”: “8268702915092631317”
}
],
“requestProcessingTime”: 22
}

Get Asset Ids

Get the IDs of all assets in the exchange in reverse block height of creation order.

Request:
requestType is getAssetIds
firstIndex is the zero-based index to the first asset ID to retrieve (optional)
lastIndex is the zero-based index to the last asset ID to retrieve (optional)

Response:

(A) assets is the array of asset IDs
(N) requestProcessingTime is the API request processing time (in millisec)

Example:

Request:

https://europe1.signum.network/burst?requestType=getAssetIds&lastIndex=5

Response:

{
“assetIds”: [
“2644409077762286513”,
“5533434524898779728”,
“7756017130240677072”,
“2663432644302202784”,
“11700625361170592721”,
“9789600218215198873”
],
“requestProcessingTime”: 1
}

Get Asset Transfers

Get transfers associated with a given asset and/or account in reverse block height order (or in the expected order of execution for expected transfers).

Request:
requestType is getAssetTransfers provides expected transfers from the unconfirmed transactions pool or phased transactions scheduled to finish in the next block
asset is the asset ID (optional)
account is the account ID (optional if asset provided)
includeAssetInfo is true if the decimals and name fields are to be included (optional, does not apply to expected transfers)
firstIndex is a zero-based index to the first transfer to retrieve (optional, does not apply to expected transfers)
lastIndex is zero-based index to the last transfer to retrieve (optional, does not apply to expected transfers)

Response:

(A) transfers is the array of transfer objects with the following fields for each transfer:

(S) quantityQNT is the quantity (in QNT) of the asset traded
(S) senderRS is the Reed-Solomon address of the sender
(S) assetTransfer is the transaction ID of the asset transfer
(S) sender is the account ID of the sender
(S) recipientRS is the Reed-Solomon address of the recipient
(N) decimals is the number of decimal places used by the asset (if includeAssetInfo is true)
(S) recipient is the account number of the recipient
(S) name is the name of the asset (if includeAssetInfo is true)
(S) asset is the asset ID
(N) height is the height of the transfer block
(N) timestamp is the timestamp (in seconds since the genesis block) of the transfer block, does not apply to an expected transfer

(N) requestProcesssingTime is the API request processing time (in millisec)

Example:

Request:

https://europe1.signum.network/burst?requestType=getAssetTransfers&asset=3702027329806229573&lastIndex=1

Response:

{
“transfers”: [
{
“quantityQNT”: “10000”,
“senderRS”: “S-RBHF-BY3C-V949-37G3N”,
“assetTransfer”: “16436527819322024045”,
“sender”: “1875121765155055085”,
“recipientRS”: “S-59HP-HQ5R-7MGU-AG4LC”,
“decimals”: 2,
“recipient”: “9604012506417831413”,
“name”: “CryptoMaps”,
“asset”: “3702027329806229573”,
“height”: 504029,
“timestamp”: 121917645
},
{
“quantityQNT”: “5500”,
“senderRS”: “S-PVZT-KWEH-ZTJE-7Z7C9”,
“assetTransfer”: “9907383924348587793”,
“sender”: “6028278722555736057”,
“recipientRS”: “S-RKW5-ZVFT-JU69-6X4JC”,
“decimals”: 2,
“recipient”: “4990091736314005379”,
“name”: “CryptoMaps”,
“asset”: “3702027329806229573”,
“height”: 500631,
“timestamp”: 121093713
}
],
“requestProcessingTime”: 2
}

Get Assets

Get asset information given multiple asset IDs

Request:
requestType is getAssets
assets is one of the multiple asset IDs
assets is one of the multiple asset IDs
assets is one of the multiple asset IDs

Response:

(A) assets is the array of asset objects (refer to Get Asset)

(N) requestProcesssingTime is the API request processing time (in millisec)

Example:

Request:

https://europe1.signum.network/burst?requestType=getAssets&assets=9306257191450064346&assets=3702027329806229573

Response:

{
“assets”: [
{
“quantityQNT”: “20000000000”,
“numberOfAccounts”: 9210,
“accountRS”: “S-CMAP-ME5N-TFKP-6BCER”,
“decimals”: 2,
“numberOfTransfers”: 11869,
“name”: “CryptoMaps”,
“description”: “The official CryptoMaps Token, see more details at https://token.cryptomaps.me”,
“numberOfTrades”: 523,
“asset”: “3702027329806229573”,
“account”: “5454221553913122069”
},
{
“quantityQNT”: “200000000000”,
“numberOfAccounts”: 1,
“accountRS”: “Signum-SPPT-TD44-HUVK-FSZS4”,
“decimals”: 2,
“numberOfTransfers”: 0,
“name”: “SpotPoint”,
“description”: “The official SpotPoint Token, see more details at https://spotpoint.me”,
“numberOfTrades”: 0,
“asset”: “9306257191450064346”,
“account”: “15088176726379615929”
}
],
“requestProcessingTime”: 0
}

Get Assets By Issuer

Get asset information given multiple creation account IDs in reverse block height of creation order.

Request:
requestType is getAssetsByIssuer
account is one of the multiple account IDs
account is one of the multiple account IDs
firstIndex is a zero-based index to the first asset to retrieve (optional)
lastIndex is zero-based index to the last asset to retrieve (optional)

Response:

(A) assets is the array of asset objects (refer to Get Asset)

(N) requestProcessingTime is the API request processing time (in millisec)

Example:

Request:

https://europe1.signum.network/burst?requestType=getAssetsByIssuer&account=1494753212313950790&account=5970910749481183928

Response:

{
“assets”: [
[
{
“quantityQNT”: “100000000”,
“numberOfAccounts”: 19,
“accountRS”: “S-KQL8-645F-3WU8-3GMHB”,
“decimals”: 2,
“numberOfTransfers”: 0,
“name”: “BoB1Pos”,
“description”: “Brotherhood of Blockchain bob-invest.com proudly present the first investment opportunity on Signum asset. This asset will invest in Prove of Stake coins and pay out dividend in Signum. The payout ratio is 70% to asset holder 20% equipment, internet, electricity, maintenance and admin. 10% reinvest in coins.This asset will make a monthly payment every 15th of the month, first payment is 15/6/2018.”,
“numberOfTrades”: 35,
“asset”: “15511449532155436028”,
“account”: “1494753212313950790”
}
],
[
{
“quantityQNT”: “80000000000000”,
“numberOfAccounts”: 6,
“accountRS”: “Signum-8CPS-Q628-PU9W-7H9R7”,
“decimals”: 6,
“numberOfTransfers”: 3,
“name”: “GMK”,
“description”: “GMK Coin”,
“numberOfTrades”: 2,
“asset”: “8141917335139373659”,
“account”: “5970910749481183928”
}
]
],
“requestProcessingTime”: 3
}

Get Order

Get a bid/ask order given an order ID.

Request:
requestType is either getBidOrder or getAskOrder
order is the Order ID

Response:

(S) quantityQNT is the order quantity (in QNT)
(S) priceNQT is the order price (in NQT)
(S) accountRS is the Reed-Solomon address of the account
(N) requestProcessingTime is the API request processing time (in millisec)
(S) asset is the ID of the asset being ordered
(S) type is the type of order (bid or ask)
(S) account is the account number associated with the order
(S) order is the ID of the order
(N) height is the block height of the order transaction

Example:

https://europe1.signum.network/burst?requestType=getAskOrder&order=14034527401109329159

Response:

{
“quantityQNT”: “10”,
“priceNQT”: “10000000000000”,
“accountRS”: “S-359Q-QH73-4N5P-FP54C”,
“requestProcessingTime”: 1,
“asset”: “15295227971848272658”,
“type”: “ask”,
“account”: “15350648744942013686”,
“order”: “14034527401109329159”,
“height”: 17901
}

Get Order Ids

Get bid/ask order IDs given an asset ID, in order of decreasing bid price or increasing ask price.

Request:
requestType is either getBidOrderIds or getAskOrderIds
asset is the asset ID
firstIndex is a zero-based index to the first order ID to retrieve (optional)
lastIndex is a zero-based index to the last order ID to retrieve (optional)

Response:

(A) bidOrderIds or askOrderIds is the array of order IDs
(N) requestProcessingTime is the API request processing time (in millisec)

Example:

Request:

https://europe1.signum.network/burst?requestType=getAskOrderIds&asset=11700625361170592721&lastIndex=5

Response:

{
“requestProcessingTime”: 3,
“askOrderIds”: [
“9230225288402446558”,
“9243318318548315528”,
“9399454941412352140”,
“9436352279829246389”,
“9443733332658954573”,
“9545675672764030312”
]
}

Get Orders

Get bid/ask orders given an asset ID, in order of decreasing bid price or increasing ask price (if sortByPrice is true for expected orders, otherwise in the expected order of execution).

Request:
requestType is one of getBidOrders, getAskOrders, where expected orders are from the unconfirmed transactions pool or are phased transactions scheduled to finish in the next block
asset is the asset ID
firstIndex is a zero-based index to the first order to retrieve (optional, does not apply to expected orders)
lastIndex is a zero-based index to the last order to retrieve (optional, does not apply to expected orders)

Response:

(A) bidOrders or askOrders is the array of order objects (refer to Get Order for details) with the following additional field only for an expected order:

phased (B) is true if the order is phased, false otherwise

(N) requestProcessingTime is the API request processing time (in millisec)

Example:

Request:

https://europe1.signum.network/burst?requestType=getAskOrders&asset=11700625361170592721&lastIndex=2

Response:

{
“askOrders”: [
{
“quantityQNT”: “250”,
“priceNQT”: “100000000”,
“accountRS”: “S-CDQV-WN87-YB2L-FTEPP”,
“asset”: “11700625361170592721”,
“type”: “ask”,
“account”: “15768678879341129435”,
“order”: “9230225288402446558”,
“height”: 501552
},
{
“quantityQNT”: “50000”,
“priceNQT”: “100000000”,
“accountRS”: “S-CDQV-WN87-YB2L-FTEPP”,
“asset”: “11700625361170592721”,
“type”: “ask”,
“account”: “15768678879341129435”,
“order”: “9243318318548315528”,
“height”: 501552
},
{
“quantityQNT”: “50”,
“priceNQT”: “100000000”,
“accountRS”: “S-CDQV-WN87-YB2L-FTEPP”,
“asset”: “11700625361170592721”,
“type”: “ask”,
“account”: “15768678879341129435”,
“order”: “9399454941412352140”,
“height”: 501552
}
],
“requestProcessingTime”: 1
}

Get Trades

Get trades associated with a given asset and/or account in reverse block height order.

Request:
requestType is getTrades
asset is the asset ID
account is the account ID (optional if asset provided)
firstIndex is a zero-based index to the first trade to retrieve (optional)
lastIndex is a zero-based index to the last trade to retrieve (optional)
includeAssetInfo is true if the decimals and name fields are to be included (optional)

Response:

(A) trades is the array of trade objects with the following fields for each trade:

(S) seller is the account number of the seller
(S) quantityQNT is the quantity (in QNT) of the asset traded
(S) bidOrder is the bid order ID
(S) sellerRS is the Reed-Solomon address of the seller
(S) buyer is the account number of the buyer
(S) priceNQT is the trade price (in NQT, the ask price for a buy or the bid price for a sell)
(S) askOrder is the ask order ID
(S) buyerRS is the Reed-Solomon address of the buyer
(N) decimals is the number of decimal places used by the asset
(S) name is the name of the asset (if includeAssetInfo is true)
(S) block is the block ID of the trade (if includeAssetInfo is true)
(S) asset is the asset ID
(N) askOrderHeight is the block height of the ask order
(N) bidOrderHeight is the block height of the bid order
(S) tradeType is the trade type (sell or buy, where buy implies that the bid occurred after the ask, or if in the same block, has a greater order ID)
(N) timestamp is the timestamp (in seconds since the genesis block) of the trade block
(N) height is the height of the trade block

(N) requestProcessingTime is the API request processing time (in millisec)

Example:

Request:

https://europe1.signum.network/burst?requestType=getTrades&asset=3702027329806229573&lastIndex=2&includeAssetInfo=false

Response:

{
“trades”: [
{
“seller”: “2695253629713716937”,
“quantityQNT”: “7700”,
“bidOrder”: “17489219850997945774”,
“sellerRS”: “S-Q7QB-WPPC-6VE2-4QVTC”,
“buyer”: “14676337193484961173”,
“priceNQT”: “100000”,
“askOrder”: “7125231493760146086”,
“buyerRS”: “S-EKEP-XEYS-6YPW-EL8DR”,
“block”: “10810208340839229954”,
“asset”: “3702027329806229573”,
“askOrderHeight”: 504189,
“tradeType”: “sell”,
“timestamp”: 122140342,
“height”: 504949
},
{
“seller”: “13248005565246971693”,
“quantityQNT”: “100000”,
“bidOrder”: “6312065606850043247”,
“sellerRS”: “S-59TF-VVKH-X6SQ-DYLQH”,
“buyer”: “9582909050628712440”,
“priceNQT”: “120000”,
“askOrder”: “17472059594274895773”,
“buyerRS”: “S-MBZS-2BCT-45QV-APCZB”,
“block”: “12097007668561592790”,
“asset”: “3702027329806229573”,
“askOrderHeight”: 504899,
“tradeType”: “buy”,
“timestamp”: 122129038,
“height”: 504899
},
{
“seller”: “12065311156306389227”,
“quantityQNT”: “7700”,
“bidOrder”: “17489219850997945774”,
“sellerRS”: “S-8C9D-LBN5-X9FG-CS6WG”,
“buyer”: “14676337193484961173”,
“priceNQT”: “100000”,
“askOrder”: “2519849914836375271”,
“buyerRS”: “S-EKEP-XEYS-6YPW-EL8DR”,
“block”: “16551915903483185103”,
“asset”: “3702027329806229573”,
“askOrderHeight”: 504189,
“tradeType”: “sell”,
“timestamp”: 122075678,
“height”: 504681
}
],
“requestProcessingTime”: 1
}

Issue Asset

Create an asset on the exchange. POST only. Refer to Create Transaction Request for common parameters.

Request:
requestType is issueAsset
name is the name of the asset
description is the url-encoded description of the asset in UTF-8 with a maximum length of 1000 bytes (optional)
quantityQNT is the total amount (in QNT) of the asset in existence
decimals is the number of decimal places used by the asset (optional, zero default)

Response: Refer to Create Transaction Response. The transaction ID is also the asset ID.

Example: Refer to Issue Asset example.

Issue Asset

Note: Actual data is not used in this example.

Request:

https://europe1.signum.network/burst?requestType=issueAsset&publicKey=57fb6f3a958e320bb49c4e81b4c2cf28b9f25d086c143b473beec228f79ff93c&name=SecretCoin&description=This+is+SecretCoin&quantityQNT=100&deadline=60&feeNQT=100000000000

Response:

{
“unsignedTransactionBytes”: “021095e5da013c0073080c6a224062660184f10ebb7fb431d459364a12403…”,
“transactionJSON”: {
“senderPublicKey”: “73080c6a224062660184f10ebb7fb431d459364a12403320c7f601f9d75cc547”,
“feeNQT”: “100000000000”,
“type”: 2,
“version”: 1,
“ecBlockId”: “1564408139943737911”,
“attachment”: {
“name”: “SecretCoin”,
“description”: “This+is+SecretCoin”,
“quantityQNT”: “100”,
“version.AssetIssuance”: 1,
“decimals”: 0
},
“senderRS”: “S-4VNQ-RWZC-4WWQ-GVM8S”,
“subtype”: 0,
“amountNQT”: “0”,
“sender”: “17013046603665206934”,
“ecBlockHeight”: 288402,
“deadline”: 60,
“timestamp”: 31122837,
“height”: 2147483647
},
“broadcasted”: false,
“requestProcessingTime”: 2
}

Place Order

Place an asset order. POST only. Refer to Create Transaction Request for common parameters.

Request:
requestType is either placeBidOrder or placeAskOrder
asset is the asset ID of the asset being ordered
quantityQNT is the amount (in QNT) of the asset being ordered
priceNQT is the bid/ask price (in NQT)

Response: Refer to Create Transaction Response. The transaction ID is also the order ID.

Example:

Request:

https://europe1.signum.network/burst?requestType=placeBidOrder&asset=3702027329806229573&quantityQNT=1&priceNQT=100000000&secretPhrase=IWontTellYou&feeNQT=100000000&deadline=1&broadcast=false

Response:

{
“signatureHash”: “3358f546ce7136ca478692102d0b526f80b4ca83eb78e90d15813b9636b654e5”,
“unsignedTransactionBytes”: “0213c6cc47070100a61325eec9e83d7cac55544b8eca8ea8034559bafb5834b8a5d3b6d4efb85f120000000000000000000000000000000000e1f505*”,
“transactionJSON”: {
“senderPublicKey”: “a61325eec9e83d7cac55544b8eca8ea8034559bafb5834b8a5d3b6d4efb85f12”,
“signature”: “48d14f308d26380e4dfa26b296c8728eef04af8704acff60f4d8bef28a126701ea29878753d2106a16228cfc3829e8f3d6a2e5baf739dbd0460fd45cff1241e0”,
“feeNQT”: “100000000”,
“type”: 2,
“fullHash”: “229f52765195110e0e096b81b91f04186be14ada7e29949841ee30e37b655775”,
“version”: 1,
“ecBlockId”: “6656096466494440810”,
“signatureHash”: “3358f546ce7136ca478692102d0b526f80b4ca83eb78e90d15813b9636b654e5”,
“attachment”: {
“quantityQNT”: “1”,
“priceNQT”: “100000000”,
“asset”: “3702027329806229573”,
“version.BidOrderPlacement”: 1
},
“senderRS”: “S-FRDJ-UPLH-MY9A-GUKQP”,
“subtype”: 3,
“amountNQT”: “0”,
“sender”: “16922903237994405232”,
“ecBlockHeight”: 504963,
“deadline”: 1,
“transaction”: “1013755568245088034”,
“timestamp”: 122145990,
“height”: 2147483647
},
“broadcasted”: false,
“requestProcessingTime”: 3,
“transactionBytes”: “0213c6cc47070100a61325eec9e83d7cac55544b8eca8ea8034559bafb5834b8a5d3b6d4efb85f120000000000000000000000000000000000e1f505*”,
“fullHash”: “229f52765195110e0e096b81b91f04186be14ada7e29949841ee30e37b655775”,
“transaction”: “1013755568245088034”
}

Transfer Asset

Transfer a quantity of an asset from one account to another. POST only. Refer to Create Transaction Request for common parameters.

Request:
requestType is transferAsset
recipient is the recipient account ID
recipientPublicKey is the public key of the recipient account (optional, enhances security of a new account)
asset is the ID of the asset being transferred
quantityQNT is the amount (in QNT) of the asset being transferred

Response: Refer to Create Transaction Response. The transaction ID is also the transfered asset ID.

Example:

Request:

https://europe1.signum.network/burst?requestType=transferAsset&recipient=17001464071916561838&asset=3702027329806229573&quantityQNT=1&secretPhrase=IWontTellYou&feeNQT=100000000&deadline=1&broadcast=true

Response:

{
“signatureHash”: “59456e26081926b27c38ca46d574e4a6373953b932e8368f131f7bc86ffc3aa9”,
“unsignedTransactionBytes”: “021143d147070100a61325eec9e83d7cac55544b8eca8ea8034559bafb5834b8a5d3b6d4efb85f12ae2527ec7e55f1eb000000000000000000e1f505*”,
“transactionJSON”: {
“senderPublicKey”: “a61325eec9e83d7cac55544b8eca8ea8034559bafb5834b8a5d3b6d4efb85f12”,
“signature”: “b5f33599a52e5e4e56ad5c316cd6f6ced8ebe9e9931222aaee30407570ede60031a068b6a89714fca851b486e8d8c2509ef46b3e0e1ef44c819cbff5b0bb78c4”,
“feeNQT”: “100000000”,
“type”: 2,
“fullHash”: “3b7d9f5b998ce795a3300ed1e6df1ba8fe467b137e2f2c662c9149a5b0f878d9”,
“version”: 1,
“ecBlockId”: “6974740076508916530”,
“signatureHash”: “59456e26081926b27c38ca46d574e4a6373953b932e8368f131f7bc86ffc3aa9”,
“attachment”: {
“version.AssetTransfer”: 1,
“quantityQNT”: “1”,
“asset”: “3702027329806229573”
},
“senderRS”: “S-FRDJ-UPLH-MY9A-GUKQP”,
“subtype”: 1,
“amountNQT”: “0”,
“sender”: “16922903237994405232”,
“recipientRS”: “S-GBFG-HVQ4-8AMM-GPCWR”,
“recipient”: “17001464071916561838”,
“ecBlockHeight”: 504968,
“deadline”: 1,
“transaction”: “10801756821566487867”,
“timestamp”: 122147139,
“height”: 2147483647
},
“broadcasted”: true,
“requestProcessingTime”: 5,
“transactionBytes”: “021143d147070100a61325eec9e83d7cac55544b8eca8ea8034559bafb5834b8a5d3b6d4efb85f12ae2527ec7e55f1eb000000000000000000e1f505*”,
“fullHash”: “3b7d9f5b998ce795a3300ed1e6df1ba8fe467b137e2f2c662c9149a5b0f878d9”,
“transaction”: “10801756821566487867”
}

DGS Delisting

Delist a listed product. POST only. Refer to Create Transaction Request for common parameters.

Request:
requestType is dgsDelisting
goods is the goods ID

Response: Refer to Create Transaction Response.

Example:

Request:

https://europe1.signum.network/burst?requestType=dgsDelisting&goods=11813734897437346473&secretPhrase=IWontTellYou&feeNQT=100000000&deadline=60

Response:

{
“signatureHash”: “87dd2aa00690acaa5da4e8cd9db6ab94b5ed8bf0f8fe2c2ba6a39c57d3073105”,
“unsignedTransactionBytes”: “03111852e2013c0057fb6f3a958e320bb49c4e81b4c2cf28b9f25d086c143b…”,
“transactionJSON”: {
“senderPublicKey”: “57fb6f3a958e320bb49c4e81b4c2cf28b9f25d086c143b473beec228f79ff93c”,
“signature”: “39ee52204d0a32c0bbd0e4bc6a6fb52299cd7d16ab74e9a040f857d3b1c3e…”,
“feeNQT”: “100000000”,
“type”: 3,
“fullHash”: “40e64c357e240f9b7ca5780e757e34d48a58ae93eeb19e62d020d5719b43e2b6”,
“version”: 1,
“ecBlockId”: “5345754442518111082”,
“signatureHash”: “87dd2aa00690acaa5da4e8cd9db6ab94b5ed8bf0f8fe2c2ba6a39c57d3073105”,
“attachment”: {
“version.DigitalGoodsDelisting”: 1,
“goods”: “11813734897437346473”
},
“senderRS”: “S-L6FM-89WK-VK8P-FCRBB”,
“subtype”: 1,
“amountNQT”: “0”,
“sender”: “15323192282528158131”,
“ecBlockHeight”: 292903,
“deadline”: 60,
“transaction”: “11173189325008201280”,
“timestamp”: 31609368,
“height”: 2147483647
},
“broadcasted”: true,
“requestProcessingTime”: 5188,
“transactionBytes”: “03111852e2013c0057fb6f3a958e320bb49c4e81b4c2cf28b9f25d086c143b…”,
“fullHash”: “40e64c357e240f9b7ca5780e757e34d48a58ae93eeb19e62d020d5719b43e2b6”,
“transaction”: “11173189325008201280”
}

DGS Delivery

Deliver a product. POST only. Refer to Create Transaction Request for common parameters.

Request:
requestType is dgsDelivery
purchase is the purchase order ID
discountNQT is the discount (in NQT) off the selling price (optional, default is zero)
goodsToEncrypt is the product, a text or a hex string to be encrypted (optional if goodsData provided)
goodIsText is false if goodsToEncrypt is a hex string (optional)
goodsData is AES-encrypted (using Encrypt To) goodsToEncrypt, up to 1000 bytes long (required only if secretPhrase is omitted)
goodsNonce is the unique nonce associated with the encrypted data (required only if secretPhrase is omitted)

Note: If the encrypted goods data is longer than 1000 bytes, use a prunable encrypted message to deliver the goods.

Response: Refer to Create Transaction Response.

Example:

DGS Delivery

Request:

https://europe1.signum.network/burst?requestType=dgsDelivery&purchase=3723760852542296589&goodsToEncrypt=DownloadCode&secretPhrase=IWontTellYou&feeNQT=100000000&deadline=60

Response:

{
“signatureHash”: “f3f1f1bf30c7a6f5a7776aa23502dfe5240efe0d5c016760f8e8a152c4eb1b1b”,
“unsignedTransactionBytes”: “0315b20fe1013c0057fb6f3a958e320bb49c4e81b4c2cf28b9f25d086c143b…”,
“transactionJSON”: {
“senderPublicKey”: “57fb6f3a958e320bb49c4e81b4c2cf28b9f25d086c143b473beec228f79ff93c”,
“signature”: “b96c42161ce38177168de5a8906ce747a5415017df5b16cdce1c015cb6e1f10b…”,
“feeNQT”: “100000000”,
“type”: 3,
“fullHash”: “349926ea025b627117c05fbe3ff298e97a8efdb07f7ae552b5a91e7112c5b82b”,
“version”: 1,
“ecBlockId”: “15813950788992376142”,
“signatureHash”: “f3f1f1bf30c7a6f5a7776aa23502dfe5240efe0d5c016760f8e8a152c4eb1b1b”,
“attachment”: {
“goodsIsText”: true,
“discountNQT”: “0”,
“purchase”: “3723760852542296589”,
“goodsData”: “aef91bfe543844964b0dadc51c6fe4c624b6b0c72c23c5c61f7e626f51e15…”,
“version.DigitalGoodsDelivery”: 1,
“goodsNonce”: “4cb474ec53a590c6fd20d050c429d009ddefd286b2782eb3a0782ae45c2bbbbd”
},
“senderRS”: “S-L6FM-89WK-VK8P-FCRBB”,
“subtype”: 5,
“amountNQT”: “0”,
“sender”: “15323192282528158131”,
“recipientRS”: “S-6GMG-FC5F-YSX6-8CVEL”,
“recipient”: “7580519603555678830”,
“ecBlockHeight”: 292069,
“deadline”: 60,
“transaction”: “8170192742079961396”,
“timestamp”: 31526834,
“height”: 2147483647
},
“broadcasted”: true,
“requestProcessingTime”: 8832,
“transactionBytes”: “0315b20fe1013c0057fb6f3a958e320bb49c4e81b4c2cf28b9f25d086c143b…”,
“fullHash”: “349926ea025b627117c05fbe3ff298e97a8efdb07f7ae552b5a91e7112c5b82b”,
“transaction”: “8170192742079961396”
}

DGS Feedback

Give feedback about a purchased product after delivery. POST only. Refer to Create Transaction Request for common parameters.

Request:
requestType is dgsFeedback
purchase is the purchase order ID
message is the unencrypted (public) feedback text up to 1000 bytes

Note: The unencrypted message parameter is used for public feedback, but in addition or instead, an encrypted message can be used for private feedback to the seller and/or an encrypted message can be sent to self (buyer) although the current BRS client does not recognize non-public feedback messages.

Response: Refer to Create Transaction Response.

Example:

Request:

https://europe1.signum.network/burst?requestType=dgsFeedback&purchase=10234639413366748292&secretPhrase=IWontTellYou&feeNQT=100000000&deadline=60&message=Thanks!

Response:

{
“signatureHash”: “bf31e4e3b2037bfe223efd72519e3a2d25cd1e0dc1a62e3eeefe59179e16a7a4”,
“unsignedTransactionBytes”: “0316a463e2013c0057fb6f3a958e320bb49c4e81b4c2cf28b9f25d086c143b…”,
“transactionJSON”: {
“senderPublicKey”: “57fb6f3a958e320bb49c4e81b4c2cf28b9f25d086c143b473beec228f79ff93c”,
“signature”: “a3ee76ce4bec0328fe5cfc1a2adfc229a8c9959a81b7912664de51156987c…”,
“feeNQT”: “100000000”,
“type”: 3,
“fullHash”: “491d94b9031b7a7a32d9ab5d0491b81364941eb080ee9029de58cb6ffa0161f6”,
“version”: 1,
“ecBlockId”: “5484311742753527844”,
“signatureHash”: “bf31e4e3b2037bfe223efd72519e3a2d25cd1e0dc1a62e3eeefe59179e16a7a4”,
“attachment”: {
“purchase”: “10234639413366748292”,
“version.Message”: 1,
“messageIsText”: true,
“version.DigitalGoodsFeedback”: 1,
“message”: “Thank you!”
},
“senderRS”: “S-L6FM-89WK-VK8P-FCRBB”,
“subtype”: 6,
“amountNQT”: “0”,
“sender”: “15323192282528158131”,
“recipientRS”: “S-6GMG-FC5F-YSX6-8CVEL”,
“recipient”: “7580519603555678830”,
“ecBlockHeight”: 292938,
“deadline”: 60,
“transaction”: “8825396122598251849”,
“timestamp”: 31613860,
“height”: 2147483647
},
“broadcasted”: true,
“requestProcessingTime”: 9343,
“transactionBytes”: “0316a463e2013c0057fb6f3a958e320bb49c4e81b4c2cf28b9f25d086c143b…”,
“fullHash”: “491d94b9031b7a7a32d9ab5d0491b81364941eb080ee9029de58cb6ffa0161f6”,
“transaction”: “8825396122598251849”
}

DGS Listing

List a product in the DGS by creating a listing transaction. POST only. Refer to Create Transaction Request for common parameters.

Request:
requestType is dgsListing
name is the name of the product up to 100 characters in length
description is the description of the product up to 1000 characters in length
tags is up to three comma separated keywords describing the product up to 100 characters in length (optional)
quantity is the quantity of the product for sale
priceNQT is the price (in NQT) of the product

Response: Refer to Create Transaction Response. The transaction ID is also the goods ID.

Example:

Request:

https://europe1.signum.network/burst?requestType=dgsListing&secretPhrase=IWontTellYou&name=Test&description=Testing&tags=test&quantity=3&priceNQT=100000000&feeNQT=100000000& deadline=60

Response:

{
“signatureHash”: “565bc0a6140ae1331cd5db009fbd9da164d8802330939ef40204a9bc343b3149”,
“unsignedTransactionBytes”: “031092aedf013c0057fb6f3a958e320bb49c4e81b4c2cf28b9f25d086c143b…”,
“transactionJSON”: {
“senderPublicKey”: “57fb6f3a958e320bb49c4e81b4c2cf28b9f25d086c143b473beec228f79ff93c”,
“signature”: “465ed3dfef9a02fc97fc18a6f83bb9f07c285aef41ff78c957d59cda2972ba…”,
“feeNQT”: “100000000”,
“type”: 3,
“fullHash”: “a98a63204cd1f2a3304cee79776854f290f0472883c576056fec16a23efa90df”,
“version”: 1,
“ecBlockId”: “4480409615309425420”,
“signatureHash”: “565bc0a6140ae1331cd5db009fbd9da164d8802330939ef40204a9bc343b3149”,
“attachment”: {
“priceNQT”: “100000000”,
“quantity”: 3,
“name”: “Test Product”,
“description”: “Testing the DGS.”,
“version.DigitalGoodsListing”: 1,
“tags”: “test, product, tag, extra”
},
“senderRS”: “S-L6FM-89WK-VK8P-FCRBB”,
“subtype”: 0,
“amountNQT”: “0”,
“sender”: “15323192282528158131”,
“ecBlockHeight”: 291240,
“deadline”: 60,
“transaction”: “11813734897437346473”,
“timestamp”: 31436434,
“height”: 2147483647
},
“broadcasted”: true,
“requestProcessingTime”: 8958,
“transactionBytes”: “031092aedf013c0057fb6f3a958e320bb49c4e81b4c2cf28b9f25d086c143b473b…”,
“fullHash”: “a98a63204cd1f2a3304cee79776854f290f0472883c576056fec16a23efa90df”,
“transaction”: “11813734897437346473”
}

DGS Price Change

Change the price of a listed product. POST only. Refer to Create Transaction Request for common parameters.

Request:
requestType is dgsPriceChange
goods is the goods ID of the product
priceNQT is the new price of the product

Response: Refer to Create Transaction Response.

Example:

Request:

https://europe1.signum.network/burst?requestType=dgsPriceChange&goods=11813734897437346473&priceNQT=200000000&secretPhrase=IWontTellYou&feeNQT=100000000&deadline=60

Response:

{
“signatureHash”: “aad88476935eda8ca3a9190163b83106e6ca95733ddfa274d29a0378d773cc3c”,
“unsignedTransactionBytes”: “0312cebbdf013c0057fb6f3a958e320bb49c4e81b4c2cf28b9f25d086c143b…”,
“transactionJSON”: {
“senderPublicKey”: “57fb6f3a958e320bb49c4e81b4c2cf28b9f25d086c143b473beec228f79ff93c”,
“signature”: “533f9c330100cab8a7a0f9375b49a09f6432b0e029660ab715a728ac75e6c2…”,
“feeNQT”: “100000000”,
“type”: 3,
“fullHash”: “1964e4fe11f4a00a96c79e274f9da21f64d7fe10ed77a154975b92d3c65f1287”,
“version”: 1,
“ecBlockId”: “14411471768450948944”,
“signatureHash”: “aad88476935eda8ca3a9190163b83106e6ca95733ddfa274d29a0378d773cc3c”,
“attachment”: {
“goods”: “11813734897437346473”,
“priceNQT”: “200000000”,
“version.DigitalGoodsPriceChange”: 1
},
“senderRS”: “S-L6FM-89WK-VK8P-FCRBB”,
“subtype”: 2,
“amountNQT”: “0”,
“sender”: “15323192282528158131”,
“ecBlockHeight”: 291259,
“deadline”: 60,
“transaction”: “765880294780986393”,
“timestamp”: 31439822,
“height”: 2147483647
},
“broadcasted”: true,
“requestProcessingTime”: 6444,
“transactionBytes”: “0312cebbdf013c0057fb6f3a958e320bb49c4e81b4c2cf28b9f25d086c143b…”,
“fullHash”: “1964e4fe11f4a00a96c79e274f9da21f64d7fe10ed77a154975b92d3c65f1287”,
“transaction”: “765880294780986393”
}

DGS Purchase

Purchase a product for sale. POST only. Refer to Create Transaction Request for common parameters.

Request:
requestType is dgsPurchase
goods is the goods ID of the product
priceNQT is the price of the product
quantity is the quantity to be purchased
deliveryDeadlineTimestamp is the timestamp (in seconds since the genesis block) by which delivery of the product must occur

Response: Refer to Create Transaction Response. The transaction ID is also the purchase order ID.

Example:

Request:

https://europe1.signum.network/burst?requestType=dgsPurchase&goods=1587116104511359906&quantity=1&deliveryDeadlineTimestamp=31800000&secretPhrase=IWontTellYou&feeNQT=100000000&deadline=60

Response:

{
“signatureHash”: “03e112d8707ae33ec37ff4405f31920c0e67c58439e33033c248b3eaca81d2c3”,
“unsignedTransactionBytes”: “0314805be2013c0057fb6f3a958e320bb49c4e81b4c2cf28b9f25d086c143b…”,
“transactionJSON”: {
“senderPublicKey”: “57fb6f3a958e320bb49c4e81b4c2cf28b9f25d086c143b473beec228f79ff93c”,
“signature”: “a2739ef63024d9d3c61bebbb2692e7a2092666e13fc380c2e8b29c3a3fc24…”,
“feeNQT”: “100000000”,
“type”: 3,
“fullHash”: “84f4ef2d52be088e011e5b7857fbab88665918e0df02102a8333aee53c3bb88b”,
“version”: 1,
“ecBlockId”: “3186563001195424357”,
“signatureHash”: “03e112d8707ae33ec37ff4405f31920c0e67c58439e33033c248b3eaca81d2c3”,
“attachment”: {
“goods”: “1587116104511359906”,
“priceNQT”: “100000000”,
“quantity”: 1,
“deliveryDeadlineTimestamp”: 31800000,
“version.DigitalGoodsPurchase”: 1
},
“senderRS”: “S-L6FM-89WK-VK8P-FCRBB”,
“subtype”: 4,
“amountNQT”: “0”,
“sender”: “15323192282528158131”,
“recipientRS”: “S-6GMG-FC5F-YSX6-8CVEL”,
“recipient”: “7580519603555678830”,
“ecBlockHeight”: 292925,
“deadline”: 60,
“transaction”: “10234639413366748292”,
“timestamp”: 31611776,
“height”: 2147483647
},
“broadcasted”: true,
“requestProcessingTime”: 5536,
“transactionBytes”: “0314805be2013c0057fb6f3a958e320bb49c4e81b4c2cf28b9f25d086c143b…”,
“fullHash”: “84f4ef2d52be088e011e5b7857fbab88665918e0df02102a8333aee53c3bb88b”,
“transaction”: “10234639413366748292”
}

Create an Arbitrary Message transaction. POST only. Refer to Create Transaction Request for common parameters.

Request:
requestType is getBlocks
firstIndex is the first block to retrieve (optional, default is zero or the last block on the blockchain)
lastIndex is the last block to retrieve (optional, default is firstIndex + 99)
includeTransactions is true to include transaction details (optional)

Response:

(A) blocks is the array of blocks retrieved (refer to Get Block for details)
(N) requestProcessingTime is the API request processing time (in millisec)

Example:

Request:

https://europe1.signum.network/burst?requestType=getBlocks&lastIndex=1

Response:

{
“blocks”: [
{
“previousBlockHash”: “e4cc2b7c6f62c290d1405ef236b846d316df4cc187c9554b18dcb54861f4ade2”,
“payloadLength”: 1234,
“totalAmountNQT”: “132933935798”,
“generationSignature”: “53f43986acef5899f08e388bde1bc6b935499c91badace2247076aa984fea577”,
“generator”: “12019899115821911181”,
“generatorPublicKey”: “f6b3ee829223351281340617eae3bdc3082ae9db6899395befddabc4aae37161”,
“baseTarget”: “115429”,
“payloadHash”: “2e71185d5f9c8cce3f2cc87dec5df9643dc0b6562f78f49b553610bc4d9af5a3”,
“generatorRS”: “S-KM6F-KZ7B-46SF-C4UMF”,
“blockReward”: “944”,
“scoopNum”: 1265,
“numberOfTransactions”: 7,
“blockSignature”: “c5f9495278e685e90d4d42108c0a25b0a62f0006bdbb70f8df90d17d49a4670c09d13d63947fe69904340748348001277308de67891ee3bec177524629bc7383”,
“transactions”: [
“14343547955476128075”,
“14751316321929102651”,
“18403710335612237831”,
“2492947289038528624”,
“3664660987329932102”,
“5094936331677798562”,
“5165719427461695861”
],
“nonce”: “518857973”,
“version”: 3,
“totalFeeNQT”: “510735000”,
“previousBlock”: “10431007917907627236”,
“block”: “3526547904120473437”,
“height”: 502799,
“timestamp”: 121621514
},
{
“previousBlockHash”: “58e5680bb903e51f3dfe2221d5f291e5e7750f360fe78f7f5fee3c568867c7f2”,
“payloadLength”: 938,
“totalAmountNQT”: “139674768871”,
“generationSignature”: “142e073b4a84e95284b8eae679f1cc87d82f418897ffe0858d9bd1adda33d220”,
“generator”: “12414125682074447698”,
“generatorPublicKey”: “4f04a259ddc9c60e49bf3ef0ca5cb53c00ae97dedc1fcb59af2e48a9894ea745”,
“baseTarget”: “116986”,
“payloadHash”: “3d5153f350a07fb6d0b9a4cd07f2d4ef38b0bf312df2091eda05edf2ca4f1283”,
“generatorRS”: “S-MVUL-K5UK-RRTY-CPYKS”,
“blockReward”: “944”,
“nextBlock”: “3526547904120473437”,
“scoopNum”: 3885,
“numberOfTransactions”: 5,
“blockSignature”: “300fd5eace546b846213894c0afa9e68755fa300472a1101ca36d524d3433108445f7154d6b9151c3202272e516b7b9c180751ee65de949cdc7a459409a8b613”,
“transactions”: [
“13447447233023586787”,
“14140393734437081046”,
“3451268376629033899”,
“4144139998017169860”,
“5800257696655274819”
],
“nonce”: “77540123”,
“version”: 3,
“totalFeeNQT”: “400735000”,
“previousBlock”: “2298247278137763160”,
“block”: “10431007917907627236”,
“height”: 502798,
“timestamp”: 121620994
}
],
“requestProcessingTime”: 1
}

Get DGS Goods

Get DGS products for sale in reverse chronological listing creation order unless a seller is given, then in product name order.

Request:
requestType is getDGSGoods
seller is the account ID of the product seller (optional)
firstIndex is the zero-based index to the first product to retrieve (optional)
lastIndex is the zero-based index to the last product to retrieve (optional)
inStockOnly is false if out-of-stock products (zero quantity) are to be retrieved (optional)

Note: If none of the optional parameters are specified, all in-stock products in the blockchain are retrieved at once, which may take a long time.

Response:

(A) goods is the array of goods (refer to Get DGS Good for details)
(N) requestProcessingTime is the API request processing time (in millisec)

Example:

Request:

https://europe1.signum.network/burst?requestType=getDGSGoods&seller=869755421284789028

Response:

Get EC Block

Get Economic Cluster block data.

Request:
requestType is getECBlock
timestamp is the timestamp (in seconds since the genesis block) of the EC block (optional, default (or zero) is the current timestamp)
Note: If timestamp is more than 15 seconds before the timestamp of the last block on the blockchain, errorCode 4 is returned.

Response:

(N) ecBlockHeight is the EC block height
(N) requestProcessingTime is the API request processing time (in millisec)
(S) ecBlockId is the EC block ID
(N) timestamp is the timestamp (in seconds since the genesis block) of the EC block

Example:

Request:

https://europe1.signum.network/burst?requestType=getECBlock

Response:

{
“ecBlockHeight”: 502788,
“requestProcessingTime”: 1,
“ecBlockId”: “15769175919943831738”,
“timestamp”: 121621703
}

Mining Operations

Get Mining Info

Request:
requestType is getMiningInfo

Response:

(S) generationSignature is based from the previous block generation signature and block generator. This value is then used by miners to forge a new block. Generation signature is 32bytes long.
(N) baseTarget is calculated from the last 24 blocks. This value adjusts the difficulty for the miners. The lower the base target, the harder it is for a miner to find a low deadline.
(N) requestProcessingTime is the API request processing time (in millisec)
(N) height is the previous block’s number + 1

Example:

Request:

https://europe1.signum.network/burst?requestType=getMiningInfo

Response:

{
“generationSignature”: “2cfe207000274ed4194fc32699ab4265a3c8698d31aa169c24e87ef51b1dd985”,
“baseTarget”: “53922”,
“requestProcessingTime”: 0,
“height”: “562666”
}

Set Reward Recipient

Set Reward recipient is used to set the reward recipient of a given account.

Request:
requestType is setRewardRecipient
recipient is the account ID of the recipient.

Response:

Refer to Create Transaction Response.

Example: To do

Get Reward Recipient

Request:
requestType is getRewardRecipient
account is the account ID.

Response:

(S) rewardRecipient is the id of the reward recipient.
(N) requestProcessingTime is the API request processing time (in millisec)

Example:

Request:

https://europe1.signum.network/burst?requestType=getRewardRecipient&account=S-FRDJ-UPLH-MY9A-GUKQP

Response:

{
“rewardRecipient”: “16922903237994405232”,
“requestProcessingTime”: 1
}

Submit Nonce

Request:
requestType is submitNonce

Response: To do

Example: To do

Get Accounts With Reward Recipient

Request:
requestType is getAccountsWithRewardRecipient
account is the account ID (either RS address or number)

Response:

(A) accounts is the the account ID of pool members.
(N) requestProcessingTime is the API request processing time (in millisec)

Example:

Request:

https://europe1.signum.network/burst?requestType=getAccountsWithRewardRecipient&account=S-S8Z2-TQ7W-ECVP-FM4FP

Response:

(N) standard is the Standard fee
(N) requestProcessingTime is the API request processing time (in millisec)
(N) cheap is the Cheap fee. Your transaction may not be processed immediately
(N) priority is the Priority fee. Your transaction has high probability of being processed by the network.