The Database API provides read-only access to blockchain state including accounts, witnesses, and global properties. Use these endpoints to query information without modifying the blockchain.
find_accounts Find detailed information about one or more accounts.
import { createHiveChain } from "@hiveio/wax" ; const chain = await createHiveChain (); const result = await chain . api . database_api . find_accounts ({ accounts: [ "alice" , "bob" ], delayed_votes_active: true }); console . log ( result . accounts );
Parameters Array of account names to retrieve
Whether to include delayed votes information
Response Array of account objects Show ApiAccount properties
Owner authority with weight threshold and key/account auths
Active authority with weight threshold and key/account auths
Posting authority with weight threshold and key/account auths
Public key for memo encryption
Posting JSON metadata string
Account creation timestamp
HIVE balance with amount, precision, and nai
HBD balance with amount, precision, and nai
Vesting shares (VESTS) with amount, precision, and nai
Voting mana information with current_mana and last_update_time
Downvote mana information with current_mana and last_update_time
Account that can recover this account
Number of witnesses voted for
{ "accounts" : [ { "id" : 1234 , "name" : "alice" , "balance" : { "amount" : "1000000" , "precision" : 3 , "nai" : "@@000000021" }, "hbd_balance" : { "amount" : "50000" , "precision" : 3 , "nai" : "@@000000013" }, "vesting_shares" : { "amount" : "5000000000" , "precision" : 6 , "nai" : "@@000000037" }, "voting_manabar" : { "current_mana" : "4500000000" , "last_update_time" : 1709510400 }, "can_vote" : true , "post_count" : 42 } ] }
get_dynamic_global_properties Get current global blockchain properties including block height, supply, and witness information.
import { createHiveChain } from "@hiveio/wax" ; const chain = await createHiveChain (); const dgpo = await chain . api . database_api . get_dynamic_global_properties ({}); console . log ( `Head block: ${ dgpo . head_block_number } ` ); console . log ( `Current witness: ${ dgpo . current_witness } ` );
Parameters This endpoint takes no parameters.
Response Current head block number
Name of current block producer
Total HIVE in vesting fund
Total vesting shares (VESTS)
Current HBD interest rate in basis points
Maximum block size in bytes
last_irreversible_block_num
Last irreversible block number
Witness participation count
{ "head_block_number" : 80000000 , "head_block_id" : "04c1c7a566fc0da66aee465714acee7346b48ac2" , "time" : "2026-03-04T12:00:00" , "current_witness" : "blocktrades" , "total_pow" : "514415" , "virtual_supply" : { "amount" : "400000000000" , "precision" : 3 , "nai" : "@@000000021" }, "current_supply" : { "amount" : "380000000000" , "precision" : 3 , "nai" : "@@000000021" }, "hbd_interest_rate" : 2000 , "maximum_block_size" : 65536 , "last_irreversible_block_num" : 79999970 }
find_witnesses Find information about one or more witnesses.
import { createHiveChain } from "@hiveio/wax" ; const chain = await createHiveChain (); const result = await chain . api . database_api . find_witnesses ({ owners: [ "blocktrades" , "good-karma" ], delayed_votes_active: false }); console . log ( result . witnesses );
Parameters Array of witness account names
Whether to include delayed votes information
Response Array of witness objects with signing key, properties, and voting information
get_witness_schedule Get the current witness schedule and median properties.
import { createHiveChain } from "@hiveio/wax" ; const chain = await createHiveChain (); const schedule = await chain . api . database_api . get_witness_schedule ({}); console . log ( `Current witnesses: ${ schedule . current_shuffled_witnesses } ` );
Parameters This endpoint takes no parameters.
Response current_shuffled_witnesses
Array of current witness account names in shuffled order
Number of scheduled witnesses
Median witness properties Median account creation fee
Median maximum block size
Majority hardfork version
verify_authority Verify that a transaction has the required authority signatures.
import { createHiveChain } from "@hiveio/wax" ; const chain = await createHiveChain (); const result = await chain . api . database_api . verify_authority ({ trx: signedTransaction , pack: "hf26" }); console . log ( `Valid: ${ result . valid } ` );
Parameters The transaction to verify
pack
TTransactionPackType
required
Transaction pack type (e.g., “hf26”)
Response Whether the transaction has valid authority