# 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.

- Since: HF11
- Working on mainnet
- Working on testnet

#### database_api.find_account_recovery_requests

Returns a list of account recovery requests.

##### Query Parameters JSON

    {"accounts": []}

##### Expected Response JSON

    {"requests": []}

- Working on mainnet
- Working on testnet

#### database_api.find_accounts

Search for accounts.

##### Query Parameters JSON

    {"accounts": []}

##### Expected Response JSON

    {"accounts": []}

- Since: HF11
- Working on mainnet
- Working on testnet

#### 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": []}

- Working on mainnet
- Working on testnet

#### database_api.find_comments

Search for comments.

##### Query Parameters JSON

    {"comments": []}

##### Expected Response JSON

    {"comments": []}

- Since: HF14
- Working on mainnet
- Working on testnet

#### database_api.find_decline_voting_rights_requests

Returns a list of requests to decline voting rights.

##### Query Parameters JSON

    {"accounts": []}

##### Expected Response JSON

    {"requests": []}

- Since: HF14
- Working on mainnet
- Working on testnet

#### database_api.find_escrows

Returns a list of escrows.

##### Query Parameters JSON

    {"from": ""}

##### Expected Response JSON

    {"escrows": []}

- Working on mainnet
- Working on testnet

#### database_api.find_limit_orders

Returns a list of limit orders.

##### Query Parameters JSON

    {"account": ""}

##### Expected Response JSON

    {"orders": []}

- Working on mainnet
- Working on testnet

#### database_api.find_owner_histories

Returns owner authority history.

##### Query Parameters JSON

    {"owner": ""}

##### Expected Response JSON

    {"owner_auths": []}

- Since: HF14
- Working on mainnet
- Working on testnet

#### database_api.find_savings_withdrawals

Returns the list of savings withdrawls for an account.

##### Query Parameters JSON

    {"account": ""}

##### Expected Response JSON

    {"withdrawals": []}

- Working on mainnet
- Working on testnet

#### database_api.find_sbd_conversion_requests

Returns the list of SBD conversion requests for an account.

##### Query Parameters JSON

    {"account": ""}

##### Expected Response JSON

    {"requests": []}

- Since: HF17
- Working on mainnet
- Working on testnet

#### database_api.find_vesting_delegation_expirations

Returns the expirations for vesting delegations.

##### Query Parameters JSON

    {"account": ""}

##### Expected Response JSON

    {"delegations": []}

- Since: HF17
- Working on mainnet
- Working on testnet

#### database_api.find_vesting_delegations

Returns the list of vesting delegations for an account.

##### Query Parameters JSON

    {"account": ""}

##### Expected Response JSON

    {"delegations": []}

- Working on mainnet
- Working on testnet

#### database_api.find_votes

Returns the votes for an author and permlink.

##### Query Parameters JSON

    {"author": "", "permlink": ""}

##### Expected Response JSON

    {"votes": []}

- Working on mainnet
- Working on testnet

#### 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": []}

- Working on mainnet
- Working on testnet

#### database_api.find_witnesses

Search for witnesses.

##### Query Parameters JSON

    {"owners": []}

##### Expected Response JSON

    {"witnesses": []}

- Working on mainnet
- Working on testnet

#### 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

- Working on mainnet
- Working on testnet

#### 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

- Working on mainnet
- Working on testnet

#### 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"
      }
    }

- Working on mainnet
- Working on testnet

#### 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

- Working on mainnet
- Working on testnet

#### 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

- Working on mainnet
- Working on testnet

#### 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

- Working on mainnet
- Working on testnet

#### 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

- Working on mainnet
- Working on testnet

#### 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

- Working on mainnet
- Working on testnet

#### 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

- Since: HF17
- Working on mainnet
- Working on testnet

#### 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

- Working on mainnet
- Working on testnet

#### 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

- Since: HF20
- Working on mainnet
- Working on testnet

#### 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

- Working on mainnet
- Working on testnet

#### 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

- Since: HF11
- Working on mainnet
- Working on testnet

#### 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": []}

- Working on mainnet
- Working on testnet

#### database_api.list_accounts

Returns a list of accounts.

##### Query Parameters JSON

    {"start": null, "limit": 0, "order": "by_name"}

##### Expected Response JSON

    {"accounts": []}

- Since: HF11
- Working on mainnet
- Working on testnet

#### 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": []}

- Working on mainnet
- Working on testnet

#### database_api.list_comments

Returns a list of comments.

##### Query Parameters JSON

    {"start": null, "limit": 0, "order": "by_name"}

##### Expected Response JSON

    {"comments": []}

- Since: HF14
- Working on mainnet
- Working on testnet

#### 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": []}

- Since: HF14
- Working on mainnet
- Working on testnet

#### database_api.list_escrows

Returns a list of escrows.

##### Query Parameters JSON

    {"start": null, "limit": 0, "order": "by_name"}

##### Expected Response JSON

    {"escrows": []}

- Working on mainnet
- Working on testnet

#### 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": []}

- Working on mainnet
- Working on testnet

#### database_api.list_owner_histories

Returns a list of owner authority histories.

##### Query Parameters JSON

    {"start": null, "limit": 0}

##### Expected Response JSON

    {"owner_auths": []}

- Since: HF14
- Working on mainnet
- Working on testnet

#### 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": []}

- Working on mainnet
- Working on testnet

#### 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": []}

- Since: HF17
- Working on mainnet
- Working on testnet

#### 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": []}

- Since: HF17
- Working on mainnet
- Working on testnet

#### 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": []}

- Working on mainnet
- Working on testnet

#### database_api.list_votes

Returns a list of votes.

##### Query Parameters JSON

    {"start": null, "limit": 0, "order": "by_name"}

##### Expected Response JSON

    {"votes": []}

- Working on mainnet
- Working on testnet

#### 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": []}

- Working on mainnet
- Working on testnet

#### 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": []}

- Working on mainnet
- Working on testnet

#### database_api.list_witnesses

Returns the list of witnesses.

##### Query Parameters JSON

    {"start": null, "limit": 0, "order": "by_name"}

##### Expected Response JSON

    {"witnesses": []}

- Disabled
- Working on mainnet
- Working on testnet

#### 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

- Working on mainnet
- Working on testnet

#### 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

- Working on mainnet
- Working on testnet

#### 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}