Hive Developer Portal - API Definitions
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": [
"STM6vJmrwaX5TjgTS9dPH8KsArso5m91fVodJvv91j7G765wqcNM9"
]
}
Expected Response JSON
{"accounts": ["hiveio"]}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"account_by_key_api.get_key_references", "params":{"keys":["STM6vJmrwaX5TjgTS9dPH8KsArso5m91fVodJvv91j7G765wqcNM9"]}, "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.
- SDK Reference
- Related
account_history_api.get_account_history
Returns a history of all operations for a given account. Parameters:
account:string
start:int
. e.g.: -1 for reverse history or any positive numericlimit:int
up to 1000include_reversible:boolean
(optional) If set to true also operations from reversible block will be includedoperation_filter_low:int
(optional)operation_filter_high:int
(optional)
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
- SDK Reference
- Related
account_history_api.get_ops_in_block
Returns all operations contained in a block. Parameter:
block_num:int
only_virtual:boolean
include_reversible:boolean
(optional) If set to true also operations from reversible block will be included if block_num points to such block.
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 (including their signatures, operations like also a block_num it was included to).
id:string
trx_id of expected transactioninclude_reversible:boolean
(optional) If set to true also operations from reversible block will be included if block_num points to such block.
Query Parameters JSON
{"id": "6fde0190a97835ea6d9e651293e90c89911f933c"}
Expected Response JSON
{
"jsonrpc": "2.0",
"result": {
"ref_block_num": 36374,
"ref_block_prefix": 3218139339,
"expiration": "2018-04-09T00:29:06",
"operations": [
{
"type": "claim_reward_balance_operation",
"value": {
"account": "social",
"reward_hive": {
"amount": "0",
"precision": 3,
"nai": "@@000000021"
},
"reward_hbd": {
"amount": "0",
"precision": 3,
"nai": "@@000000013"
},
"reward_vests": {
"amount": "1",
"precision": 6,
"nai": "@@000000037"
}
}
}
],
"extensions": [],
"signatures": [
"1b01bdbb0c0d43db821c09ae8a82881c1ce3ba0eca35f23bc06541eca05560742f210a21243e20d04d5c88cb977abf2d75cc088db0fff2ca9fdf2cba753cf69844"
],
"transaction_id": "6fde0190a97835ea6d9e651293e90c89911f933c",
"block_num": 21401130,
"transaction_num": 25
},
"id": 1
}
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
- Since: HF24
- SDK Reference
- Related
account_history_api.enum_virtual_ops
Allows to specify range of blocks to retrieve virtual operations for.
block_range_begin:int
starting block number (inclusive) to search for virtual operationsblock_range_end:int
last block number (exclusive) to search for virtual operationsinclude_reversible:boolean
(optional) If set to true also operations from reversible block will be included if block_num points to such block.group_by_block
(optional) true/falseoperation_begin
(optional) starting virtual operation in given block (inclusive)limit
(optional) a limit of retrieved operationsfilter
(optional) a filter that decides which an operation matches - used bitwise filtering equals to position such as:fill_convert_request_operation = 0x000001
author_reward_operation = 0x000002
curation_reward_operation = 0x000004
comment_reward_operation = 0x000008
liquidity_reward_operation = 0x000010
interest_operation = 0x000020
fill_vesting_withdraw_operation = 0x000040
fill_order_operation = 0x000080
shutdown_witness_operation = 0x000100
fill_transfer_from_savings_operation = 0x000200
hardfork_operation = 0x000400
comment_payout_update_operation = 0x000800
return_vesting_delegation_operation = 0x001000
comment_benefactor_reward_operation = 0x002000
producer_reward_operation = 0x004000
clear_null_account_balance_operation = 0x008000
proposal_pay_operation = 0x010000
sps_fund_operation = 0x020000
hardfork_hive_operation = 0x040000
hardfork_hive_restore_operation = 0x080000
delayed_voting_operation = 0x100000
consolidate_treasury_balance_operation = 0x200000
effective_comment_vote_operation = 0x400000
ineffective_delete_comment_operation = 0x800000
sps_convert_operation = 0x1000000
dhf_funding_operation = 0x0020000
dhf_conversion_operation = 0x1000000
expired_account_notification_operation = 0x2000000
changed_recovery_account_operation = 0x4000000
transfer_to_vesting_completed_operation = 0x8000000
pow_reward_operation = 0x10000000
vesting_shares_split_operation = 0x20000000
account_created_operation = 0x40000000
fill_collateralized_convert_request_operation = 0x80000000
system_warning_operation = 0x100000000
fill_recurrent_transfer_operation = 0x200000000
failed_recurrent_transfer_operation = 0x400000000
limit_order_cancelled_operation = 0x800000000
producer_missed_operation = 0x1000000000
proposal_fee_operation = 0x2000000000
collateralized_convert_immediate_conversion_operation = 0x4000000000
escrow_approved_operation = 0x8000000000
escrow_rejected_operation = 0x10000000000
proxy_cleared_operation = 0x20000000000
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.
- SDK Reference
- Related
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
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
- SDK Reference
- Related
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
- Height of the block whose header should be returned
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
- SDK Reference
- Related
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
- Height of the first block to be returnedcount
- the maximum number of blocks to return
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. |
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
Bridge
Methods:
Presents data interpreted by the hivemind database as JSON-RPC.
Also see: Communities Broadcast Ops
- SDK Reference
- Related
bridge.get_ranked_posts
Get ranked posts.
Supported values for sort
:
trending
hot
created
promoted
payout
payout_comments
muted
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
- SDK Reference
- Related
bridge.account_notifications
Account notifications.
Supported values for type
:
new_community
- a new community was createdset_role
- mod/admin adds a role to an accountset_props
- properties set for a communityset_label
- a title/badge/label has been set for an accountmute_post
- a post has been muted, with a reasonunmute_post
- a post has been unmuted, with a reasonpin_post
- a post has been pinnedunpin_post
- a post has been unpinnedflag_post
- a post has been flagged by a member, with a reasonerror
- provides feedback to developers for ops that cannot be interpretedsubscribe
- an account has subscribed to a communityreply
- a post has been replied toreblog
- a post has been reblogged/rebloggedfollow
- an account has followed another accountmention
- author mentions an accountvote
- voter votes for an author
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
- SDK Reference
- Related
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
- SDK Reference
- Related
bridge.get_account_posts
Lists posts related to a given account.
sort
- Supported values:blog
- top posts authored by given account (excluding posts to communities - unless explicitely reblogged) plus reblogs ranked by creation/reblog timefeed
- top posts from blogs of accounts that given account is following ranked by creation/reblog time, not older than last monthposts
- op posts authored by given account, newer first comments - replies authored by given account, newer firstreplies
- replies to posts of given account, newer firstpayout
- all posts authored by given account that were not yet cashed out
account
: account name, points to valid accountstart_author
: author account name, if passed must be passed withstart_permlink
[optional]start_permlink
: post permlink of given author, point to valid post, paging mechanism [optional]limit
: if omitted the server will use the default value of 20 [optional]observer
: ignored forblog
, feed andreplies
, otherwise when passed has to point to valid account used to fill blacklist stats and mark posts of authors blacklisted by observer, at this time ignored [optional]
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
- SDK Reference
- Related
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
- SDK Reference
- Related
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
- SDK Reference
- Related
bridge.get_follow_list
Returns blacklisted/muted accounts or list of blacklists/mute lists followed by a given observer.
observer
- valid accountfollow_type
- Supported values:follow_blacklist
follow_muted
blacklisted
muted
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
- SDK Reference
- Related
bridge.get_profile
Gets profile
account
- valid accountobserver
- valid account [optional]
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
- SDK Reference
- Related
bridge.list_communities
Gets community
last
- name of community; paging mechanism [optional]limit
- limit number of listed communities, default:100
[optional]query
- filters againsttitle
andabout
community fields [optional]sort
- default:rank
[optional]rank
- sort by community ranknew
- sort by newest communitysubs
- sort by subscriptions
observer
- a valid account [optional]
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
- SDK Reference
- Related
bridge.list_pop_communities
Gets a list of popular communities.
limit
- limit number of listed communities, default:25
[optional]
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
- SDK Reference
- Related
bridge.list_subscribers
Gets a list of subscribers for a given community.
community
- community category namelast
- name of subscriber; paging mechanism [optional]limit
- limit number of listed subscribers, default:100
[optional]
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
- SDK Reference
- Related
bridge.list_community_roles
List community roles and labels for each account in the community.
community
- community category namelast
- name of subscriber; paging mechanism [optional]limit
- limit number of listed subscribers, default:100
[optional]
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
- SDK Reference
- Related
bridge.list_all_subscriptions
List all subscriptions, titles, and roles to a community for an account.
account
: account name, points to valid 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
- SDK Reference
- Related
bridge.get_community
Get community details.
name
- community category nameobserver
- valid account [optional]
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
- SDK Reference
- Related
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
- SDK Reference
- Related
bridge.get_payout_stats
Lists communities ordered by payout with stats (total payout, number of posts and authors).
limit
- if omitted the server will use the default value of 250 [optional]
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
- SDK Reference
- Related
bridge.get_post
Gives single selected post.
author
- valid accountpermlink
- valid permlinkobserver
- valid account [optional]
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
- SDK Reference
- Related
bridge.get_post_header
Gives very basic information on given post.
author
- valid accountpermlink
- valid permlink
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
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_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":{"amount":"100000","precision":3,"nai":"@@000000021"},"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":{"amount":"10000","precision":3,"nai":"@@000000021"},"maximum_block_size":131072,"hbd_interest_rate":1000}}]],"extensions":[],"signatures":[]}], "id":1}' https://api.hive.blog
- SDK Reference
- Related
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:
account:string
start:int
. e.g.: -1 for reverse history or any positive numericlimit:int
up to 1000operation_filter_low:int
(optional)operation_filter_high:int
(optional)
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
- Since: HF13
- SDK Reference
- Related
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_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
- SDK Reference
- Related
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
- SDK Reference
- Related
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
- SDK Reference
- Related
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
- SDK Reference
- Related
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
- SDK Reference
- Related
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
- SDK Reference
- Related
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
- SDK Reference
- Related
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
- SDK Reference
- Related
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
- SDK Reference
- Related
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
- SDK Reference
- Related
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_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_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
- Since: HF14
- SDK Reference
- Related
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
- SDK Reference
- Related
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
- SDK Reference
- Related
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
- Since: HF16
- SDK Reference
- Related
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
[
[
"STM6vJmrwaX5TjgTS9dPH8KsArso5m91fVodJvv91j7G765wqcNM9"
]
]
Expected Response JSON
[["hiveio"]]
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_key_references", "params":[["STM6vJmrwaX5TjgTS9dPH8KsArso5m91fVodJvv91j7G765wqcNM9"]], "id":1}' https://api.hive.blog
- SDK Reference
- Related
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
- SDK Reference
- Related
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
- SDK Reference
- Related
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
- SDK Reference
- Related
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
- SDK Reference
- Related
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
- SDK Reference
- Related
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
- SDK Reference
- Related
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_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
- SDK Reference
- Related
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
- Since: HF11
- SDK Reference
- Related
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_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
- Since: HF17
- SDK Reference
- Related
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
- Since: HF14
- SDK Reference
- Related
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
- Since: HF14
- SDK Reference
- Related
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
- SDK Reference
- Related
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
- SDK Reference
- Related
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
- SDK Reference
- Related
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
condenser_api.get_trending_tags
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
Query Parameters JSON
["", 1]
Expected Response JSON
[
{
"name": "",
"total_payouts": "0.000 HBD",
"net_votes": 0,
"top_posts": 0,
"comments": 0,
"trending": ""
}
]
Example curl
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
- SDK Reference
- Related
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
- SDK Reference
- Related
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
- SDK Reference
- Related
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
- SDK Reference
- Related
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
- SDK Reference
- Related
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
- SDK Reference
- Related
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
- SDK Reference
- Related
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_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
- SDK Reference
- Related
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
- SDK Reference
- Related
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
depends onorder
(see below)voter
- voter of the proposal (account name string)proposal.id
- id the proposal (int)
limit
is up to 1000.order
can be one of:by_voter_proposal
- order by proposal voterby_proposal_voter
- order byproposal.id
order_direction
can be one of:ascending
descending
status
all
inactive
active
expired
votable
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: database_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
- SDK Reference
- Related
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
depends onorder
(see below)creator
- creator of the proposal (account name string)start_date
- start date of the proposal (date string)end_date
- end date of the proposal (date string)total_votes
- total votes of the proposal (int)
limit
is up to 1000.order
can be one of:by_creator
- order by proposal creatorby_start_date
- order by proposal start dateby_end_date
- order by proposal end dateby_total_votes
- order by proposal total votes
order_direction
can be one of:ascending
descending
status
all
inactive
active
expired
votable
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
- Since: HF25
- Related
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
- Since: HF25
- SDK Reference
- Related
condenser_api.get_collateralized_conversion_requests
Returns objects corresponding with collateralized_convert
operations.
Query Parameters JSON
[]
Expected Response JSON
[]
- Since: HF25
- SDK Reference
- Related
condenser_api.find_recurrent_transfers
Finds transfers of any liquid asset every fixed amount of time from one account to another.
Also see: recurrent_transfer_operation
Query Parameters JSON
[""]
Expected Response JSON
[
{
"id": 3,
"trigger_date": "2021-07-02T18:11:51",
"from": "alice",
"to": "bob",
"amount": {
"amount": "1000",
"precision": 3,
"nai": "@@000000021"
},
"memo": "Payroll",
"recurrence": 26,
"consecutive_failures": 0,
"remaining_executions": 3
}
]
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.find_recurrent_transfers", "params":["alice"], "id":1}' https://api.hive.blog
- Since: HF26
- SDK Reference
- Related
condenser_api.find_rc_accounts
Returns the available resource credits of accounts.
Query Parameters JSON
[]
Expected Response JSON
[
{
"account": "alice",
"delegated_rc": 0,
"max_rc": 135630143570,
"max_rc_creation_adjustment": "2020.748973 VESTS",
"rc_manabar": {
"current_mana": 135375191366,
"last_update_time": 1550731380
},
"received_delegated_rc": 0
},
{
"account": "demo",
"delegated_rc": 0,
"max_rc": 50966868081,
"max_rc_creation_adjustment": "2020.748973 VESTS",
"rc_manabar": {
"current_mana": 50966868081,
"last_update_time": 1715912571
},
"received_delegated_rc": 6000000000
}
]
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.find_rc_accounts", "params":[["alice","demo"]], "id":1}' https://api.hive.blog
- Since: HF26
- SDK Reference
- Related
condenser_api.list_rc_accounts
Find accounts and their RC delegations
Query Parameters JSON
[]
Expected Response JSON
[
{
"account": "ecency",
"delegated_rc": 2065000000000,
"max_rc": 7671956433568695,
"max_rc_creation_adjustment": "5851.327807 VESTS",
"rc_manabar": {
"current_mana": 3221987144996,
"last_update_time": 1716194709
},
"received_delegated_rc": 4484642315668049
},
{
"account": "ecency-987",
"delegated_rc": 0,
"max_rc": 5568323871,
"max_rc_creation_adjustment": "5568.323871 VESTS",
"rc_manabar": {
"current_mana": 5568323871,
"last_update_time": 1637136366
},
"received_delegated_rc": 0
}
]
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.list_rc_accounts", "params":["ecency",10], "id":1}' https://api.hive.blog
- Since: HF26
- SDK Reference
- Related
condenser_api.list_rc_direct_delegations
Get list of “from” “to” which account how much RC was delegated.
Query Parameters JSON
[]
Expected Response JSON
[
{
"delegated_rc": 15000000000,
"from": "ecency",
"to": "raitakun501"
},
{
"delegated_rc": 15000000000,
"from": "ecency",
"to": "vivianemitola"
}
]
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.list_rc_direct_delegations", "params":[["ecency",""],2], "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.
- Since: HF11
- SDK Reference
- Related
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
- Since: HF11
- SDK Reference
- Related
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
- SDK Reference
- Related
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
- Since: HF14
- SDK Reference
- Related
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
- Since: HF14
- SDK Reference
- Related
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
- SDK Reference
- Related
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
- SDK Reference
- Related
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
- Since: HF14
- SDK Reference
- Related
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
{"start": null, "limit": 0, "order": "by_name"}
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
- SDK Reference
- Related
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
- SDK Reference
- Related
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
- SDK Reference
- Related
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
- SDK Reference
- Related
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
- SDK Reference
- Related
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
- SDK Reference
- Related
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",
"2021-06-30T14:00:00",
"2022-10-11T12:00:00"
],
"last_hardfork": 26,
"current_hardfork_version": "1.26.0",
"next_hardfork": "1.26.0",
"next_hardfork_time": "2022-10-11T12:00:00"
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.get_hardfork_properties", "id":1}' https://api.hive.blog
- SDK Reference
- Related
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
- Since: HF17
- SDK Reference
- Related
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
- Since: HF20
- SDK Reference
- Related
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
- Since: HF11
- SDK Reference
- Related
database_api.list_account_recovery_requests
Returns a list of account recovery requests. Parameters: start:string
, limit:int
, order:string
limit
is up to 1000.order
can be one of:by_account
- order by accont nameby_expiration
- order by expiration
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
- SDK Reference
- Related
database_api.list_accounts
List accounts ordered by specified key. Parameters: start:object
, limit:int
, order:string
, delayed_votes_active:boolean
limit
is up to 1000.order
can be one of:by_name
- order by accont nameby_proxy
- order by proxyby_next_vesting_withdrawal
- order by next next vesting withdrawal
delayed_votes_active
default true (optional)
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": "hiveio",
"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
depends onorder
(see below)limit
is up to 1000.order
can be one of:by_account
- order by accountstart
is string of:account
by_effective_date
- order by effective datestart
is an array of two values:timestamp
,account
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
- SDK Reference
- Related
database_api.list_comments
Returns all comments, starting with the specified options. Parameters: start:array
; limit:int
; order:string
start
depends onorder
(see below)limit
is up to 1000.order
can be one of:by_cashout_time
- order by cashout timestart
is an array of three required values (two optionally blank):timestamp
,author
,permlink
by_permlink
- order by permlinkstart
is an array of two required values (both optionally blank):author
,permlink
by_root
- order by rootstart
is an array of four required values (two optional blank):root_author
,root_permlink
,child_author
,child_permlink
by_parent
- order by parentstart
is an array of four required values (two optional blank):parent_author
,parent_permlink
,child_author
,child_permlink
by_last_update
- order by last updatestart
is an array of four required values (two optionally blank):parent_author
,update_time
,start_author
,permlink
by_author_last_update
- order by author’s last updatestart
is an array of four required values (two optionally blank):parent_author
,update_time
,start_author
,permlink
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
depends onorder
(see below)limit
is up to 1000.order
can be one of:by_account
- order by accountstart
is a string:account
by_effective_date
- order by effective datestart
is an array of two values:timestamp
,account
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
- Since: HF14
- SDK Reference
- Related
database_api.list_escrows
Returns a list of escrows. Parameters: start:array
; limit:int
; order:string
start
depends onorder
(see below)limit
is up to 1000.order
can be one of:by_from_id
- order by idstart
is an array of two values:account
,escrow_id
by_ratification_deadline
- order by ratification deadlinestart
is an array of three values:is_approved
,timestamp
,escrow_id
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
- SDK Reference
- Related
database_api.list_limit_orders
Returns a list of limit orders. Parameters: start:array
; limit:int
; order:string
start
depends onorder
(see below)limit
is up to 1000.order
can be one of:by_price
- order by pricestart
is an array of two values:price
,order_type
by_account
- order by accountstart
is an array of two values:account
,order_id
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_account" |
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
- SDK Reference
- Related
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
limit
is up to 1000.order
can be one of:by_from_id
- order by idstart
is an array of two values:account
,request_id
by_complete_from_id
- order by id (complete)start
is an array of three values:timestamp
,account
,request_id
by_to_complete
- order by completestart
is an array of three values:account
,timestamp
,order_id
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
limit
is up to 1000.order
can be one of:by_account
- order by accont namestart
is an array of two values:account
,request_id
by_conversion_date
- order by conversion datestart
is an array of two values:timestamp
,request_id
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
limit
is up to 1000.order
can be one of:by_expiration
- order by expirationstart
is an array of two values:timestamp
,expiration_id
by_account_expiration
- order by account expirationstart
is an array of two values:account
,timestamp
,expiration_id
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
limit
is up to 1000.order
can be one of:by_delegation
- order by delegationsstart
is an array of two values:delegator
,delegatee
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
depends onorder
(see below)voter
is optionalauthor
andpermlink
are optional, but if one is blank, they must both be blank
limit
is up to 1000.order
can be one of:by_comment_voter
- order by comment voterstart
is an array of three optional values:author
,permlink
,voter
by_voter_comment
- order by voter commentstart
is an array of three optional values:voter
,author
,permlink
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
depends onorder
(see below)limit
is up to 1000.order
can be one of:by_withdraw_route
- order by withdraw routestart
is an array of two values:from_account
,to_account
by_destination
- order by destinationstart
is an array of two values:to_account
,route_id
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
depends onorder
(see below)limit
is up to 1000.order
can be one of:by_account_witness
- order by account witnessstart
is an array of two values:account
,witness
by_witness_account
- order by witness accountstart
is an array of two values:witness
,account
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
depends onorder
(see below)limit
is up to 1000.order
can be one of:by_name
- order by namestart
is string value:account
by_vote_name
- order by vote, namestart
is an array of two values:votes
,account
by_schedule_time
- order by schedule timestart
is an array of two values:virtual_scheduled_time
,account
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": []
},
"pack": "legacy"
}
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 method validates if transaction was signed by person listed in required_owner, required_active or required_posting parameter. Hash
is a mix of chain_id and transaction data.
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
depends onorder
(see below)voter
- voter of the proposal (account name string)proposal.id
- id the proposal (int)
limit
is up to 1000.order
can be one of:by_voter_proposal
- order by proposal voterby_proposal_voter
- order byproposal.id
order_direction
can be one of:ascending
descending
status
all
inactive
active
expired
votable
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
depends onorder
(see below)creator
- creator of the proposal (account name string)start_date
- start date of the proposal (date string)end_date
- end date of the proposal (date string)total_votes
- total votes of the proposal (int)
limit
is up to 1000.order
can be one of:by_creator
- order by proposal creatorby_start_date
- order by proposal start dateby_end_date
- order by proposal end dateby_total_votes
- order by proposal total votes
order_direction
can be one of:ascending
descending
status
all
inactive
active
expired
votable
last_id (optional) - Id of the last object in the previous page from which you should start listing the next page
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 |
Proposal Structure:
id
- Unique identifier that is mostly an implementation detail (best to ignore). To uniquely identify proposal, it's best to useproposal_id
.proposal_id
- Before using this value for any further broadcasts, ensure it is part of an irreversible block.creator
- Account that created this proposal.receiver
- Account that will receive funds, if this proposal is approved.start_date
- When payments should begin.end_date
- When payments should end.daily_pay
- Amount of HBD expected per day.subject
- Summary of this proposal.permlink
- Post by either creator or receiver.total_votes
- VESTS cast for this proposal. This will is calculate every maintenance period.status
- Current status of this proposal.
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.get_comment_pending_payouts
Get comment pending payout data.
Parameters:
comments
- author/permlink
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
{"id": "0000000000000000000000000000000000000000"}
Expected Response JSON
{"is_known": false}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.is_known_transaction", "params":{"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": []}
database_api.find_recurrent_transfers
Finds transfers of any liquid asset every fixed amount of time from one account to another.
Also see: recurrent_transfer_operation
Query Parameters JSON
{"from": ""}
Expected Response JSON
{
"recurrent_transfers": [
{
"id": 3,
"trigger_date": "2021-07-02T18:11:51",
"from": "alice",
"to": "bob",
"amount": {
"amount": "1000",
"precision": 3,
"nai": "@@000000021"
},
"memo": "Payroll",
"recurrence": 26,
"consecutive_failures": 0,
"remaining_executions": 3
}
]
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.find_recurrent_transfers", "params":{"from":"alice"}, "id":1}' https://api.hive.blog
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
{"blocks": 0}
debug_node_api.debug_generate_blocks_until
Generate blocks locally until a specified head block time. Can generate them sparsely.
Query Parameters JSON
{
"debug_key": "",
"head_block_time": "1970-01-01T00:00:00",
"generate_sparsely": true
}
Expected Response JSON
{"blocks": 0}
debug_node_api.debug_get_hardfork_property_object
Query Parameters JSON
{}
Expected Response JSON
{
"id": 0,
"processed_hardforks": [],
"last_hardfork": 0,
"current_hardfork_version": "0.0.0",
"next_hardfork": "0.0.0",
"next_hardfork_time": "1970-01-01T00:00:00"
}
debug_node_api.debug_get_json_schema
Query Parameters JSON
{}
Expected Response JSON
{"schema": ""}
debug_node_api.debug_get_witness_schedule
Query Parameters JSON
{}
Expected Response JSON
{
"id": 0,
"current_virtual_time": "0",
"next_shuffle_block_num": 21573344,
"current_shuffled_witnesses": [],
"num_scheduled_witnesses": 192,
"elected_weight": 49,
"timeshare_weight": 73,
"miner_weight": 1,
"witness_pay_normalization_factor": 0,
"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.0.0",
"max_voted_witnesses": 128,
"max_miner_witnesses": 131,
"max_runner_witnesses": 191,
"hardfork_required_witnesses": 4,
"account_subsidy_rd": {
"resource_unit": 0,
"budget_per_time_unit": 0,
"pool_eq": 0,
"max_pool_size": 0,
"decay_params": {
"decay_per_time_unit": 0,
"decay_per_time_unit_denom_shift": 0
},
"min_decay": 0
},
"account_subsidy_witness_rd": {
"resource_unit": 0,
"budget_per_time_unit": 0,
"pool_eq": 0,
"max_pool_size": 0,
"decay_params": {
"decay_per_time_unit": 0,
"decay_per_time_unit_denom_shift": 0
},
"min_decay": 0
},
"min_witness_account_subsidy_decay": 0
}
debug_node_api.debug_has_hardfork
Query Parameters JSON
{"hardfork_id": 0}
Expected Response JSON
{"has_hardfork": false}
debug_node_api.debug_pop_block
Pop a block from the blockchain, returning it.
Query Parameters JSON
{}
Expected Response JSON
{}
debug_node_api.debug_push_blocks
Push blocks from existing database.
Query Parameters JSON
{
"src_filename": "",
"count": 0,
"skip_validate_invariants": false
}
Expected Response JSON
{"blocks": 0}
debug_node_api.debug_set_hardfork
Query Parameters JSON
{"hardfork_id": 0}
Expected Response JSON
{}
Follow API
Methods:
Used to lookup information related to reputation and account follow operations. These AppBase API methods are still under development and subject to change.
follow_api.get_account_reputations
Returns a list of account reputations.
Also see: Paginated API Methods
Query Parameters JSON
{"account_lower_bound": "", "limit": 1000}
Expected Response JSON
{
"reputations": [{"account": "", "reputation": 0}]
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"follow_api.get_account_reputations", "params":{"account_lower_bound":"hiveio", "limit":1}, "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"follow_api.get_account_reputations", "params":{"account_lower_bound":"a", "limit":10}, "id":1}' https://api.hive.blog
follow_api.get_blog
Removed since HF24 Use: condenser_api.get_blog
Also see: Paginated API Methods
follow_api.get_blog_authors
Removed since HF24 Use: condenser_api.get_blog_authors
follow_api.get_blog_entries
Removed since HF24 Use: condenser_api.get_blog_entries
Also see: Paginated API Methods
follow_api.get_feed
Removed since HF24 Use: condenser_api.get_feed
Also see: Paginated API Methods
follow_api.get_feed_entries
Removed since HF24 Use: condenser_api.get_feed_entries
Also see: Paginated API Methods
</p>
follow_api.get_follow_count
Removed since HF24 Use: condenser_api.get_follow_count
follow_api.get_followers
Removed since HF24 Use: condenser_api.get_followers
Also see: Paginated API Methods
follow_api.get_following
Removed since HF24 Use: condenser_api.get_following
Also see: Paginated API Methods
follow_api.get_reblogged_by
Removed since HF24 Use: condenser_api.get_reblogged_by
JSON RPC
Methods:
Used to lookup information about the JSON RPC API. These AppBase API methods are still under development and subject to change.
jsonrpc.get_methods
Returns a list of methods supported by the JSON RPC API.
Query Parameters JSON
{}
Expected Response JSON
[
"account_by_key_api.get_key_references",
"account_history_api.enum_virtual_ops",
"account_history_api.get_account_history",
"account_history_api.get_ops_in_block",
"account_history_api.get_transaction",
"block_api.get_block",
"block_api.get_block_header",
"condenser_api.broadcast_block",
"condenser_api.broadcast_transaction",
"condenser_api.broadcast_transaction_synchronous",
"condenser_api.find_proposals",
"condenser_api.get_account_count",
"condenser_api.get_account_history",
"condenser_api.get_account_references",
"condenser_api.get_account_reputations",
"condenser_api.get_account_votes",
"condenser_api.get_accounts",
"condenser_api.get_active_votes",
"condenser_api.get_active_witnesses",
"condenser_api.get_block",
"condenser_api.get_block_header",
"condenser_api.get_blog",
"condenser_api.get_blog_authors",
"condenser_api.get_blog_entries",
"condenser_api.get_chain_properties",
"condenser_api.get_comment_discussions_by_payout",
"condenser_api.get_config",
"condenser_api.get_content",
"condenser_api.get_content_replies",
"condenser_api.get_conversion_requests",
"condenser_api.get_current_median_history_price",
"condenser_api.get_discussions_by_active",
"condenser_api.get_discussions_by_author_before_date",
"condenser_api.get_discussions_by_blog",
"condenser_api.get_discussions_by_cashout",
"condenser_api.get_discussions_by_children",
"condenser_api.get_discussions_by_comments",
"condenser_api.get_discussions_by_created",
"condenser_api.get_discussions_by_feed",
"condenser_api.get_discussions_by_hot",
"condenser_api.get_discussions_by_promoted",
"condenser_api.get_discussions_by_trending",
"condenser_api.get_discussions_by_votes",
"condenser_api.get_dynamic_global_properties",
"condenser_api.get_escrow",
"condenser_api.get_expiring_vesting_delegations",
"condenser_api.get_feed",
"condenser_api.get_feed_entries",
"condenser_api.get_feed_history",
"condenser_api.get_follow_count",
"condenser_api.get_followers",
"condenser_api.get_following",
"condenser_api.get_hardfork_version",
"condenser_api.get_key_references",
"condenser_api.get_market_history",
"condenser_api.get_market_history_buckets",
"condenser_api.get_nai_pool",
"condenser_api.get_next_scheduled_hardfork",
"condenser_api.get_open_orders",
"condenser_api.get_ops_in_block",
"condenser_api.get_order_book",
"condenser_api.get_owner_history",
"condenser_api.get_post_discussions_by_payout",
"condenser_api.get_potential_signatures",
"condenser_api.get_reblogged_by",
"condenser_api.get_recent_trades",
"condenser_api.get_recovery_request",
"condenser_api.get_replies_by_last_update",
"condenser_api.get_required_signatures",
"condenser_api.get_reward_fund",
"condenser_api.get_savings_withdraw_from",
"condenser_api.get_savings_withdraw_to",
"condenser_api.get_state",
"condenser_api.get_tags_used_by_author",
"condenser_api.get_ticker",
"condenser_api.get_trade_history",
"condenser_api.get_transaction",
"condenser_api.get_transaction_hex",
"condenser_api.get_trending_tags",
"condenser_api.get_version",
"condenser_api.get_vesting_delegations",
"condenser_api.get_volume",
"condenser_api.get_withdraw_routes",
"condenser_api.get_witness_by_account",
"condenser_api.get_witness_count",
"condenser_api.get_witness_schedule",
"condenser_api.get_witnesses",
"condenser_api.get_witnesses_by_vote",
"condenser_api.list_proposal_votes",
"condenser_api.list_proposals",
"condenser_api.lookup_account_names",
"condenser_api.lookup_accounts",
"condenser_api.lookup_witness_accounts",
"condenser_api.verify_account_authority",
"condenser_api.verify_authority",
"database_api.find_account_recovery_requests",
"database_api.find_accounts",
"database_api.find_change_recovery_account_requests",
"database_api.find_comments",
"database_api.find_decline_voting_rights_requests",
"database_api.find_escrows",
"database_api.find_limit_orders",
"database_api.find_owner_histories",
"database_api.find_proposals",
"database_api.find_savings_withdrawals",
"database_api.find_hbd_conversion_requests",
"database_api.find_smt_contributions",
"database_api.find_smt_token_emissions",
"database_api.find_smt_tokens",
"database_api.find_vesting_delegation_expirations",
"database_api.find_vesting_delegations",
"database_api.find_votes",
"database_api.find_withdraw_vesting_routes",
"database_api.find_witnesses",
"database_api.get_active_witnesses",
"database_api.get_config",
"database_api.get_current_price_feed",
"database_api.get_dynamic_global_properties",
"database_api.get_feed_history",
"database_api.get_hardfork_properties",
"database_api.get_nai_pool",
"database_api.get_order_book",
"database_api.get_potential_signatures",
"database_api.get_required_signatures",
"database_api.get_reward_funds",
"database_api.get_transaction_hex",
"database_api.get_version",
"database_api.get_witness_schedule",
"database_api.list_account_recovery_requests",
"database_api.list_accounts",
"database_api.list_change_recovery_account_requests",
"database_api.list_comments",
"database_api.list_decline_voting_rights_requests",
"database_api.list_escrows",
"database_api.list_limit_orders",
"database_api.list_owner_histories",
"database_api.list_proposal_votes",
"database_api.list_proposals",
"database_api.list_savings_withdrawals",
"database_api.list_hbd_conversion_requests",
"database_api.list_smt_contributions",
"database_api.list_smt_token_emissions",
"database_api.list_smt_tokens",
"database_api.list_vesting_delegation_expirations",
"database_api.list_vesting_delegations",
"database_api.list_votes",
"database_api.list_withdraw_vesting_routes",
"database_api.list_witness_votes",
"database_api.list_witnesses",
"database_api.verify_account_authority",
"database_api.verify_authority",
"database_api.verify_signatures",
"follow_api.get_account_reputations",
"follow_api.get_blog",
"follow_api.get_blog_authors",
"follow_api.get_blog_entries",
"follow_api.get_feed",
"follow_api.get_feed_entries",
"follow_api.get_follow_count",
"follow_api.get_followers",
"follow_api.get_following",
"follow_api.get_reblogged_by",
"jsonrpc.get_methods",
"jsonrpc.get_signature",
"market_history_api.get_market_history",
"market_history_api.get_market_history_buckets",
"market_history_api.get_order_book",
"market_history_api.get_recent_trades",
"market_history_api.get_ticker",
"market_history_api.get_trade_history",
"market_history_api.get_volume",
"network_broadcast_api.broadcast_block",
"network_broadcast_api.broadcast_transaction",
"rc_api.find_rc_accounts",
"rc_api.get_resource_params",
"rc_api.get_resource_pool",
"tags_api.get_active_votes",
"tags_api.get_comment_discussions_by_payout",
"tags_api.get_content_replies",
"tags_api.get_discussion",
"tags_api.get_discussions_by_active",
"tags_api.get_discussions_by_author_before_date",
"tags_api.get_discussions_by_blog",
"tags_api.get_discussions_by_cashout",
"tags_api.get_discussions_by_children",
"tags_api.get_discussions_by_comments",
"tags_api.get_discussions_by_created",
"tags_api.get_discussions_by_feed",
"tags_api.get_discussions_by_hot",
"tags_api.get_discussions_by_promoted",
"tags_api.get_discussions_by_trending",
"tags_api.get_discussions_by_votes",
"tags_api.get_post_discussions_by_payout",
"tags_api.get_replies_by_last_update",
"tags_api.get_tags_used_by_author",
"tags_api.get_trending_tags"
]
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"jsonrpc.get_methods", "id":1}' https://api.hive.blog
jsonrpc.get_signature
Returns the signature information for a JSON RPC method including the arguments and expected response JSON.
Query Parameters JSON
{"method": ""}
Expected Response JSON
{"args": {}, "ret": []}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"jsonrpc.get_signature", "params":{"method":"jsonrpc.get_methods"}, "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"jsonrpc.get_signature", "params":{"method":"jsonrpc.get_signature"}, "id":1}' https://api.hive.blog
curl -s --data '{"jsonrpc":"2.0", "method":"jsonrpc.get_signature", "params":{"method":"condenser_api.get_dynamic_global_properties"}, "id":1}' https://api.hive.blog
curl