BitsharesAPI

Bitshares Decentralized Exchange Json-RPC 2.0 API.

Version: 1.0



get_block

database

Retrieve a full, signed block.



Parameters

Name Type Description
params array
params[0:block_num] string height of the block to be returned

Result

Name Type Description
result object the referenced block, or null if no matching block was found
result.previous string hash of a previous block
result.id string unique block identifier
result.timestamp string date and time when the block has been produced, in UTC
result.witness string id of the producing witness
result.witness_signature string block content signed with witness private key
result.transaction_merkle_root string hash of the underlying merkle tree
result.extensions array
result.extensions[#] string
result.transactions array processed transactions in the block
result.transactions[#] object a transaction: a set of operations applied atomically
result.transactions[#]?.operation_results array
result.transactions[#]?.operation_results[#] array
result.transactions[#]?.operation_results[#][0:type] number 1 = object_id_type, 2 = asset
result.transactions[#]?.operation_results[#][1:object_id_or_asset] string
result.transactions[#]?.signatures array
result.transactions[#]?.signatures[#] string
result.transactions[#]?.extensions array
result.transactions[#]?.extensions[#] string
result.transactions[#]?.ref_block_prefix number
result.transactions[#]?.ref_block_num number
result.transactions[#]?.expiration string
result.transactions[#]?.operations array
result.transactions[#]?.operations[#] array
result.transactions[#]?.operations[#][0:type] string operation type
result.transactions[#]?.operations[#][1:operation] object operation object

get_objects

database

Get the objects corresponding to the provided IDs.



Parameters

Name Type Description
params array
params[0:ids] array IDs of the objects to retrieve
params[0:ids][#] string

Result

Name Type Description
result array The objects retrieved, in the order they are mentioned in ids
result[#] object depends of the kind of requested object

get_block_header

database

Retrieve a block header.



Parameters

Name Type Description
params array
params[0:block_num] number

Result

Name Type Description
result object header of the referenced block, or null if no matching block was found
result.previous string hash of a previous block
result.timestamp string date and time when the block has been produced, in UTC
result.witness string id of the producing witness
result.transaction_merkle_root string hash of the underlying merkle tree
result.extensions array
result.extensions[#] string