Hive Developer logo

Hive Developer Portal - API Definitions

While the condenser_api.* calls are ready for use, all other appbase methods are currently works in progress and may change, or be unsuitable for production use.

Condenser Api

Methods:

To help with this transition, we created condenser_api, which contains all of the API methods that currently exist and uses the existing argument formatting. The easiest way to get your app to work with Appbase is to change the api to condenser_api.

All calls in condenser_api will return [] as the argument, as the array argument passing is opaque and implemented in the API calls themselves. They follow the current argument formatting. Existing apps should only need to skip using login_api and send all of their calls to condenser_api without any other changes required to use Appbase.

For example, calling get_dynamic_global_properties with condenser_api vs database_api:

{"jsonrpc":"2.0", "method":"condenser_api.get_dynamic_global_properties", "params":[], "id":1}
{"jsonrpc":"2.0", "method":"database_api.get_dynamic_global_properties", "id":1}

Because the method has no arguments, the params field can be omitted when not using condenser_api. However, it can optionally be included as the void type (e.g. "params":{}) but it is not required.

condenser_api.broadcast_block

Used to broadcast a block.

Also see: network_broadcast_api.broadcast_block

Query Parameters JSON
[
  {
    "previous": "0000000000000000000000000000000000000000",
    "timestamp": "1970-01-01T00:00:00",
    "witness": "",
    "transaction_merkle_root": "0000000000000000000000000000000000000000",
    "extensions": [],
    "witness_signature": "0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
    "transactions": []
  }
]
Expected Response JSON
{}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.broadcast_block", "params":[{"previous":"0000000000000000000000000000000000000000","timestamp":"1970-01-01T00:00:00","witness":"","transaction_merkle_root":"0000000000000000000000000000000000000000","extensions":[],"witness_signature":"0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000","transactions":[]}], "id":1}' https://api.hive.blog

condenser_api.broadcast_transaction

Used to broadcast a transaction.

Also see: network_broadcast_api.broadcast_transaction

Query Parameters JSON
[
  {
    "ref_block_num": 0,
    "ref_block_prefix": 0,
    "expiration": "1970-01-01T00:00:00",
    "operations": [],
    "extensions": [],
    "signatures": []
  }
]
Expected Response JSON
{}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.broadcast_transaction", "params":[{"ref_block_num":1097,"ref_block_prefix":2181793527,"expiration":"2016-03-24T18:00:21","operations":[["vote",{"voter":"hiveio","author":"alice","permlink":"a-post-by-alice","weight":10000}]],"extensions":[],"signatures":[]}], "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.broadcast_transaction", "params":[{"ref_block_num":1097,"ref_block_prefix":2181793527,"expiration":"2016-03-24T18:00:21","operations":[["pow",{"worker_account":"cloop3","block_id":"00000449f7860b82b4fbe2f317c670e9f01d6d9a","nonce":3899,"work":{"worker":"STM7P5TDnA87Pj9T4mf6YHrhzjC1KbPZpNxLWCcVcHxNYXakpoT4F","input":"ae8e7c677119d22385f8c48026fee7aad7bba693bf788d7f27047f40b47738c0","signature":"1f38fe9a3f9989f84bd94aa5bbc88beaf09b67f825aa4450cf5105d111149ba6db560b582c7dbb026c7fc9c2eb5051815a72b17f6896ed59d3851d9a0f9883ca7a","work":"000e7b209d58f2e64b36e9bf12b999c6c7af168cc3fc41eb7f8a4bf796c174c3"},"props":{"account_creation_fee":"100.000 HIVE","maximum_block_size":131072,"hbd_interest_rate":1000}}]],"extensions":[],"signatures":[]}], "id":1}' https://api.hive.blog

condenser_api.broadcast_transaction_synchronous

Used to broadcast a transaction and waits for it to be processed synchronously.

Query Parameters JSON
[
  {
    "ref_block_num": 0,
    "ref_block_prefix": 0,
    "expiration": "1970-01-01T00:00:00",
    "operations": [],
    "extensions": [],
    "signatures": []
  }
]
Expected Response JSON
{
  "id": "0000000000000000000000000000000000000000",
  "block_num": 0,
  "trx_num": 0,
  "expired": false
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.broadcast_transaction_synchronous", "params":[{"ref_block_num":1097,"ref_block_prefix":2181793527,"expiration":"2016-03-24T18:00:21","operations":[["vote",{"voter":"hiveio","author":"alice","permlink":"a-post-by-alice","weight":10000}]],"extensions":[],"signatures":[]}], "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.broadcast_transaction_synchronous", "params":[{"ref_block_num":1097,"ref_block_prefix":2181793527,"expiration":"2016-03-24T18:00:21","operations":[["pow",{"worker_account":"cloop3","block_id":"00000449f7860b82b4fbe2f317c670e9f01d6d9a","nonce":3899,"work":{"worker":"STM7P5TDnA87Pj9T4mf6YHrhzjC1KbPZpNxLWCcVcHxNYXakpoT4F","input":"ae8e7c677119d22385f8c48026fee7aad7bba693bf788d7f27047f40b47738c0","signature":"1f38fe9a3f9989f84bd94aa5bbc88beaf09b67f825aa4450cf5105d111149ba6db560b582c7dbb026c7fc9c2eb5051815a72b17f6896ed59d3851d9a0f9883ca7a","work":"000e7b209d58f2e64b36e9bf12b999c6c7af168cc3fc41eb7f8a4bf796c174c3"},"props":{"account_creation_fee":"100.000 HIVE","maximum_block_size":131072,"hbd_interest_rate":1000}}]],"extensions":[],"signatures":[]}], "id":1}' https://api.hive.blog

condenser_api.get_account_bandwidth

Disabled since 0.20.6, see: #3029; Removed: HF24

Returns the available bandwidth of an account. Parameters: account:string; type:string, e.g.: forum or market

account (string) type (string)  
"hiveio" "forum" Query the available forum bandwidth for the account named “hiveio”.
"alice" "market" Query the available market bandwidth for the account named “alice”.

See: Forum/Market Bandwidth

Query Parameters JSON
["", ""]
Expected Response JSON
{
  "id": 8,
  "account": "hiveio",
  "type": "forum",
  "average_bandwidth": 214996934,
  "lifetime_bandwidth": "48395000000",
  "last_bandwidth_update": "2018-02-16T03:11:00"
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_account_bandwidth", "params":["hiveio","forum"], "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_account_bandwidth", "params":["alice","market"], "id":1}' https://api.hive.blog

condenser_api.get_account_count

Returns the number of accounts.

Query Parameters JSON
[]
Expected Response JSON
0
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_account_count", "params":[], "id":1}' https://api.hive.blog

condenser_api.get_account_history

Returns a history of all operations for a given account. Parameters:

If either operation_filter_low or operation_filter_high are set, the set of returned operations will include only these matching bitwise filter.

For the first 64 operations (as defined in protocol/operations.hpp), set the corresponding bit in operation_filter_low; for the higher-numbered operations, set the bit in operation_filter_high (pretending operation_filter is a 128-bit bitmask composed of {operation_filter_high, operation_filter_low})

account (string) start (int) limit (int) operation_filter_low (int) operation_filter_low (int)  
"hiveio" 1000 1000     Queries the account named hiveio starting on the latest item in history, up to 1,000 results.
"alice" -1 1000     Queries the account named alice starting on the oldest item in history, up to 1,000 results.
"bob" -1 1000 1   Queries only votes by the account named bob starting on the oldest item in history, up to 1,000 results.
"charlie" -1 1000 262144   Queries only custom jsons by the account named charlie starting on the oldest item in history, up to 1,000 results.
"emma" -1 1000 0 1 Queries only proposal payments by the account named emma starting on the oldest item in history, up to 1,000 results.

Also see: account_history_api.get_account_history, Paginated API Methods

Query Parameters JSON
["", 0, 1000]
Expected Response JSON
[
  99,
  {
    "trx_id": "0000000000000000000000000000000000000000",
    "block": 0,
    "trx_in_block": 4294967295,
    "op_in_trx": 0,
    "virtual_op": 0,
    "timestamp": "2019-12-09T21:32:39",
    "op": {}
  }
]
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_account_history", "params":["hiveio", 1000, 1000], "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_account_history", "params":["hiveio", -1, 1000], "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_account_history", "params":["bob", -1, 1000, 1], "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_account_history", "params":["charlie", -1, 1000, 262144], "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_account_history", "params":["emma", -1, 1000, 0, 1], "id":1}' https://api.hive.blog

condenser_api.get_account_reputations

Returns a list of account reputations. Parameters: account_lower_bound:string; limit:int up to 1000

account_lower_bound (string) limit (int)  
"hiveio" 1 Queries for accounts that start with “hiveio”, only one result.
"a" 10 Queries for accounts that start with “a”, up to 10 results.

Also see: follow_api.get_account_reputations

Query Parameters JSON
["", 1000]
Expected Response JSON
[]
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_account_reputations", "params":["hiveio", 1], "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_account_reputations", "params":["a", 10], "id":1}' https://api.hive.blog

condenser_api.get_account_votes

Returns all votes by an account. Parameters: account:string

account (string)  
"hiveio" Queries for votes by “hiveio”.
"alice" Queries for votes by “alice”.
Query Parameters JSON
[""]
Expected Response JSON
[
  {
    "authorperm": "",
    "weight": "",
    "rshares": "",
    "percent": null,
    "time": "2016-04-29T22:27:42"
  }
]
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_account_votes", "params":["hiveio"], "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_account_votes", "params":["alice"], "id":1}' https://api.hive.blog

condenser_api.get_accounts

Returns accounts, queried by name. Parameters: account:string array; delayed_votes_active:boolean

account (string array) delayed_votes_active (boolean)  
["hiveio"]   Queries for account named “hiveio”.
["hiveio", "alice"] false Queries for accounts named “hiveio” and “alice” with delayed_votes hidden.

Also see: database_api.find_accounts

Query Parameters JSON
[[""]]
Expected Response JSON
{
  "id": 1370484,
  "name": "hiveio",
  "owner": {
    "weight_threshold": 1,
    "account_auths": [],
    "key_auths": [
      [
        "STM65PUAPA4yC4RgPtGgsPupxT6yJtMhmT5JHFdsT3uoCbR8WJ25s",
        1
      ]
    ]
  },
  "active": {
    "weight_threshold": 1,
    "account_auths": [],
    "key_auths": [
      [
        "STM69zfrFGnZtU3gWFWpQJ6GhND1nz7TJsKBTjcWfebS1JzBEweQy",
        1
      ]
    ]
  },
  "posting": {
    "weight_threshold": 1,
    "account_auths": [["threespeak", 1], ["vimm.app", 1]],
    "key_auths": [
      [
        "STM6vJmrwaX5TjgTS9dPH8KsArso5m91fVodJvv91j7G765wqcNM9",
        1
      ]
    ]
  },
  "memo_key": "STM7wrsg1BZogeK7X3eG4ivxmLaH69FomR8rLkBbepb3z3hm5SbXu",
  "json_metadata": "",
  "posting_json_metadata": "{\"profile\":{\"pinned\":\"none\",\"version\":2,\"website\":\"hive.io\",\"profile_image\":\"https://files.peakd.com/file/peakd-hive/hiveio/Jp2YHc6Q-hive-logo.png\",\"cover_image\":\"https://files.peakd.com/file/peakd-hive/hiveio/Xe1TcEBi-hive-banner.png\"}}",
  "proxy": "",
  "last_owner_update": "1970-01-01T00:00:00",
  "last_account_update": "2020-11-12T01:20:48",
  "created": "2020-03-06T12:22:48",
  "mined": false,
  "recovery_account": "steempeak",
  "last_account_recovery": "1970-01-01T00:00:00",
  "reset_account": "null",
  "comment_count": 0,
  "lifetime_vote_count": 0,
  "post_count": 31,
  "can_vote": true,
  "voting_manabar": {
    "current_mana": "598442432741",
    "last_update_time": 1591297380
  },
  "downvote_manabar": {
    "current_mana": "149610608184",
    "last_update_time": 1591297380
  },
  "voting_power": 0,
  "balance": "11.682 HIVE",
  "savings_balance": "0.000 HIVE",
  "hbd_balance": "43.575 HBD",
  "hbd_seconds": "0",
  "hbd_seconds_last_update": "2020-10-21T02:45:12",
  "hbd_last_interest_payment": "2020-10-21T02:45:12",
  "savings_hbd_balance": "0.000 HBD",
  "savings_hbd_seconds": "0",
  "savings_hbd_seconds_last_update": "1970-01-01T00:00:00",
  "savings_hbd_last_interest_payment": "1970-01-01T00:00:00",
  "savings_withdraw_requests": 0,
  "reward_hbd_balance": "0.000 HBD",
  "reward_hive_balance": "0.000 HIVE",
  "reward_vesting_balance": "0.000000 VESTS",
  "reward_vesting_hive": "0.000 HIVE",
  "vesting_shares": "598442.432741 VESTS",
  "delegated_vesting_shares": "0.000000 VESTS",
  "received_vesting_shares": "0.000000 VESTS",
  "vesting_withdraw_rate": "0.000000 VESTS",
  "post_voting_power": "598442.432741 VESTS",
  "next_vesting_withdrawal": "1969-12-31T23:59:59",
  "withdrawn": 0,
  "to_withdraw": 0,
  "withdraw_routes": 0,
  "pending_transfers": 0,
  "curation_rewards": 0,
  "posting_rewards": 604589,
  "proxied_vsf_votes": [0, 0, 0, 0],
  "witnesses_voted_for": 0,
  "last_post": "2021-03-23T18:05:48",
  "last_root_post": "2021-03-23T18:05:48",
  "last_vote_time": "1970-01-01T00:00:00",
  "post_bandwidth": 0,
  "pending_claimed_accounts": 0,
  "delayed_votes": [
    {
      "time": "2021-02-24T05:08:21",
      "val": "11550765516955"
    },
    {
      "time": "2021-02-26T15:46:06",
      "val": "633465684569"
    },
    {
      "time": "2021-03-07T17:54:39",
      "val": "1000000037683"
    },
    {
      "time": "2021-03-16T05:54:33",
      "val": "999978763511"
    },
    {
      "time": "2021-03-18T06:06:00",
      "val": "1000000171317"
    }
  ],
  "vesting_balance": "0.000 HIVE",
  "reputation": "88826789432105",
  "transfer_history": [],
  "market_history": [],
  "post_history": [],
  "vote_history": [],
  "other_history": [],
  "witness_votes": [],
  "tags_usage": [],
  "guest_bloggers": []
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_accounts", "params":[["hiveio"]], "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_accounts", "params":[["hiveio", "alice"], true], "id":1}' https://api.hive.blog

condenser_api.get_active_votes

Returns all votes for the given post. Parameters: author:string; permlink:string

author (string) permlink (string)  
"hiveio" "firstpost" Queries votes for content with a slug @hiveio/firstpost
"alice" "a-post-by-alice" Queries votes for content with a slug @alice/a-post-by-alice
Query Parameters JSON
["", ""]
Expected Response JSON
[
  {
    "voter": "",
    "weight": "",
    "rshares": 0,
    "percent": 0,
    "reputation": "",
    "time": "1970-01-01T00:00:00"
  }
]
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_active_votes", "params":["hiveio", "firstpost"], "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_active_votes", "params":["alice", "a-post-by-alice"], "id":1}' https://api.hive.blog

condenser_api.get_active_witnesses

Returns the list of active witnesses.

Also see: database_api.get_active_witnesses

Query Parameters JSON
[]
Expected Response JSON
[]
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_active_witnesses", "params":[], "id":1}' https://api.hive.blog

condenser_api.get_block

Returns a block. Parameters: block_num:int

block_num (int)  
1 Queries the very first block.
8675309 Queries block number 8,675,309.
62396745 Queries block number 62,396,745.

Also see: block_api.get_block

Query Parameters JSON
[1]
Expected Response JSON
{
  "previous": "0000000000000000000000000000000000000000",
  "timestamp": "2016-03-24T16:05:00",
  "witness": "initminer",
  "transaction_merkle_root": "0000000000000000000000000000000000000000",
  "extensions": [],
  "witness_signature": "204f8ad56a8f5cf722a02b035a61b500aa59b9519b2c33c77a80c0a714680a5a5a7a340d909d19996613c5e4ae92146b9add8a7a663eef37d837ef881477313043",
  "transactions": [],
  "block_id": "0000000109833ce528d5bbfb3f6225b39ee10086",
  "signing_key": "STM8GC13uCZbP44HzMLV6zPZGwVQ8Nt4Kji8PapsPiNq1BK153XTX",
  "transaction_ids": []
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_block", "params":[1], "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_block", "params":[8675309], "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_block", "params":[62396745], "id":1}' https://api.hive.blog

condenser_api.get_block_header

Returns a block header. Parameters: block_num:int

block_num (int)  
1 Queries the block headers for the very first block.
8675309 Queries block headers for block number 8,675,309.
62396745 Queries block headers for block number 62,396,745.

Also see: block_api.get_block_header

Query Parameters JSON
[1]
Expected Response JSON
{
  "previous": "0000000000000000000000000000000000000000",
  "timestamp": "2016-03-24T16:05:00",
  "witness": "initminer",
  "transaction_merkle_root": "0000000000000000000000000000000000000000",
  "extensions": []
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_block_header", "params":[1], "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_block_header", "params":[8675309], "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_block_header", "params":[62396745], "id":1}' https://api.hive.blog

condenser_api.get_blog

Returns the list of blog entries for an account. Parameters: account:string; start_entry_id:int; limit:int up to 500

account (string) start_entry_id (int) limit (int)  
“hiveio” 0 1 Queries the blog for the account named “hiveio”, up to one result.
“alice” 0 50 Queries the blog for the account named “alice”, up to 50 results.

Also see: Paginated API Methods

Query Parameters JSON
["hiveio", 0, 1]
Expected Response JSON
[
  {
    "comment": {
      "id": 0,
      "author": "hiveio",
      "permlink": "firstpost",
      "category": "meta",
      "parent_author": "",
      "parent_permlink": "meta",
      "title": "Welcome to Hive!",
      "body": "Hive is a social media platform where anyone can earn HIVE points by posting. The more people who like a post, the more HIVE the poster earns. Anyone can sell their HIVE for cash or vest it to boost their voting power.",
      "json_metadata": "",
      "last_update": "2016-03-30T18:30:18",
      "created": "2016-03-30T18:30:18",
      "active": "2018-04-09T12:00:42",
      "last_payout": "2016-08-24T19:59:42",
      "depth": 0,
      "children": 336,
      "net_rshares": 0,
      "abs_rshares": 0,
      "vote_rshares": 0,
      "children_abs_rshares": "26169324897669",
      "cashout_time": "1969-12-31T23:59:59",
      "max_cashout_time": "1969-12-31T23:59:59",
      "total_vote_weight": 0,
      "reward_weight": 10000,
      "total_payout_value": {
        "amount": "942",
        "precision": 3,
        "nai": "@@000000013"
      },
      "curator_payout_value": {
        "amount": "756",
        "precision": 3,
        "nai": "@@000000013"
      },
      "author_rewards": 3548,
      "net_votes": 90,
      "root_author": "hiveio",
      "root_permlink": "firstpost",
      "max_accepted_payout": {
        "amount": "1000000000",
        "pecision": 3,
        "nai": "@@000000013"
      },
      "percent_hbd": 10000,
      "allow_replies": true,
      "allow_votes": true,
      "allow_curation_rewards": true,
      "beneficiaries": []
    },
    "blog": "hiveio",
    "reblog_on": "1970-01-01T00:00:00",
    "entry_id": 0
  }
]
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_blog", "params":["hiveio",0,1], "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_blog", "params":["alice",0,50], "id":1}' https://api.hive.blog

condenser_api.get_blog_authors

Returns a list of authors that have had their content reblogged on a given blog account. Parameters: account:string

account (string)  
"hiveio" Queries for account named “hiveio”.
"alice" Queries for accounts named alice”.
Query Parameters JSON
[""]
Expected Response JSON
[{"author": "", "count": 0}]
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_blog_authors", "params":["hiveio"], "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_blog_authors", "params":["alice"], "id":1}' https://api.hive.blog

condenser_api.get_blog_entries

Returns a list of blog entries for an account. Parameters: account:string; start_entry_id:int; limit:int up to 500

account (string) start_entry_id (int) limit (int)  
“hiveio” 0 1 Queries the blog entries for the account named “hiveio”, up to one result.
“alice” 0 50 Queries the blog entries for the account named “alice”, up to 50 results.

Also see: Paginated API Methods

Query Parameters JSON
["hiveio", 0, 1]
Expected Response JSON
[
  {
    "author": "hiveio",
    "permlink": "firstpost",
    "blog": "hiveio",
    "reblog_on": "1970-01-01T00:00:00",
    "entry_id": 0
  }
]
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_blog_entries", "params":["hiveio",0,1], "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_blog_entries", "params":["alice",0,50], "id":1}' https://api.hive.blog

condenser_api.get_chain_properties

Returns the chain properties.

Query Parameters JSON
[]
Expected Response JSON
{
  "account_creation_fee": "0.100 HIVE",
  "maximum_block_size": 131072,
  "hbd_interest_rate": 1000,
  "account_subsidy_limit": 0
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_chain_properties", "params":[], "id":1}' https://api.hive.blog

condenser_api.get_comment_discussions_by_payout

Returns a list of discussions based on payout.

Also see: tags_api.get_comment_discussions_by_payout

Query Parameters JSON
[
  {
    "tag": "",
    "limit": 0,
    "filter_tags": [],
    "select_authors": [],
    "select_tags": [],
    "truncate_body": 0
  }
]
Expected Response JSON
[]
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_comment_discussions_by_payout", "params":[{"tag":"hive","limit":1}], "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_comment_discussions_by_payout", "params":[{"tag":"photography","limit":10,"truncate_body":0}], "id":1}' https://api.hive.blog

condenser_api.get_config

Returns information about compile-time constants. See: Understanding Configuration Values

Also see: database_api.get_config

Query Parameters JSON
[]
Expected Response JSON
{}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_config", "params":[], "id":1}' https://api.hive.blog

condenser_api.get_content

Returns the content (post or comment). Parameters: author:string; permlink:string

author (string) permlink (string)  
"hiveio" "firstpost" Queries content with a slug @hiveio/firstpost
"alice" "a-post-by-alice" Queries content with a slug @alice/a-post-by-alice
Query Parameters JSON
["", ""]
Expected Response JSON
{
  "id": 0,
  "author": "",
  "permlink": "",
  "category": "",
  "parent_author": "",
  "parent_permlink": "",
  "title": "",
  "body": "",
  "json_metadata": "",
  "last_update": "1970-01-01T00:00:00",
  "created": "1970-01-01T00:00:00",
  "active": "1970-01-01T00:00:00",
  "last_payout": "1970-01-01T00:00:00",
  "depth": 0,
  "children": 0,
  "net_rshares": 0,
  "abs_rshares": 0,
  "vote_rshares": 0,
  "children_abs_rshares": 0,
  "cashout_time": "1970-01-01T00:00:00",
  "max_cashout_time": "1970-01-01T00:00:00",
  "total_vote_weight": 0,
  "reward_weight": 0,
  "total_payout_value": "0.000 HIVE",
  "curator_payout_value": "0.000 HIVE",
  "author_rewards": 0,
  "net_votes": 0,
  "root_author": "",
  "root_permlink": "",
  "max_accepted_payout": "0.000 HIVE",
  "percent_hbd": 0,
  "allow_replies": false,
  "allow_votes": false,
  "allow_curation_rewards": false,
  "beneficiaries": [],
  "url": "",
  "root_title": "",
  "pending_payout_value": "0.000 HIVE",
  "total_pending_payout_value": "0.000 HIVE",
  "active_votes": [],
  "replies": [],
  "author_reputation": 0,
  "promoted": "0.000 HIVE",
  "body_length": 0,
  "reblogged_by": []
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_content", "params":["hiveio", "firstpost"], "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_content", "params":["alice", "a-post-by-alice"], "id":1}' https://api.hive.blog

condenser_api.get_content_replies

Returns a list of replies. Parameters: author:string; permlink:string

author (string) permlink (string)  
"hiveio" "firstpost" Queries replies for a slug @hiveio/firstpost
"alice" "a-post-by-alice" Queries replies for a slug @alice/a-post-by-alice

Also see: tags_api.get_content_replies

Query Parameters JSON
["", ""]
Expected Response JSON
{
  "id": 0,
  "author": "",
  "permlink": "",
  "category": "",
  "parent_author": "",
  "parent_permlink": "",
  "title": "",
  "body": "",
  "json_metadata": "",
  "last_update": "1970-01-01T00:00:00",
  "created": "1970-01-01T00:00:00",
  "active": "1970-01-01T00:00:00",
  "last_payout": "1970-01-01T00:00:00",
  "depth": 0,
  "children": 0,
  "net_rshares": 0,
  "abs_rshares": 0,
  "vote_rshares": 0,
  "children_abs_rshares": 0,
  "cashout_time": "1970-01-01T00:00:00",
  "max_cashout_time": "1970-01-01T00:00:00",
  "total_vote_weight": 0,
  "reward_weight": 0,
  "total_payout_value": "0.000 HIVE",
  "curator_payout_value": "0.000 HIVE",
  "author_rewards": 0,
  "net_votes": 0,
  "root_author": "",
  "root_permlink": "",
  "max_accepted_payout": "0.000 HIVE",
  "percent_hbd": 0,
  "allow_replies": false,
  "allow_votes": false,
  "allow_curation_rewards": false,
  "beneficiaries": [],
  "url": "",
  "root_title": "",
  "pending_payout_value": "0.000 HIVE",
  "total_pending_payout_value": "0.000 HIVE",
  "active_votes": [],
  "replies": [],
  "author_reputation": 0,
  "promoted": "0.000 HIVE",
  "body_length": 0,
  "reblogged_by": []
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_content_replies", "params":["hiveio", "firstpost"], "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_content_replies", "params":["alice", "a-post-by-alice"], "id":1}' https://api.hive.blog

condenser_api.get_conversion_requests

Returns a list of conversion request. Parameters: id:integer

id (int)  
1234 Queries a conversion request with the id of 1234.

Also see: database_api.list_hbd_conversion_requests

Query Parameters JSON
[0]
Expected Response JSON
[]
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_conversion_requests", "params":[1234], "id":1}' https://api.hive.blog

condenser_api.get_current_median_history_price

Query Parameters JSON
[]
Expected Response JSON
{"base": "0.000 HIVE", "quote": "0.000 HIVE"}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_current_median_history_price", "params":[], "id":1}' https://api.hive.blog

condenser_api.get_discussions_by_active

Returns a list of discussions based on active.

Query Parameters JSON
[
  {
    "tag": "",
    "limit": 0,
    "filter_tags": [],
    "select_authors": [],
    "select_tags": [],
    "truncate_body": 0
  }
]
Expected Response JSON
[]
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_discussions_by_active", "params":[{"tag":"hive","limit":1}], "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_discussions_by_active", "params":[{"tag":"photography","limit":10,"truncate_body":0}], "id":1}' https://api.hive.blog

condenser_api.get_discussions_by_author_before_date

Returns a list of discussions based on author before date.

Also see: tags_api.get_discussions_by_author_before_date, Paginated API Methods

Query Parameters JSON
["", "", "1970-01-01T00:00:00", 100]
Expected Response JSON
[]
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_discussions_by_author_before_date", "params":["hiveio","firstpost","2016-04-19T22:49:43",1], "id":1}' https://api.hive.blog

condenser_api.get_discussions_by_blog

Returns a list of discussions by blog.

Also see: tags_api.get_discussions_by_blog

Query Parameters JSON
[
  {
    "tag": "",
    "limit": 0,
    "filter_tags": [],
    "select_authors": [],
    "select_tags": [],
    "truncate_body": 0
  }
]
Expected Response JSON
[]
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_discussions_by_blog", "params":[{"tag":"hiveio","limit":1}], "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_discussions_by_blog", "params":[{"tag":"alice","limit":10}], "id":1}' https://api.hive.blog

condenser_api.get_discussions_by_cashout

Returns a list of discussions by cashout.

Query Parameters JSON
[
  {
    "tag": "",
    "limit": 0,
    "filter_tags": [],
    "select_authors": [],
    "select_tags": [],
    "truncate_body": 0
  }
]
Expected Response JSON
[]
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_discussions_by_cashout", "params":[{"tag":"hive","limit":1}], "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_discussions_by_cashout", "params":[{"tag":"photography","limit":10,"truncate_body":0}], "id":1}' https://api.hive.blog

condenser_api.get_discussions_by_children

Returns a list of discussions by children.

Query Parameters JSON
[
  {
    "tag": "",
    "limit": 0,
    "filter_tags": [],
    "select_authors": [],
    "select_tags": [],
    "truncate_body": 0
  }
]
Expected Response JSON
[]
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_discussions_by_children", "params":[{"tag":"hive","limit":1}], "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_discussions_by_children", "params":[{"tag":"photography","limit":10,"truncate_body":0}], "id":1}' https://api.hive.blog

condenser_api.get_discussions_by_comments

Returns a list of discussions by comments.

Also see: tags_api.get_discussions_by_comments

Query Parameters JSON
[
  {
    "start_author": "",
    "start_permlink": "",
    "limit": 100
  }
]
Expected Response JSON
[]
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_discussions_by_comments", "params":[{"start_author":"hiveio","start_permlink":"firstpost","limit":1}], "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_discussions_by_comments", "params":[{"start_author":"alice","start_permlink":"a-post-by-alice","limit":10,"truncate_body":0}], "id":1}' https://api.hive.blog

condenser_api.get_discussions_by_created

Returns a list of discussions by created.

Also see: tags_api.get_discussions_by_created

Query Parameters JSON
[
  {
    "tag": "",
    "limit": 0,
    "filter_tags": [],
    "select_authors": [],
    "select_tags": [],
    "truncate_body": 0
  }
]
Expected Response JSON
[]
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_discussions_by_created", "params":[{"tag":"hive","limit":1}], "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_discussions_by_created", "params":[{"tag":"photography","limit":10,"truncate_body":0}], "id":1}' https://api.hive.blog

condenser_api.get_discussions_by_feed

Returns a list of discussions by feed.

Query Parameters JSON
[
  {
    "tag": "",
    "start_author": "",
    "start_permlink": "",
    "limit": 100
  }
]
Expected Response JSON
[]
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_discussions_by_feed", "params":[{"tag":"hive","limit":1}], "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_discussions_by_feed", "params":[{"tag":"photography","limit":10,"truncate_body":0}], "id":1}' https://api.hive.blog

condenser_api.get_discussions_by_hot

Returns a list of discussions by hot.

Also see: tags_api.get_discussions_by_hot

Query Parameters JSON
[
  {
    "tag": "",
    "limit": 0,
    "filter_tags": [],
    "select_authors": [],
    "select_tags": [],
    "truncate_body": 0
  }
]
Expected Response JSON
[]
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_discussions_by_hot", "params":[{"tag":"hive","limit":1}], "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_discussions_by_hot", "params":[{"tag":"photography","limit":10,"truncate_body":0}], "id":1}' https://api.hive.blog

condenser_api.get_discussions_by_promoted

Returns a list of discussions by promoted.

Also see: tags_api.get_discussions_by_promoted

Query Parameters JSON
[
  {
    "tag": "",
    "limit": 0,
    "filter_tags": [],
    "select_authors": [],
    "select_tags": [],
    "truncate_body": 0
  }
]
Expected Response JSON
[]
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_discussions_by_promoted", "params":[{"tag":"hive","limit":1}], "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_discussions_by_promoted", "params":[{"tag":"photography","limit":10,"truncate_body":0}], "id":1}' https://api.hive.blog

Returns a list of discussions by trending.

Also see: tags_api.get_discussions_by_trending

[
  {
    "tag": "",
    "limit": 0,
    "filter_tags": [],
    "select_authors": [],
    "select_tags": [],
    "truncate_body": 0
  }
]
[]
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_discussions_by_trending", "params":[{"tag":"hive","limit":1}], "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_discussions_by_trending", "params":[{"tag":"photography","limit":10,"truncate_body":0}], "id":1}' https://api.hive.blog

condenser_api.get_discussions_by_votes

Returns a list of discussions by votes.

Query Parameters JSON
[
  {
    "tag": "",
    "limit": 0,
    "filter_tags": [],
    "select_authors": [],
    "select_tags": [],
    "truncate_body": 0
  }
]
Expected Response JSON
[]
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_discussions_by_votes", "params":[{"tag":"hive","limit":1}], "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_discussions_by_votes", "params":[{"tag":"photography","limit":10,"truncate_body":0}], "id":1}' https://api.hive.blog

condenser_api.get_dynamic_global_properties

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

Also see: database_api.get_dynamic_global_properties

Query Parameters JSON
[]
Expected Response JSON
{
  "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": "0.000 HIVE",
  "current_supply": "0.000 HIVE",
  "confidential_supply": "0.000 HIVE",
  "current_hbd_supply": "0.000 HIVE",
  "confidential_hbd_supply": "0.000 HIVE",
  "total_vesting_fund_hive": "0.000 HIVE",
  "total_vesting_shares": "0.000 HIVE",
  "total_reward_fund_hive": "0.000 HIVE",
  "total_reward_shares2": "0",
  "pending_rewarded_vesting_shares": "0.000 HIVE",
  "pending_rewarded_vesting_hive": "0.000 HIVE",
  "hbd_interest_rate": 0,
  "hbd_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
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_dynamic_global_properties", "params":[], "id":1}' https://api.hive.blog

condenser_api.get_escrow

Returns the escrow for a certain account by id.

Also see: database_api.list_escrows

Query Parameters JSON
["", 0]
Expected Response JSON
null
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_escrow", "params":["hiveio", 1234], "id":1}' https://api.hive.blog

condenser_api.get_expiring_vesting_delegations

Returns the expiring vesting delegations for an account. Parameters: account:string, after:timestamp

account (string) after (timestamp)  
"hiveio" "2018-01-01T00:00:00" Queries for expiring vesting after January 1st, 2018.
"alice" "2017-12-01T00:00:00" Queries for expiring vesting after December 1st, 2017.
Query Parameters JSON
["", "1970-01-01T00:00:00"]
Expected Response JSON
[
  {
    "id": 0,
    "delegator": "",
    "vesting_shares": "0.000000 VESTS",
    "expiration": "1970-01-01T00:00:00"
  }
]
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_expiring_vesting_delegations", "params":["hiveio","2018-01-01T00:00:00"], "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_expiring_vesting_delegations", "params":["alice","2017-12-01T00:00:00"], "id":1}' https://api.hive.blog

condenser_api.get_feed

Returns a list of items in an account’s feed. Parameters: account:string; start_entry_id:int; limit:int up to 500

account (string) start_entry_id (int) limit (int)  
"hiveio" 0 1 Queries the account named hiveio starting on the first item, up to 1 result.
"alice" 1 10 Queries the account named alice starting on the second item, up to 10 results.

Also see: Paginated API Methods

Query Parameters JSON
["", 0, 1]
Expected Response JSON
[]
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_feed", "params":["hiveio",0,1], "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_feed", "params":["alice",1,10], "id":1}' https://api.hive.blog

condenser_api.get_feed_entries

Returns a list of entries in an account’s feed. Parameters: account:string; start_entry_id:int; limit:int up to 500

account (string) start_entry_id (int) limit (int)  
"hiveio" 0 1 Queries the account named hiveio starting on the first item, up to 1 result.
"alice" 1 10 Queries the account named alice starting on the second item, up to 10 results.

Also see: Paginated API Methods

Query Parameters JSON
["", 0, 1]
Expected Response JSON
[]
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_feed_entries", "params":["hiveio",0,1], "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_feed_entries", "params":["alice",1,10], "id":1}' https://api.hive.blog

condenser_api.get_feed_history

Returns the history of price feed values.

Also see: database_api.get_feed_history

Query Parameters JSON
[]
Expected Response JSON
{
  "id": 0,
  "current_median_history": {"base": "0.000 HIVE", "quote": "0.000 HIVE"},
  "price_history": []
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_feed_history", "params":[], "id":1}' https://api.hive.blog

condenser_api.get_follow_count

Returns the count of followers/following for an account. Parameters: account:string

account (string)  
"hiveio" Queries the account named hiveio.
"alice" Queries the account named alice.
Query Parameters JSON
[""]
Expected Response JSON
{
  "account": "",
  "follower_count": 0,
  "following_count": 0
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_follow_count", "params":["hiveio"], "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_follow_count", "params":["alice"], "id":1}' https://api.hive.blog

condenser_api.get_followers

Returns the list of followers for an account. Parameters: account:string; start:string (account to start from); type:string e.g.: blog; limit:int up to 1000

account (string) start (string) type (string) limit (int)  
"hiveio" null "blog" 10 Queries for follows of the account named hiveio, up to 10 results.
"alice" null "ignore" 100 Queries for mutes of the account named alice, up to 100 results.

Also see: Paginated API Methods

Query Parameters JSON
["", "", "", 1]
Expected Response JSON
[]
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_followers", "params":["hiveio",null,"blog",10], "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_followers", "params":["alice",null,"ignore",100], "id":1}' https://api.hive.blog

condenser_api.get_following

Returns the list of accounts that are following an account. Parameters: account:string; start:string (account to start from); type:string e.g.: blog; limit:int up to 1000

account (string) start (string) type (string) limit (int)  
"hiveio" null "blog" 10 Queries for follows of the account named hiveio, up to 10 results.
"alice" null "ignore" 100 Queries for mutes of the account named alice, up to 100 results.

Also see: Paginated API Methods

Query Parameters JSON
["", "", "", 1]
Expected Response JSON
[]
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_following", "params":["hiveio",null,"blog",10], "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_following", "params":["alice",null,"ignore",100], "id":1}' https://api.hive.blog

condenser_api.get_hardfork_version

Returns the current hardfork version.

Also see: database_api.get_hardfork_properties

Query Parameters JSON
[]
Expected Response JSON
"0.0.0"
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_hardfork_version", "params":[], "id":1}' https://api.hive.blog

condenser_api.get_key_references

Returns all accounts that have the key associated with their owner or active authorities.

Also see: account_by_key_api.get_key_references

Query Parameters JSON
[
  [
    "STM5jZtLoV8YbxCxr4imnbWn61zMB24wwonpnVhfXRmv7j6fk3dTH"
  ]
]
Expected Response JSON
[["hiveio"]]
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_key_references", "params":[["STM5jZtLoV8YbxCxr4imnbWn61zMB24wwonpnVhfXRmv7j6fk3dTH"]], "id":1}' https://api.hive.blog

condenser_api.get_market_history

Returns the market history for the internal HBD:HIVE market. Parameters: bucket_seconds:int; start:timestamp; end:timestamp

bucket_seconds (int) start (timestamp) end (timestamp)  
15 "2018-01-01T00:00:00" "2018-01-02T00:00:00" Queries for market history between January 1st, 2018 and January 2nd, 2018, segmented by 15 seconds.
60 "2018-01-01T00:00:00" "2018-01-02T00:00:00" Queries for market history between January 1st, 2018 and January 2nd, 2018, segmented by one minute.
300 "2018-01-01T00:00:00" "2018-01-02T00:00:00" Queries for market history between January 1st, 2018 and January 2nd, 2018, segmented by five minutes.
3600 "2018-01-01T00:00:00" "2018-01-02T00:00:00" Queries for market history between January 1st, 2018 and January 2nd, 2018, segmented by one hour.
86400 "2018-01-01T00:00:00" "2018-01-02T00:00:00" Queries for market history between January 1st, 2018 and January 2nd, 2018, segmented by one day.

Also see: market_history_api.get_market_history

Query Parameters JSON
[0, "1970-01-01T00:00:00", "1970-01-01T00:00:00"]
Expected Response JSON
[
  {
    "id": 0,
    "open": "1970-01-01T00:00:00",
    "seconds": 0,
    "hive": {
      "high": 0,
      "low": 0,
      "open": 0,
      "close": 0,
      "volume": 0
    },
    "non_hive": {
      "high": 0,
      "low": 0,
      "open": 0,
      "close": 0,
      "volume": 0
    }
  }
]
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_market_history", "params":[15,"2018-01-01T00:00:00","2018-01-02T00:00:00"], "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_market_history", "params":[60,"2018-01-01T00:00:00","2018-01-02T00:00:00"], "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_market_history", "params":[300,"2018-01-01T00:00:00","2018-01-02T00:00:00"], "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_market_history", "params":[3600,"2018-01-01T00:00:00","2018-01-02T00:00:00"], "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_market_history", "params":[86400,"2018-01-01T00:00:00","2018-01-02T00:00:00"], "id":1}' https://api.hive.blog

condenser_api.get_market_history_buckets

Returns the bucket seconds being tracked by the plugin.

Also see: market_history_api.get_market_history_buckets

Query Parameters JSON
[]
Expected Response JSON
[15, 60, 300, 3600, 86400]
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_market_history_buckets", "params":[], "id":1}' https://api.hive.blog

condenser_api.get_next_scheduled_hardfork

Returns the next scheduled hardfork.

Also see: database_api.get_hardfork_properties, hardfork

Query Parameters JSON
[]
Expected Response JSON
{
  "hf_version": "0.0.0",
  "live_time": "1970-01-01T00:00:00"
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_next_scheduled_hardfork", "params":[], "id":1}' https://api.hive.blog

condenser_api.get_open_orders

Returns the open orders for an account. account:string

Also see: database_api.list_limit_orders

Query Parameters JSON
[""]
Expected Response JSON
[]
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_open_orders", "params":["hiveio"], "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_open_orders", "params":["alice"], "id":1}' https://api.hive.blog

condenser_api.get_ops_in_block

Returns all operations contained in a block. Parameters: block_num:int; only_virtual:boolean

block_num (int) only_virtual (boolean)  
1 false Queries the operations in block #1.
5443322 true Queries only the virtual operations in block #5,443,322.

Also see: account_history_api.get_ops_in_block

Query Parameters JSON
[0, false]
Expected Response JSON
[
  {
    "trx_id": "0000000000000000000000000000000000000000",
    "block": 0,
    "trx_in_block": 0,
    "op_in_trx": 0,
    "virtual_op": 0,
    "timestamp": "2016-10-01T06:31:24",
    "op": [
      "producer_reward",
      {
        "producer": "",
        "vesting_shares": "0.000000 VESTS"
      }
    ]
  }
]
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_ops_in_block", "params":[1,false], "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_ops_in_block", "params":[5443322,true], "id":1}' https://api.hive.blog

condenser_api.get_order_book

Returns the internal market order book. Parameters: limit:int up to 500

limit (int)  
10 Queries up to 10 items in the order book.
500 Queries up to 500 items in the order book.

Also see: database_api.get_order_book, market_history_api.get_order_book

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

condenser_api.get_owner_history

Returns the owner history of an account. Parameters: account:string

account (string)  
"hiveio" Queries the owner history for account named “hiveio”.

Also see: database_api.list_owner_histories

Query Parameters JSON
[""]
Expected Response JSON
[]
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_owner_history", "params":["hiveio"], "id":1}' https://api.hive.blog

condenser_api.get_post_discussions_by_payout

Returns a list of post discussions by payout.

Also see: tags_api.get_post_discussions_by_payout

Query Parameters JSON
[
  {
    "tag": "",
    "limit": 0,
    "filter_tags": [],
    "select_authors": [],
    "select_tags": [],
    "truncate_body": 0
  }
]
Expected Response JSON
[]
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_post_discussions_by_payout", "params":[{"tag":"hive","limit":1}], "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_post_discussions_by_payout", "params":[{"tag":"photography","limit":10,"truncate_body":0}], "id":1}' https://api.hive.blog

condenser_api.get_potential_signatures

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

Also see: database_api.get_potential_signatures

Query Parameters JSON
[
  {
    "ref_block_num": 0,
    "ref_block_prefix": 0,
    "expiration": "1970-01-01T00:00:00",
    "operations": [],
    "extensions": [],
    "signatures": []
  }
]
Expected Response JSON
[]
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_potential_signatures", "params":[{"ref_block_num":1097,"ref_block_prefix":2181793527,"expiration":"2016-03-24T18:00:21","operations":[["pow",{"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,"hbd_interest_rate":1000}}]],"extensions":[],"signatures":[]}], "id":1}' https://api.hive.blog

condenser_api.get_reblogged_by

Returns a list of authors that have reblogged a post. Parameters: author:string; permlink:string

author (string) permlink (string)  
"hiveio" "firstpost" Queries reblogs for content with a slug @hiveio/firstpost
"alice" "a-post-by-alice" Queries reblogs for content with a slug @alice/a-post-by-alice
Query Parameters JSON
["", ""]
Expected Response JSON
[]
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_reblogged_by", "params":["hiveio","firstpost"], "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_reblogged_by", "params":["alice","a-post-by-alice"], "id":1}' https://api.hive.blog

condenser_api.get_recent_trades

Returns the most recent trades for the internal HBD:HIVE market. Parameters: limit:int up to 1000

limit (int)  
10 Queries up to 10 latest trades.
500 Queries up to 500 latest trades.

Also see: market_history_api.get_recent_trades

Query Parameters JSON
[1]
Expected Response JSON
[
  {
    "date": "1970-01-01T00:00:00",
    "current_pays": "0.0 HBD",
    "open_pays": "0.0 HIVE"
  }
]
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_recent_trades", "params":[10], "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_recent_trades", "params":[500], "id":1}' https://api.hive.blog

condenser_api.get_recovery_request

Returns the recovery request for an account. Parameters: account:string

account (string)  
"hiveio" Queries the recovery requests for account named “hiveio”.

Also see: database_api.list_account_recovery_requests

Query Parameters JSON
[""]
Expected Response JSON
null
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_recovery_request", "params":["hiveio"], "id":1}' https://api.hive.blog

condenser_api.get_replies_by_last_update

Returns a list of replies by last update. start_parent_author:string, start_permlink:string, limit:int up to 100

Also see: Paginated API Methods

Query Parameters JSON
["", "", 1]
Expected Response JSON
[]
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_replies_by_last_update", "params":["hiveio","firstpost",1], "id":1}' https://api.hive.blog

condenser_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. Parameters: trx:object; available_keys:[string]

Also see: database_api.get_required_signatures

Query Parameters JSON
[
  {
    "ref_block_num": 0,
    "ref_block_prefix": 0,
    "expiration": "1970-01-01T00:00:00",
    "operations": [],
    "extensions": [],
    "signatures": []
  },
  []
]
Expected Response JSON
[]
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_required_signatures", "params":[{"ref_block_num":1097,"ref_block_prefix":2181793527,"expiration":"2016-03-24T18:00:21","operations":[["pow",{"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,"hbd_interest_rate":1000}}]],"extensions":[],"signatures":[]},[]], "id":1}' https://api.hive.blog

condenser_api.get_reward_fund

Returns information about the current reward funds.

Also see: database_api.get_reward_funds

Query Parameters JSON
["post"]
Expected Response JSON
{
  "id": 0,
  "name": "",
  "reward_balance": "0.000 HIVE",
  "recent_claims": "0",
  "last_update": "1970-01-01T00:00:00",
  "content_constant": "0",
  "percent_curation_rewards": 0,
  "percent_content_rewards": 0,
  "author_reward_curve": "quadratic",
  "curation_reward_curve": "34723648"
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_reward_fund", "params":["post"], "id":1}' https://api.hive.blog

condenser_api.get_savings_withdraw_from

Returns savings withdraw from an account. Parameters: account:string

account (string)  
"hiveio" Queries the savings withdraw for account named “hiveio”.

Also see: database_api.list_savings_withdrawals

Query Parameters JSON
[""]
Expected Response JSON
[]
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_savings_withdraw_from", "params":["hiveio"], "id":1}' https://api.hive.blog

condenser_api.get_savings_withdraw_to

Returns the savings withdraw to an account. Parameters: account:string

account (string)  
"hiveio" Queries the savings withdraw for account named “hiveio”.

Also see: database_api.list_savings_withdrawals

Query Parameters JSON
[""]
Expected Response JSON
[]
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_savings_withdraw_to", "params":["hiveio"], "id":1}' https://api.hive.blog

condenser_api.get_state

Returns the state of a path. Deprecated. Parameters: path:string

See: JS: Get State Replacement Api

Query Parameters JSON
[""]
Expected Response JSON
{
  "current_route": "",
  "props": {
    "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": "0.000 HIVE",
    "current_supply": "0.000 HIVE",
    "confidential_supply": "0.000 HIVE",
    "current_hbd_supply": "0.000 HIVE",
    "confidential_hbd_supply": "0.000 HIVE",
    "total_vesting_fund_hive": "0.000 HIVE",
    "total_vesting_shares": "0.000 HIVE",
    "total_reward_fund_hive": "0.000 HIVE",
    "total_reward_shares2": "0",
    "pending_rewarded_vesting_shares": "0.000 HIVE",
    "pending_rewarded_vesting_hive": "0.000 HIVE",
    "hbd_interest_rate": 0,
    "hbd_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,
    "average_block_size": 0,
    "current_reserve_ratio": 1,
    "max_virtual_bandwidth": "0"
  },
  "tag_idx": {"trending": []},
  "tags": {},
  "content": {},
  "accounts": {},
  "witnesses": {},
  "discussion_idx": {},
  "witness_schedule": {
    "id": 0,
    "current_virtual_time": "0",
    "next_shuffle_block_num": 1,
    "current_shuffled_witnesses": [],
    "num_scheduled_witnesses": 1,
    "top19_weight": 1,
    "timeshare_weight": 5,
    "miner_weight": 1,
    "witness_pay_normalization_factor": 25,
    "median_props": {
      "account_creation_fee": "0.000 HIVE",
      "maximum_block_size": 131072,
      "hbd_interest_rate": 1000
    },
    "majority_version": "0.0.0",
    "max_voted_witnesses": 19,
    "max_miner_witnesses": 1,
    "max_runner_witnesses": 1,
    "hardfork_required_witnesses": 17
  },
  "feed_price": {"base": "0.000 HIVE", "quote": "0.000 HIVE"},
  "error": ""
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_state", "params":["/@hiveio"], "id":1}' https://api.hive.blog

condenser_api.get_tags_used_by_author

Returns a list of tags used by an author. Parameters: author:string

account (string)  
"hiveio" Queries the tags used by the account named “hiveio”.
Query Parameters JSON
[""]
Expected Response JSON
[]
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_tags_used_by_author", "params":["hiveio"], "id":1}' https://api.hive.blog

condenser_api.get_ticker

Returns the market ticker for the internal HBD:HIVE market.

Also see: market_history_api.get_ticker

Query Parameters JSON
[]
Expected Response JSON
{
  "latest": "0.00000000000000000",
  "lowest_ask": "0.00000000000000000",
  "highest_bid": "0.00000000000000000",
  "percent_change": "0.00000000000000000",
  "hive_volume": "0.000 HIVE",
  "hbd_volume": "0.000 HIVE"
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_ticker", "params":[], "id":1}' https://api.hive.blog

condenser_api.get_trade_history

Returns the trade history for the internal HBD:HIVE market. Parameters: start:timestamp; end:timestamp; limit:int up to 1000

start (timestamp) end (timestamp) limit (int)  
"2018-01-01T00:00:00" "2018-01-02T00:00:00" 10 Queries up to 10 trades between January 1st, 2018 and January 2nd, 2018.

Also see: market_history_api.get_trade_history

Query Parameters JSON
[
  "1970-01-01T00:00:00",
  "1970-01-01T00:00:00",
  1000
]
Expected Response JSON
[
  {
    "date": "1970-01-01T00:00:00",
    "current_pays": "0.000 HBD",
    "open_pays": "0.000 HIVE"
  }
]
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_trade_history", "params":["2018-01-01T00:00:00","2018-01-02T00:00:00",10], "id":1}' https://api.hive.blog

condenser_api.get_transaction

Returns the details of a transaction based on a transaction id. Parameters: trx_id:string

trx_id (string)  
"6fde0190a97835ea6d9e651293e90c89911f933c" Queries for this exact transaction id.

Also see: account_history_api.get_transaction

Query Parameters JSON
[""]
Expected Response JSON
{
  "ref_block_num": 0,
  "ref_block_prefix": 0,
  "expiration": "1970-01-01T00:00:00",
  "operations": [],
  "extensions": [],
  "signatures": [],
  "transaction_id": "0000000000000000000000000000000000000000",
  "block_num": 0,
  "transaction_num": 0
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_transaction", "params":["6fde0190a97835ea6d9e651293e90c89911f933c"], "id":1}' https://api.hive.blog

condenser_api.get_transaction_hex

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

Also see: database_api.get_transaction_hex

Query Parameters JSON
[
  {
    "ref_block_num": 0,
    "ref_block_prefix": 0,
    "expiration": "1970-01-01T00:00:00",
    "operations": [],
    "extensions": [],
    "signatures": []
  }
]
Expected Response JSON
""
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_transaction_hex", "params":[{"ref_block_num":1097,"ref_block_prefix":2181793527,"expiration":"2016-03-24T18:00:21","operations":[["pow",{"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,"hbd_interest_rate":1000}}]],"extensions":[],"signatures":[]}], "id":1}' https://api.hive.blog

Returns the list of trending tags. Parameter: start_tag:string; limit:int up to 100

tag (string) limit (int)  
null 100 Queries the top 100 trending tags.
"hive" 10 Queries the tags after “hive”, up to 10 tags.

Also see: Paginated API Methods

["", 1]
[
  {
    "name": "",
    "total_payouts": "0.000 HBD",
    "net_votes": 0,
    "top_posts": 0,
    "comments": 0,
    "trending": ""
  }
]
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_trending_tags", "params":[null,100], "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_trending_tags", "params":["hive",10], "id":1}' https://api.hive.blog

condenser_api.get_version

Returns the versions of blockchain, hive, and FC.

Also see: database_api.get_version, Paginated API Methods

Query Parameters JSON
[]
Expected Response JSON
{
  "blockchain_version": "",
  "hive_revision": "",
  "fc_revision": ""
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_version", "params":[], "id":1}' https://api.hive.blog

condenser_api.get_vesting_delegations

Returns the vesting delegations by an account. Parameters: delegator_account:string; start_account:string; limit:int up to 1000

delegator_account (string) start_account (string) limit (int)  
"hiveio" null 10 Queries up to 10 vesting delegations by “hiveio”.

Also see: database_api.list_vesting_delegations, Paginated API Methods

Query Parameters JSON
["", "", 1]
Expected Response JSON
[
  {
    "id": 0,
    "delegator": "",
    "delegatee": "",
    "vesting_shares": "0.000000 VESTS",
    "min_delegation_time": "1970-01-01T00:00:00"
  }
]
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_vesting_delegations", "params":["hiveio",null,10], "id":1}' https://api.hive.blog

condenser_api.get_volume

Returns the market volume for the past 24 hours.

Also see: market_history_api.get_volume

Query Parameters JSON
[]
Expected Response JSON
{
  "hive_volume": "0.000 HIVE",
  "hbd_volume": "0.000 HIVE"
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_volume", "params":[], "id":1}' https://api.hive.blog

condenser_api.get_withdraw_routes

Returns the withdraw routes for an account. Parameters: account:string; type:string

account (string) type (string)  
"hiveio" "outgoing" Queries outgoing withdraw routes by “hiveio”.
"hiveio" "incoming" Queries incoming withdraw routes by “hiveio”.
"hiveio" "all" Queries all withdraw routes by “hiveio”.

Also see: database_api.list_withdraw_vesting_routes

Query Parameters JSON
["", ""]
Expected Response JSON
[
  {
    "id": 0,
    "from_account": "",
    "to_account": "",
    "percent": 0,
    "auto_vest": false
  }
]
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_withdraw_routes", "params":["hiveio","outgoing"], "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_withdraw_routes", "params":["hiveio","incoming"], "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_withdraw_routes", "params":["hiveio","all"], "id":1}' https://api.hive.blog

condenser_api.get_witness_by_account

Returns the witness of an account. Parameters: account:string

account (string)  
"hiveio" Queries witness account of “hiveio” (of null if none exists).

Also see: database_api.list_witnesses

Query Parameters JSON
[""]
Expected Response JSON
{
  "id": 0,
  "owner": "",
  "created": "1970-01-01T00:00:00",
  "url": "",
  "votes": "0",
  "virtual_last_update": "0",
  "virtual_position": "0",
  "virtual_scheduled_time": "0",
  "total_missed": 0,
  "last_aslot": 0,
  "last_confirmed_block_num": 0,
  "pow_worker": 0,
  "signing_key": "",
  "props": {
    "account_creation_fee": "0.000 HIVE",
    "maximum_block_size": 65536,
    "hbd_interest_rate": 0
  },
  "hbd_exchange_rate": {"base": "0.000 HBD", "quote": "0.000 HIVE"},
  "last_hbd_exchange_update": "1970-01-01T00:00:00",
  "last_work": "",
  "running_version": "",
  "hardfork_version_vote": "",
  "hardfork_time_vote": "1970-01-01T00:00:00"
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_witness_by_account", "params":["hiveio"], "id":1}' https://api.hive.blog

condenser_api.get_witness_count

Query Parameters JSON
[]
Expected Response JSON
0
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_witness_count", "params":[], "id":1}' https://api.hive.blog

condenser_api.get_witness_schedule

Returns the current witness schedule.

Also see: database_api.get_witness_schedule

Query Parameters JSON
[]
Expected Response JSON
{
  "id": 0,
  "current_virtual_time": "0",
  "next_shuffle_block_num": 1,
  "current_shuffled_witnesses": [],
  "num_scheduled_witnesses": 1,
  "top19_weight": 1,
  "timeshare_weight": 5,
  "miner_weight": 1,
  "witness_pay_normalization_factor": 25,
  "median_props": {
    "account_creation_fee": "0.000 HIVE",
    "maximum_block_size": 131072,
    "hbd_interest_rate": 1000
  },
  "majority_version": "0.0.0",
  "max_voted_witnesses": 19,
  "max_miner_witnesses": 1,
  "max_runner_witnesses": 1,
  "hardfork_required_witnesses": 17
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_witness_schedule", "params":[], "id":1}' https://api.hive.blog

condenser_api.get_witnesses

Returns current witnesses.

Also see: database_api.list_witnesses

Query Parameters JSON
[[0]]
Expected Response JSON
[]
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_witnesses", "params":[[28]], "id":1}' https://api.hive.blog

condenser_api.get_witnesses_by_vote

Returns current witnesses by vote. Parameters: start_name:string; limit:int up to 1000

account (string) limit (int)  
null 21 Queries top 21 witness votes.
"a" 1 Queries top 10 witness votes starting with “a”.

Also see: database_api.list_witnesses

Query Parameters JSON
["", 1000]
Expected Response JSON
[]
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_witnesses_by_vote", "params":[null, 21], "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_witnesses_by_vote", "params":["a", 1], "id":1}' https://api.hive.blog

condenser_api.lookup_account_names

Looks up account names. Parameters: accounts:[string]; delayed_votes_active:boolean

Also see: database_api.find_accounts

Query Parameters JSON
[["hiveio", true]]
Expected Response JSON
{
  "id": 1370484,
  "name": "hiveio",
  "owner": {
    "weight_threshold": 1,
    "account_auths": [],
    "key_auths": [
      [
        "STM65PUAPA4yC4RgPtGgsPupxT6yJtMhmT5JHFdsT3uoCbR8WJ25s",
        1
      ]
    ]
  },
  "active": {
    "weight_threshold": 1,
    "account_auths": [],
    "key_auths": [
      [
        "STM69zfrFGnZtU3gWFWpQJ6GhND1nz7TJsKBTjcWfebS1JzBEweQy",
        1
      ]
    ]
  },
  "posting": {
    "weight_threshold": 1,
    "account_auths": [["threespeak", 1], ["vimm.app", 1]],
    "key_auths": [
      [
        "STM6vJmrwaX5TjgTS9dPH8KsArso5m91fVodJvv91j7G765wqcNM9",
        1
      ]
    ]
  },
  "memo_key": "STM7wrsg1BZogeK7X3eG4ivxmLaH69FomR8rLkBbepb3z3hm5SbXu",
  "json_metadata": "",
  "posting_json_metadata": "{\"profile\":{\"pinned\":\"none\",\"version\":2,\"website\":\"hive.io\",\"profile_image\":\"https://files.peakd.com/file/peakd-hive/hiveio/Jp2YHc6Q-hive-logo.png\",\"cover_image\":\"https://files.peakd.com/file/peakd-hive/hiveio/Xe1TcEBi-hive-banner.png\"}}",
  "proxy": "",
  "last_owner_update": "1970-01-01T00:00:00",
  "last_account_update": "2020-11-12T01:20:48",
  "created": "2020-03-06T12:22:48",
  "mined": false,
  "recovery_account": "steempeak",
  "last_account_recovery": "1970-01-01T00:00:00",
  "reset_account": "null",
  "comment_count": 0,
  "lifetime_vote_count": 0,
  "post_count": 31,
  "can_vote": true,
  "voting_manabar": {
    "current_mana": "598442432741",
    "last_update_time": 1591297380
  },
  "downvote_manabar": {
    "current_mana": "149610608184",
    "last_update_time": 1591297380
  },
  "voting_power": 0,
  "balance": "11.682 HIVE",
  "savings_balance": "0.000 HIVE",
  "hbd_balance": "43.575 HBD",
  "hbd_seconds": "0",
  "hbd_seconds_last_update": "2020-10-21T02:45:12",
  "hbd_last_interest_payment": "2020-10-21T02:45:12",
  "savings_hbd_balance": "0.000 HBD",
  "savings_hbd_seconds": "0",
  "savings_hbd_seconds_last_update": "1970-01-01T00:00:00",
  "savings_hbd_last_interest_payment": "1970-01-01T00:00:00",
  "savings_withdraw_requests": 0,
  "reward_hbd_balance": "0.000 HBD",
  "reward_hive_balance": "0.000 HIVE",
  "reward_vesting_balance": "0.000000 VESTS",
  "reward_vesting_hive": "0.000 HIVE",
  "vesting_shares": "598442.432741 VESTS",
  "delegated_vesting_shares": "0.000000 VESTS",
  "received_vesting_shares": "0.000000 VESTS",
  "vesting_withdraw_rate": "0.000000 VESTS",
  "post_voting_power": "598442.432741 VESTS",
  "next_vesting_withdrawal": "1969-12-31T23:59:59",
  "withdrawn": 0,
  "to_withdraw": 0,
  "withdraw_routes": 0,
  "pending_transfers": 0,
  "curation_rewards": 0,
  "posting_rewards": 604589,
  "proxied_vsf_votes": [0, 0, 0, 0],
  "witnesses_voted_for": 0,
  "last_post": "2021-03-23T18:05:48",
  "last_root_post": "2021-03-23T18:05:48",
  "last_vote_time": "1970-01-01T00:00:00",
  "post_bandwidth": 0,
  "pending_claimed_accounts": 0,
  "delayed_votes": [
    {
      "time": "2021-02-24T05:08:21",
      "val": "11550765516955"
    },
    {
      "time": "2021-02-26T15:46:06",
      "val": "633465684569"
    },
    {
      "time": "2021-03-07T17:54:39",
      "val": "1000000037683"
    },
    {
      "time": "2021-03-16T05:54:33",
      "val": "999978763511"
    },
    {
      "time": "2021-03-18T06:06:00",
      "val": "1000000171317"
    }
  ],
  "vesting_balance": "0.000 HIVE",
  "reputation": "88826789432105",
  "transfer_history": [],
  "market_history": [],
  "post_history": [],
  "vote_history": [],
  "other_history": [],
  "witness_votes": [],
  "tags_usage": [],
  "guest_bloggers": []
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.lookup_account_names", "params":[["hiveio"]], "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.lookup_account_names", "params":[["hiveio"], false], "id":1}' https://api.hive.blog

condenser_api.lookup_accounts

Looks up accounts starting with name. Parameterslower_bound_name:string; limit:int up to 1000

lower_bound_name (string) limit (int)  
"a" 10 Queries up to 10 accounts that start with “a”.

Also see: database_api.list_accounts

Query Parameters JSON
["", 1]
Expected Response JSON
[]
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.lookup_accounts", "params":["a",10], "id":1}' https://api.hive.blog

condenser_api.lookup_witness_accounts

Looks up witness accounts starting with name. Parameters: lower_bound_name:string; limit:int up to 1000

lower_bound_name (string) limit (int)  
"a" 10 Queries up to 10 witnesses that start with “a”.

Also see: database_api.list_witnesses

Query Parameters JSON
["", 1]
Expected Response JSON
[]
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.lookup_witness_accounts", "params":["a",10], "id":1}' https://api.hive.blog

condenser_api.verify_account_authority

Not Implemented

Also see: database_api.verify_account_authority

Query Parameters JSON
["", [""]]
Expected Response JSON
false
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.verify_account_authority", "params":["temp",["STM8GC13uCZbP44HzMLV6zPZGwVQ8Nt4Kji8PapsPiNq1BK153XTX"]], "id":1}' https://api.hive.blog

condenser_api.verify_authority

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

Also see: database_api.verify_authority

Query Parameters JSON
[
  {
    "ref_block_num": 0,
    "ref_block_prefix": 0,
    "expiration": "1970-01-01T00:00:00",
    "operations": [],
    "extensions": [],
    "signatures": []
  }
]
Expected Response JSON
false
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.verify_authority", "params":[{"ref_block_num":1097,"ref_block_prefix":2181793527,"expiration":"2016-03-24T18:00:21","operations":[["pow",{"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,"hbd_interest_rate":1000}}]],"extensions":[],"signatures":[]}], "id":1}' https://api.hive.blog

condenser_api.get_account_references

Not Implemented

Query Parameters JSON
[]
Expected Response JSON
[]

condenser_api.find_proposals

Finds proposals by proposal.id (not proposal.proposal_id).

Also see: database_api.find_proposals

Query Parameters JSON
[0]
Expected Response JSON
[
  {
    "id": 0,
    "proposal_id": "139924505899904",
    "creator": "alice",
    "receiver": "bob",
    "start_date": "2019-07-01T00:00:00",
    "end_date": "2019-08-01T23:59:59",
    "daily_pay": "4800.000 HBD",
    "subject": "My Proposal",
    "permlink": "creator-proposal-permlink",
    "total_votes": "77351826710",
    "status": "active"
  }
]
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.find_proposals", "params":[[0]], "id":1}' https://api.hive.blog

condenser_api.list_proposal_votes

Returns all proposal votes, starting with the specified voter or proposal.id. Parameters: start:array; limit:int; order:string; order_direction:string; status:string

start (array) limit (int) order (string) order_direction (string) status (string)  
["alice"] 10 by_voter_proposal ascending active list 10 proposals with active status, ordered by voter, ascending
[10] 1000 by_proposal_voter ascending votable list 1000 votes on proposal 10, ordered by proposal.id, ascending

Also see: datbase_api.list_proposals

Query Parameters JSON
[[], 0, "by_name", "ascending", "all"]
Expected Response JSON
[
  {
    "id": 0,
    "voter": "charlie",
    "proposal": {
      "id": 0,
      "proposal_id": 0,
      "creator": "alice",
      "receiver": "bob",
      "start_date": "2019-07-01T00:00:00",
      "end_date": "2019-08-01T23:59:59",
      "daily_pay": {
        "amount": "4800000",
        "precision": 3,
        "nai": "@@000000013"
      },
      "subject": "My Proposal",
      "permlink": "creator-proposal-permlink",
      "total_votes": "77351826710",
      "status": "active"
    }
  }
]
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.list_proposal_votes", "params":[[""], 10, "by_voter_proposal", "ascending", "active"], "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.list_proposal_votes", "params":[[0], 10, "by_proposal_voter", "ascending", "active"], "id":1}' https://api.hive.blog

condenser_api.list_proposals

Returns all proposals, starting with the specified creator or start date. Parameters: start:array; limit:int; order:string; order_direction:string; status:string

start (array) limit (int) order (string) order_direction (string) status (string)  
[""] 10 by_creator ascending active list 10 proposals with active status, ordered by creator, ascending
["2019-08-07T16:54:03"] 1000 by_start_date ascending inactive list 1000 proposals with inactive status, ordered by start date, ascending, since 2019-08-07T16:54:03
["a"] 1 by_creator ascending expired list 1 proposal with expired status, ordered by creator, ascending, by accounts starting with “a”
["alice"] 10 by_creator ascending all list 10 proposals with any status, ordered by creator, ascending, by alice
[""] 1000 by_creator ascending votable list 1000 votable proposals, ordered by creator, ascending
[10] 1000 by_total_votes ascending votable list 1000 votable proposals, ordered by creator, ascending, having at least 10 votes

Also see: datbase_api.list_proposals

Query Parameters JSON
[[], 0, "by_name", "ascending", "all"]
Expected Response JSON
[
  {
    "id": 0,
    "proposal_id": "1103806595072",
    "creator": "alice",
    "receiver": "bob",
    "start_date": "2019-07-01T00:00:00",
    "end_date": "2019-08-01T23:59:59",
    "daily_pay": "4800.000 HBD",
    "subject": "My Proposal",
    "permlink": "creator-proposal-permlink",
    "total_votes": "77351826710",
    "status": "active"
  }
]
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.list_proposals", "params":[[""], 10, "by_creator", "ascending", "active"], "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.list_proposals", "params":[["2019-08-07T16:54:03"], 1000, "order_direction": "ascending", "inactive"], "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.list_proposals", "params":[["a"], 1, "by_creator", "ascending", "expired"], "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.list_proposals", "params":[["alice"], 10, "by_creator", "ascending", "all"], "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.list_proposals", "params":[[""], 1000, "by_creator", "ascending", "votable"], "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.list_proposals", "params":[[10], 1000, "by_total_votes", "ascending", "votable"], "id":1}' https://api.hive.blog

condenser_api.is_known_transaction

Only return true if the transaction has not expired or been invalidated. If this method is called with a VERY old transaction we will return false, use account_history_api.get_transaction.

Also see: transaction_status_api.find_transaction, account_history_api.get_transaction

Query Parameters JSON
["0000000000000000000000000000000000000000"]
Expected Response JSON
false
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.is_known_transaction", "params":["0000000000000000000000000000000000000000"]}, "id":1}' https://api.hive.blog

condenser_api.get_collateralized_conversion_requests

Returns objects corresponding with collateralized_convert operations.

 

 

 

Query Parameters JSON
[]
Expected Response JSON
[]

Account By Key Api

Methods:

Used to lookup account information based on a key. These AppBase API methods are still under development and subject to change.

account_by_key_api.get_key_references

Returns all accounts that have the key associated with their owner or active authorities.

Query Parameters JSON
{"keys": []}
Expected Response JSON
{"accounts": []}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"account_by_key_api.get_key_references", "params":{"keys":["STM5jZtLoV8YbxCxr4imnbWn61zMB24wwonpnVhfXRmv7j6fk3dTH"]}, "id":1}' https://api.hive.blog

Bridge

Methods:

Presents data interpreted by the hivemind database as JSON-RPC.

Also see: Communities Broadcast Ops

bridge.get_ranked_posts

Get ranked posts.

Supported values for sort:

The value for tag can be any valid tag.

The value for observer can be any valid account or empty string.

Query Parameters JSON
{"sort": "", "tag": "", "observer": ""}
Expected Response JSON
[
  {
    "post_id": 12345678,
    "author": "alice",
    "permlink": "that-march-hare",
    "category": "wonderland",
    "title": "That March Hare",
    "body": "I think he went mad.",
    "json_metadata": {
      "tags": ["wonderland"],
      "app": "hiveblog/0.1"
    },
    "created": "2019-12-05T16:29:12",
    "updated": "2019-12-05T16:29:12",
    "depth": 0,
    "children": 0,
    "net_rshares": 1539574839484,
    "is_paidout": false,
    "payout_at": "2019-12-12T16:29:12",
    "payout": 0.286,
    "pending_payout_value": "0.286 HBD",
    "author_payout_value": "0.000 HBD",
    "curator_payout_value": "0.000 HBD",
    "promoted": "0.000 HBD",
    "replies": [],
    "active_votes": [{"voter": "bob", "rshares": "67759296290"}],
    "author_reputation": 47.15,
    "stats": {
      "hide": false,
      "gray": false,
      "total_votes": 12,
      "flag_weight": 0
    },
    "beneficiaries": [],
    "max_accepted_payout": "1000000.000 HBD",
    "percent_hbd": 10000,
    "url": "/wonderland/@alice/that-march-hare",
    "blacklists": []
  }
]
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"bridge.get_ranked_posts", "params":{"sort":"trending","tag":"","observer":"alice"}, "id":1}' https://api.hive.blog

bridge.account_notifications

Account notifications.

Supported values for type:

The score value is based on the originating account’s rank.

Query Parameters JSON
{"account": "alice", "limit": 100}
Expected Response JSON
[
  {
    "id": 3629306,
    "type": "vote",
    "score": 25,
    "date": "2019-11-20T07:48:06",
    "msg": "@bob voted on your post ($0.013)",
    "url": "@alice/a-post-by-alice"
  }
]
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"bridge.account_notifications", "params":{"account":"alice","limit":100}, "id":1}' https://api.hive.blog

bridge.does_user_follow_any_lists

Checks if a given observer follows any blacklists or mute lists.

Query Parameters JSON
{"observer": "alice"}
Expected Response JSON
false
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"bridge.does_user_follow_any_lists", "params":{"observer":"alice"}, "id":1}' https://api.hive.blog

bridge.get_account_posts

Lists posts related to a given account.

Query Parameters JSON
{"sort": "blog", "account": "alice", "limit": 1}
Expected Response JSON
[
  {
    "post_id": 101867403,
    "author": "hiveio",
    "permlink": "around-the-hive-reflections",
    "category": "hiveecosystem",
    "title": "Around the Hive: Reflections",
    "body": "It's been a busy year so far for developers on Hive. Layer 2 solutions are in progress, key optimization is an ongoing priority ...",
    "json_metadata": {
      "tags": ["hiveecosystem"],
      "users": ["blocktrades", "howo"],
      "image": [
        "https://images.hive.blog/768x0/https://files.peakd.com/file/peakd-hive/hiveio/pKjrNcbK-Hive-Wallpaper-1920x1080.png",
        "https://images.hive.blog/DQmR3iwCn9yvwXDXfuNjmMX6FrjAvFfYQWgA4QRckpens1j/hive%20dividers-02.png"
      ],
      "links": [
        "https://gitlab.syncad.com/hive/hive-whitepaper/-/blob/master/technical-vision/infographic.pdf"
      ],
      "app": "hiveblog/0.1",
      "format": "markdown",
      "description": "The strength of Hive lies in our decentralization."
    },
    "created": "2021-02-14T08:16:03",
    "updated": "2021-02-14T08:16:03",
    "depth": 0,
    "children": 15,
    "net_rshares": 93531156115025,
    "is_paidout": true,
    "payout_at": "2021-02-21T08:16:03",
    "payout": 0,
    "pending_payout_value": "0.000 HBD",
    "author_payout_value": "0.000 HBD",
    "curator_payout_value": "0.000 HBD",
    "promoted": "0.000 HBD",
    "replies": [],
    "author_reputation": 69.29,
    "stats": {
      "hide": false,
      "gray": false,
      "total_votes": 129,
      "flag_weight": 0
    },
    "url": "/hiveecosystem/@hiveio/around-the-hive-reflections",
    "beneficiaries": [],
    "max_accepted_payout": "0.000 HBD",
    "percent_hbd": 10000,
    "active_votes": [],
    "blacklists": []
  }
]
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"bridge.get_account_posts", "params":{"sort":"blog", "account": "alice", "limit": 1}, "id":1}' https://api.hive.blog

bridge.get_community_context

Gets the role, subscription status, and title for a given account in a given community.

Query Parameters JSON
{"name": "hive-111111", "account": "therealwolf"}
Expected Response JSON
{
  "role": "admin",
  "subscribed": true,
  "title": "Witness: @therealwolf"
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"bridge.get_community_context", "params":{"name": "hive-111111", "account": "therealwolf"}, "id":1}' https://api.hive.blog

bridge.get_discussion

Gives a flattened discussion tree starting at given post.

Query Parameters JSON
{
  "author": "hiveio",
  "permlink": "around-the-hive-reflections",
  "observer": "alice"
}
Expected Response JSON
{
  "hiveio/around-the-hive-reflections": {
    "post_id": 101867403,
    "author": "hiveio",
    "permlink": "around-the-hive-reflections",
    "category": "hiveecosystem",
    "title": "Around the Hive: Reflections",
    "body": "It's been a busy year so far for developers on Hive. Layer 2 solutions are in progress, key optimization is an ongoing priority ...",
    "json_metadata": {
      "tags": ["hiveecosystem"],
      "users": ["blocktrades", "howo"],
      "image": [
        "https://images.hive.blog/768x0/https://files.peakd.com/file/peakd-hive/hiveio/pKjrNcbK-Hive-Wallpaper-1920x1080.png",
        "https://images.hive.blog/DQmR3iwCn9yvwXDXfuNjmMX6FrjAvFfYQWgA4QRckpens1j/hive%20dividers-02.png"
      ],
      "links": [
        "https://gitlab.syncad.com/hive/hive-whitepaper/-/blob/master/technical-vision/infographic.pdf"
      ],
      "app": "hiveblog/0.1",
      "format": "markdown",
      "description": "The strength of Hive lies in our decentralization."
    },
    "created": "2021-02-14T08:16:03",
    "updated": "2021-02-14T08:16:03",
    "depth": 0,
    "children": 15,
    "net_rshares": 93531156115025,
    "is_paidout": true,
    "payout_at": "2021-02-21T08:16:03",
    "payout": 0,
    "pending_payout_value": "0.000 HBD",
    "author_payout_value": "0.000 HBD",
    "curator_payout_value": "0.000 HBD",
    "promoted": "0.000 HBD",
    "replies": [],
    "author_reputation": 69.29,
    "stats": {
      "hide": false,
      "gray": false,
      "total_votes": 129,
      "flag_weight": 0
    },
    "url": "/hiveecosystem/@hiveio/around-the-hive-reflections",
    "beneficiaries": [],
    "max_accepted_payout": "0.000 HBD",
    "percent_hbd": 10000,
    "active_votes": [],
    "blacklists": []
  }
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"bridge.get_discussion", "params":{"author": "hiveio", "permlink": "around-the-hive-reflections", "observer": "alice"}, "id":1}' https://api.hive.blog

bridge.get_follow_list

Returns blacklisted/muted accounts or list of blacklists/mute lists followed by a given observer.

Query Parameters JSON
{
  "observer": "blocktrades",
  "follow_type": "follow_blacklist"
}
Expected Response JSON
[
  {
    "name": "hive.blog",
    "blacklist_description": "",
    "muted_list_description": ""
  }
]
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"bridge.get_follow_list", "params":{"observer": "blocktrades", "follow_type": "follow_blacklist"}, "id":1}' https://api.hive.blog

bridge.get_profile

Gets profile

Query Parameters JSON
{"account": "alice", "observer": "bob"}
Expected Response JSON
{
  "id": 241,
  "name": "alice",
  "created": "2016-03-25T15:09:27",
  "active": "2016-04-29T22:28:00",
  "post_count": 0,
  "reputation": 25,
  "blacklists": [],
  "stats": {"rank": 0, "following": 0, "followers": 431},
  "metadata": {
    "profile": {
      "name": "",
      "about": "",
      "website": "",
      "location": "",
      "cover_image": "",
      "profile_image": "",
      "blacklist_description": "",
      "muted_list_description": ""
    }
  },
  "context": {"followed": false}
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"bridge.get_profile", "params":{"account": "alice", "observer": "bob"}, "id":1}' https://api.hive.blog

bridge.list_communities

Gets community

Query Parameters JSON
{"limit": 1, "query": "wall street bets"}
Expected Response JSON
[
  {
    "id": 1432978,
    "name": "hive-103566",
    "title": "Wall Street Bets",
    "about": "Wall Street Bets - In Case Reddit Shuts Down.",
    "lang": "en",
    "type_id": 1,
    "is_nsfw": false,
    "subscribers": 6,
    "sum_pending": 0,
    "num_pending": 0,
    "num_authors": 0,
    "created_at": "2021-01-28 18:34:09",
    "avatar_url": "",
    "context": {},
    "admins": ["spitr"]
  }
]
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"bridge.list_communities", "params":{"limit": 1, "query": "wall street bets"}, "id":1}' https://api.hive.blog

bridge.list_pop_communities

Gets a list of popular communities.

Query Parameters JSON
{"limit": 10}
Expected Response JSON
[
  ["hive-167922", "LeoFinance"],
  ["hive-194913", "Photography Lovers"],
  ["hive-148441", "GEMS"],
  ["hive-196037", "DTube"],
  ["hive-196708", "Hive Pets"],
  ["hive-120586", "Foodies Bee Hive"],
  ["hive-140217", "Hive Gaming"],
  ["hive-174578", "OCD"],
  ["hive-129496", "Nerday"],
  ["hive-193816", "Music"]
]
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"bridge.list_pop_communities", "params":{"limit": 10}, "id":1}' https://api.hive.blog

bridge.list_subscribers

Gets a list of subscribers for a given community.

Query Parameters JSON
{"community": "hive-111111", "limit": 10}
Expected Response JSON
[
  [
    "gatticus",
    "guest",
    null,
    "2021-02-18 13:15:42"
  ],
  [
    "thewarkettle",
    "guest",
    null,
    "2021-02-15 22:04:36"
  ],
  [
    "darkflame",
    "guest",
    null,
    "2021-02-14 00:30:12"
  ],
  [
    "oiuygtfrd76543",
    "guest",
    null,
    "2021-02-01 19:35:03"
  ],
  ["bhattg", "guest", null, "2021-02-01 18:39:06"],
  [
    "elenahornfilm",
    "guest",
    null,
    "2021-02-01 09:19:54"
  ],
  [
    "mrhappypants",
    "guest",
    null,
    "2021-02-01 01:03:48"
  ],
  [
    "petrahaller",
    "guest",
    null,
    "2021-02-01 00:08:09"
  ],
  [
    "hgregoria",
    "guest",
    null,
    "2021-01-29 18:46:12"
  ],
  [
    "theblockabout",
    "guest",
    null,
    "2021-01-29 15:21:48"
  ]
]
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"bridge.list_subscribers", "params":{"community": "hive-111111", "limit": 10}, "id":1}' https://api.hive.blog

bridge.list_community_roles

List community roles and labels for each account in the community.

Query Parameters JSON
{"community": "hive-123456"}
Expected Response JSON
[
  ["hive-123456", "owner", ""],
  ["alice", "admin", "Miss"]
]
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"bridge.list_community_roles", "params":{"community":"hive-123456"}, "id":1}' https://api.hive.blog

bridge.list_all_subscriptions

List all subscriptions, titles, and roles to a community for an account.

Query Parameters JSON
{"account": "alice"}
Expected Response JSON
[
  ["hive-123456", "Wonderland", "guest", ""],
  [
    "hive-654321",
    "Tulgey Wood",
    "admin",
    "Mrs. Vex"
  ]
]
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"bridge.list_all_subscriptions", "params":{"account":"alice"}, "id":1}' https://api.hive.blog

bridge.get_community

Get community details.

Query Parameters JSON
{"name": "hive-123456", "observer": "alice"}
Expected Response JSON
{
  "id": 1332149,
  "name": "hive-123456",
  "title": "@hive-123456",
  "about": "Wonderland",
  "lang": "en",
  "type_id": 1,
  "is_nsfw": false,
  "subscribers": 0,
  "sum_pending": 0,
  "num_pending": 0,
  "num_authors": 0,
  "created_at": "2019-10-27 08:28:54",
  "context": {
    "role": "admin",
    "title": "Miss",
    "subscribed": true
  },
  "avatar_url": "",
  "description": "",
  "flag_text": "",
  "settings": {},
  "team": [
    ["hive-123456", "owner", ""],
    ["alice", "admin", "Miss"]
  ]
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"bridge.get_community", "params":{"name":"hive-123456","observer":"alice"}, "id":1}' https://api.hive.blog

bridge.get_relationship_between_accounts

Tells what relations connect given accounts from the perspective of first account.

Query Parameters JSON
["alice", "bob"]
Expected Response JSON
{
  "follows": false,
  "ignores": false,
  "blacklists": false,
  "follows_blacklists": false,
  "follows_muted": false
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"bridge.get_relationship_between_accounts", "params":["alice", "bob"], "id":1}' https://api.hive.blog

bridge.get_payout_stats

Lists communities ordered by payout with stats (total payout, number of posts and authors).

Query Parameters JSON
{"limit": 250}
Expected Response JSON
{
  "items": [
    [
      "hive-167922",
      "LeoFinance",
      10881.39,
      16791,
      1466
    ]
  ],
  "total": 107662.592,
  "blogs": 14453.794
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"bridge.get_payout_stats", "params":{"limit": 1}, "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"bridge.get_payout_stats", "params":{"limit": 250}, "id":1}' https://api.hive.blog

bridge.get_post

Gives single selected post.

Query Parameters JSON
{
  "author": "hiveio",
  "permlink": "around-the-hive-reflections"
}
Expected Response JSON
{
  "post_id": 101867403,
  "author": "hiveio",
  "permlink": "around-the-hive-reflections",
  "category": "hiveecosystem",
  "title": "Around the Hive: Reflections",
  "body": "It's been a busy year so far for developers on Hive. Layer 2 solutions are in progress, key optimization is an ongoing priority ...",
  "json_metadata": {
    "tags": ["hiveecosystem"],
    "users": ["blocktrades", "howo"],
    "image": [
      "https://images.hive.blog/768x0/https://files.peakd.com/file/peakd-hive/hiveio/pKjrNcbK-Hive-Wallpaper-1920x1080.png",
      "https://images.hive.blog/DQmR3iwCn9yvwXDXfuNjmMX6FrjAvFfYQWgA4QRckpens1j/hive%20dividers-02.png"
    ],
    "links": [
      "https://gitlab.syncad.com/hive/hive-whitepaper/-/blob/master/technical-vision/infographic.pdf"
    ],
    "app": "hiveblog/0.1",
    "format": "markdown",
    "description": "The strength of Hive lies in our decentralization."
  },
  "created": "2021-02-14T08:16:03",
  "updated": "2021-02-14T08:16:03",
  "depth": 0,
  "children": 15,
  "net_rshares": 93531156115025,
  "is_paidout": true,
  "payout_at": "2021-02-21T08:16:03",
  "payout": 0,
  "pending_payout_value": "0.000 HBD",
  "author_payout_value": "0.000 HBD",
  "curator_payout_value": "0.000 HBD",
  "promoted": "0.000 HBD",
  "replies": [],
  "author_reputation": 69.29,
  "stats": {
    "hide": false,
    "gray": false,
    "total_votes": 129,
    "flag_weight": 0
  },
  "url": "/hiveecosystem/@hiveio/around-the-hive-reflections",
  "beneficiaries": [],
  "max_accepted_payout": "0.000 HBD",
  "percent_hbd": 10000,
  "active_votes": [],
  "blacklists": []
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"bridge.get_post", "params":{"author": "alice", "permlink": "that-march-hare", "observer": "bob"}, "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"bridge.get_post", "params":{"author": "hiveio", "permlink": "around-the-hive-reflections"}, "id":1}' https://api.hive.blog

bridge.get_post_header

Gives very basic information on given post.

Query Parameters JSON
{
  "author": "hiveio",
  "permlink": "around-the-hive-reflections"
}
Expected Response JSON
{
  "author": "hiveio",
  "permlink": "around-the-hive-reflections",
  "category": "hiveecosystem",
  "depth": 0
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"bridge.get_post_header", "params":{"author": "alice", "permlink": "that-march-hare"}, "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"bridge.get_post_header", "params":{"author": "hiveio", "permlink": "around-the-hive-reflections"}, "id":1}' https://api.hive.blog

Account History Api

Methods:

Used to lookup account history information. These AppBase API methods are still under development and subject to change.

account_history_api.get_account_history

Returns a history of all operations for a given account. Parameters:

If either operation_filter_low or operation_filter_high are set, the set of returned operations will include only these matching bitwise filter.

For the first 64 operations (as defined in protocol/operations.hpp), set the corresponding bit in operation_filter_low; for the higher-numbered operations, set the bit in operation_filter_high (pretending operation_filter is a 128-bit bitmask composed of {operation_filter_high, operation_filter_low})

account (string) start (int) limit (int) include_reversible (boolean) operation_filter_low (int) operation_filter_high (int)  
"hiveio" 1000 1000       Queries the account named hiveio starting on the latest item in history, up to 1,000 results.
"alice" -1 1000       Queries the account named alice starting on the oldest item in history, up to 1,000 results.
"bob" -1 1000 true 1   Queries only votes by the account named bob starting on the oldest item in history, up to 1,000 results.
"charlie" -1 1000 true 262144   Queries only custom jsons by the account named charlie starting on the oldest item in history, up to 1,000 results.
"emma" -1 1000 true 0 1 Queries only proposal payments to the account named emma starting on the oldest item in history, up to 1,000 results.

Also see: Paginated API Methods

Query Parameters JSON
{
  "account": "",
  "start": "18446744073709551615",
  "limit": 1000,
  "include_reversible": true,
  "operation_filter_low": 4294967295,
  "operation_filter_high": 4294967295
}
Expected Response JSON
{
  "history": [
    [
      99,
      {
        "trx_id": "0000000000000000000000000000000000000000",
        "block": 0,
        "trx_in_block": 4294967295,
        "op_in_trx": 0,
        "virtual_op": 0,
        "timestamp": "2019-12-09T21:32:39",
        "op": {}
      }
    ]
  ]
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"account_history_api.get_account_history", "params":{"account":"hiveio", "start":1000, "limit":1000}, "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"account_history_api.get_account_history", "params":{"account":"hiveio", "start":-1, "limit":1000}, "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"account_history_api.get_account_history", "params":{"account":"bob", "start":-1, "limit":1000, "include_reversible": true, "operation_filter_low": 1}, "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"account_history_api.get_account_history", "params":{"account":"charlie", "start":-1, "limit":1000, "include_reversible": true, "operation_filter_low": 262144}, "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"account_history_api.get_account_history", "params":{"account":"emma", "start":-1, "limit":1000, "include_reversible": true, "operation_filter_low": 0, "operation_filter_high": 1}, "id":1}' https://api.hive.blog

account_history_api.get_ops_in_block

Returns all operations contained in a block. Parameter:

Query Parameters JSON
{
  "block_num": 0,
  "only_virtual": false,
  "include_reversible": true
}
Expected Response JSON
{
  "ops": [
    {
      "trx_id": "0000000000000000000000000000000000000000",
      "block": 0,
      "trx_in_block": 4294967295,
      "op_in_trx": 0,
      "virtual_op": 0,
      "timestamp": "2019-10-06T09:05:15",
      "op": {}
    }
  ]
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"account_history_api.get_ops_in_block", "params":{"block_num":1,"only_virtual":false}, "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"account_history_api.get_ops_in_block", "params":{"block_num":5443322,"only_virtual":true}, "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"account_history_api.get_ops_in_block", "params":{"block_num":5443322,"only_virtual":true,"include_reversible":true}, "id":1}' https://api.hive.blog

account_history_api.get_transaction

Returns the details of a transaction based on a transaction id.

Query Parameters JSON
{
  "id": "0000000000000000000000000000000000000000",
  "include_reversible": true
}
Expected Response JSON
{
  "ref_block_num": 0,
  "ref_block_prefix": 0,
  "expiration": "1970-01-01T00:00:00",
  "operations": [],
  "extensions": [],
  "signatures": [],
  "transaction_id": "0000000000000000000000000000000000000000",
  "block_num": 0,
  "transaction_num": 0
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"account_history_api.get_transaction", "params":{"id":"6fde0190a97835ea6d9e651293e90c89911f933c"}, "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"account_history_api.get_transaction", "params":{"id":"6fde0190a97835ea6d9e651293e90c89911f933c", "include_reversible": true}, "id":1}' https://api.hive.blog

account_history_api.enum_virtual_ops

Allows to specify range of blocks to retrieve virtual operations for.

Query Parameters JSON
{
  "block_range_begin": 1,
  "block_range_end": 2,
  "include_reversible": true,
  "group_by_block": false,
  "operation_begin": 0,
  "limit": 1000,
  "filter": 1
}
Expected Response JSON
{
  "ops": [
    {
      "trx_id": "0000000000000000000000000000000000000000",
      "block": 0,
      "trx_in_block": 4294967295,
      "op_in_trx": 0,
      "virtual_op": 0,
      "timestamp": "2016-03-24T17:46:30",
      "op": {},
      "operation_id": "18446744069414584320"
    }
  ]
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"account_history_api.enum_virtual_ops", "params":{"block_range_begin":1,"block_range_end":2}, "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"account_history_api.enum_virtual_ops", "params":{"block_range_begin":1,"block_range_end":2,"include_reversible":true}, "id":1}' https://api.hive.blog

Block Api

Methods:

Used to query values related to the block plugin. These AppBase API methods are still under development and subject to change.

block_api.get_block

Retrieve a full, signed block of the referenced block, or null if no matching block was found.

Parameters:

block_num (int)  
1 Queries the very first block.
8675309 Queries block number 8,675,309.
62396745 Queries block number 62,396,745.
Query Parameters JSON
{"block_num": 0}
Expected Response JSON
{
  "block": {
    "previous": "0000000000000000000000000000000000000000",
    "timestamp": "2016-03-24T16:05:00",
    "witness": "",
    "transaction_merkle_root": "0000000000000000000000000000000000000000",
    "extensions": [],
    "witness_signature": "",
    "transactions": [],
    "block_id": "",
    "signing_key": "",
    "transaction_ids": []
  }
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"block_api.get_block", "params":{"block_num":1}, "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"block_api.get_block", "params":{"block_num":8675309}, "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"block_api.get_block", "params":{"block_num":62396745}, "id":1}' https://api.hive.blog

block_api.get_block_header

Retrieve a block header of the referenced block, or null if no matching block was found.

Parameters:

block_num (int)  
1 Queries the block headers for the very first block.
8675309 Queries block headers for block number 8,675,309.
62396745 Queries block headers for block number 62,396,745.
Query Parameters JSON
{"block_num": 0}
Expected Response JSON
{
  "header": {
    "previous": "0000000000000000000000000000000000000000",
    "timestamp": "2016-03-24T16:05:00",
    "witness": "",
    "transaction_merkle_root": "0000000000000000000000000000000000000000",
    "extensions": []
  }
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"block_api.get_block_header", "params":{"block_num":1}, "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"block_api.get_block_header", "params":{"block_num":8675309}, "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"block_api.get_block_header", "params":{"block_num":62396745}, "id":1}' https://api.hive.blog

block_api.get_block_range

Retrieve a range of full, signed blocks. The list may be shorter than requested if count blocks would take you past the current head block.

Parameters:

starting_block_num (int) count (int)  
1 10 Queries the block headers for the very first block through the tenth block.
8675309 50 Queries block headers for block numbers 8,675,309 through 8,675,359.
62396745 1000 Queries block headers for block numbers 62,396,745 through 62,397,745.

See: !149, 702ea4a

Query Parameters JSON
{"starting_block_num": 0, "count": 0}
Expected Response JSON
{"blocks": []}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"block_api.get_block_range", "params":{"starting_block_num": 1, "count": 10}, "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"block_api.get_block_range", "params":{"starting_block_num": 8675309, "count": 50}, "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"block_api.get_block_range", "params":{"starting_block_num": 62396745, "count": 1000}, "id":1}' https://api.hive.blog

Database Api

Methods:

Used to query information about accounts, transactions, and blockchain data.

To enable this API for hived, the following is required in config.ini by specifying:

plugin = database_api

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. Parameters: account:string

account (string)  
"hiveio" Queries the recovery requests for account named “hiveio”.
Query Parameters JSON
{"accounts": []}
Expected Response JSON
{"requests": []}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.find_account_recovery_requests", "params": {"accounts":["hiveio"]}, "id":1}' https://api.hive.blog

database_api.find_accounts

Returns accounts, queried by name. Parameters: account:string array; delayed_votes_active:boolean

account (string array) delayed_votes_active (boolean)  
["hiveio"]   Queries for account named “hiveio”.
["hiveio", "alice"] false Queries for accounts named “hiveio” and “alice” with delayed_votes hidden.
Query Parameters JSON
{"accounts": [], "delayed_votes_active": true}
Expected Response JSON
{
  "accounts": [
    {
      "id": 1370484,
      "name": "hiveio",
      "owner": {
        "weight_threshold": 1,
        "account_auths": [],
        "key_auths": [
          [
            "STM65PUAPA4yC4RgPtGgsPupxT6yJtMhmT5JHFdsT3uoCbR8WJ25s",
            1
          ]
        ]
      },
      "active": {
        "weight_threshold": 1,
        "account_auths": [],
        "key_auths": [
          [
            "STM69zfrFGnZtU3gWFWpQJ6GhND1nz7TJsKBTjcWfebS1JzBEweQy",
            1
          ]
        ]
      },
      "posting": {
        "weight_threshold": 1,
        "account_auths": [["threespeak", 1], ["vimm.app", 1]],
        "key_auths": [
          [
            "STM6vJmrwaX5TjgTS9dPH8KsArso5m91fVodJvv91j7G765wqcNM9",
            1
          ]
        ]
      },
      "memo_key": "STM7wrsg1BZogeK7X3eG4ivxmLaH69FomR8rLkBbepb3z3hm5SbXu",
      "json_metadata": "",
      "posting_json_metadata": "{\"profile\":{\"pinned\":\"none\",\"version\":2,\"website\":\"hive.io\",\"profile_image\":\"https://files.peakd.com/file/peakd-hive/hiveio/Jp2YHc6Q-hive-logo.png\",\"cover_image\":\"https://files.peakd.com/file/peakd-hive/hiveio/Xe1TcEBi-hive-banner.png\"}}",
      "proxy": "",
      "last_owner_update": "1970-01-01T00:00:00",
      "last_account_update": "2020-11-12T01:20:48",
      "created": "2020-03-06T12:22:48",
      "mined": false,
      "recovery_account": "steempeak",
      "last_account_recovery": "1970-01-01T00:00:00",
      "reset_account": "null",
      "comment_count": 0,
      "lifetime_vote_count": 0,
      "post_count": 31,
      "can_vote": true,
      "voting_manabar": {
        "current_mana": "598442432741",
        "last_update_time": 1591297380
      },
      "downvote_manabar": {
        "current_mana": "149610608184",
        "last_update_time": 1591297380
      },
      "balance": {
        "amount": "11682",
        "precision": 3,
        "nai": "@@000000021"
      },
      "savings_balance": {
        "amount": "0",
        "precision": 3,
        "nai": "@@000000021"
      },
      "hbd_balance": {
        "amount": "43575",
        "precision": 3,
        "nai": "@@000000013"
      },
      "hbd_seconds": "0",
      "hbd_seconds_last_update": "2020-10-21T02:45:12",
      "hbd_last_interest_payment": "2020-10-21T02:45:12",
      "savings_hbd_balance": {
        "amount": "0",
        "precision": 3,
        "nai": "@@000000013"
      },
      "savings_hbd_seconds": "0",
      "savings_hbd_seconds_last_update": "1970-01-01T00:00:00",
      "savings_hbd_last_interest_payment": "1970-01-01T00:00:00",
      "savings_withdraw_requests": 0,
      "reward_hbd_balance": {
        "amount": "0",
        "precision": 3,
        "nai": "@@000000013"
      },
      "reward_hive_balance": {
        "amount": "0",
        "precision": 3,
        "nai": "@@000000021"
      },
      "reward_vesting_balance": {
        "amount": "0",
        "precision": 6,
        "nai": "@@000000037"
      },
      "reward_vesting_hive": {
        "amount": "0",
        "precision": 3,
        "nai": "@@000000021"
      },
      "vesting_shares": {
        "amount": "598442432741",
        "precision": 6,
        "nai": "@@000000037"
      },
      "delegated_vesting_shares": {
        "amount": "0",
        "precision": 6,
        "nai": "@@000000037"
      },
      "received_vesting_shares": {
        "amount": "0",
        "precision": 6,
        "nai": "@@000000037"
      },
      "vesting_withdraw_rate": {
        "amount": "0",
        "precision": 6,
        "nai": "@@000000037"
      },
      "post_voting_power": {
        "amount": "598442432741",
        "precision": 6,
        "nai": "@@000000037"
      },
      "next_vesting_withdrawal": "1969-12-31T23:59:59",
      "withdrawn": 0,
      "to_withdraw": 0,
      "withdraw_routes": 0,
      "pending_transfers": 0,
      "curation_rewards": 0,
      "posting_rewards": 604589,
      "proxied_vsf_votes": [0, 0, 0, 0],
      "witnesses_voted_for": 0,
      "last_post": "2021-03-23T18:05:48",
      "last_root_post": "2021-03-23T18:05:48",
      "last_post_edit": "2021-03-23T18:05:48",
      "last_vote_time": "1970-01-01T00:00:00",
      "post_bandwidth": 0,
      "pending_claimed_accounts": 0,
      "is_smt": false,
      "delayed_votes": [
        {
          "time": "2021-02-24T05:08:21",
          "val": "11550765516955"
        },
        {
          "time": "2021-02-26T15:46:06",
          "val": "633465684569"
        },
        {
          "time": "2021-03-07T17:54:39",
          "val": "1000000037683"
        },
        {
          "time": "2021-03-16T05:54:33",
          "val": "999978763511"
        },
        {
          "time": "2021-03-18T06:06:00",
          "val": "1000000171317"
        }
      ]
    }
  ]
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.find_accounts", "params": {"accounts":["hiveio"]}, "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.find_accounts", "params": {"accounts":["hiveio", "alice"], "delayed_votes_active": false}, "id":1}' https://api.hive.blog

database_api.find_change_recovery_account_requests

Returns a list of requests to change the recovery account. Parameters: account:array

account (array)  
["hiveio"] Queries the recovery requests for account named “hiveio”.
Query Parameters JSON
{"accounts": []}
Expected Response JSON
{
  "requests": [
    {
      "id": 0,
      "account_to_recover": "",
      "recovery_account": "",
      "effective_on": "2020-01-08T00:45:18"
    }
  ]
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.find_change_recovery_account_requests", "params": {"accounts":["hiveio"]}, "id":1}' https://api.hive.blog

database_api.find_comments

Search for comments by author/permlink.

Query Parameters JSON
{"comments": [["author", "permlink"]]}
Expected Response JSON
{"comments": []}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.find_comments", "params": {"comments":[["hiveio", "around-the-hive-reflections"]]}, "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.find_comments", "params": {"comments":[["alice", "a-post-by-alice"]]}, "id":1}' https://api.hive.blog

database_api.find_decline_voting_rights_requests

Returns a list of requests to decline voting rights.

Query Parameters JSON
{"accounts": []}
Expected Response JSON
{"requests": []}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.find_decline_voting_rights_requests", "params": {"accounts":["temp","null"]}, "id":1}' https://api.hive.blog

database_api.find_escrows

Returns a list of escrows.

Query Parameters JSON
{"from": ""}
Expected Response JSON
{
  "escrows": [
    {
      "id": 143,
      "escrow_id": 12345,
      "from": "temp",
      "to": "guest123",
      "agent": "smitop",
      "ratification_deadline": "2038-01-19T03:14:06",
      "escrow_expiration": "2038-01-19T03:14:07",
      "hbd_balance": {
        "amount": "0",
        "precision": 3,
        "nai": "@@000000013"
      },
      "hive_balance": {
        "amount": "1",
        "precision": 3,
        "nai": "@@000000021"
      },
      "pending_fee": {
        "amount": "1",
        "precision": 3,
        "nai": "@@000000021"
      },
      "to_approved": false,
      "agent_approved": false,
      "disputed": false
    }
  ]
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.find_escrows", "params": {"from": "temp"}, "id":1}' https://api.hive.blog

database_api.find_limit_orders

Returns a list of limit orders.

Query Parameters JSON
{"account": ""}
Expected Response JSON
{
  "orders": [
    {
      "id": 0,
      "created": "2019-12-14T04:05:39",
      "expiration": "2019-12-15T05:05:21",
      "seller": "",
      "orderid": 0,
      "for_sale": 0,
      "sell_price": {
        "base": {
          "amount": "0",
          "precision": 3,
          "nai": "@@000000013"
        },
        "quote": {
          "amount": "0",
          "precision": 3,
          "nai": "@@000000021"
        }
      }
    }
  ]
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.find_limit_orders", "params": {"account":"temp"}, "id":1}' https://api.hive.blog

database_api.find_owner_histories

Returns owner authority history. Parameters: owner:string

owner (string)  
"hiveio" Queries the owner history for account named “hiveio”.
"alice" Queries the owner history for account named “alice”.
Query Parameters JSON
{"owner": ""}
Expected Response JSON
{"owner_auths": []}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.find_owner_histories", "params": {"owner":"hiveio"}, "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.find_owner_histories", "params": {"owner":"alice"}, "id":1}' https://api.hive.blog

database_api.find_savings_withdrawals

Returns the list of savings withdrawls for an account. Parameters: account:string

account (string)  
"hiveio" Queries the savings withdraw for account named “hiveio”.
Query Parameters JSON
{"account": ""}
Expected Response JSON
{"withdrawals": []}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.find_savings_withdrawals", "params": {"start":"temp"}, "id":1}' https://api.hive.blog

database_api.find_hbd_conversion_requests

Returns the list of HBD conversion requests for an account. Parameters: account:string

account (string)  
"hiveio" Queries a conversion request for hiveio.
"alice" Queries a conversion request for alice.
Query Parameters JSON
{"account": ""}
Expected Response JSON
{"requests": []}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.find_hbd_conversion_requests", "params": {"account":"hiveio"}, "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.find_hbd_conversion_requests", "params": {"account":"alice"}, "id":1}' https://api.hive.blog

database_api.find_vesting_delegation_expirations

Returns the expiring vesting delegations for an account. Parameters: account:string

account (string)    
"hiveio"   Queries for expiring vesting for hiveio.
"alice"   Queries for expiring vesting for alice.
Query Parameters JSON
{"account": ""}
Expected Response JSON
{
  "delegations": [
    {
      "id": 3077902,
      "delegator": "hiveio",
      "vesting_shares": {
        "amount": "201417615",
        "precision": 6,
        "nai": "@@000000037"
      },
      "expiration": "2018-12-05T21:46:48"
    }
  ]
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.find_vesting_delegation_expirations", "params": {"account":"hiveio"}, "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.find_vesting_delegation_expirations", "params": {"account":"alice"}, "id":1}' https://api.hive.blog

database_api.find_vesting_delegations

Returns the list of vesting delegations for an account. Parameters: account:string

account (string)    
"hiveio"   Queries for vesting for hiveio.
"alice"   Queries for vesting for alice.
Query Parameters JSON
{"account": ""}
Expected Response JSON
{
  "delegations": [
    {
      "id": 0,
      "delegator": "",
      "delegatee": "",
      "vesting_shares": {
        "amount": "0",
        "precision": 6,
        "nai": "@@000000037"
      },
      "min_delegation_time": "2018-02-28T15:36:51"
    }
  ]
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.find_vesting_delegations", "params": {"account":"hiveio"}, "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.find_vesting_delegations", "params": {"account":"alice"}, "id":1}' https://api.hive.blog

database_api.find_votes

Returns all votes for the given post. Required (non-empty) parameters: author:string; permlink:string

author (string) permlink (string)  
"hiveio" "announcing-the-launch-of-hive-blockchain" Queries votes for content with a slug @hiveio/announcing-the-launch-of-hive-blockchain
"alice" "a-post-by-alice" Queries votes for content with a slug @alice/a-post-by-alice
Query Parameters JSON
{
  "author": "hiveio",
  "permlink": "announcing-the-launch-of-hive-blockchain"
}
Expected Response JSON
{
  "votes": [
    {
      "id": 0,
      "voter": "",
      "author": "",
      "permlink": "",
      "weight": "0",
      "rshares": 0,
      "vote_percent": 0,
      "last_update": "2016-04-07T19:15:36",
      "num_changes": -1
    }
  ]
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.find_votes", "params": {"author":"hiveio", "permlink":"announcing-the-launch-of-hive-blockchain"}, "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.find_votes", "params": {"author":"alice", "permlink":"a-post-by-alice"}, "id":1}' https://api.hive.blog

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": [
    {
      "id": 0,
      "from_account": "",
      "to_account": "",
      "percent": 0,
      "auto_vest": true
    }
  ]
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.find_withdraw_vesting_routes", "params": {"account":"temp", "order":"by_destination"}, "id":1}' https://api.hive.blog

database_api.find_witnesses

Search for witnesses.

Query Parameters JSON
{"owners": []}
Expected Response JSON
{
  "witnesses": [
    {
      "id": 0,
      "owner": "initminer",
      "created": "1970-01-01T00:00:00",
      "url": "",
      "votes": 0,
      "virtual_last_update": "225400650183277777230188182",
      "virtual_position": "28933178228158941342755574680549120",
      "virtual_scheduled_time": "340253433742935705172215129634317850517",
      "total_missed": 88,
      "last_aslot": 1202,
      "last_confirmed_block_num": 1092,
      "pow_worker": 0,
      "signing_key": "STM8GC13uCZbP44HzMLV6zPZGwVQ8Nt4Kji8PapsPiNq1BK153XTX",
      "props": {
        "account_creation_fee": {
          "amount": "1",
          "precision": 3,
          "nai": "@@000000021"
        },
        "maximum_block_size": 131072,
        "hbd_interest_rate": 1000,
        "account_subsidy_budget": 797,
        "account_subsidy_decay": 347321
      },
      "hbd_exchange_rate": {
        "base": {
          "amount": "0",
          "precision": 3,
          "nai": "@@000000021"
        },
        "quote": {
          "amount": "0",
          "precision": 3,
          "nai": "@@000000021"
        }
      },
      "last_hbd_exchange_update": "1970-01-01T00:00:00",
      "last_work": "0000000000000000000000000000000000000000000000000000000000000000",
      "running_version": "0.23.0",
      "hardfork_version_vote": "0.23.0",
      "hardfork_time_vote": "2019-10-14T15:00:00",
      "available_witness_account_subsidies": 9379874
    }
  ]
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.find_witnesses", "params": {"owners":["initminer"]}, "id":1}' https://api.hive.blog

database_api.get_active_witnesses

Returns the list of active witnesses.

Query Parameters JSON
{}
Expected Response JSON
{
  "witnesses": [
    "lukestokes.mhth",
    "gtg",
    "ausbitbank",
    "clayop",
    "yabapmatt",
    "curie",
    "thecryptodrive",
    "roelandp",
    "followbtcnews",
    "timcliff",
    "smooth.witness",
    "bhuz",
    "aggroed",
    "blocktrades",
    "cervantes",
    "utopian-io",
    "anyx",
    "jesta",
    "drakos",
    "someguy123",
    "good-karma"
  ]
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.get_active_witnesses", "id":1}' https://api.hive.blog

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
{
  "IS_TEST_NET": true,
  "TESTNET_BLOCK_LIMIT": 3000000,
  "SMT_MAX_VOTABLE_ASSETS": 2,
  "SMT_VESTING_WITHDRAW_INTERVAL_SECONDS": 604800,
  "SMT_UPVOTE_LOCKOUT": 43200,
  "SMT_EMISSION_MIN_INTERVAL_SECONDS": 21600,
  "SMT_EMIT_INDEFINITELY": 4294967295,
  "SMT_MAX_NOMINAL_VOTES_PER_DAY": 1000,
  "SMT_MAX_VOTES_PER_REGENERATION": 7000,
  "SMT_DEFAULT_VOTES_PER_REGEN_PERIOD": 50,
  "SMT_DEFAULT_PERCENT_CURATION_REWARDS": 2500,
  "SMT_INITIAL_VESTING_PER_UNIT": 1000000,
  "SMT_BALLAST_SUPPLY_PERCENT": 10,
  "SMT_MAX_ICO_TIERS": 10,
  "HBD_SYMBOL": {"nai": "@@000000013", "precision": 3},
  "HIVE_INITIAL_VOTE_POWER_RATE": 40,
  "HIVE_REDUCED_VOTE_POWER_RATE": 10,
  "HIVE_100_PERCENT": 10000,
  "HIVE_1_PERCENT": 100,
  "HIVE_ACCOUNT_RECOVERY_REQUEST_EXPIRATION_PERIOD": 12000000,
  "HIVE_ACTIVE_CHALLENGE_COOLDOWN": "86400000000",
  "HIVE_ACTIVE_CHALLENGE_FEE": {
    "amount": "2000",
    "precision": 3,
    "nai": "@@000000021"
  },
  "HIVE_ADDRESS_PREFIX": "TST",
  "HIVE_APR_PERCENT_MULTIPLY_PER_BLOCK": "102035135585887",
  "HIVE_APR_PERCENT_MULTIPLY_PER_HOUR": "119577151364285",
  "HIVE_APR_PERCENT_MULTIPLY_PER_ROUND": "133921203762304",
  "HIVE_APR_PERCENT_SHIFT_PER_BLOCK": 87,
  "HIVE_APR_PERCENT_SHIFT_PER_HOUR": 77,
  "HIVE_APR_PERCENT_SHIFT_PER_ROUND": 83,
  "HIVE_BANDWIDTH_AVERAGE_WINDOW_SECONDS": 604800,
  "HIVE_BANDWIDTH_PRECISION": 1000000,
  "HIVE_BENEFICIARY_LIMIT": 128,
  "HIVE_BLOCKCHAIN_PRECISION": 1000,
  "HIVE_BLOCKCHAIN_PRECISION_DIGITS": 3,
  "HIVE_BLOCKCHAIN_HARDFORK_VERSION": "0.23.0",
  "HIVE_BLOCKCHAIN_VERSION": "0.23.0",
  "HIVE_BLOCK_INTERVAL": 3,
  "HIVE_BLOCKS_PER_DAY": 28800,
  "HIVE_BLOCKS_PER_HOUR": 1200,
  "HIVE_BLOCKS_PER_YEAR": 10512000,
  "HIVE_CASHOUT_WINDOW_SECONDS": 3600,
  "HIVE_CASHOUT_WINDOW_SECONDS_PRE_HF12": 3600,
  "HIVE_CASHOUT_WINDOW_SECONDS_PRE_HF17": 3600,
  "HIVE_CHAIN_ID": "18dcf0a285365fc58b71f18b3d3fec954aa0c141c44e4e5cb4cf777b9eab274e",
  "HIVE_COMMENT_REWARD_FUND_NAME": "comment",
  "HIVE_COMMENT_TITLE_LIMIT": 256,
  "HIVE_CONTENT_APR_PERCENT": 3875,
  "HIVE_CONTENT_CONSTANT_HF0": "2000000000000",
  "HIVE_CONTENT_CONSTANT_HF21": "2000000000000",
  "HIVE_CONTENT_REWARD_PERCENT_HF16": 7500,
  "HIVE_CONTENT_REWARD_PERCENT_HF21": 6500,
  "HIVE_CONVERSION_DELAY": "302400000000",
  "HIVE_CONVERSION_DELAY_PRE_HF_16": "604800000000",
  "HIVE_CREATE_ACCOUNT_DELEGATION_RATIO": 5,
  "HIVE_CREATE_ACCOUNT_DELEGATION_TIME": "2592000000000",
  "HIVE_CREATE_ACCOUNT_WITH_HIVE_MODIFIER": 30,
  "HIVE_CURATE_APR_PERCENT": 3875,
  "HIVE_CUSTOM_OP_DATA_MAX_LENGTH": 8192,
  "HIVE_CUSTOM_OP_ID_MAX_LENGTH": 32,
  "HIVE_DEFAULT_HBD_INTEREST_RATE": 1000,
  "HIVE_DOWNVOTE_POOL_PERCENT_HF21": 2500,
  "HIVE_EQUIHASH_K": 6,
  "HIVE_EQUIHASH_N": 140,
  "HIVE_FEED_HISTORY_WINDOW": 84,
  "HIVE_FEED_HISTORY_WINDOW_PRE_HF_16": 168,
  "HIVE_FEED_INTERVAL_BLOCKS": 1200,
  "HIVE_GENESIS_TIME": "2016-01-01T00:00:00",
  "HIVE_HARDFORK_REQUIRED_WITNESSES": 17,
  "HIVE_HF21_CONVERGENT_LINEAR_RECENT_CLAIMS": "503600561838938636",
  "HIVE_INFLATION_NARROWING_PERIOD": 250000,
  "HIVE_INFLATION_RATE_START_PERCENT": 978,
  "HIVE_INFLATION_RATE_STOP_PERCENT": 95,
  "HIVE_INIT_MINER_NAME": "initminer",
  "HIVE_INIT_PUBLIC_KEY_STR": "TST6LLegbAgLAy28EHrffBVuANFWcFgmqRMW13wBmTExqFE9SCkg4",
  "HIVE_INIT_SUPPLY": "250000000000",
  "HIVE_HBD_INIT_SUPPLY": "7000000000",
  "HIVE_INIT_TIME": "1970-01-01T00:00:00",
  "HIVE_IRREVERSIBLE_THRESHOLD": 7500,
  "HIVE_LIQUIDITY_APR_PERCENT": 750,
  "HIVE_LIQUIDITY_REWARD_BLOCKS": 1200,
  "HIVE_LIQUIDITY_REWARD_PERIOD_SEC": 3600,
  "HIVE_LIQUIDITY_TIMEOUT_SEC": "604800000000",
  "HIVE_MAX_ACCOUNT_CREATION_FEE": 1000000000,
  "HIVE_MAX_ACCOUNT_NAME_LENGTH": 16,
  "HIVE_MAX_ACCOUNT_WITNESS_VOTES": 30,
  "HIVE_MAX_ASSET_WHITELIST_AUTHORITIES": 10,
  "HIVE_MAX_AUTHORITY_MEMBERSHIP": 40,
  "HIVE_MAX_BLOCK_SIZE": 393216000,
  "HIVE_SOFT_MAX_BLOCK_SIZE": 2097152,
  "HIVE_MAX_CASHOUT_WINDOW_SECONDS": 86400,
  "HIVE_MAX_COMMENT_DEPTH": 65535,
  "HIVE_MAX_COMMENT_DEPTH_PRE_HF17": 6,
  "HIVE_MAX_FEED_AGE_SECONDS": 604800,
  "HIVE_MAX_INSTANCE_ID": "281474976710655",
  "HIVE_MAX_MEMO_SIZE": 2048,
  "HIVE_MAX_WITNESSES": 21,
  "HIVE_MAX_MINER_WITNESSES_HF0": 1,
  "HIVE_MAX_MINER_WITNESSES_HF17": 0,
  "HIVE_MAX_PERMLINK_LENGTH": 256,
  "HIVE_MAX_PROXY_RECURSION_DEPTH": 4,
  "HIVE_MAX_RATION_DECAY_RATE": 1000000,
  "HIVE_MAX_RESERVE_RATIO": 20000,
  "HIVE_MAX_RUNNER_WITNESSES_HF0": 1,
  "HIVE_MAX_RUNNER_WITNESSES_HF17": 1,
  "HIVE_MAX_SATOSHIS": "4611686018427387903",
  "HIVE_MAX_SHARE_SUPPLY": "1000000000000000",
  "HIVE_MAX_SIG_CHECK_DEPTH": 2,
  "HIVE_MAX_SIG_CHECK_ACCOUNTS": 125,
  "HIVE_MAX_TIME_UNTIL_EXPIRATION": 3600,
  "HIVE_MAX_TRANSACTION_SIZE": 65536,
  "HIVE_MAX_UNDO_HISTORY": 10000,
  "HIVE_MAX_URL_LENGTH": 127,
  "HIVE_MAX_VOTE_CHANGES": 5,
  "HIVE_MAX_VOTED_WITNESSES_HF0": 19,
  "HIVE_MAX_VOTED_WITNESSES_HF17": 20,
  "HIVE_MAX_WITHDRAW_ROUTES": 10,
  "HIVE_MAX_WITNESS_URL_LENGTH": 2048,
  "HIVE_MIN_ACCOUNT_CREATION_FEE": 0,
  "HIVE_MIN_ACCOUNT_NAME_LENGTH": 3,
  "HIVE_MIN_BLOCK_SIZE_LIMIT": 65536,
  "HIVE_MIN_BLOCK_SIZE": 115,
  "HIVE_MIN_CONTENT_REWARD": {
    "amount": "1000",
    "precision": 3,
    "nai": "@@000000021"
  },
  "HIVE_MIN_CURATE_REWARD": {
    "amount": "1000",
    "precision": 3,
    "nai": "@@000000021"
  },
  "HIVE_MIN_PERMLINK_LENGTH": 0,
  "HIVE_MIN_REPLY_INTERVAL": 20000000,
  "HIVE_MIN_REPLY_INTERVAL_HF20": 3000000,
  "HIVE_MIN_ROOT_COMMENT_INTERVAL": 300000000,
  "HIVE_MIN_COMMENT_EDIT_INTERVAL": 3000000,
  "HIVE_MIN_VOTE_INTERVAL_SEC": 3,
  "HIVE_MINER_ACCOUNT": "miners",
  "HIVE_MINER_PAY_PERCENT": 100,
  "HIVE_MIN_FEEDS": 7,
  "HIVE_MINING_REWARD": {
    "amount": "1000",
    "precision": 3,
    "nai": "@@000000021"
  },
  "HIVE_MINING_TIME": "2016-01-01T00:00:00",
  "HIVE_MIN_LIQUIDITY_REWARD": {
    "amount": "1200000",
    "precision": 3,
    "nai": "@@000000021"
  },
  "HIVE_MIN_LIQUIDITY_REWARD_PERIOD_SEC": 60000000,
  "HIVE_MIN_PAYOUT_HBD": {
    "amount": "20",
    "precision": 3,
    "nai": "@@000000013"
  },
  "HIVE_MIN_POW_REWARD": {
    "amount": "1000",
    "precision": 3,
    "nai": "@@000000021"
  },
  "HIVE_MIN_PRODUCER_REWARD": {
    "amount": "1000",
    "precision": 3,
    "nai": "@@000000021"
  },
  "HIVE_MIN_TRANSACTION_EXPIRATION_LIMIT": 15,
  "HIVE_MIN_TRANSACTION_SIZE_LIMIT": 1024,
  "HIVE_MIN_UNDO_HISTORY": 10,
  "HIVE_NULL_ACCOUNT": "null",
  "HIVE_NUM_INIT_MINERS": 1,
  "HIVE_OWNER_AUTH_HISTORY_TRACKING_START_BLOCK_NUM": 1,
  "HIVE_OWNER_AUTH_RECOVERY_PERIOD": 60000000,
  "HIVE_OWNER_CHALLENGE_COOLDOWN": "86400000000",
  "HIVE_OWNER_CHALLENGE_FEE": {
    "amount": "30000",
    "precision": 3,
    "nai": "@@000000021"
  },
  "HIVE_OWNER_UPDATE_LIMIT": 0,
  "HIVE_POST_AVERAGE_WINDOW": 86400,
  "HIVE_POST_REWARD_FUND_NAME": "post",
  "HIVE_POST_WEIGHT_CONSTANT": 1600000000,
  "HIVE_POW_APR_PERCENT": 750,
  "HIVE_PRODUCER_APR_PERCENT": 750,
  "HIVE_PROXY_TO_SELF_ACCOUNT": "",
  "HIVE_HBD_INTEREST_COMPOUND_INTERVAL_SEC": 2592000,
  "HIVE_SECONDS_PER_YEAR": 31536000,
  "HIVE_PROPOSAL_FUND_PERCENT_HF0": 0,
  "HIVE_PROPOSAL_FUND_PERCENT_HF21": 1000,
  "HIVE_RECENT_RSHARES_DECAY_TIME_HF19": "1296000000000",
  "HIVE_RECENT_RSHARES_DECAY_TIME_HF17": "2592000000000",
  "HIVE_REVERSE_AUCTION_WINDOW_SECONDS_HF6": 1800,
  "HIVE_REVERSE_AUCTION_WINDOW_SECONDS_HF20": 900,
  "HIVE_REVERSE_AUCTION_WINDOW_SECONDS_HF21": 300,
  "HIVE_ROOT_POST_PARENT": "",
  "HIVE_SAVINGS_WITHDRAW_REQUEST_LIMIT": 100,
  "HIVE_SAVINGS_WITHDRAW_TIME": "259200000000",
  "HIVE_HBD_START_PERCENT_HF14": 200,
  "HIVE_HBD_START_PERCENT_HF20": 900,
  "HIVE_HBD_STOP_PERCENT_HF14": 500,
  "HIVE_HBD_STOP_PERCENT_HF20": 1000,
  "HIVE_SECOND_CASHOUT_WINDOW": 259200,
  "HIVE_SOFT_MAX_COMMENT_DEPTH": 255,
  "HIVE_START_MINER_VOTING_BLOCK": 864000,
  "HIVE_START_VESTING_BLOCK": 201600,
  "HIVE_TEMP_ACCOUNT": "temp",
  "HIVE_UPVOTE_LOCKOUT_HF7": 60000000,
  "HIVE_UPVOTE_LOCKOUT_HF17": 300000000,
  "HIVE_UPVOTE_LOCKOUT_SECONDS": 300,
  "HIVE_VESTING_FUND_PERCENT_HF16": 1500,
  "HIVE_VESTING_WITHDRAW_INTERVALS": 13,
  "HIVE_VESTING_WITHDRAW_INTERVALS_PRE_HF_16": 104,
  "HIVE_VESTING_WITHDRAW_INTERVAL_SECONDS": 604800,
  "HIVE_VOTE_DUST_THRESHOLD": 50000000,
  "HIVE_VOTING_MANA_REGENERATION_SECONDS": 432000,
  "HIVE_SYMBOL": {"nai": "@@000000021", "precision": 3},
  "VESTS_SYMBOL": {"nai": "@@000000037", "precision": 6},
  "HIVE_VIRTUAL_SCHEDULE_LAP_LENGTH": "18446744073709551615",
  "HIVE_VIRTUAL_SCHEDULE_LAP_LENGTH2": "340282366920938463463374607431768211455",
  "HIVE_VOTES_PER_PERIOD_SMT_HF": 50,
  "HIVE_MAX_LIMIT_ORDER_EXPIRATION": 2419200,
  "HIVE_DELEGATION_RETURN_PERIOD_HF0": 3600,
  "HIVE_DELEGATION_RETURN_PERIOD_HF20": 432000,
  "HIVE_RD_MIN_DECAY_BITS": 6,
  "HIVE_RD_MAX_DECAY_BITS": 32,
  "HIVE_RD_DECAY_DENOM_SHIFT": 36,
  "HIVE_RD_MAX_POOL_BITS": 64,
  "HIVE_RD_MAX_BUDGET_1": "17179869183",
  "HIVE_RD_MAX_BUDGET_2": 268435455,
  "HIVE_RD_MAX_BUDGET_3": 2147483647,
  "HIVE_RD_MAX_BUDGET": 268435455,
  "HIVE_RD_MIN_DECAY": 64,
  "HIVE_RD_MIN_BUDGET": 1,
  "HIVE_RD_MAX_DECAY": 4294967295,
  "HIVE_ACCOUNT_SUBSIDY_PRECISION": 10000,
  "HIVE_WITNESS_SUBSIDY_BUDGET_PERCENT": 12500,
  "HIVE_WITNESS_SUBSIDY_DECAY_PERCENT": 210000,
  "HIVE_DEFAULT_ACCOUNT_SUBSIDY_DECAY": 347321,
  "HIVE_DEFAULT_ACCOUNT_SUBSIDY_BUDGET": 797,
  "HIVE_DECAY_BACKSTOP_PERCENT": 9000,
  "HIVE_BLOCK_GENERATION_POSTPONED_TX_LIMIT": 5,
  "HIVE_PENDING_TRANSACTION_EXECUTION_LIMIT": 200000,
  "HIVE_TREASURY_ACCOUNT": "hive.fund",
  "HIVE_TREASURY_FEE": 10000,
  "HIVE_PROPOSAL_MAINTENANCE_PERIOD": 3600,
  "HIVE_PROPOSAL_MAINTENANCE_CLEANUP": 86400,
  "HIVE_PROPOSAL_SUBJECT_MAX_LENGTH": 80,
  "HIVE_PROPOSAL_MAX_IDS_NUMBER": 5,
  "HIVE_NETWORK_TYPE": "testnet",
  "HIVE_DB_FORMAT_VERSION": "1"
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.get_config", "id":1}' https://api.hive.blog

database_api.get_current_price_feed

Returns the current price feed.

Query Parameters JSON
{}
Expected Response JSON
{
  "base": {
    "amount": "1",
    "precision": 3,
    "nai": "@@000000013"
  },
  "quote": {
    "amount": "1",
    "precision": 3,
    "nai": "@@000000021"
  }
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.get_current_price_feed", "id":1}' https://api.hive.blog

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": 293261,
  "head_block_id": "0004798df7357f23b9e6d4b6739e4ca9eac2f403",
  "time": "2019-12-14T22:58:51",
  "current_witness": "init-0",
  "total_pow": "18446744073709551615",
  "num_pow_witnesses": 0,
  "virtual_supply": {
    "amount": "286041551516",
    "precision": 3,
    "nai": "@@000000021"
  },
  "current_supply": {
    "amount": "250990841260",
    "precision": 3,
    "nai": "@@000000021"
  },
  "confidential_supply": {
    "amount": "0",
    "precision": 3,
    "nai": "@@000000021"
  },
  "init_hbd_supply": {
    "amount": "7000000000",
    "precision": 3,
    "nai": "@@000000013"
  },
  "current_hbd_supply": {
    "amount": "35050710256",
    "precision": 3,
    "nai": "@@000000013"
  },
  "confidential_hbd_supply": {
    "amount": "0",
    "precision": 3,
    "nai": "@@000000013"
  },
  "total_vesting_fund_hive": {
    "amount": "146016220388",
    "precision": 3,
    "nai": "@@000000021"
  },
  "total_vesting_shares": {
    "amount": "52556676118700",
    "precision": 6,
    "nai": "@@000000037"
  },
  "total_reward_fund_hive": {
    "amount": "0",
    "precision": 3,
    "nai": "@@000000021"
  },
  "total_reward_shares2": "0",
  "pending_rewarded_vesting_shares": {
    "amount": "55809356614",
    "precision": 6,
    "nai": "@@000000037"
  },
  "pending_rewarded_vesting_hive": {
    "amount": "154999023",
    "precision": 3,
    "nai": "@@000000021"
  },
  "hbd_interest_rate": 1000,
  "hbd_print_rate": 0,
  "maximum_block_size": 131072,
  "required_actions_partition_percent": 2500,
  "current_aslot": 41585977,
  "recent_slots_filled": "340282366920938463463374607431768211455",
  "participation_count": 128,
  "last_irreversible_block_num": 293240,
  "target_votes_per_period": 50,
  "delegation_return_period": 432000,
  "reverse_auction_seconds": 300,
  "available_account_subsidies": 120334411,
  "hbd_stop_percent": 1000,
  "hbd_start_percent": 900,
  "next_maintenance_time": "2019-12-14T23:18:24",
  "last_budget_time": "2019-12-14T22:18:24",
  "content_reward_percent": 6500,
  "vesting_reward_percent": 1500,
  "sps_fund_percent": 1000,
  "sps_interval_ledger": {
    "amount": "213590",
    "precision": 3,
    "nai": "@@000000013"
  },
  "downvote_pool_percent": 2500,
  "smt_creation_fee": {
    "amount": "1000",
    "precision": 3,
    "nai": "@@000000013"
  }
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.get_dynamic_global_properties", "id":1}' https://api.hive.blog

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": "1",
      "precision": 3,
      "nai": "@@000000013"
    },
    "quote": {
      "amount": "1",
      "precision": 3,
      "nai": "@@000000021"
    }
  },
  "price_history": []
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.get_feed_history", "id":1}' https://api.hive.blog

database_api.get_hardfork_properties

Returns the current properties about the blockchain’s hardforks.

See: condenser_api.get_next_scheduled_hardfork, hardfork

Query Parameters JSON
{}
Expected Response JSON
{
  "id": 0,
  "processed_hardforks": [
    "2016-03-24T16:00:00",
    "2016-04-25T17:30:00",
    "2016-04-26T18:00:00",
    "2016-04-27T13:00:00",
    "2016-04-30T15:00:00",
    "2016-05-31T17:00:00",
    "2016-06-30T14:00:00",
    "2016-07-04T00:00:00",
    "2016-07-04T01:00:00",
    "2016-07-14T00:00:00",
    "2016-07-15T12:00:00",
    "2016-07-17T15:00:00",
    "2016-07-26T15:00:00",
    "2016-08-15T14:00:00",
    "2016-09-20T15:00:00",
    "2016-11-08T16:00:00",
    "2016-12-06T16:00:00",
    "2017-03-30T15:00:00",
    "2017-03-30T15:00:00",
    "2017-06-20T15:00:00",
    "2018-09-25T15:00:00",
    "2019-08-27T15:00:00",
    "2019-08-29T15:00:00",
    "2020-03-20T14:00:00",
    "2020-10-06T14:00:00"
  ],
  "last_hardfork": 24,
  "current_hardfork_version": "1.24.0",
  "next_hardfork": "1.24.0",
  "next_hardfork_time": "2020-10-06T14:00:00"
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.get_hardfork_properties", "id":1}' https://api.hive.blog

database_api.get_order_book

Returns the order book.

Query Parameters JSON
{
  "limit": 0,
  "base": {
    "amount": "1000",
    "precision": 3,
    "nai": "@@000000021"
  },
  "quote": {
    "amount": "1",
    "precision": 3,
    "nai": "@@000000013"
  }
}
Expected Response JSON
{"asks": [], "bids": []}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.get_order_book", "params":{"limit":10,"base":{"amount":"1000","precision":3,"nai":"@@000000021"},"quote":{"amount":"1","precision":3,"nai":"@@000000013"}}, "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.get_order_book", "params":{"limit":50,"base":{"amount":"1000","precision":3,"nai":"@@000000021"},"quote":{"amount":"1","precision":3,"nai":"@@000000013"}}, "id":1}' https://api.hive.blog

database_api.get_potential_signatures

This method will return the set of all public keys that could possibly sign for a given transaction. This call can be used by wallets to filter their set of public keys to just the relevant subset prior to calling get_required_signatures to get the minimum subset.

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,"hbd_interest_rate":1000}}}],"extensions":[],"signatures":[]}}, "id":1}' https://api.hive.blog

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,"hbd_interest_rate":1000}}}],"extensions":[],"signatures":[]},"available_keys":[]}, "id":1}' https://api.hive.blog

database_api.get_reward_funds

Returns information about the current reward funds.

Query Parameters JSON
{}
Expected Response JSON
{
  "funds": [
    {
      "id": 0,
      "name": "post",
      "reward_balance": {
        "amount": "189101553",
        "precision": 3,
        "nai": "@@000000021"
      },
      "recent_claims": "2723043883497",
      "last_update": "2019-12-14T23:10:42",
      "content_constant": "2000000000000",
      "percent_curation_rewards": 5000,
      "percent_content_rewards": 10000,
      "author_reward_curve": "convergent_linear",
      "curation_reward_curve": "convergent_square_root"
    }
  ]
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.get_reward_funds", "id":1}' https://api.hive.blog

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": "00000000000000000000000000"}
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,"hbd_interest_rate":1000}}}],"extensions":[],"signatures":[]}}, "id":1}' https://api.hive.blog

database_api.get_version

Returns the compile time versions of blockchain, hived, 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": "0.23.0",
  "hive_revision": "5cda10a488cf77f68549ec6d3a6be9af2ea9351b",
  "fc_revision": "5cda10a488cf77f68549ec6d3a6be9af2ea9351b",
  "chain_id": "beeab0de00000000000000000000000000000000000000000000000000000000"
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.get_version", "id":1}' https://api.hive.blog

database_api.get_witness_schedule

Returns the current witness schedule.

Query Parameters JSON
{}
Expected Response JSON
{
  "id": 0,
  "current_virtual_time": "55892543567970911424442556665819",
  "next_shuffle_block_num": 293580,
  "current_shuffled_witnesses": [
    "init-2",
    "init-11",
    "init-18",
    "init-16",
    "init-1",
    "init-10",
    "init-0",
    "init-14",
    "init-13",
    "gandalf",
    "init-3",
    "init-12",
    "init-5",
    "init-17",
    "initminer",
    "init-19",
    "init-4",
    "init-15",
    "drakos",
    "gtg",
    "init-7"
  ],
  "num_scheduled_witnesses": 21,
  "elected_weight": 1,
  "timeshare_weight": 5,
  "miner_weight": 1,
  "witness_pay_normalization_factor": 25,
  "median_props": {
    "account_creation_fee": {
      "amount": "0",
      "precision": 3,
      "nai": "@@000000021"
    },
    "maximum_block_size": 131072,
    "hbd_interest_rate": 1000,
    "account_subsidy_budget": 797,
    "account_subsidy_decay": 347321
  },
  "majority_version": "0.23.0",
  "max_voted_witnesses": 20,
  "max_miner_witnesses": 0,
  "max_runner_witnesses": 1,
  "hardfork_required_witnesses": 17,
  "account_subsidy_rd": {
    "resource_unit": 10000,
    "budget_per_time_unit": 797,
    "pool_eq": 157691079,
    "max_pool_size": 157691079,
    "decay_params": {
      "decay_per_time_unit": 347321,
      "decay_per_time_unit_denom_shift": 36
    },
    "min_decay": 0
  },
  "account_subsidy_witness_rd": {
    "resource_unit": 10000,
    "budget_per_time_unit": 996,
    "pool_eq": 9384019,
    "max_pool_size": 9384019,
    "decay_params": {
      "decay_per_time_unit": 7293741,
      "decay_per_time_unit_denom_shift": 36
    },
    "min_decay": 612
  },
  "min_witness_account_subsidy_decay": 0
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.get_witness_schedule", "id":1}' https://api.hive.blog

database_api.list_account_recovery_requests

Returns a list of account recovery requests. Parameters: start:string, limit:int, order:string

account (string) limit (int) order (string)  
"hiveio" 10 "by_account" Queries the recovery requests for account named “hiveio”, ordered by account name.
["1960-01-01T00:00:00"] 10 "by_expiration" Queries the recovery requests for date, ordered by expiration.
Query Parameters JSON
{"start": null, "limit": 0, "order": "by_name"}
Expected Response JSON
{"requests": []}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_account_recovery_requests", "params": {"start":"", "limit":10, "order":"by_account"}, "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_account_recovery_requests", "params": {"start":["1960-01-01T00:00:00"], "limit":10, "order":"by_expiration"}, "id":1}' https://api.hive.blog

database_api.list_accounts

List accounts ordered by specified key. Parameters: start:object, limit:int, order:string, delayed_votes_active:boolean

start (object) limit (int) order (string) delayed_votes_active (boolean)
"" 10 "by_name" Queries for up to 10 accounts starting at the beginning, sorted by name.  
["", ""] 10 "by_proxy" Queries for up to 10 accounts starting at the beginning, sorted by proxy.  
["1960-01-01T00:00:00", ""] 10 "by_next_vesting_withdrawal" Queries for up to 10 accounts starting at the beginning, sorted by next vesting withdrawl. false

Also see: Paginated API Methods

Query Parameters JSON
{
  "start": null,
  "limit": 0,
  "order": "by_name",
  "delayed_votes_active": true
}
Expected Response JSON
{
  "accounts": [
    {
      "id": 7184,
      "name": "a-0",
      "owner": {
        "weight_threshold": 1,
        "account_auths": [],
        "key_auths": [
          [
            "STM5RrTRNDhhrMaA24SzSeE5AvmUcutb1q1VZp1imnT8p871s3UjN",
            1
          ]
        ]
      },
      "active": {
        "weight_threshold": 1,
        "account_auths": [],
        "key_auths": [
          [
            "STM5RrTRNDhhrMaA24SzSeE5AvmUcutb1q1VZp1imnT8p871s3UjN",
            1
          ]
        ]
      },
      "posting": {
        "weight_threshold": 1,
        "account_auths": [],
        "key_auths": [
          [
            "STM5RrTRNDhhrMaA24SzSeE5AvmUcutb1q1VZp1imnT8p871s3UjN",
            1
          ]
        ]
      },
      "memo_key": "STM5RrTRNDhhrMaA24SzSeE5AvmUcutb1q1VZp1imnT8p871s3UjN",
      "json_metadata": "",
      "posting_json_metadata": "",
      "proxy": "",
      "last_owner_update": "1970-01-01T00:00:00",
      "last_account_update": "1970-01-01T00:00:00",
      "created": "2016-04-30T12:27:12",
      "mined": true,
      "recovery_account": "steem",
      "last_account_recovery": "1970-01-01T00:00:00",
      "reset_account": "null",
      "comment_count": 0,
      "lifetime_vote_count": 0,
      "post_count": 0,
      "can_vote": true,
      "voting_manabar": {
        "current_mana": 10000,
        "last_update_time": 1462019232
      },
      "downvote_manabar": {
        "current_mana": 0,
        "last_update_time": 1462019232
      },
      "balance": {
        "amount": "1",
        "precision": 3,
        "nai": "@@000000021"
      },
      "savings_balance": {
        "amount": "0",
        "precision": 3,
        "nai": "@@000000021"
      },
      "hbd_balance": {
        "amount": "0",
        "precision": 3,
        "nai": "@@000000013"
      },
      "hbd_seconds": "0",
      "hbd_seconds_last_update": "1970-01-01T00:00:00",
      "hbd_last_interest_payment": "1970-01-01T00:00:00",
      "savings_hbd_balance": {
        "amount": "0",
        "precision": 3,
        "nai": "@@000000013"
      },
      "savings_hbd_seconds": "0",
      "savings_hbd_seconds_last_update": "1970-01-01T00:00:00",
      "savings_hbd_last_interest_payment": "1970-01-01T00:00:00",
      "savings_withdraw_requests": 0,
      "reward_hbd_balance": {
        "amount": "0",
        "precision": 3,
        "nai": "@@000000013"
      },
      "reward_hive_balance": {
        "amount": "0",
        "precision": 3,
        "nai": "@@000000021"
      },
      "reward_vesting_balance": {
        "amount": "0",
        "precision": 6,
        "nai": "@@000000037"
      },
      "reward_vesting_hive": {
        "amount": "0",
        "precision": 3,
        "nai": "@@000000021"
      },
      "vesting_shares": {
        "amount": "13873020360",
        "precision": 6,
        "nai": "@@000000037"
      },
      "delegated_vesting_shares": {
        "amount": "0",
        "precision": 6,
        "nai": "@@000000037"
      },
      "received_vesting_shares": {
        "amount": "0",
        "precision": 6,
        "nai": "@@000000037"
      },
      "vesting_withdraw_rate": {
        "amount": "0",
        "precision": 6,
        "nai": "@@000000037"
      },
      "post_voting_power": {
        "amount": "13873020360",
        "precision": 6,
        "nai": "@@000000037"
      },
      "next_vesting_withdrawal": "1969-12-31T23:59:59",
      "withdrawn": 0,
      "to_withdraw": 0,
      "withdraw_routes": 0,
      "pending_transfers": 0,
      "curation_rewards": 0,
      "posting_rewards": 0,
      "proxied_vsf_votes": [0, 0, 0, 0],
      "witnesses_voted_for": 0,
      "last_post": "1970-01-01T00:00:00",
      "last_root_post": "1970-01-01T00:00:00",
      "last_post_edit": "1970-01-01T00:00:00",
      "last_vote_time": "1970-01-01T00:00:00",
      "post_bandwidth": 0,
      "pending_claimed_accounts": 0,
      "is_smt": false,
      "delayed_votes": [
        {
          "time": "2021-02-24T05:08:21",
          "val": "11550765516955"
        },
        {
          "time": "2021-02-26T15:46:06",
          "val": "633465684569"
        },
        {
          "time": "2021-03-07T17:54:39",
          "val": "1000000037683"
        },
        {
          "time": "2021-03-16T05:54:33",
          "val": "999978763511"
        },
        {
          "time": "2021-03-18T06:06:00",
          "val": "1000000171317"
        }
      ]
    }
  ]
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_accounts", "params": {"start":"", "limit":10, "order":"by_name"}, "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_accounts", "params": {"start":["", ""], "limit":10, "order":"by_proxy"}, "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_accounts", "params": {"start":["1960-01-01T00:00:00", ""], "limit":10, "order":"by_next_vesting_withdrawal","delayed_votes_active":false}, "id":1}' https://api.hive.blog

database_api.list_change_recovery_account_requests

Returns a list of recovery account change requests. Parameters: start:object, limit:int, order:string

start (object) limit (int) order (string)  
"" 10 "by_account" Queries first 10 requests, sort by account
["1960-01-01T00:00:00", ""] 10 "by_effective_date" Queries first 10 requests, sort by effective date

Also see: Paginated API Methods

Query Parameters JSON
{"start": null, "limit": 0, "order": "by_name"}
Expected Response JSON
{
  "requests": [
    {
      "id": 99,
      "account_to_recover": "alice",
      "recovery_account": "bob",
      "effective_on": "1960-01-01T00:00:00"
    }
  ]
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_change_recovery_account_requests", "params": {"start":"alice", "limit":10, "order":"by_account"}, "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_change_recovery_account_requests", "params": {"start":["1960-01-01T00:00:00",""], "limit":10, "order":"by_effective_date"}, "id":1}' https://api.hive.blog

database_api.list_comments

Returns all comments, starting with the specified options. Parameters: start:array; limit:int; order:string

start (array) limit (int) order (string)  
["1970-01-01T00:00:00", "", ""] 10 "by_cashout_time" Queries first 10 comments, sort by cashout time
["", ""] 10 "by_permlink" Queries first 10 comments, sort by permlink
["hiveio","announcing-the-launch-of-hive-blockchain", "", ""] 10 "by_root" Queries next 10 comments starting at @hiveio/firstpost, sort by root
["hiveio","announcing-the-launch-of-hive-blockchain", "", ""] 10 "by_parent" Queries next 10 comments starting at @hiveio/firstpost, sort by parent
["hiveio","1970-01-01T00:00:00", "", ""] 10 "by_last_update" Queries next 10 comments starting at @hiveio’s updates since timpstamp, sort by last update
["hiveio","1970-01-01T00:00:00", "", ""] 10 "by_author_last_update" Queries next 10 comments starting at @hiveio’s updates since timestamp, sort by author’s last update

Also see: Paginated API Methods

Query Parameters JSON
{"start": null, "limit": 0, "order": "by_name"}
Expected Response JSON
{
  "comments": [
    {
      "active": "2020-03-18T16:45:21",
      "author_rewards": 11835,
      "id": 96448425,
      "author": "berniesanders",
      "permlink": "q7d2ue",
      "category": "communityfork",
      "title": "",
      "body": "https://media.giphy.com/media/xjLlSxM5Z61FJh9wMC/giphy.gif",
      "json_metadata": "{\"image\":[\"https://media.giphy.com/media/xjLlSxM5Z61FJh9wMC/giphy.gif\"],\"app\":\"steemit/0.2\"}",
      "created": "2020-03-17T23:35:06",
      "last_update": "2020-03-17T23:35:06",
      "depth": 1,
      "children": 5,
      "last_payout": "2020-03-24T23:35:06",
      "cashout_time": "1969-12-31T23:59:59",
      "max_cashout_time": "1969-12-31T23:59:59",
      "curator_payout_value": {
        "amount": "2120",
        "nai": "@@000000013",
        "precision": 3
      },
      "total_payout_value": {
        "amount": "2247",
        "nai": "@@000000013",
        "precision": 3
      },
      "reward_weight": 10000,
      "root_author": "hiveio",
      "root_permlink": "announcing-the-launch-of-hive-blockchain",
      "allow_replies": true,
      "allow_votes": true,
      "allow_curation_rewards": true,
      "parent_author": "hiveio",
      "parent_permlink": "announcing-the-launch-of-hive-blockchain",
      "beneficiaries": [],
      "max_accepted_payout": {
        "amount": "1000000000",
        "nai": "@@000000013",
        "precision": 3
      },
      "percent_hbd": 10000,
      "net_votes": 30,
      "total_vote_weight": 0,
      "vote_rshares": 0,
      "net_rshares": 0,
      "abs_rshares": 0,
      "children_abs_rshares": 0
    }
  ]
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_comments", "params": {"start":["1970-01-01T00:00:00","",""], "limit":10, "order":"by_cashout_time"}, "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_comments", "params": {"start":["",""], "limit":10, "order":"by_permlink"}, "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_comments", "params": {"start":["hiveio","announcing-the-launch-of-hive-blockchain","",""], "limit":10, "order":"by_root"}, "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_comments", "params": {"start":["hiveio","announcing-the-launch-of-hive-blockchain","",""], "limit":10, "order":"by_parent"}, "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_comments", "params": {"start":["hiveio","1970-01-01T00:00:00","",""], "limit":10, "order":"by_last_update"}, "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_comments", "params": {"start":["hiveio","1970-01-01T00:00:00","",""], "limit":10, "order":"by_author_last_update"}, "id":1}' https://api.hive.blog

database_api.list_decline_voting_rights_requests

Returns a list of decline voting rights requests. Parameters: start:object; limit:int; order:string

start (object) limit (int) order (string)  
"" 10 "by_account" Queries first 10 requests, sort by account
["1960-01-01T00:00:00", ""] 10 "by_effective_date" Queries first 10 requests, sort by effective date

Also see: Paginated API Methods

Query Parameters JSON
{"start": null, "limit": 0, "order": "by_name"}
Expected Response JSON
{"requests": []}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_decline_voting_rights_requests", "params": {"start":"", "limit":10, "order":"by_account"}, "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_decline_voting_rights_requests", "params": {"start":["1970-01-01T00:00:00","",""], "limit":10, "order":"by_effective_date"}, "id":1}' https://api.hive.blog

database_api.list_escrows

Returns a list of escrows. Parameters: start:array; limit:int; order:string

start (array) limit (int) order (string)  
["alice", 99] 10 "by_from_id" Queries first 10 requests, sort by id
[true, "1960-01-01T00:00:00", 99] 10 "by_ratification_deadline" Queries first 10 requests, sort by ratification deadline

Also see: Paginated API Methods

Query Parameters JSON
{"start": null, "limit": 0, "order": "by_name"}
Expected Response JSON
{
  "escrows": [
    {
      "id": 158,
      "escrow_id": 1,
      "from": "addicttolife",
      "to": "fundition.help",
      "agent": "ongame",
      "ratification_deadline": "2018-11-23T17:31:26",
      "escrow_expiration": "2018-11-24T17:31:26",
      "hbd_balance": {
        "amount": "0",
        "precision": 3,
        "nai": "@@000000013"
      },
      "hive_balance": {
        "amount": "4832",
        "precision": 3,
        "nai": "@@000000021"
      },
      "pending_fee": {
        "amount": "0",
        "precision": 3,
        "nai": "@@000000021"
      },
      "to_approved": true,
      "agent_approved": true,
      "disputed": false
    }
  ]
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_escrows", "params": {"start":["",0], "limit":10, "order":"by_from_id"}, "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_escrows", "params": {"start":[true, "1970-01-01T00:00:00", 0], "limit":10, "order":"by_ratification_deadline"}, "id":1}' https://api.hive.blog

database_api.list_limit_orders

Returns a list of limit orders. Parameters: start:array; limit:int; order:string

start (array) limit (int) order (string)  
[{"base": {"amount": "85405", "precision": 3, "nai": "@@000000021"}, "quote": {"amount": "17192", "precision": 3, "nai": "@@000000013"}}, 0] 10 "by_price" Queries first 10 requests, sort by price
["alice", 0] 10 "by_effective_date" Queries first 10 requests, sort by account

Also see: Paginated API Methods

Query Parameters JSON
{"start": null, "limit": 0, "order": "by_name"}
Expected Response JSON
{
  "orders": [
    {
      "id": 3155591,
      "created": "2018-12-05T06:34:21",
      "expiration": "2018-12-15T06:34:20",
      "seller": "teamsmooth-mm",
      "orderid": 2000,
      "for_sale": 197714,
      "sell_price": {
        "base": {
          "amount": "198513",
          "precision": 3,
          "nai": "@@000000021"
        },
        "quote": {
          "amount": "80000",
          "precision": 3,
          "nai": "@@000000013"
        }
      }
    }
  ]
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_limit_orders", "params": {"start":[{"base":{"amount":"1000","precision":3,"nai":"@@000000021"},"quote":{"amount":"1","precision":3,"nai":"@@000000013"}},0], "limit":10, "order":"by_price"}, "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_limit_orders", "params": {"start":["alice",0], "limit":10, "order":"by_account"}, "id":1}' https://api.hive.blog

database_api.list_owner_histories

Returns a list of owner authority histories. Parameters: start:array, limit:int

start (array) limit (int)  
["hiveio", "1970-01-01T00:00:00"] 10 Queries the owner history starting from account named “hiveio” on “1970-01-01T00:00:00”, limit 10 results.
["alice", "1970-01-01T00:00:00"] 10 Queries the owner history starting from account named “alice”, limit 10 results.

Also see: Paginated API Methods

Query Parameters JSON
{"start": null, "limit": 0}
Expected Response JSON
{
  "owner_auths": [
    {
      "id": 129742,
      "account": "a-m",
      "previous_owner_authority": {
        "weight_threshold": 1,
        "account_auths": [],
        "key_auths": [
          [
            "STM7J6gXoztfTscNzmzL11DFtTPCFCTeZzsFtFxsQrQw91KnN1YxQ",
            1
          ]
        ]
      },
      "last_valid_time": "2018-11-24T02:35:27"
    }
  ]
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_owner_histories", "params": {"start":["hiveio","1970-01-01T00:00:00"], "limit":10}, "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_owner_histories", "params": {"start":["alice","1970-01-01T00:00:00"], "limit":10}, "id":1}' https://api.hive.blog

database_api.list_savings_withdrawals

Returns a list of savings withdrawls. Parameters: start:object, limit:int, order:string

start (object) limit (int) order (string)  
[0] 10 "by_from_id" Queries the savings withdraw for id.
["2018-12-07T16:54:03", "hiveio", 0] 10 "by_complete_from_id" Queries the savings withdraw for id (completed).
["", "1970-01-01T00:00:00", 0] 10 "by_to_complete" Queries the savings withdraw completed.

Also see: Paginated API Methods

Query Parameters JSON
{"start": null, "limit": 0, "order": "by_name"}
Expected Response JSON
{
  "withdrawals": [
    {
      "id": 120083,
      "from": "adafnnys",
      "to": "adafnnys",
      "memo": "",
      "request_id": 1543942411,
      "amount": {
        "amount": "2413",
        "precision": 3,
        "nai": "@@000000013"
      },
      "complete": "2018-12-07T16:54:03"
    }
  ]
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_savings_withdrawals", "params": {"start":[0], "limit":10, "order":"by_from_id"}, "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_savings_withdrawals", "params": {"start":["2018-12-07T16:54:03", "hiveio", 0], "limit":10, "order":"by_complete_from_id"}, "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_savings_withdrawals", "params": {"start":["", "1970-01-01T00:00:00", 0], "limit":10, "order":"by_to_complete"}, "id":1}' https://api.hive.blog

database_api.list_hbd_conversion_requests

Returns the list of HBD conversion requests for an account. Parameters: start:array, limit:int, order:string

start (array) limit (int) order (string)  
["hiveio", 0] 10 by_account Queries a conversion request for hiveio, limit to 10 results, order by account name.
["2018-12-07T16:54:03", 0] 10 by_conversion_date Queries a conversion request from this date, limit to 10 results, order by conversion date.

Also see: Paginated API Methods

Query Parameters JSON
{"start": null, "limit": 0, "order": "by_name"}
Expected Response JSON
{
  "requests": [
    {
      "id": 75677,
      "owner": "adenijiadeshina",
      "requestid": 3,
      "amount": {
        "amount": "311",
        "precision": 3,
        "nai": "@@000000013"
      },
      "conversion_date": "2018-12-06T20:42:42"
    }
  ]
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_hbd_conversion_requests", "params": {"start":["hiveio", 0], "limit":10, "order":"by_account"}, "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_hbd_conversion_requests", "params": {"start":["2018-12-07T16:54:03", 0], "limit":10, "order":"by_conversion_date"}, "id":1}' https://api.hive.blog

database_api.list_vesting_delegation_expirations

Returns a list of vesting delegation expirations. Parameters: start:array, limit:int, order:string

start (array) limit (int) order (string)  
["1970-01-01T00:00:00", 0] 10 by_expiration Queries delegations, limit to 10 results, order by expiration.
["alice", "1970-01-01T00:00:00", 0] 10 by_account_expiration Queries delegation from this date, limit to 10 results, order by account expiration.

Also see: Paginated API Methods

Query Parameters JSON
{"start": null, "limit": 0, "order": "by_name"}
Expected Response JSON
{
  "delegations": [
    {
      "id": 3076685,
      "delegator": "anonsteem",
      "vesting_shares": {
        "amount": "6050629930",
        "precision": 6,
        "nai": "@@000000037"
      },
      "expiration": "2018-12-05T07:07:15"
    }
  ]
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_vesting_delegation_expirations", "params": {"start":["1970-01-01T00:00:00",0], "limit":10, "order":"by_expiration"}, "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_vesting_delegation_expirations", "params": {"start":["alice", "1970-01-01T00:00:00",0], "limit":10, "order":"by_account_expiration"}, "id":1}' https://api.hive.blog

database_api.list_vesting_delegations

Returns a list of vesting delegations. Parameters: start:array, limit:int, order:string

start (array) limit (int) order (string)  
["", ""] 10 by_delegation Queries delegations, limit to 10 results, order by delegations.

Also see: Paginated API Methods

Query Parameters JSON
{"start": null, "limit": 0, "order": "by_name"}
Expected Response JSON
{
  "delegations": [
    {
      "id": 554317,
      "delegator": "a-0-0-0",
      "delegatee": "a-0-0",
      "vesting_shares": {
        "amount": "6141067173",
        "precision": 6,
        "nai": "@@000000037"
      },
      "min_delegation_time": "2018-01-24T22:23:54"
    }
  ]
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_vesting_delegations", "params": {"start":["",""], "limit":10, "order":"by_delegation"}, "id":1}' https://api.hive.blog

database_api.list_votes

Returns all votes, starting with the specified voter and/or author and permlink. Parameters: start:array; limit:int; order:string

start (array) limit (int) order (string)  
["", "", ""] 10 "by_comment_voter" Queries first 10 votes, sort by comment voter
["", "", ""] 10 "by_voter_comment" Queries first 10 votes, sort by voter comment
["xeroc", "vanteem-config", ""] 10 "by_comment_voter" Queries next 10 votes starting on the post @xeroc/vanteem-config, sort by comment voter
["alice", "xeroc", "vanteem-config"] 10 "by_voter_comment" Queries next 10 votes starting at alice on the post @xeroc/vanteem-config, sort by voter comment

Also see: Paginated API Methods

Query Parameters JSON
{
  "start": null,
  "limit": 0,
  "order": "by_comment_voter"
}
Expected Response JSON
{
  "votes": [
    {
      "id": 9,
      "voter": "dantheman",
      "author": "hiveio",
      "permlink": "firstpost",
      "weight": "32866333630",
      "rshares": 375241,
      "vote_percent": 100,
      "last_update": "2016-04-07T19:15:36",
      "num_changes": -1
    }
  ]
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_votes", "params": {"start":["", "", ""], "limit":10, "order":"by_comment_voter"}, "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_votes", "params": {"start":["", "", ""], "limit":10, "order":"by_voter_comment"}, "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_votes", "params": {"start":["", "", "hiveio"], "limit":10, "order":"by_comment_voter"}, "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_votes", "params": {"start":["alice", "xeroc", "vanteem-config"], "limit":10, "order":"by_voter_comment"}, "id":1}' https://api.hive.blog

database_api.list_withdraw_vesting_routes

Returns a list of vesting withdraw routes. Parameters: start:array; limit:int; order:string

start (array) limit (int) order (string)  
["temp", ""] 10 "by_withdraw_route" Queries first 10 routes, sort by withdraw route
["", 0] 10 "by_destination" Queries first 10 routes, sort by destination

Also see: Paginated API Methods

Query Parameters JSON
{"start": null, "limit": 0, "order": "by_name"}
Expected Response JSON
{
  "routes": [
    {
      "id": 39503,
      "from_account": "temperature",
      "to_account": "luckdiver",
      "percent": 10000,
      "auto_vest": false
    }
  ]
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_withdraw_vesting_routes", "params": {"start":["temp",""], "limit":10, "order":"by_withdraw_route"}, "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_withdraw_vesting_routes", "params": {"start":["",0], "limit":10, "order":"by_destination"}, "id":1}' https://api.hive.blog

database_api.list_witness_votes

Returns a list of witness votes. Parameters: start:array; limit:int; order:string

start (array) limit (int) order (string)  
["", ""] 10 "by_withdraw_route" Queries first 10 votes, sort by account witness
["", ""] 10 "by_destination" Queries first 10 votes, sort by witness account

Also see: Paginated API Methods

Query Parameters JSON
{"start": null, "limit": 0, "order": "by_name"}
Expected Response JSON
{
  "votes": [
    {
      "id": 428961,
      "witness": "aggroed",
      "account": "a-0magic"
    }
  ]
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_witness_votes", "params": {"start":["",""], "limit":10, "order":"by_account_witness"}, "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_witness_votes", "params": {"start":["",""], "limit":10, "order":"by_witness_account"}, "id":1}' https://api.hive.blog

database_api.list_witnesses

Returns the list of witnesses. Parameters: start:object; limit:int; order:string

start (object) limit (int) order (string)  
"" 10 "by_name" Queries first 10 witnesses, sort by account name
[0, ""] 10 "by_vote_name" Queries first 10 witnesses, sort by votes
["473718186844702107410533306", "alice"] 10 "by_schedule_time" Queries first 10 witnesses, sort by schedule

Also see: Paginated API Methods

Query Parameters JSON
{"start": null, "limit": 0, "order": "by_name"}
Expected Response JSON
{
  "witnesses": [
    {
      "id": 6950,
      "owner": "a-0",
      "created": "1970-01-01T00:00:00",
      "url": "",
      "votes": 0,
      "virtual_last_update": "0",
      "virtual_position": "0",
      "virtual_scheduled_time": "340282366920938463463374607431768211455",
      "total_missed": 0,
      "last_aslot": 1063323,
      "last_confirmed_block_num": 1040423,
      "pow_worker": 0,
      "signing_key": "STM5RrTRNDhhrMaA24SzSeE5AvmUcutb1q1VZp1imnT8p871s3UjN",
      "props": {
        "account_creation_fee": {
          "amount": "1",
          "precision": 3,
          "nai": "@@000000021"
        },
        "maximum_block_size": 131072,
        "hbd_interest_rate": 1000,
        "account_subsidy_budget": 797,
        "account_subsidy_decay": 347321
      },
      "hbd_exchange_rate": {
        "base": {
          "amount": "0",
          "precision": 3,
          "nai": "@@000000021"
        },
        "quote": {
          "amount": "0",
          "precision": 3,
          "nai": "@@000000021"
        }
      },
      "last_hbd_exchange_update": "1970-01-01T00:00:00",
      "last_work": "000000127cb0e335667f30100bc1a061175c2d789f808e0e9ac82ee70fa8e604",
      "running_version": "0.0.0",
      "hardfork_version_vote": "0.0.0",
      "hardfork_time_vote": "2016-03-24T16:00:00",
      "available_witness_account_subsidies": 0
    }
  ]
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_witnesses", "params": {"start":"", "limit":10, "order":"by_name"}, "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_witnesses", "params": {"start":[0,""], "limit":10, "order":"by_vote_name"}, "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_witnesses", "params": {"start":["473718186844702107410533306","alice"], "limit":10, "order":"by_schedule_time"}, "id":1}' https://api.hive.blog

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":"temp","signers":["STM8GC13uCZbP44HzMLV6zPZGwVQ8Nt4Kji8PapsPiNq1BK153XTX"]}, "id":1}' https://api.hive.blog

database_api.verify_authority

Returns true if the transaction has all of the required signatures, otherwise throws an exception.

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,"hbd_interest_rate":1000}}}],"extensions":[],"signatures":[]}}, "id":1}' https://api.hive.blog

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}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.verify_signatures", "params":{"hash": "0000000000000000000000000000000000000000000000000000000000000000", "signatures": [], "required_owner": [], "required_active": [], "required_posting": [], "required_other": []}, "id":1}' https://api.hive.blog

database_api.find_proposals

Finds proposals by proposal.id (not proposal.proposal_id).

Query Parameters JSON
{"proposal_ids": [0]}
Expected Response JSON
{
  "proposals": [
    {
      "id": 0,
      "proposal_id": "139925218365120",
      "creator": "alice",
      "receiver": "bob",
      "start_date": "2019-07-01T00:00:00",
      "end_date": "2019-08-01T23:59:59",
      "daily_pay": {
        "amount": "4800000",
        "precision": 3,
        "nai": "@@000000013"
      },
      "subject": "My Proposal",
      "permlink": "creator-proposal-permlink",
      "total_votes": "77351826710",
      "status": "active"
    }
  ]
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.find_proposals", "params":{"proposal_ids": [0]}, "id":1}' https://api.hive.blog

database_api.list_proposal_votes

Returns all proposal votes, starting with the specified voter or proposal.id. Parameters: start:array; limit:int; order:string; order_direction:string; status:string

start (array) limit (int) order (string) order_direction (string) status (string)  
["alice"] 10 by_voter_proposal ascending active list 10 proposals with active status, ordered by voter, ascending
[10] 1000 by_proposal_voter ascending votable list 1000 votes on proposal 10, ordered by proposal.id, ascending

Also see: Paginated API Methods

Query Parameters JSON
{
  "start": null,
  "limit": 0,
  "order": "by_name",
  "order_direction": "ascending",
  "status": "all"
}
Expected Response JSON
{
  "proposal_votes": [
    {
      "id": 0,
      "voter": "charlie",
      "proposal": {
        "id": 0,
        "proposal_id": 0,
        "creator": "alice",
        "receiver": "bob",
        "start_date": "2019-07-01T00:00:00",
        "end_date": "2019-08-01T23:59:59",
        "daily_pay": {
          "amount": "4800000",
          "precision": 3,
          "nai": "@@000000013"
        },
        "subject": "My Proposal",
        "permlink": "creator-proposal-permlink",
        "total_votes": "77351826710",
        "status": "active"
      }
    }
  ]
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_proposal_votes", "params":{"start": [""], "limit": 10, "order": "by_voter_proposal", "order_direction": "ascending", "status": "active"}, "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_proposal_votes", "params":{"start": [0], "limit": 10, "order": "by_proposal_voter", "order_direction": "ascending", "status": "active"}, "id":1}' https://api.hive.blog

database_api.list_proposals

Returns all proposals, starting with the specified creator or start date. Parameters: start:array; limit:int; order:string; order_direction:string; status:string

start (array) limit (int) order (string) order_direction (string) status (string)  
[""] 10 by_creator ascending active list 10 proposals with active status, ordered by creator, ascending
["2019-08-07T16:54:03"] 1000 by_start_date ascending inactive list 1000 proposals with inactive status, ordered by start date, ascending, since 2019-08-07T16:54:03
["a"] 1 by_creator ascending expired list 1 proposal with expired status, ordered by creator, ascending, by accounts starting with “a”
["alice"] 10 by_creator ascending all list 10 proposals with any status, ordered by creator, ascending, by alice
[""] 1000 by_creator ascending votable list 1000 votable proposals, ordered by creator, ascending
[10] 1000 by_total_votes ascending votable list 1000 votable proposals, ordered by creator, ascending, having at least 10 votes

Also see: Paginated API Methods

Query Parameters JSON
{
  "start": null,
  "limit": 0,
  "order": "by_name",
  "order_direction": "ascending",
  "status": "all"
}
Expected Response JSON
{
  "proposals": [
    {
      "id": 0,
      "proposal_id": "1103806595072",
      "creator": "alice",
      "receiver": "bob",
      "start_date": "2019-07-01T00:00:00",
      "end_date": "2019-08-01T23:59:59",
      "daily_pay": {
        "amount": "4800000",
        "precision": 3,
        "nai": "@@000000013"
      },
      "subject": "My Proposal",
      "permlink": "creator-proposal-permlink",
      "total_votes": "77351826710",
      "status": "active"
    }
  ]
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_proposals", "params":{"start": [""], "limit": 10, "order": "by_creator", "order_direction": "ascending", "status": "active"}, "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_proposals", "params":{"start": ["2019-08-07T16:54:03"], "limit": 1000, "order": "by_start_date", "order_direction": "ascending", "status": "inactive"}, "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_proposals", "params":{"start": ["a"], "limit": 1, "order": "by_creator", "order_direction": "ascending", "status": "expired"}, "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_proposals", "params":{"start": ["alice"], "limit": 10, "order": "by_creator", "order_direction": "ascending", "status": "all"}, "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_proposals", "params":{"start": [""], "limit": 1000, "order": "by_creator", "order_direction": "ascending", "status": "votable"}, "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_proposals", "params":{"start": [10], "limit": 1000, "order": "by_total_votes", "order_direction": "ascending", "status": "votable"}, "id":1}' https://api.hive.blog

database_api.find_smt_contributions

Find SMT contributions. Contributions are needed to track individual contributions on an SMT during the ICO phase.

See: Token Units, Vesting Contributions

Query Parameters JSON
{"symbol_contributors": []}
Expected Response JSON
{
  "contributions": [
    {
      "id": 0,
      "symbol": {"nai": "@@422838704", "precision": 0},
      "contributor": "alice",
      "contribution_id": 0,
      "contribution": {
        "amount": "1000",
        "precision": 3,
        "nai": "@@000000021"
      }
    }
  ]
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.find_smt_contributions", "params":{"symbol_contributors": []}, "id":1}' https://api.hive.blog

database_api.find_smt_token_emissions

Find SMT emissions.

See: Content Rewards, Qualitative Discussion

Query Parameters JSON
{
  "asset_symbol": {"nai": "@@422838704", "precision": 0}
}
Expected Response JSON
{"token_emissions": []}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.find_smt_token_emissions", "params":{"asset_symbol":{"nai":"@@422838704","precision":0}}, "id":1}' https://api.hive.blog

database_api.find_smt_tokens

Find SMT.

See: Smart Media Tokens (SMTs)

Query Parameters JSON
{"symbols": [], "ignore_precision": false}
Expected Response JSON
{"tokens": []}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.find_smt_tokens", "params":{"symbols":[],"ignore_precision":false}, "id":1}' https://api.hive.blog

database_api.get_nai_pool

Return an array of Numeric Asset Identifier (NAI) available to be used for new SMT to be created.

See: Numerical Asset Identifiers

Query Parameters JSON
{}
Expected Response JSON
{
  "nai_pool": [
    {"nai": "@@456173464", "precision": 0},
    {"nai": "@@483570188", "precision": 0},
    {"nai": "@@262899546", "precision": 0},
    {"nai": "@@651791780", "precision": 0},
    {"nai": "@@695960327", "precision": 0},
    {"nai": "@@337834146", "precision": 0},
    {"nai": "@@465565260", "precision": 0},
    {"nai": "@@528352042", "precision": 0},
    {"nai": "@@326426201", "precision": 0},
    {"nai": "@@960128623", "precision": 0}
  ]
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.get_nai_pool", "params":{}, "id":1}' https://api.hive.blog

database_api.list_smt_contributions

List SMT contributions. Contributions are needed to track individual contributions on an SMT during the ICO phase. Parameters: start:array; limit:int; order:string

start (array) limit (int) order (string)  
[{"nai": "@@422838704", "precision": 0}, 0] 10 by_symbol_id list 10 contributions, ordered by symbol, id
[{"nai": "@@422838704", "precision": 0}, "alice", 0] 10 by_symbol_contributor list 10 contributions, ordered by symbol, contributor, id

See: Token Units, Vesting Contributions

Also see: Paginated API Methods

Query Parameters JSON
{
  "start": null,
  "limit": 0,
  "order": "by_symbol_id"
}
Expected Response JSON
{
  "contributions": [
    {
      "id": 0,
      "symbol": {"nai": "@@422838704", "precision": 0},
      "contributor": "alice",
      "contribution_id": 0,
      "contribution": {
        "amount": "1000",
        "precision": 3,
        "nai": "@@000000021"
      }
    }
  ]
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_smt_contributions", "params":{"start":[{"nai": "@@422838704", "precision": 0}, 0],"limit":10,"order":"by_symbol_id"}, "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_smt_contributions", "params":{"start":[{"nai": "@@422838704", "precision": 0}, "alice", 0],"limit":10,"order":"by_symbol_contributor"}, "id":1}' https://api.hive.blog

database_api.list_smt_token_emissions

List SMT emissions. Parameters: start:array; limit:int; order:string

start (array) limit (int) order (string)  
[{"nai": "@@422838704", "precision": 0}, "2019-08-07T16:54:03"] 10 by_symbol_time list 10 emissions, ordered by symbol, timestamp

See: Content Rewards, Qualitative Discussion

Also see: Paginated API Methods

Query Parameters JSON
{
  "start": null,
  "limit": 0,
  "order": "by_symbol_time"
}
Expected Response JSON
{
  "token_emissions": [
    {
      "id": 0,
      "symbol": {"nai": "@@918753685", "precision": 3},
      "schedule_time": "2019-12-12T01:00:00",
      "emissions_unit": {"token_unit": [["extratest4", 1]]},
      "interval_seconds": 21600,
      "interval_count": 1,
      "lep_time": "2019-12-12T01:01:00",
      "rep_time": "2019-12-12T01:02:00",
      "lep_abs_amount": 1000000,
      "rep_abs_amount": 1000000,
      "lep_rel_amount_numerator": 1,
      "rep_rel_amount_numerator": 1,
      "rel_amount_denom_bits": 1,
      "floor_emissions": false
    }
  ]
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_smt_token_emissions", "params":{"start":[{"nai": "@@422838704", "precision": 0}, "2019-08-07T16:54:03"],"limit":10,"order":"by_symbol_time"}, "id":1}' https://api.hive.blog

database_api.list_smt_tokens

List SMTs. Parameters: start:object; limit:int; order:string

start (object) limit (int) order (string)  
{"nai": "@@422838704", "precision": 0} 10 by_symbol list 10 tokens, ordered by symbol
"" 10 by_control_account list 10 tokens, ordered by control account
["", {"nai": "@@422838704", "precision": 0}] 10 by_control_account list 10 tokens, ordered by control account, symbol

See: Smart Media Tokens (SMTs)

Also see: Paginated API Methods

Query Parameters JSON
{"start": null, "limit": 0, "order": "by_symbol"}
Expected Response JSON
{
  "tokens": [
    {
      "token": {
        "id": 177,
        "liquid_symbol": {"nai": "@@423920664", "precision": 3},
        "control_account": "petanque",
        "phase": "setup",
        "current_supply": 0,
        "total_vesting_fund_smt": 0,
        "total_vesting_shares": 0,
        "total_vesting_fund_ballast": 0,
        "total_vesting_shares_ballast": 0,
        "pending_rewarded_vesting_shares": 0,
        "pending_rewarded_vesting_smt": 0,
        "reward_balance": {
          "amount": "0",
          "precision": 3,
          "nai": "@@423920664"
        },
        "recent_claims": "0",
        "last_reward_update": "1970-01-01T00:00:00",
        "last_virtual_emission_time": "1970-01-01T00:00:00",
        "allow_downvotes": true,
        "market_maker": {
          "hive_balance": {
            "amount": "0",
            "precision": 3,
            "nai": "@@000000021"
          },
          "token_balance": {
            "amount": "0",
            "precision": 3,
            "nai": "@@423920664"
          },
          "reserve_ratio": 0
        },
        "allow_voting": true,
        "cashout_window_seconds": 3600,
        "reverse_auction_window_seconds": 900,
        "vote_regeneration_period_seconds": 432000,
        "votes_per_regeneration_period": 50,
        "content_constant": "2000000000000",
        "percent_curation_rewards": 2500,
        "author_reward_curve": "linear",
        "curation_reward_curve": "square_root",
        "max_supply": 0
      }
    }
  ]
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_smt_tokens", "params":{"start":{"nai": "@@422838704", "precision": 0},"limit":10,"order":"by_symbol"}, "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_smt_tokens", "params":{"start":"","limit":10,"order":"by_control_account"}, "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_smt_tokens", "params":{"start":["", {"nai": "@@422838704", "precision": 0}],"limit":10,"order":"by_control_account"}, "id":1}' https://api.hive.blog

database_api.get_comment_pending_payouts

Get comment pending payout data.

Parameters:

comments (array:string)  
[["hbd.funder", "upvote-this-post-to-fund-hbdstabilizer-qr2j7n"]] Returns comment info for a single post.
[["hbd.funder", "upvote-this-post-to-fund-hbdstabilizer-qr2j7n"], ["arcange", "hivesql-proposal-unfunded-information-and-reaction"]] Returns comment info for multiple posts.
Query Parameters JSON
{
  "comments": [
    [
      "hbd.funder",
      "upvote-this-post-to-fund-hbdstabilizer-qr2j7n"
    ]
  ]
}
Expected Response JSON
{
  "cashout_infos": [
    {
      "author": "hbd.funder",
      "permlink": "upvote-this-post-to-fund-hbdstabilizer-qr2j7n",
      "cashout_info": {
        "total_vote_weight": 22841196,
        "total_payout_value": {
          "amount": "0",
          "precision": 3,
          "nai": "@@000000013"
        },
        "curator_payout_value": {
          "amount": "0",
          "precision": 3,
          "nai": "@@000000013"
        },
        "max_accepted_payout": {
          "amount": "1000000000",
          "precision": 3,
          "nai": "@@000000013"
        },
        "author_rewards": 0,
        "children_abs_rshares": "606511906476641",
        "net_rshares": "571577939879762",
        "abs_rshares": "594467432989642",
        "vote_rshares": "583007369825359",
        "net_votes": 378,
        "active": "2021-04-06T15:29:03",
        "last_payout": "1970-01-01T00:00:00",
        "cashout_time": "2021-04-12T02:07:00",
        "max_cashout_time": "1969-12-31T23:59:59",
        "percent_hbd": 10000,
        "reward_weight": 10000,
        "allow_replies": false,
        "allow_votes": true,
        "allow_curation_rewards": true
      }
    }
  ]
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.get_comment_pending_payouts", "params":{"comments":[["hbd.funder", "upvote-this-post-to-fund-hbdstabilizer-qr2j7n"]]}, "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.get_comment_pending_payouts", "params":{"comments":[["hbd.funder", "upvote-this-post-to-fund-hbdstabilizer-qr2j7n"], ["arcange", "hivesql-proposal-unfunded-information-and-reaction"]]}, "id":1}' https://api.hive.blog

database_api.is_known_transaction

Only return true if the transaction has not expired or been invalidated. If this method is called with a VERY old transaction we will return false, use account_history_api.get_transaction.

Also see: transaction_status_api.find_transaction, account_history_api.get_transaction

Query Parameters JSON
{
  "transaction_id": "0000000000000000000000000000000000000000"
}
Expected Response JSON
{"is_known": false}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.is_known_transaction", "params":{"transaction_id":"0000000000000000000000000000000000000000"}, "id":1}' https://api.hive.blog

database_api.find_collateralized_conversion_requests

Returns objects corresponding with collateralized_convert operations.

 

 

 

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

database_api.list_collateralized_conversion_requests

Returns objects corresponding with collateralized_convert operations.

 

 

 

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

Debug Node Api

Methods:

This plugin allows all sorts of creative “what-if” experiments with the chain.

See: debug_node_plugin.md

debug_node_api.debug_generate_blocks

Generate blocks locally.

Query Parameters JSON
{
  "debug_key": "",
  "count": 0,
  "skip": 0,
  "miss_blocks": 0,
  "edit_if_needed": true
}
Expected Response JSON