Database API

Query account, witness, and blockchain state information using the Database API

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.

TypeScript

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

accounts · string[] · required

Array of account names to retrieve

delayed_votes_active · boolean

Whether to include delayed votes information

Response

accounts · ApiAccount[]

Array of account objects

Show ApiAccount properties

id · number

Account ID

name · string

Account name

owner · ApiAuthority

Owner authority with weight threshold and key/account auths

active · ApiAuthority

Active authority with weight threshold and key/account auths

posting · ApiAuthority

Posting authority with weight threshold and key/account auths

memo_key · string

Public key for memo encryption

json_metadata · string

JSON metadata string

posting_json_metadata · string

Posting JSON metadata string

created · string

Account creation timestamp

balance · NaiAsset

HIVE balance with amount, precision, and nai

hbd_balance · NaiAsset

HBD balance with amount, precision, and nai

vesting_shares · NaiAsset

Vesting shares (VESTS) with amount, precision, and nai

voting_manabar · ApiManabar

Voting mana information with current_mana and last_update_time

downvote_manabar · ApiManabar

Downvote mana information with current_mana and last_update_time

recovery_account · string

Account that can recover this account

last_vote_time · string

Timestamp of last vote

post_count · number

Number of posts created

can_vote · boolean

Whether account can vote

witnesses_voted_for · number

Number of witnesses voted for

Example Response

{
  "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.

TypeScript

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

head_block_number · number

Current head block number

head_block_id · string

Current head block ID

time · string

Current blockchain time

current_witness · string

Name of current block producer

total_pow · string | number

Total proof of work

virtual_supply · NaiAsset

Virtual HIVE supply

current_supply · NaiAsset

Current HIVE supply

current_hbd_supply · NaiAsset

Current HBD supply

total_vesting_fund_hive · NaiAsset

Total HIVE in vesting fund

total_vesting_shares · NaiAsset

Total vesting shares (VESTS)

hbd_interest_rate · number

Current HBD interest rate in basis points

hbd_print_rate · number

Current HBD print rate

maximum_block_size · number

Maximum block size in bytes

last_irreversible_block_num · number

Last irreversible block number

participation_count · number

Witness participation count

Example Response

{
  "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.

TypeScript

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

owners · string[] · required

Array of witness account names

delayed_votes_active · boolean · required

Whether to include delayed votes information

Response

witnesses · ApiWitness[]

Array of witness objects with signing key, properties, and voting information

get_witness_schedule

Get the current witness schedule and median properties.

TypeScript

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 · string[]

Array of current witness account names in shuffled order

num_scheduled_witnesses · number

Number of scheduled witnesses

median_props · object

Median witness properties

Show Median properties

account_creation_fee · NaiAsset

Median account creation fee

maximum_block_size · number

Median maximum block size

hbd_interest_rate · number

Median HBD interest rate

majority_version · string

Majority hardfork version

verify_authority

Verify that a transaction has the required authority signatures.

TypeScript

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

trx · ApiTransaction · required

The transaction to verify

pack · TTransactionPackType · required

Transaction pack type (e.g., “hf26”)

Response

valid · boolean

Whether the transaction has valid authority

Example Response

{
  "valid": true
}