Steem Developer logo

Steem Developer Portal

Used to query information about accounts, transactions, and blockchain data. These AppBase API methods are still under development and subject to change.

database_api.find_account_recovery_requests

Returns a list of account recovery requests.

Query Parameters JSON
{"accounts": []}
Expected Response JSON
{"requests": []}

database_api.find_accounts

Search for accounts.

Query Parameters JSON
{"accounts": []}
Expected Response JSON
{"accounts": []}

database_api.find_change_recovery_account_requests

Returns a list of requests to change the recovery account.

Query Parameters JSON
{"accounts": []}
Expected Response JSON
{"requests": []}

database_api.find_comments

Search for comments.

Query Parameters JSON
{"comments": []}
Expected Response JSON
{"comments": []}

database_api.find_decline_voting_rights_requests

Returns a list of requests to decline voting rights.

Query Parameters JSON
{"accounts": []}
Expected Response JSON
{"requests": []}

database_api.find_escrows

Returns a list of escrows.

Query Parameters JSON
{"from": ""}
Expected Response JSON
{"escrows": []}

database_api.find_limit_orders

Returns a list of limit orders.

Query Parameters JSON
{"account": ""}
Expected Response JSON
{"orders": []}

database_api.find_owner_histories

Returns owner authority history.

Query Parameters JSON
{"owner": ""}
Expected Response JSON
{"owner_auths": []}

database_api.find_savings_withdrawals

Returns the list of savings withdrawls for an account.

Query Parameters JSON
{"account": ""}
Expected Response JSON
{"withdrawals": []}

database_api.find_sbd_conversion_requests

Returns the list of SBD conversion requests for an account.

Query Parameters JSON
{"account": ""}
Expected Response JSON
{"requests": []}

database_api.find_vesting_delegation_expirations

Returns the expirations for vesting delegations.

Query Parameters JSON
{"account": ""}
Expected Response JSON
{"delegations": []}

database_api.find_vesting_delegations

Returns the list of vesting delegations for an account.

Query Parameters JSON
{"account": ""}
Expected Response JSON
{"delegations": []}

database_api.find_votes

Returns the votes for an author and permlink.

Query Parameters JSON
{"author": "", "permlink": ""}
Expected Response JSON
{"votes": []}

database_api.find_withdraw_vesting_routes

Returns the list of vesting withdraw routes for an account.

Query Parameters JSON
{"account": "", "order": "by_name"}
Expected Response JSON
{"routes": []}

database_api.find_witnesses

Search for witnesses.

Query Parameters JSON
{"owners": []}
Expected Response JSON
{"witnesses": []}

database_api.get_active_witnesses

Returns the list of active witnesses.

Query Parameters JSON
{}
Expected Response JSON
{"witnesses": []}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.get_active_witnesses", "id":1}' https://api.steemit.com

database_api.get_config

Returns information about compile-time constants. Some properties may not be present. See: Understanding Configuration Values

Query Parameters JSON
{}
Expected Response JSON
{}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.get_config", "id":1}' https://api.steemit.com

database_api.get_current_price_feed

Returns the current price feed.

Query Parameters JSON
{}
Expected Response JSON
{
  "base": {
    "amount": "0",
    "precision": 3,
    "nai": "@@000000021"
  },
  "quote": {
    "amount": "0",
    "precision": 3,
    "nai": "@@000000021"
  }
}

database_api.get_dynamic_global_properties

Returns the current dynamic global properties. See: Understanding Dynamic Global Properties

Query Parameters JSON
{}
Expected Response JSON
{
  "id": 0,
  "head_block_number": 0,
  "head_block_id": "0000000000000000000000000000000000000000",
  "time": "1970-01-01T00:00:00",
  "current_witness": "",
  "total_pow": "18446744073709551615",
  "num_pow_witnesses": 0,
  "virtual_supply": {
    "amount": "0",
    "precision": 3,
    "nai": "@@000000021"
  },
  "current_supply": {
    "amount": "0",
    "precision": 3,
    "nai": "@@000000021"
  },
  "confidential_supply": {
    "amount": "0",
    "precision": 3,
    "nai": "@@000000021"
  },
  "current_sbd_supply": {
    "amount": "0",
    "precision": 3,
    "nai": "@@000000013"
  },
  "confidential_sbd_supply": {
    "amount": "0",
    "precision": 3,
    "nai": "@@000000013"
  },
  "total_vesting_fund_steem": {
    "amount": "0",
    "precision": 3,
    "nai": "@@000000021"
  },
  "total_vesting_shares": {
    "amount": "0",
    "precision": 6,
    "nai": "@@000000037"
  },
  "total_reward_fund_steem": {
    "amount": "0",
    "precision": 3,
    "nai": "@@000000021"
  },
  "total_reward_shares2": "0",
  "pending_rewarded_vesting_shares": {
    "amount": "0",
    "precision": 6,
    "nai": "@@000000037"
  },
  "pending_rewarded_vesting_steem": {
    "amount": "0",
    "precision": 3,
    "nai": "@@000000021"
  },
  "sbd_interest_rate": 0,
  "sbd_print_rate": 10000,
  "maximum_block_size": 0,
  "current_aslot": 0,
  "recent_slots_filled": "0",
  "participation_count": 0,
  "last_irreversible_block_num": 0,
  "vote_power_reserve_rate": 40,
  "delegation_return_period": 604800,
  "reverse_auction_seconds": 0,
  "available_account_subsidies": 0,
  "sbd_stop_percent": 0,
  "sbd_start_percent": 0
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.get_dynamic_global_properties", "id":1}' https://api.steemit.com

database_api.get_feed_history

Returns the history of price feed values.

Query Parameters JSON
{}
Expected Response JSON
{
  "id": 0,
  "current_median_history": {
    "base": {
      "amount": "0",
      "precision": 3,
      "nai": "@@000000021"
    },
    "quote": {
      "amount": "0",
      "precision": 3,
      "nai": "@@000000021"
    }
  },
  "price_history": []
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.get_feed_history", "id":1}' https://api.steemit.com

database_api.get_hardfork_properties

Returns the current properties about the blockchain’s hardforks.

Query Parameters JSON
{}
Expected Response JSON
{
  "id": 0,
  "processed_hardforks": [],
  "last_hardfork": 0,
  "current_hardfork_version": "0.0.0",
  "next_hardfork": "0.0.0",
  "next_hardfork_time": "1970-01-01T00:00:00"
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.get_hardfork_properties", "id":1}' https://api.steemit.com

database_api.get_order_book

Returns the order book.

Query Parameters JSON
{"limit": 0}
Expected Response JSON
{"asks": [], "bids": []}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.get_order_book", "params":{"limit":10}, "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.get_order_book", "params":{"limit":50}, "id":1}' https://api.steemit.com

database_api.get_potential_signatures

This method will return the set of all public keys that could possibly sign for a given transaction.

Query Parameters JSON
{
  "trx": {
    "ref_block_num": 0,
    "ref_block_prefix": 0,
    "expiration": "1970-01-01T00:00:00",
    "operations": [],
    "extensions": [],
    "signatures": []
  }
}
Expected Response JSON
{"keys": []}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.get_potential_signatures", "params":{"trx":{"ref_block_num":1097,"ref_block_prefix":2181793527,"expiration":"2016-03-24T18:00:21","operations":[{"type":"pow_operation","value":{"worker_account":"cloop3","block_id":"00000449f7860b82b4fbe2f317c670e9f01d6d9a","nonce":3899,"work":{"worker":"STM7P5TDnA87Pj9T4mf6YHrhzjC1KbPZpNxLWCcVcHxNYXakpoT4F","input":"ae8e7c677119d22385f8c48026fee7aad7bba693bf788d7f27047f40b47738c0","signature":"1f38fe9a3f9989f84bd94aa5bbc88beaf09b67f825aa4450cf5105d111149ba6db560b582c7dbb026c7fc9c2eb5051815a72b17f6896ed59d3851d9a0f9883ca7a","work":"000e7b209d58f2e64b36e9bf12b999c6c7af168cc3fc41eb7f8a4bf796c174c3"},"props":{"account_creation_fee":{"amount":"100000","precision":3,"nai":"@@000000021"},"maximum_block_size":131072,"sbd_interest_rate":1000}}}],"extensions":[],"signatures":[]}}, "id":1}' https://api.steemit.com

database_api.get_required_signatures

This API will take a partially signed transaction and a set of public keys that the owner has the ability to sign for and return the minimal subset of public keys that should add signatures to the transaction.

Query Parameters JSON
{
  "trx": {
    "ref_block_num": 0,
    "ref_block_prefix": 0,
    "expiration": "1970-01-01T00:00:00",
    "operations": [],
    "extensions": [],
    "signatures": []
  },
  "available_keys": []
}
Expected Response JSON
{"keys": []}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.get_required_signatures", "params":{"trx":{"ref_block_num":1097,"ref_block_prefix":2181793527,"expiration":"2016-03-24T18:00:21","operations":[{"type":"pow_operation","value":{"worker_account":"cloop3","block_id":"00000449f7860b82b4fbe2f317c670e9f01d6d9a","nonce":3899,"work":{"worker":"STM7P5TDnA87Pj9T4mf6YHrhzjC1KbPZpNxLWCcVcHxNYXakpoT4F","input":"ae8e7c677119d22385f8c48026fee7aad7bba693bf788d7f27047f40b47738c0","signature":"1f38fe9a3f9989f84bd94aa5bbc88beaf09b67f825aa4450cf5105d111149ba6db560b582c7dbb026c7fc9c2eb5051815a72b17f6896ed59d3851d9a0f9883ca7a","work":"000e7b209d58f2e64b36e9bf12b999c6c7af168cc3fc41eb7f8a4bf796c174c3"},"props":{"account_creation_fee":{"amount":"100000","precision":3,"nai":"@@000000021"},"maximum_block_size":131072,"sbd_interest_rate":1000}}}],"extensions":[],"signatures":[]},"available_keys":[]}, "id":1}' https://api.steemit.com

database_api.get_reward_funds

Returns information about the current reward funds.

Query Parameters JSON
{}
Expected Response JSON
{"funds": []}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.get_reward_funds", "id":1}' https://api.steemit.com

database_api.get_transaction_hex

Returns a hexdump of the serialized binary form of a transaction.

Query Parameters JSON
{
  "trx": {
    "ref_block_num": 0,
    "ref_block_prefix": 0,
    "expiration": "1970-01-01T00:00:00",
    "operations": [],
    "extensions": [],
    "signatures": []
  }
}
Expected Response JSON
{"hex": ""}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.get_transaction_hex", "params":{"trx":{"ref_block_num":1097,"ref_block_prefix":2181793527,"expiration":"2016-03-24T18:00:21","operations":[{"type":"pow_operation","value":{"worker_account":"cloop3","block_id":"00000449f7860b82b4fbe2f317c670e9f01d6d9a","nonce":3899,"work":{"worker":"STM7P5TDnA87Pj9T4mf6YHrhzjC1KbPZpNxLWCcVcHxNYXakpoT4F","input":"ae8e7c677119d22385f8c48026fee7aad7bba693bf788d7f27047f40b47738c0","signature":"1f38fe9a3f9989f84bd94aa5bbc88beaf09b67f825aa4450cf5105d111149ba6db560b582c7dbb026c7fc9c2eb5051815a72b17f6896ed59d3851d9a0f9883ca7a","work":"000e7b209d58f2e64b36e9bf12b999c6c7af168cc3fc41eb7f8a4bf796c174c3"},"props":{"account_creation_fee":{"amount":"100000","precision":3,"nai":"@@000000021"},"maximum_block_size":131072,"sbd_interest_rate":1000}}}],"extensions":[],"signatures":[]}}, "id":1}' https://api.steemit.com

database_api.get_version

Returns the compile time versions of blockchain, steem, FC. Also returns the boot time version of the chain id (may be different from compile time value only when looking at a testnet)

Query Parameters JSON
{}
Expected Response JSON
{
  "blockchain_version": "",
  "steem_revision": "",
  "fc_revision": "",
  "chain_id": "0000000000000000000000000000000000000000000000000000000000000000"
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.get_version", "params":[], "id":1}' https://api.steemit.com

database_api.get_witness_schedule

Returns the current witness schedule.

Query Parameters JSON
{}
Expected Response JSON
{
  "id": 0,
  "current_virtual_time": "0",
  "next_shuffle_block_num": 76479392,
  "current_shuffled_witnesses": [],
  "num_scheduled_witnesses": 0,
  "elected_weight": 132,
  "timeshare_weight": 86,
  "miner_weight": 125,
  "witness_pay_normalization_factor": 32767,
  "median_props": {
    "account_creation_fee": {
      "amount": "1",
      "precision": 3,
      "nai": "@@000000021"
    },
    "maximum_block_size": 131072,
    "sbd_interest_rate": 1000,
    "account_subsidy_budget": 797,
    "account_subsidy_decay": 347321
  },
  "majority_version": "0.0.0",
  "max_voted_witnesses": 0,
  "max_miner_witnesses": 0,
  "max_runner_witnesses": 0,
  "hardfork_required_witnesses": 0,
  "account_subsidy_rd": {
    "resource_unit": 0,
    "budget_per_time_unit": 0,
    "pool_eq": 0,
    "max_pool_size": 0,
    "decay_params": {
      "decay_per_time_unit": 0,
      "decay_per_time_unit_denom_shift": 0
    },
    "min_decay": 0
  },
  "account_subsidy_witness_rd": {
    "resource_unit": 0,
    "budget_per_time_unit": 0,
    "pool_eq": 0,
    "max_pool_size": 0,
    "decay_params": {
      "decay_per_time_unit": 0,
      "decay_per_time_unit_denom_shift": 0
    },
    "min_decay": 0
  },
  "min_witness_account_subsidy_decay": 0
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.get_witness_schedule", "id":1}' https://api.steemit.com

database_api.list_account_recovery_requests

Returns a list of account recovery requests.

Query Parameters JSON
{"start": null, "limit": 0, "order": "by_name"}
Expected Response JSON
{"requests": []}

database_api.list_accounts

Returns a list of accounts.

Query Parameters JSON
{"start": null, "limit": 0, "order": "by_name"}
Expected Response JSON
{"accounts": []}

database_api.list_change_recovery_account_requests

Returns a list of recovery account change requests.

Query Parameters JSON
{"start": null, "limit": 0, "order": "by_name"}
Expected Response JSON
{"requests": []}

database_api.list_comments

Returns a list of comments.

Query Parameters JSON
{"start": null, "limit": 0, "order": "by_name"}
Expected Response JSON
{"comments": []}

database_api.list_decline_voting_rights_requests

Returns a list of decline voting rights requests.

Query Parameters JSON
{"start": null, "limit": 0, "order": "by_name"}
Expected Response JSON
{"requests": []}

database_api.list_escrows

Returns a list of escrows.

Query Parameters JSON
{"start": null, "limit": 0, "order": "by_name"}
Expected Response JSON
{"escrows": []}

database_api.list_limit_orders

Returns a list of limit orders.

Query Parameters JSON
{"start": null, "limit": 0, "order": "by_name"}
Expected Response JSON
{"orders": []}

database_api.list_owner_histories

Returns a list of owner authority histories.

Query Parameters JSON
{"start": null, "limit": 0}
Expected Response JSON
{"owner_auths": []}

database_api.list_savings_withdrawals

Returns a list of savings withdrawls.

Query Parameters JSON
{"start": null, "limit": 0, "order": "by_name"}
Expected Response JSON
{"withdrawals": []}

database_api.list_sbd_conversion_requests

Returns a list of SBD conversion requests.

Query Parameters JSON
{"start": null, "limit": 0, "order": "by_name"}
Expected Response JSON
{"requests": []}

database_api.list_vesting_delegation_expirations

Returns a list of vesting delegation expirations.

Query Parameters JSON
{"start": null, "limit": 0, "order": "by_name"}
Expected Response JSON
{"delegations": []}

database_api.list_vesting_delegations

Returns a list of vesting delegations.

Query Parameters JSON
{"start": null, "limit": 0, "order": "by_name"}
Expected Response JSON
{"delegations": []}

database_api.list_votes

Returns a list of votes.

Query Parameters JSON
{"start": null, "limit": 0, "order": "by_name"}
Expected Response JSON
{"votes": []}

database_api.list_withdraw_vesting_routes

Returns a list of vesting withdraw routes.

Query Parameters JSON
{"start": null, "limit": 0, "order": "by_name"}
Expected Response JSON
{"routes": []}

database_api.list_witness_votes

Returns a list of witness votes.

Query Parameters JSON
{"start": null, "limit": 0, "order": "by_name"}
Expected Response JSON
{"votes": []}

database_api.list_witnesses

Returns the list of witnesses.

Query Parameters JSON
{"start": null, "limit": 0, "order": "by_name"}
Expected Response JSON
{"witnesses": []}

database_api.verify_account_authority

Not Implemented

Query Parameters JSON
{"account": "", "signers": []}
Expected Response JSON
{"valid": false}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.verify_account_authority", "params":{"account":"steemit","signers":["STM7Q2rLBqzPzFeteQZewv9Lu3NLE69fZoLeL6YK59t7UmssCBNTU"]}, "id":1}' https://api.steemit.com

database_api.verify_authority

Returns true if the transaction has all of the required signatures.

Query Parameters JSON
{
  "trx": {
    "ref_block_num": 0,
    "ref_block_prefix": 0,
    "expiration": "1970-01-01T00:00:00",
    "operations": [],
    "extensions": [],
    "signatures": []
  }
}
Expected Response JSON
{"valid": false}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.verify_authority", "params":{"trx":{"ref_block_num":1097,"ref_block_prefix":2181793527,"expiration":"2016-03-24T18:00:21","operations":[{"type":"pow_operation","value":{"worker_account":"cloop3","block_id":"00000449f7860b82b4fbe2f317c670e9f01d6d9a","nonce":3899,"work":{"worker":"STM7P5TDnA87Pj9T4mf6YHrhzjC1KbPZpNxLWCcVcHxNYXakpoT4F","input":"ae8e7c677119d22385f8c48026fee7aad7bba693bf788d7f27047f40b47738c0","signature":"1f38fe9a3f9989f84bd94aa5bbc88beaf09b67f825aa4450cf5105d111149ba6db560b582c7dbb026c7fc9c2eb5051815a72b17f6896ed59d3851d9a0f9883ca7a","work":"000e7b209d58f2e64b36e9bf12b999c6c7af168cc3fc41eb7f8a4bf796c174c3"},"props":{"account_creation_fee":{"amount":"100000","precision":3,"nai":"@@000000021"},"maximum_block_size":131072,"sbd_interest_rate":1000}}}],"extensions":[],"signatures":[]}}, "id":1}' https://api.steemit.com

database_api.verify_signatures

This is a general purpose API that checks signatures against accounts for an arbitrary sha256 hash using the existing authority structures.

Query Parameters JSON
{
  "hash": "0000000000000000000000000000000000000000000000000000000000000000",
  "signatures": [],
  "required_owner": [],
  "required_active": [],
  "required_posting": [],
  "required_other": []
}
Expected Response JSON
{"valid": false}