Steem Developer Portal - API Definitions
While the condenser_api.* calls are ready for use, all other appbase methods are currently works in progress and may change, or be unsuitable for production use.
Condenser Api
To help with this transition, we created condenser_api, which contains all of the API methods that currently exist and uses the existing argument formatting. The easiest way to get your app to work with Appbase is to change the api to condenser_api.
All calls in condenser_api will return [] as the argument, as the array argument passing is opaque and implemented in the API calls themselves. They follow the current argument formatting. Existing apps should only need to skip using login_api and send all of their calls to condenser_api without any other changes required to use Appbase.
For example, calling get_dynamic_global_properties with condenser_api vs database_api:
{"jsonrpc":"2.0", "method":"condenser_api.get_dynamic_global_properties", "params":[], "id":1}
{"jsonrpc":"2.0", "method":"database_api.get_dynamic_global_properties", "id":1}
Because the method has no arguments, the params field can be omitted when not using condenser_api. However, it can optionally be included as the void type (e.g. "params":{}) but it is not required.
condenser_api.broadcast_block
Used to broadcast a block.
Query Parameters JSON:
[{"previous":"0000000000000000000000000000000000000000","timestamp":"1970-01-01T00:00:00","witness":"","transaction_merkle_root":"0000000000000000000000000000000000000000","extensions":[],"witness_signature":"0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000","transactions":[]}]
Expected Response JSON:
{}
Example curl:
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.broadcast_block", "params":[{"previous":"0000000000000000000000000000000000000000","timestamp":"1970-01-01T00:00:00","witness":"","transaction_merkle_root":"0000000000000000000000000000000000000000","extensions":[],"witness_signature":"0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000","transactions":[]}], "id":1}' https://api.steemit.com
condenser_api.broadcast_transaction
Used to broadcast a 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":[["pow",{"worker_account":"cloop3","block_id":"00000449f7860b82b4fbe2f317c670e9f01d6d9a","nonce":3899,"work":{"worker":"STM7P5TDnA87Pj9T4mf6YHrhzjC1KbPZpNxLWCcVcHxNYXakpoT4F","input":"ae8e7c677119d22385f8c48026fee7aad7bba693bf788d7f27047f40b47738c0","signature":"1f38fe9a3f9989f84bd94aa5bbc88beaf09b67f825aa4450cf5105d111149ba6db560b582c7dbb026c7fc9c2eb5051815a72b17f6896ed59d3851d9a0f9883ca7a","work":"000e7b209d58f2e64b36e9bf12b999c6c7af168cc3fc41eb7f8a4bf796c174c3"},"props":{"account_creation_fee":["100000",3,"@@000000021"],"maximum_block_size":131072,"sbd_interest_rate":1000}}]],"extensions":[],"signatures":[]}], "id":1}' https://api.steemit.com
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":[["pow",{"worker_account":"cloop3","block_id":"00000449f7860b82b4fbe2f317c670e9f01d6d9a","nonce":3899,"work":{"worker":"STM7P5TDnA87Pj9T4mf6YHrhzjC1KbPZpNxLWCcVcHxNYXakpoT4F","input":"ae8e7c677119d22385f8c48026fee7aad7bba693bf788d7f27047f40b47738c0","signature":"1f38fe9a3f9989f84bd94aa5bbc88beaf09b67f825aa4450cf5105d111149ba6db560b582c7dbb026c7fc9c2eb5051815a72b17f6896ed59d3851d9a0f9883ca7a","work":"000e7b209d58f2e64b36e9bf12b999c6c7af168cc3fc41eb7f8a4bf796c174c3"},"props":{"account_creation_fee":["100000",3,"@@000000021"],"maximum_block_size":131072,"sbd_interest_rate":1000}}]],"extensions":[],"signatures":[]}], "id":1}' https://api.steemit.com
condenser_api.get_account_bandwidth
Returns the available bandwidth of an account. Parameters: account:string; type:string, e.g.: forum or market
account (string) |
type (string) |
|
|---|---|---|
"steemit" |
"forum" |
Query the available forum bandwidth for the account named “steemit”. |
"alice" |
"market" |
Query the available market bandwidth for the account named “alice”. |
Query Parameters JSON:
["steemit","forum"]
Expected Response JSON:
{"id":8,"account":"steemit","type":"forum","average_bandwidth":214996934,"lifetime_bandwidth":"48395000000","last_bandwidth_update":"2018-02-16T03:11:00"}
Example curl:
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_account_bandwidth", "params":["steemit","forum"], "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_account_bandwidth", "params":["alice","market"], "id":1}' https://api.steemit.com
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.steemit.com
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 numeric; limit:int up to 10000
account (string) |
start (int) |
limit (int) |
|
|---|---|---|---|
"steemit" |
1000 |
1000 |
Queries the account named steemit starting on the latest item in history, up to 1,000 results. |
"alice" |
-1 |
10000 |
Queries the account named alice starting on the oldest item in history, up to 10,000 results. |
Query Parameters JSON:
["",0,1000]
Expected Response JSON:
[]
Example curl:
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_account_history", "params":["steemit", 1000, 1000], "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_account_history", "params":["steemit", -1, 10000], "id":1}' https://api.steemit.com
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) |
|
|---|---|---|
"steemit" |
1 |
Queries for accounts that start with “steemit”, only one result. |
"a" |
10 |
Queries for accounts that start with “a”, up to 10 results. |
Query Parameters JSON:
["",1000]
Expected Response JSON:
[]
Example curl:
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_account_reputations", "params":["steemit", 1], "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_account_reputations", "params":["a", 10], "id":1}' https://api.steemit.com
condenser_api.get_account_votes
Returns all votes by an account. Parameters: account:string
account (string) |
|
|---|---|
"steemit" |
Queries for votes by “steemit”. |
"alice" |
Queries for votes by “alice”. |
Query Parameters JSON:
[""]
Expected Response JSON:
[{"authorperm":"","weight":"","rshares":"","percent":null,"time":"2016-04-29T22:27:42"}]
Example curl:
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_account_votes", "params":["steemit"], "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_account_votes", "params":["alice"], "id":1}' https://api.steemit.com
condenser_api.get_accounts
Returns accounts, queried by name. Parameters: account:string array
account (string array) |
|
|---|---|
["steemit"] |
Queries for account named “steemit”. |
["steemit", "alice"] |
Queries for accounts named “steemit” and “alice”. |
Query Parameters JSON:
[[""]]
Expected Response JSON:
[{"id":0,"name":"","owner":{"weight_threshold":0,"account_auths":[],"key_auths":[["",0],["",0],["",0]]},"active":{"weight_threshold":0,"account_auths":[],"key_auths":[["",0],["",0]]},"posting":{"weight_threshold":0,"account_auths":[],"key_auths":[["",0],["",0],["",0]]},"memo_key":"","json_metadata":"","proxy":"","last_owner_update":"2017-03-16T21:17:51","last_account_update":"2017-03-16T23:10:36","created":"2016-03-24T17:00:21","mined":false,"recovery_account":"","last_account_recovery":"1970-01-01T00:00:00","reset_account":"null","comment_count":0,"lifetime_vote_count":0,"post_count":0,"can_vote":false,"voting_power":0,"last_vote_time":"2016-12-04T23:10:57","balance":"0.000 STEEM","savings_balance":"0.0 STEEM","sbd_balance":"0.0 SBD","sbd_seconds":"","sbd_seconds_last_update":"2018-04-10T04:08:36","sbd_last_interest_payment":"2018-03-15T17:58:24","savings_sbd_balance":"0.000 SBD","savings_sbd_seconds":"","savings_sbd_seconds_last_update":"1970-01-01T00:00:00","savings_sbd_last_interest_payment":"1970-01-01T00:00:00","savings_withdraw_requests":0,"reward_sbd_balance":"0.000 SBD","reward_steem_balance":"0.000 STEEM","reward_vesting_balance":"0.000000 VESTS","reward_vesting_steem":"0.000 STEEM","vesting_shares":"0.000 VESTS","delegated_vesting_shares":"0.000000 VESTS","received_vesting_shares":"0.000000 VESTS","vesting_withdraw_rate":"0.000000 VESTS","next_vesting_withdrawal":"1969-12-31T23:59:59","withdrawn":0,"to_withdraw":0,"withdraw_routes":0,"curation_rewards":0,"posting_rewards":0,"proxied_vsf_votes":[0,0,0,0],"witnesses_voted_for":0,"last_post":"2016-03-30T18:30:18","last_root_post":"2016-03-30T18:30:18","average_bandwidth":0,"lifetime_bandwidth":"","last_bandwidth_update":"2018-02-16T03:11:00","average_market_bandwidth":0,"lifetime_market_bandwidth":"","last_market_bandwidth_update":"2018-02-01T19:12:24","vesting_balance":"0.000 STEEM","reputation":"","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":[["steemit"]], "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_accounts", "params":[["steemit", "alice"]], "id":1}' https://api.steemit.com
condenser_api.get_active_votes
Returns all votes for the given post. Parameters: author:string; permlink:string
author (string) |
permlink (string) |
|
|---|---|---|
"steemit" |
"firstpost" |
Queries votes for content with a slug @steemit/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":["steemit", "firstpost"], "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_active_votes", "params":["alice", "a-post-by-alice"], "id":1}' https://api.steemit.com
condenser_api.get_active_witnesses
Returns the list of 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.steemit.com
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. |
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.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_block", "params":[8675309], "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_block", "params":[62396745], "id":1}' https://api.steemit.com
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. |
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.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_block_header", "params":[8675309], "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_block_header", "params":[62396745], "id":1}' https://api.steemit.com
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) |
|
|---|---|---|---|
| “steemit” | 0 |
1 |
Queries the blog for the account named “steemit”, up to one result. |
| “alice” | 0 |
50 |
Queries the blog for the account named “steemit”, up to 50 results. |
Query Parameters JSON:
["steemit",0,1]
Expected Response JSON:
[{"comment":{"id":0,"author":"steemit","permlink":"firstpost","category":"meta","parent_author":"","parent_permlink":"meta","title":"Welcome to Steem!","body":"Steemit is a social media platform where anyone can earn STEEM points by posting. The more people who like a post, the more STEEM the poster earns. Anyone can sell their STEEM 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":["942",3,"@@000000013"],"curator_payout_value":["756",3,"@@000000013"],"author_rewards":3548,"net_votes":90,"root_author":"steemit","root_permlink":"firstpost","max_accepted_payout":["1000000000",3,"@@000000013"],"percent_steem_dollars":10000,"allow_replies":true,"allow_votes":true,"allow_curation_rewards":true,"beneficiaries":[]},"blog":"steemit","reblog_on":"1970-01-01T00:00:00","entry_id":0}]
Example curl:
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_blog", "params":["steemit",0,1], "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_blog", "params":["alice",0,50], "id":1}' https://api.steemit.com
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) |
|
|---|---|
"steemit" |
Queries for account named “steemit”. |
"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":["steemit"], "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_blog_authors", "params":["alice"], "id":1}' https://api.steemit.com
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) |
|
|---|---|---|---|
| “steemit” | 0 |
1 |
Queries the blog entries for the account named “steemit”, up to one result. |
| “alice” | 0 |
50 |
Queries the blog entries for the account named “steemit”, up to 50 results. |
Query Parameters JSON:
["steemit",0,1]
Expected Response JSON:
[{"author":"steemit","permlink":"firstpost","blog":"steemit","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":["steemit",0,1], "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_blog_entries", "params":["alice",0,50], "id":1}' https://api.steemit.com
condenser_api.get_chain_properties
Returns the chain properties.
Query Parameters JSON:
[]
Expected Response JSON:
{"account_creation_fee":"0.100 STEEM","maximum_block_size":131072,"sbd_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.steemit.com
condenser_api.get_comment_discussions_by_payout
Returns a list of discussions based on 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":"steem","limit":1}], "id":1}' https://api.steemit.com
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.steemit.com
condenser_api.get_config
Returns information about compile-time constants.
Query Parameters JSON:
[]
Expected Response JSON:
{}
Example curl:
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_config", "params":[], "id":1}' https://api.steemit.com
condenser_api.get_content
Returns the content (post or comment). Parameters: author:string; permlink:string
author (string) |
permlink (string) |
|
|---|---|---|
"steemit" |
"firstpost" |
Queries content with a slug @steemit/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 STEEM","curator_payout_value":"0.000 STEEM","author_rewards":0,"net_votes":0,"root_author":"","root_permlink":"","max_accepted_payout":"0.000 STEEM","percent_steem_dollars":0,"allow_replies":false,"allow_votes":false,"allow_curation_rewards":false,"beneficiaries":[],"url":"","root_title":"","pending_payout_value":"0.000 STEEM","total_pending_payout_value":"0.000 STEEM","active_votes":[],"replies":[],"author_reputation":0,"promoted":"0.000 STEEM","body_length":0,"reblogged_by":[]}
Example curl:
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_content", "params":["steemit", "firstpost"], "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_content", "params":["alice", "a-post-by-alice"], "id":1}' https://api.steemit.com
condenser_api.get_content_replies
Returns a list of replies. Parameters: author:string; permlink:string
author (string) |
permlink (string) |
|
|---|---|---|
"steemit" |
"firstpost" |
Queries replies for a slug @steemit/firstpost |
"alice" |
"a-post-by-alice" |
Queries replies for 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 STEEM","curator_payout_value":"0.000 STEEM","author_rewards":0,"net_votes":0,"root_author":"","root_permlink":"","max_accepted_payout":"0.000 STEEM","percent_steem_dollars":0,"allow_replies":false,"allow_votes":false,"allow_curation_rewards":false,"beneficiaries":[],"url":"","root_title":"","pending_payout_value":"0.000 STEEM","total_pending_payout_value":"0.000 STEEM","active_votes":[],"replies":[],"author_reputation":0,"promoted":"0.000 STEEM","body_length":0,"reblogged_by":[]}
Example curl:
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_content_replies", "params":["steemit", "firstpost"], "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_content_replies", "params":["alice", "a-post-by-alice"], "id":1}' https://api.steemit.com
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. |
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.steemit.com
condenser_api.get_current_median_history_price
Query Parameters JSON:
[]
Expected Response JSON:
{"base":"0.000 STEEM","quote":"0.000 STEEM"}
Example curl:
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_current_median_history_price", "params":[], "id":1}' https://api.steemit.com
condenser_api.get_discussions_by_active
Returns a list of discussions based on active.
Query Parameters JSON:
[{"tag":"","limit":0,"filter_tags":[],"select_authors":[],"select_tags":[],"truncate_body":0}]
Expected Response JSON:
[]
Example curl:
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_discussions_by_active", "params":[{"tag":"steem","limit":1}], "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_discussions_by_active", "params":[{"tag":"photography","limit":10,"truncate_body":0}], "id":1}' https://api.steemit.com
condenser_api.get_discussions_by_author_before_date
Returns a list of discussions based on author before date.
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":["steemit","firstpost","2016-04-19T22:49:43",1], "id":1}' https://api.steemit.com
condenser_api.get_discussions_by_blog
Returns a list of discussions by blog.
Query Parameters JSON:
[{"tag":"","limit":0,"filter_tags":[],"select_authors":[],"select_tags":[],"truncate_body":0}]
Expected Response JSON:
[]
Example curl:
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_discussions_by_blog", "params":[{"tag":"steemit","limit":1}], "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_discussions_by_blog", "params":[{"tag":"alice","limit":10}], "id":1}' https://api.steemit.com
condenser_api.get_discussions_by_cashout
Returns a list of discussions by cashout.
Query Parameters JSON:
[{"tag":"","limit":0,"filter_tags":[],"select_authors":[],"select_tags":[],"truncate_body":0}]
Expected Response JSON:
[]
Example curl:
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_discussions_by_cashout", "params":[{"tag":"steem","limit":1}], "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_discussions_by_cashout", "params":[{"tag":"photography","limit":10,"truncate_body":0}], "id":1}' https://api.steemit.com
condenser_api.get_discussions_by_children
Returns a list of discussions by children.
Query Parameters JSON:
[{"tag":"","limit":0,"filter_tags":[],"select_authors":[],"select_tags":[],"truncate_body":0}]
Expected Response JSON:
[]
Example curl:
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_discussions_by_children", "params":[{"tag":"steem","limit":1}], "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_discussions_by_children", "params":[{"tag":"photography","limit":10,"truncate_body":0}], "id":1}' https://api.steemit.com
condenser_api.get_discussions_by_comments
Returns a list of discussions by comments.
Query Parameters JSON:
[{"start_author":"","start_permlink":"","limit":100}]
Expected Response JSON:
[]
Example curl:
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_discussions_by_comments", "params":[{"start_author":"steemit","start_permlink":"firstpost","limit":1}], "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_discussions_by_comments", "params":[{"start_author":"alice","start_permlink":"a-post-by-alice","limit":10,"truncate_body":0}], "id":1}' https://api.steemit.com
condenser_api.get_discussions_by_created
Returns a list of discussions by created.
Query Parameters JSON:
[{"tag":"","limit":0,"filter_tags":[],"select_authors":[],"select_tags":[],"truncate_body":0}]
Expected Response JSON:
[]
Example curl:
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_discussions_by_created", "params":[{"tag":"steem","limit":1}], "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_discussions_by_created", "params":[{"tag":"photography","limit":10,"truncate_body":0}], "id":1}' https://api.steemit.com
condenser_api.get_discussions_by_feed
Returns a list of discussions by feed.
Query Parameters JSON:
[{"tag":"","start_author":"","start_permlink":"","limit":100}]
Expected Response JSON:
[]
Example curl:
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_discussions_by_feed", "params":[{"tag":"steem","limit":1}], "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_discussions_by_feed", "params":[{"tag":"photography","limit":10,"truncate_body":0}], "id":1}' https://api.steemit.com
condenser_api.get_discussions_by_hot
Returns a list of discussions by hot.
Query Parameters JSON:
[{"tag":"","limit":0,"filter_tags":[],"select_authors":[],"select_tags":[],"truncate_body":0}]
Expected Response JSON:
[]
Example curl:
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_discussions_by_hot", "params":[{"tag":"steem","limit":1}], "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_discussions_by_hot", "params":[{"tag":"photography","limit":10,"truncate_body":0}], "id":1}' https://api.steemit.com
condenser_api.get_discussions_by_promoted
Returns a list of discussions by promoted.
Query Parameters JSON:
[{"tag":"","limit":0,"filter_tags":[],"select_authors":[],"select_tags":[],"truncate_body":0}]
Expected Response JSON:
[]
Example curl:
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_discussions_by_promoted", "params":[{"tag":"steem","limit":1}], "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_discussions_by_promoted", "params":[{"tag":"photography","limit":10,"truncate_body":0}], "id":1}' https://api.steemit.com
condenser_api.get_discussions_by_trending
Returns a list of discussions by trending.
Query Parameters JSON:
[{"tag":"","limit":0,"filter_tags":[],"select_authors":[],"select_tags":[],"truncate_body":0}]
Expected Response JSON:
[]
Example curl:
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_discussions_by_trending", "params":[{"tag":"steem","limit":1}], "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_discussions_by_trending", "params":[{"tag":"photography","limit":10,"truncate_body":0}], "id":1}' https://api.steemit.com
condenser_api.get_discussions_by_votes
Returns a list of discussions by votes.
Query Parameters JSON:
[{"tag":"","limit":0,"filter_tags":[],"select_authors":[],"select_tags":[],"truncate_body":0}]
Expected Response JSON:
[]
Example curl:
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_discussions_by_votes", "params":[{"tag":"steem","limit":1}], "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_discussions_by_votes", "params":[{"tag":"photography","limit":10,"truncate_body":0}], "id":1}' https://api.steemit.com
condenser_api.get_dynamic_global_properties
Returns the current 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 STEEM","current_supply":"0.000 STEEM","confidential_supply":"0.000 STEEM","current_sbd_supply":"0.000 STEEM","confidential_sbd_supply":"0.000 STEEM","total_vesting_fund_steem":"0.000 STEEM","total_vesting_shares":"0.000 STEEM","total_reward_fund_steem":"0.000 STEEM","total_reward_shares2":"0","pending_rewarded_vesting_shares":"0.000 STEEM","pending_rewarded_vesting_steem":"0.000 STEEM","sbd_interest_rate":0,"sbd_print_rate":10000,"maximum_block_size":0,"current_aslot":0,"recent_slots_filled":"0","participation_count":0,"last_irreversible_block_num":0,"vote_power_reserve_rate":40,"average_block_size":0,"current_reserve_ratio":1,"max_virtual_bandwidth":"0"}
Example curl:
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_dynamic_global_properties", "params":[], "id":1}' https://api.steemit.com
condenser_api.get_escrow
Returns the escrow for a certain account by id.
Query Parameters JSON:
["",0]
Expected Response JSON:
null
Example curl:
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_escrow", "params":["steemit", 1234], "id":1}' https://api.steemit.com
condenser_api.get_expiring_vesting_delegations
Returns the expiring vesting delegations for an account. Parameters: account:string, after:timestamp
account (string) |
after (timestamp) |
|
|---|---|---|
"steemit" |
"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":["steemit","2018-01-01T00:00:00"], "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_expiring_vesting_delegations", "params":["alice","2017-12-01T00:00:00"], "id":1}' https://api.steemit.com
condenser_api.get_feed
Returns a list of items in an account’s feed. Parameters: account:string; start_entry_id:int; limit:int up to 500
account (string) |
start_entry_id (int) |
limit (int) |
|
|---|---|---|---|
"steemit" |
0 |
1 |
Queries the account named steemit starting on the first item, up to 1 result. |
"alice" |
1 |
10 |
Queries the account named alice starting on the second item, up to 10 results. |
Query Parameters JSON:
["",0,1]
Expected Response JSON:
[]
Example curl:
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_feed", "params":["steemit",0,1], "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_feed", "params":["alice",1,10], "id":1}' https://api.steemit.com
condenser_api.get_feed_entries
Returns a list of entries in an account’s feed. Parameters: account:string; start_entry_id:int; limit:int up to 500
account (string) |
start_entry_id (int) |
limit (int) |
|
|---|---|---|---|
"steemit" |
0 |
1 |
Queries the account named steemit starting on the first item, up to 1 result. |
"alice" |
1 |
10 |
Queries the account named alice starting on the second item, up to 10 results. |
Query Parameters JSON:
["",0,1]
Expected Response JSON:
[]
Example curl:
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_feed_entries", "params":["steemit",0,1], "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_feed_entries", "params":["alice",1,10], "id":1}' https://api.steemit.com
condenser_api.get_feed_history
Returns the history of price feed values.
Query Parameters JSON:
[]
Expected Response JSON:
{"id":0,"current_median_history":{"base":"0.000 STEEM","quote":"0.000 STEEM"},"price_history":[]}
Example curl:
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_feed_history", "params":[], "id":1}' https://api.steemit.com
condenser_api.get_follow_count
Returns the count of followers/following for an account. Parameters: account:string
account (string) |
|
|---|---|
"steemit" |
Queries the account named steemit. |
"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":["steemit"], "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_follow_count", "params":["alice"], "id":1}' https://api.steemit.com
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) |
|
|---|---|---|---|---|
"steemit" |
null |
"blog" |
10 |
Queries for follows of the account named steemit, up to 10 results. |
"alice" |
null |
"ignore" |
100 |
Queries for mutes of the account named alice, up to 100 results. |
Query Parameters JSON:
["","","",1]
Expected Response JSON:
[]
Example curl:
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_followers", "params":["steemit",null,"blog",10], "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_followers", "params":["alice",null,"ignore",100], "id":1}' https://api.steemit.com
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) |
|
|---|---|---|---|---|
"steemit" |
null |
"blog" |
10 |
Queries for follows of the account named steemit, up to 10 results. |
"alice" |
null |
"ignore" |
100 |
Queries for mutes of the account named alice, up to 100 results. |
Query Parameters JSON:
["","","",1]
Expected Response JSON:
[]
Example curl:
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_following", "params":["steemit",null,"blog",10], "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_following", "params":["alice",null,"ignore",100], "id":1}' https://api.steemit.com
condenser_api.get_hardfork_version
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.steemit.com
condenser_api.get_key_references
Returns all accounts that have the key associated with their owner or active authorities.
Query Parameters JSON:
[["STM5jZtLoV8YbxCxr4imnbWn61zMB24wwonpnVhfXRmv7j6fk3dTH"]]
Expected Response JSON:
[["steemit"]]
Example curl:
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_key_references", "params":[["STM5jZtLoV8YbxCxr4imnbWn61zMB24wwonpnVhfXRmv7j6fk3dTH"]], "id":1}' https://api.steemit.com
condenser_api.get_market_history
Returns the market history for the internal SBD:STEEM 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. |
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,"steem":{"high":0,"low":0,"open":0,"close":0,"volume":0},"non_steem":{"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.steemit.com
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.steemit.com
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.steemit.com
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.steemit.com
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.steemit.com
condenser_api.get_market_history_buckets
Returns the bucket seconds being tracked by the plugin.
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.steemit.com
condenser_api.get_next_scheduled_hardfork
Returns the next scheduled 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.steemit.com
condenser_api.get_open_orders
Returns the open orders for an account. account:string
Query Parameters JSON:
[""]
Expected Response JSON:
[]
Example curl:
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_open_orders", "params":["steemit"], "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_open_orders", "params":["alice"], "id":1}' https://api.steemit.com
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. |
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.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_ops_in_block", "params":[5443322,true], "id":1}' https://api.steemit.com
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. |
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.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_order_book", "params":[50], "id":1}' https://api.steemit.com
condenser_api.get_owner_history
Returns the owner history of an account. Parameters: account:string
account (string) |
|
|---|---|
"steemit" |
Queries the owner history for account named “steemit”. |
Query Parameters JSON:
[""]
Expected Response JSON:
[]
Example curl:
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_owner_history", "params":["steemit"], "id":1}' https://api.steemit.com
condenser_api.get_post_discussions_by_payout
Returns a list of post discussions by payout.
Query Parameters JSON:
[{"tag":"","limit":0,"filter_tags":[],"select_authors":[],"select_tags":[],"truncate_body":0}]
Expected Response JSON:
[]
Example curl:
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_post_discussions_by_payout", "params":[{"tag":"steem","limit":1}], "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_post_discussions_by_payout", "params":[{"tag":"photography","limit":10,"truncate_body":0}], "id":1}' https://api.steemit.com
condenser_api.get_potential_signatures
This method will return the set of all public keys that could possibly sign for a given transaction.
Query Parameters JSON:
[{"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":["100000",3,"@@000000021"],"maximum_block_size":131072,"sbd_interest_rate":1000}}]],"extensions":[],"signatures":[]}], "id":1}' https://api.steemit.com
condenser_api.get_reblogged_by
Returns a list of authors that have reblogged a post. Parameters: author:string; permlink:string
author (string) |
permlink (string) |
|
|---|---|---|
"steemit" |
"firstpost" |
Queries reblogs for content with a slug @steemit/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":["steemit","firstpost"], "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_reblogged_by", "params":["alice","a-post-by-alice"], "id":1}' https://api.steemit.com
condenser_api.get_recent_trades
Returns the most recent trades for the internal SBD:STEEM market. Parameters: limit:int up to 1000
limit (int) |
|
|---|---|
10 |
Queries up to 10 latest trades. |
500 |
Queries up to 500 latest trades. |
Query Parameters JSON:
[1]
Expected Response JSON:
[{"date":"1970-01-01T00:00:00","current_pays":"0.0 SBD","open_pays":"0.0 STEEM"}]
Example curl:
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_recent_trades", "params":[10], "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_recent_trades", "params":[500], "id":1}' https://api.steemit.com
condenser_api.get_recovery_request
Returns the recovery request for an account. Parameters: account:string
account (string) |
|
|---|---|
"steemit" |
Queries the recovery requests for account named “steemit”. |
Query Parameters JSON:
[""]
Expected Response JSON:
null
Example curl:
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_recovery_request", "params":["steemit"], "id":1}' https://api.steemit.com
condenser_api.get_replies_by_last_update
Returns a list of replies by last update. start_parent_author:string, start_permlink:string, limit:int up to 100
Query Parameters JSON:
["","",1]
Expected Response JSON:
[]
Example curl:
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_replies_by_last_update", "params":["steemit","firstpost",1], "id":1}' https://api.steemit.com
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]
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":["100000",3,"@@000000021"],"maximum_block_size":131072,"sbd_interest_rate":1000}}]],"extensions":[],"signatures":[]},[]], "id":1}' https://api.steemit.com
condenser_api.get_reward_fund
Returns information about the current reward funds.
Query Parameters JSON:
["post"]
Expected Response JSON:
{"id":0,"name":"","reward_balance":"0.000 STEEM","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.steemit.com
condenser_api.get_savings_withdraw_from
Returns savings withdraw from an account. Parameters: account:string
account (string) |
|
|---|---|
"steemit" |
Queries the savings withdraw for account named “steemit”. |
Query Parameters JSON:
[""]
Expected Response JSON:
[]
Example curl:
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_savings_withdraw_from", "params":["steemit"], "id":1}' https://api.steemit.com
condenser_api.get_savings_withdraw_to
Returns the savings withdraw to an account. Parameters: account:string
account (string) |
|
|---|---|
"steemit" |
Queries the savings withdraw for account named “steemit”. |
Query Parameters JSON:
[""]
Expected Response JSON:
[]
Example curl:
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_savings_withdraw_to", "params":["steemit"], "id":1}' https://api.steemit.com
condenser_api.get_state
Returns the state of a path. Deprecated. Parameters: path:string
Query Parameters JSON:
[""]
Expected Response JSON:
{"current_route":"","props":{"head_block_number":0,"head_block_id":"0000000000000000000000000000000000000000","time":"1970-01-01T00:00:00","current_witness":"","total_pow":"18446744073709551615","num_pow_witnesses":0,"virtual_supply":"0.000 STEEM","current_supply":"0.000 STEEM","confidential_supply":"0.000 STEEM","current_sbd_supply":"0.000 STEEM","confidential_sbd_supply":"0.000 STEEM","total_vesting_fund_steem":"0.000 STEEM","total_vesting_shares":"0.000 STEEM","total_reward_fund_steem":"0.000 STEEM","total_reward_shares2":"0","pending_rewarded_vesting_shares":"0.000 STEEM","pending_rewarded_vesting_steem":"0.000 STEEM","sbd_interest_rate":0,"sbd_print_rate":10000,"maximum_block_size":0,"current_aslot":0,"recent_slots_filled":"0","participation_count":0,"last_irreversible_block_num":0,"vote_power_reserve_rate":40,"average_block_size":0,"current_reserve_ratio":1,"max_virtual_bandwidth":"0"},"tag_idx":{"trending":[]},"tags":{},"content":{},"accounts":{},"witnesses":{},"discussion_idx":{},"witness_schedule":{"id":0,"current_virtual_time":"0","next_shuffle_block_num":1,"current_shuffled_witnesses":[],"num_scheduled_witnesses":1,"top19_weight":1,"timeshare_weight":5,"miner_weight":1,"witness_pay_normalization_factor":25,"median_props":{"account_creation_fee":"0.000 STEEM","maximum_block_size":131072,"sbd_interest_rate":1000},"majority_version":"0.0.0","max_voted_witnesses":19,"max_miner_witnesses":1,"max_runner_witnesses":1,"hardfork_required_witnesses":17},"feed_price":{"base":"0.000 STEEM","quote":"0.000 STEEM"},"error":""}
Example curl:
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_state", "params":["/@steemit"], "id":1}' https://api.steemit.com
condenser_api.get_tags_used_by_author
Returns a list of tags used by an author. Parameters: author:string
account (string) |
|
|---|---|
"steemit" |
Queries the tags used by the account named “steemit”. |
Query Parameters JSON:
[""]
Expected Response JSON:
[]
Example curl:
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_tags_used_by_author", "params":["steemit"], "id":1}' https://api.steemit.com
condenser_api.get_ticker
Returns the market ticker for the internal SBD:STEEM market.
Query Parameters JSON:
[]
Expected Response JSON:
{"latest":"0.00000000000000000","lowest_ask":"0.00000000000000000","highest_bid":"0.00000000000000000","percent_change":"0.00000000000000000","steem_volume":"0.000 STEEM","sbd_volume":"0.000 STEEM"}
Example curl:
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_ticker", "params":[], "id":1}' https://api.steemit.com
condenser_api.get_trade_history
Returns the trade history for the internal SBD:STEEM 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. |
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 SBD","open_pays":"0.000 STEEM"}]
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.steemit.com
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. |
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.steemit.com
condenser_api.get_transaction_hex
Returns a hexdump of the serialized binary form of a 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.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":["100000",3,"@@000000021"],"maximum_block_size":131072,"sbd_interest_rate":1000}}]],"extensions":[],"signatures":[]}], "id":1}' https://api.steemit.com
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. |
"steem" |
10 | Queries the tags after “steem”, up to 10 tags. |
Query Parameters JSON:
["",1]
Expected Response JSON:
[{"name":"","total_payouts":"0.000 SBD","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.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_trending_tags", "params":["steem",10], "id":1}' https://api.steemit.com
condenser_api.get_version
Returns the versions of blockchain, steem, and FC.
Query Parameters JSON:
[]
Expected Response JSON:
{"blockchain_version":"","steem_revision":"","fc_revision":""}
Example curl:
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_version", "params":[], "id":1}' https://api.steemit.com
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) |
|
|---|---|---|---|
"steemit" |
null |
10 |
Queries up to 10 vesting delegations by “steemit”. |
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":["steemit",null,10], "id":1}' https://api.steemit.com
condenser_api.get_volume
Returns the market volume for the past 24 hours.
Query Parameters JSON:
[]
Expected Response JSON:
{"steem_volume":"0.000 STEEM","sbd_volume":"0.000 STEEM"}
Example curl:
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_volume", "params":[], "id":1}' https://api.steemit.com
condenser_api.get_withdraw_routes
Returns the withdraw routes for an account. Parameters: account:string; type:string
account (string) |
type (string) |
|
|---|---|---|
"steemit" |
"outgoing" |
Queries outgoing withdraw routes by “steemit”. |
"steemit" |
"incoming" |
Queries incoming withdraw routes by “steemit”. |
"steemit" |
"all" |
Queries all withdraw routes by “steemit”. |
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":["steemit","outgoing"], "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_withdraw_routes", "params":["steemit","incoming"], "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_withdraw_routes", "params":["steemit","all"], "id":1}' https://api.steemit.com
condenser_api.get_witness_by_account
Returns the witness of an account. Parameters: account:string
account (string) |
|
|---|---|
"steemit" |
Queries witness account of “steemit” (of null if none exists). |
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 STEEM","maximum_block_size":65536,"sbd_interest_rate":0},"sbd_exchange_rate":{"base":"0.000 SBD","quote":"0.000 STEEM"},"last_sbd_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":["steemit"], "id":1}' https://api.steemit.com
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.steemit.com
condenser_api.get_witness_schedule
Returns the current witness schedule.
Query Parameters JSON:
[]
Expected Response JSON:
{"id":0,"current_virtual_time":"0","next_shuffle_block_num":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 STEEM","maximum_block_size":131072,"sbd_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.steemit.com
condenser_api.get_witnesses
Returns current 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.steemit.com
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”. |
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.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.get_witnesses_by_vote", "params":["a", 1], "id":1}' https://api.steemit.com
condenser_api.lookup_account_names
Looks up account names. accounts:[string]
Query Parameters JSON:
[["steemit"]]
Expected Response JSON:
[{"id":28,"name":"steemit","owner":{"weight_threshold":1,"account_auths":[],"key_auths":[["STM5tfrdPG1Ycjwa9FuBUueDFFyygndBLXdVEEs2c9eRKScnFk6vM",1],["STM71f6yWztimJuREVyyMXNqAVbx1FzPVW6LLXNoQ35dHwKuszmHX",1],["STM7U3ymhUTuKME72dpdpQkdQvh722gTLjKBKtmKQPPWgtkr418Nf",1]]},"active":{"weight_threshold":1,"account_auths":[],"key_auths":[["STM5832HKCJzs6K3rRCsZ1PidTKgjF38ZJb718Y3pCW92HEMsCGPf",1],["STM7Q2rLBqzPzFeteQZewv9Lu3NLE69fZoLeL6YK59t7UmssCBNTU",1]]},"posting":{"weight_threshold":1,"account_auths":[],"key_auths":[["STM5jZtLoV8YbxCxr4imnbWn61zMB24wwonpnVhfXRmv7j6fk3dTH",1],["STM7xVFaqi8RxhWKZwuLA2bKrAiQmhnrbgvw4e2ChAsKYQbPjqUq2",1],["STM83dmDkQcZU9X8MWcxsTztSyutE6udrb55PvYgu7RLzStaoAt67",1]]},"memo_key":"STM5jZtLoV8YbxCxr4imnbWn61zMB24wwonpnVhfXRmv7j6fk3dTH","json_metadata":"","proxy":"","last_owner_update":"2017-03-16T21:17:51","last_account_update":"2017-03-16T23:10:36","created":"2016-03-24T17:00:21","mined":true,"recovery_account":"steem","last_account_recovery":"1970-01-01T00:00:00","reset_account":"null","comment_count":0,"lifetime_vote_count":0,"post_count":1,"can_vote":true,"voting_power":9950,"last_vote_time":"2016-12-04T23:10:57","balance":"0.006 STEEM","savings_balance":"11006644.632 STEEM","sbd_balance":"8581.890 SBD","sbd_seconds":"18846158467785","sbd_seconds_last_update":"2018-04-10T04:08:36","sbd_last_interest_payment":"2018-03-15T17:58:24","savings_sbd_balance":"0.000 SBD","savings_sbd_seconds":"0","savings_sbd_seconds_last_update":"1970-01-01T00:00:00","savings_sbd_last_interest_payment":"1970-01-01T00:00:00","savings_withdraw_requests":0,"reward_sbd_balance":"0.000 SBD","reward_steem_balance":"0.000 STEEM","reward_vesting_balance":"0.000000 VESTS","reward_vesting_steem":"0.000 STEEM","vesting_shares":"90039851836.689703 VESTS","delegated_vesting_shares":"0.000000 VESTS","received_vesting_shares":"0.000000 VESTS","vesting_withdraw_rate":"0.000000 VESTS","next_vesting_withdrawal":"1969-12-31T23:59:59","withdrawn":0,"to_withdraw":0,"withdraw_routes":0,"curation_rewards":0,"posting_rewards":3548,"proxied_vsf_votes":["28583799126",0,0,0],"witnesses_voted_for":0,"last_post":"2016-03-30T18:30:18","last_root_post":"2016-03-30T18:30:18"}]
Example curl:
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.lookup_account_names", "params":[["steemit"]], "id":1}' https://api.steemit.com
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”. |
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.steemit.com
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”. |
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.steemit.com
condenser_api.verify_account_authority
Returns true if the signers have enough authority to authorize an account. Parameters: account:string, signer:[string]
account (string) |
signer (string array) |
|
|---|---|---|
"steemit" |
["STM7Q2rLBqzPzFeteQZewv9Lu3NLE69fZoLeL6YK59t7UmssCBNTU"] |
Checks if the “steemit” account against one of it’s current active keys. |
Query Parameters JSON:
["",[""]]
Expected Response JSON:
false
Example curl:
curl -s --data '{"jsonrpc":"2.0", "method":"condenser_api.verify_account_authority", "params":["steemit",["STM7Q2rLBqzPzFeteQZewv9Lu3NLE69fZoLeL6YK59t7UmssCBNTU"]], "id":1}' https://api.steemit.com
condenser_api.verify_authority
Returns true if the transaction has all of the 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:
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":["100000",3,"@@000000021"],"maximum_block_size":131072,"sbd_interest_rate":1000}}]],"extensions":[],"signatures":[]}], "id":1}' https://api.steemit.com
Account By Key Api
Used to lookup account information based on a key. These AppBase API methods are still under development and subject to change.
account_by_key_api.get_key_references
Returns all accounts that have the key associated with their owner or active authorities.
Query Parameters JSON:
{"keys":[]}
Expected Response JSON:
{"accounts":[]}
Example curl:
curl -s --data '{"jsonrpc":"2.0", "method":"account_by_key_api.get_key_references", "params":{"keys":["STM5jZtLoV8YbxCxr4imnbWn61zMB24wwonpnVhfXRmv7j6fk3dTH"]}, "id":1}' https://api.steemit.com
Account History Api
Used to lookup account history information. These AppBase API methods are still under development and subject to change.
account_history_api.get_account_history
Returns a history of all operations for a given account.
Query Parameters JSON:
{"account":"","start":"18446744073709551615","limit":1000}
Expected Response JSON:
{"history":[]}
Example curl:
curl -s --data '{"jsonrpc":"2.0", "method":"account_history_api.get_account_history", "params":{"account":"steemit", "start":1000, "limit":1000}, "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"account_history_api.get_account_history", "params":{"account":"steemit", "start":-1, "limit":10000}, "id":1}' https://api.steemit.com
account_history_api.get_ops_in_block
Returns all operations contained in a block.
Query Parameters JSON:
{"block_num":0,"only_virtual":false}
Expected Response JSON:
{"ops":[]}
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.steemit.com
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.steemit.com
account_history_api.get_transaction
Returns the details of a transaction based on a transaction id.
Query Parameters JSON:
{"id":"0000000000000000000000000000000000000000"}
Expected Response JSON:
{"ref_block_num":0,"ref_block_prefix":0,"expiration":"1970-01-01T00:00:00","operations":[],"extensions":[],"signatures":[],"transaction_id":"0000000000000000000000000000000000000000","block_num":0,"transaction_num":0}
Example curl:
curl -s --data '{"jsonrpc":"2.0", "method":"account_history_api.get_transaction", "params":{"id":"6fde0190a97835ea6d9e651293e90c89911f933c"}, "id":1}' https://api.steemit.com
Database Api
Used query information about accounts, transactions, and blockchain data. These AppBase API methods are still under development and subject to change.
database_api.find_account_recovery_requests
Returns a list of account recovery requests.
Query Parameters JSON:
{"accounts":[]}
Expected Response JSON:
{"requests":[]}
database_api.find_accounts
Search for accounts.
Query Parameters JSON:
{"accounts":[]}
Expected Response JSON:
{"accounts":[]}
database_api.find_change_recovery_account_requests
Returns a list of requests to change the recovery account.
Query Parameters JSON:
{"accounts":[]}
Expected Response JSON:
{"requests":[]}
database_api.find_comments
Search for comments.
Query Parameters JSON:
{"comments":[]}
Expected Response JSON:
{"comments":[]}
database_api.find_decline_voting_rights_requests
Returns a list of requests to decline voting rights.
Query Parameters JSON:
{"accounts":[]}
Expected Response JSON:
{"requests":[]}
database_api.find_escrows
Returns a list of escrows.
Query Parameters JSON:
{"from":""}
Expected Response JSON:
{"escrows":[]}
database_api.find_limit_orders
Returns a list of limit orders.
Query Parameters JSON:
{"account":""}
Expected Response JSON:
{"orders":[]}
database_api.find_owner_histories
Returns owner authority history.
Query Parameters JSON:
{"owner":""}
Expected Response JSON:
{"owner_auths":[]}
database_api.find_savings_withdrawals
Returns the list of savings withdrawls for an account.
Query Parameters JSON:
{"account":""}
Expected Response JSON:
{"withdrawals":[]}
database_api.find_sbd_conversion_requests
Returns the list of SBD conversion requests for an account.
Query Parameters JSON:
{"account":""}
Expected Response JSON:
{"requests":[]}
database_api.find_vesting_delegation_expirations
Returns the expirations for vesting delegations.
Query Parameters JSON:
{"account":""}
Expected Response JSON:
{"delegations":[]}
database_api.find_vesting_delegations
Returns the list of vesting delegations for an account.
Query Parameters JSON:
{"account":""}
Expected Response JSON:
{"delegations":[]}
database_api.find_votes
Returns the votes for an author and permlink.
Query Parameters JSON:
{"author":"","permlink":""}
Expected Response JSON:
{"votes":[]}
database_api.find_withdraw_vesting_routes
Returns the list of vesting withdraw routes for an account.
Query Parameters JSON:
{"account":"","order":"by_name"}
Expected Response JSON:
{"routes":[]}
database_api.find_witnesses
Search for witnesses.
Query Parameters JSON:
{"owners":[]}
Expected Response JSON:
{"witnesses":[]}
database_api.get_active_witnesses
Returns the list of active witnesses.
Query Parameters JSON:
{}
Expected Response JSON:
{"witnesses":[]}
Example curl:
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.get_active_witnesses", "id":1}' https://api.steemit.com
database_api.get_config
Returns information about compile-time constants.
Query Parameters JSON:
{}
Expected Response JSON:
{}
Example curl:
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.get_config", "id":1}' https://api.steemit.com
database_api.get_current_price_feed
Returns the current price feed.
Query Parameters JSON:
{}
Expected Response JSON:
{"base":["0",3,"@@000000021"],"quote":["0",3,"@@000000021"]}
database_api.get_dynamic_global_properties
Returns the current dynamic global properties.
Query Parameters JSON:
{}
Expected Response JSON:
{"id":0,"head_block_number":0,"head_block_id":"0000000000000000000000000000000000000000","time":"1970-01-01T00:00:00","current_witness":"","total_pow":"18446744073709551615","num_pow_witnesses":0,"virtual_supply":["0",3,"@@000000021"],"current_supply":["0",3,"@@000000021"],"confidential_supply":["0",3,"@@000000021"],"current_sbd_supply":["0",3,"@@000000013"],"confidential_sbd_supply":["0",3,"@@000000013"],"total_vesting_fund_steem":["0",3,"@@000000021"],"total_vesting_shares":["0",6,"@@000000037"],"total_reward_fund_steem":["0",3,"@@000000021"],"total_reward_shares2":"0","pending_rewarded_vesting_shares":["0",6,"@@000000037"],"pending_rewarded_vesting_steem":["0",3,"@@000000021"],"sbd_interest_rate":0,"sbd_print_rate":10000,"maximum_block_size":0,"current_aslot":0,"recent_slots_filled":"0","participation_count":0,"last_irreversible_block_num":0,"vote_power_reserve_rate":40}
Example curl:
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.get_dynamic_global_properties", "id":1}' https://api.steemit.com
database_api.get_feed_history
Returns the history of price feed values.
Query Parameters JSON:
{}
Expected Response JSON:
{"id":0,"current_median_history":{"base":["0",3,"@@000000021"],"quote":["0",3,"@@000000021"]},"price_history":[]}
Example curl:
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.get_feed_history", "id":1}' https://api.steemit.com
database_api.get_hardfork_properties
Returns the current properties about the blockchain’s hardforks.
Query Parameters JSON:
{}
Expected Response JSON:
{"id":0,"processed_hardforks":[],"last_hardfork":0,"current_hardfork_version":"0.0.0","next_hardfork":"0.0.0","next_hardfork_time":"1970-01-01T00:00:00"}
Example curl:
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.get_hardfork_properties", "id":1}' https://api.steemit.com
database_api.get_order_book
Returns the order book.
Query Parameters JSON:
{"limit":0}
Expected Response JSON:
{"asks":[],"bids":[]}
Example curl:
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.get_order_book", "params":{"limit":10}, "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.get_order_book", "params":{"limit":50}, "id":1}' https://api.steemit.com
database_api.get_potential_signatures
This method will return the set of all public keys that could possibly sign for a given transaction.
Query Parameters JSON:
{"trx":{"ref_block_num":0,"ref_block_prefix":0,"expiration":"1970-01-01T00:00:00","operations":[],"extensions":[],"signatures":[]}}
Expected Response JSON:
{"keys":[]}
Example curl:
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.get_potential_signatures", "params":{"trx":{"ref_block_num":1097,"ref_block_prefix":2181793527,"expiration":"2016-03-24T18:00:21","operations":[["pow",{"worker_account":"cloop3","block_id":"00000449f7860b82b4fbe2f317c670e9f01d6d9a","nonce":3899,"work":{"worker":"STM7P5TDnA87Pj9T4mf6YHrhzjC1KbPZpNxLWCcVcHxNYXakpoT4F","input":"ae8e7c677119d22385f8c48026fee7aad7bba693bf788d7f27047f40b47738c0","signature":"1f38fe9a3f9989f84bd94aa5bbc88beaf09b67f825aa4450cf5105d111149ba6db560b582c7dbb026c7fc9c2eb5051815a72b17f6896ed59d3851d9a0f9883ca7a","work":"000e7b209d58f2e64b36e9bf12b999c6c7af168cc3fc41eb7f8a4bf796c174c3"},"props":{"account_creation_fee":["100000",3,"@@000000021"],"maximum_block_size":131072,"sbd_interest_rate":1000}}]],"extensions":[],"signatures":[]}}, "id":1}' https://api.steemit.com
database_api.get_required_signatures
This API will take a partially signed transaction and a set of public keys that the owner has the ability to sign for and return the minimal subset of public keys that should add signatures to the transaction.
Query Parameters JSON:
{"trx":{"ref_block_num":0,"ref_block_prefix":0,"expiration":"1970-01-01T00:00:00","operations":[],"extensions":[],"signatures":[]},"available_keys":[]}
Expected Response JSON:
{"keys":[]}
Example curl:
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.get_required_signatures", "params":{"trx":{"ref_block_num":1097,"ref_block_prefix":2181793527,"expiration":"2016-03-24T18:00:21","operations":[["pow",{"worker_account":"cloop3","block_id":"00000449f7860b82b4fbe2f317c670e9f01d6d9a","nonce":3899,"work":{"worker":"STM7P5TDnA87Pj9T4mf6YHrhzjC1KbPZpNxLWCcVcHxNYXakpoT4F","input":"ae8e7c677119d22385f8c48026fee7aad7bba693bf788d7f27047f40b47738c0","signature":"1f38fe9a3f9989f84bd94aa5bbc88beaf09b67f825aa4450cf5105d111149ba6db560b582c7dbb026c7fc9c2eb5051815a72b17f6896ed59d3851d9a0f9883ca7a","work":"000e7b209d58f2e64b36e9bf12b999c6c7af168cc3fc41eb7f8a4bf796c174c3"},"props":{"account_creation_fee":["100000",3,"@@000000021"],"maximum_block_size":131072,"sbd_interest_rate":1000}}]],"extensions":[],"signatures":[]},"available_keys":[]}, "id":1}' https://api.steemit.com
database_api.get_reward_funds
Returns information about the current reward funds.
Query Parameters JSON:
{}
Expected Response JSON:
{"funds":[]}
Example curl:
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.get_reward_funds", "id":1}' https://api.steemit.com
database_api.get_transaction_hex
Returns a hexdump of the serialized binary form of a transaction.
Query Parameters JSON:
{"trx":{"ref_block_num":0,"ref_block_prefix":0,"expiration":"1970-01-01T00:00:00","operations":[],"extensions":[],"signatures":[]}}
Expected Response JSON:
{"hex":""}
Example curl:
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.get_transaction_hex", "params":{"trx":{"ref_block_num":1097,"ref_block_prefix":2181793527,"expiration":"2016-03-24T18:00:21","operations":[["pow",{"worker_account":"cloop3","block_id":"00000449f7860b82b4fbe2f317c670e9f01d6d9a","nonce":3899,"work":{"worker":"STM7P5TDnA87Pj9T4mf6YHrhzjC1KbPZpNxLWCcVcHxNYXakpoT4F","input":"ae8e7c677119d22385f8c48026fee7aad7bba693bf788d7f27047f40b47738c0","signature":"1f38fe9a3f9989f84bd94aa5bbc88beaf09b67f825aa4450cf5105d111149ba6db560b582c7dbb026c7fc9c2eb5051815a72b17f6896ed59d3851d9a0f9883ca7a","work":"000e7b209d58f2e64b36e9bf12b999c6c7af168cc3fc41eb7f8a4bf796c174c3"},"props":{"account_creation_fee":["100000",3,"@@000000021"],"maximum_block_size":131072,"sbd_interest_rate":1000}}]],"extensions":[],"signatures":[]}}, "id":1}' https://api.steemit.com
database_api.get_witness_schedule
Returns the current witness schedule.
Query Parameters JSON:
{}
Expected Response JSON:
{"id":0,"current_virtual_time":"0","next_shuffle_block_num":0,"current_shuffled_witnesses":[],"num_scheduled_witnesses":48,"top19_weight":77,"timeshare_weight":16,"miner_weight":2,"witness_pay_normalization_factor":0,"median_props":{"account_creation_fee":["1",3,"@@000000021"],"maximum_block_size":131072,"sbd_interest_rate":1000,"account_subsidy_limit":0},"majority_version":"0.0.0","max_voted_witnesses":48,"max_miner_witnesses":77,"max_runner_witnesses":16,"hardfork_required_witnesses":2}
Example curl:
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.get_witness_schedule", "id":1}' https://api.steemit.com
database_api.list_account_recovery_requests
Returns a list of account recovery requests.
Query Parameters JSON:
{"start":null,"limit":0,"order":"by_name"}
Expected Response JSON:
{"requests":[]}
database_api.list_accounts
Returns a list of accounts.
Query Parameters JSON:
{"start":null,"limit":0,"order":"by_name"}
Expected Response JSON:
{"accounts":[]}
database_api.list_change_recovery_account_requests
Returns a list of recovery account change requests.
Query Parameters JSON:
{"start":null,"limit":0,"order":"by_name"}
Expected Response JSON:
{"requests":[]}
database_api.list_comments
Returns a list of comments.
Query Parameters JSON:
{"start":null,"limit":0,"order":"by_name"}
Expected Response JSON:
{"comments":[]}
database_api.list_decline_voting_rights_requests
Returns a list of decline voting rights requests.
Query Parameters JSON:
{"start":null,"limit":0,"order":"by_name"}
Expected Response JSON:
{"requests":[]}
database_api.list_escrows
Returns a list of escrows.
Query Parameters JSON:
{"start":null,"limit":0,"order":"by_name"}
Expected Response JSON:
{"escrows":[]}
database_api.list_limit_orders
Returns a list of limit orders.
Query Parameters JSON:
{"start":null,"limit":0,"order":"by_name"}
Expected Response JSON:
{"orders":[]}
database_api.list_owner_histories
Returns a list of owner authority histories.
Query Parameters JSON:
{"start":null,"limit":0}
Expected Response JSON:
{"owner_auths":[]}
database_api.list_savings_withdrawals
Returns a list of savings withdrawls.
Query Parameters JSON:
{"start":null,"limit":0,"order":"by_name"}
Expected Response JSON:
{"withdrawals":[]}
database_api.list_sbd_conversion_requests
Returns a list of SBD conversion requests.
Query Parameters JSON:
{"start":null,"limit":0,"order":"by_name"}
Expected Response JSON:
{"requests":[]}
database_api.list_vesting_delegation_expirations
Returns a list of vesting delegation expirations.
Query Parameters JSON:
{"start":null,"limit":0,"order":"by_name"}
Expected Response JSON:
{"delegations":[]}
database_api.list_vesting_delegations
Returns a list of vesting delegations.
Query Parameters JSON:
{"start":null,"limit":0,"order":"by_name"}
Expected Response JSON:
{"delegations":[]}
database_api.list_votes
Returns a list of votes.
Query Parameters JSON:
{"start":null,"limit":0,"order":"by_name"}
Expected Response JSON:
{"votes":[]}
database_api.list_withdraw_vesting_routes
Returns a list of vesting withdraw routes.
Query Parameters JSON:
{"start":null,"limit":0,"order":"by_name"}
Expected Response JSON:
{"routes":[]}
database_api.list_witness_votes
Returns a list of witness votes.
Query Parameters JSON:
{"start":null,"limit":0,"order":"by_name"}
Expected Response JSON:
{"votes":[]}
database_api.list_witnesses
Returns the list of witnesses.
Query Parameters JSON:
{"start":null,"limit":0,"order":"by_name"}
Expected Response JSON:
{"witnesses":[]}
database_api.verify_account_authority
Returns true if the signers have enough authority to authorize an account.
Query Parameters JSON:
{"account":"","signers":[]}
Expected Response JSON:
{"valid":false}
Example curl:
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.verify_account_authority", "params":{"account":"steemit","signers":["STM7Q2rLBqzPzFeteQZewv9Lu3NLE69fZoLeL6YK59t7UmssCBNTU"]}, "id":1}' https://api.steemit.com
database_api.verify_authority
Returns true if the transaction has all of the required signatures.
Query Parameters JSON:
{"trx":{"ref_block_num":0,"ref_block_prefix":0,"expiration":"1970-01-01T00:00:00","operations":[],"extensions":[],"signatures":[]}}
Expected Response JSON:
{"valid":false}
Example curl:
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.verify_authority", "params":{"trx":{"ref_block_num":1097,"ref_block_prefix":2181793527,"expiration":"2016-03-24T18:00:21","operations":[["pow",{"worker_account":"cloop3","block_id":"00000449f7860b82b4fbe2f317c670e9f01d6d9a","nonce":3899,"work":{"worker":"STM7P5TDnA87Pj9T4mf6YHrhzjC1KbPZpNxLWCcVcHxNYXakpoT4F","input":"ae8e7c677119d22385f8c48026fee7aad7bba693bf788d7f27047f40b47738c0","signature":"1f38fe9a3f9989f84bd94aa5bbc88beaf09b67f825aa4450cf5105d111149ba6db560b582c7dbb026c7fc9c2eb5051815a72b17f6896ed59d3851d9a0f9883ca7a","work":"000e7b209d58f2e64b36e9bf12b999c6c7af168cc3fc41eb7f8a4bf796c174c3"},"props":{"account_creation_fee":["100000",3,"@@000000021"],"maximum_block_size":131072,"sbd_interest_rate":1000}}]],"extensions":[],"signatures":[]}}, "id":1}' https://api.steemit.com
database_api.verify_signatures
This is a general purpose API that checks signatures against accounts for an arbitrary sha256 hash using the existing authority structures.
Query Parameters JSON:
{"hash":"0000000000000000000000000000000000000000000000000000000000000000","signatures":[],"required_owner":[],"required_active":[],"required_posting":[],"required_other":[]}
Expected Response JSON:
{"valid":false}
Follow Api
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.
Query Parameters JSON:
{"account_lower_bound":"","limit":1000}
Expected Response JSON:
{"reputations":[]}
Example curl:
curl -s --data '{"jsonrpc":"2.0", "method":"follow_api.get_account_reputations", "params":{"account_lower_bound":"steemit", "limit":1}, "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"follow_api.get_account_reputations", "params":{"account_lower_bound":"a", "limit":10}, "id":1}' https://api.steemit.com
follow_api.get_blog
Returns the list of blog entries for an account.
Query Parameters JSON:
{"account":"","start_entry_id":0,"limit":500}
Expected Response JSON:
{"blog":[]}
Example curl:
curl -s --data '{"jsonrpc":"2.0", "method":"follow_api.get_blog", "params":{"account":"steemit","start_entry_id":0,"limit":1}, "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"follow_api.get_blog", "params":{"account":"alice","start_entry_id":0,"limit":50}, "id":1}' https://api.steemit.com
follow_api.get_blog_authors
Returns a list of authors that have had their content reblogged on a given blog account.
Query Parameters JSON:
{"blog_account":""}
Expected Response JSON:
{"blog_authors":[]}
Example curl:
curl -s --data '{"jsonrpc":"2.0", "method":"follow_api.get_blog_authors", "params":{"blog_account":"steemit"}, "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"follow_api.get_blog_authors", "params":{"blog_account":"alice"}, "id":1}' https://api.steemit.com
follow_api.get_blog_entries
Returns a list of blog entries for an account.
Query Parameters JSON:
{"account":"","start_entry_id":0,"limit":500}
Expected Response JSON:
{"blog":[]}
Example curl:
curl -s --data '{"jsonrpc":"2.0", "method":"follow_api.get_blog_entries", "params":{"account":"steemit","start_entry_id":0,"limit":1}, "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"follow_api.get_blog_entries", "params":{"account":"alice","start_entry_id":0,"limit":50}, "id":1}' https://api.steemit.com
follow_api.get_feed
Returns a list of items in an account’s feed.
Query Parameters JSON:
{"account":"","start_entry_id":0,"limit":500}
Expected Response JSON:
{"feed":[]}
Example curl:
curl -s --data '{"jsonrpc":"2.0", "method":"follow_api.get_feed", "params":{"account":"steemit","start_entry_id":0,"limit":1}, "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"follow_api.get_feed", "params":{"account":"alice","start_entry_id":1,"limit":10}, "id":1}' https://api.steemit.com
follow_api.get_feed_entries
Returns a list of entries in an account’s feed.
Query Parameters JSON:
{"account":"","start_entry_id":0,"limit":500}
Expected Response JSON:
{"feed":[]}
Example curl:
curl -s --data '{"jsonrpc":"2.0", "method":"follow_api.get_feed_entries", "params":{"account":"steemit","start_entry_id":0,"limit":1}, "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"follow_api.get_feed_entries", "params":{"account":"alice","start_entry_id":1,"limit":10}, "id":1}' https://api.steemit.com
follow_api.get_follow_count
Returns the count of followers for an account.
Query Parameters JSON:
{"account":""}
Expected Response JSON:
{"account":"","follower_count":0,"following_count":0}
Example curl:
curl -s --data '{"jsonrpc":"2.0", "method":"follow_api.get_follow_count", "params":{"account":"steemit"}, "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"follow_api.get_follow_count", "params":{"account":"alice"}, "id":1}' https://api.steemit.com
follow_api.get_followers
Returns the list of followers for an account.
Query Parameters JSON:
{"account":"","start":"","type":"undefined","limit":1000}
Expected Response JSON:
{"followers":[]}
Example curl:
curl -s --data '{"jsonrpc":"2.0", "method":"follow_api.get_followers", "params":{"account":"steemit","start":null,"type":"blog","limit":10}, "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"follow_api.get_followers", "params":{"account":"alice","start":null,"type":"ignore","limit":100}, "id":1}' https://api.steemit.com
follow_api.get_following
Returns the list of accounts that are following an account.
Query Parameters JSON:
{"account":"","start":"","type":"undefined","limit":1000}
Expected Response JSON:
{"following":[]}
Example curl:
curl -s --data '{"jsonrpc":"2.0", "method":"follow_api.get_following", "params":{"account":"steemit","start":null,"type":"blog","limit":10}, "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"follow_api.get_following", "params":{"account":"alice","start":null,"type":"ignore","limit":100}, "id":1}' https://api.steemit.com
follow_api.get_reblogged_by
Returns a list of authors that have reblogged a post.
Query Parameters JSON:
{"author":"","permlink":""}
Expected Response JSON:
{"accounts":[]}
Example curl:
curl -s --data '{"jsonrpc":"2.0", "method":"follow_api.get_reblogged_by", "params":{"author":"steemit","permlink":"firstpost"}, "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"follow_api.get_reblogged_by", "params":{"author":"alice","permlink":"a-post-by-alice"}, "id":1}' https://api.steemit.com
Jsonrpc
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:
{}
Example curl:
curl -s --data '{"jsonrpc":"2.0", "method":"jsonrpc.get_methods", "id":1}' https://api.steemit.com
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":null,"ret":null}
Example curl:
curl -s --data '{"jsonrpc":"2.0", "method":"jsonrpc.get_signature", "params":{"method":"jsonrpc.get_methods"}, "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"jsonrpc.get_signature", "params":{"method":"jsonrpc.get_signature"}, "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"jsonrpc.get_signature", "params":{"method":"condenser_api.get_dynamic_global_properties"}, "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"jsonrpc.get_signature", "params":{"method":"database_api.get_dynamic_global_properties"}, "id":1}' https://api.steemit.com
Market History Api
Used to lookup market history information. These AppBase API methods are still under development and subject to change.
market_history_api.get_market_history
Returns the market history for the internal SBD:STEEM market.
Query Parameters JSON:
{"bucket_seconds":0,"start":"1970-01-01T00:00:00","end":"1970-01-01T00:00:00"}
Expected Response JSON:
{"buckets":[]}
Example curl:
curl -s --data '{"jsonrpc":"2.0", "method":"market_history_api.get_market_history", "params":{"bucket_seconds":15,"start":"2018-01-01T00:00:00","end":"2018-01-02T00:00:00"}, "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"market_history_api.get_market_history", "params":{"bucket_seconds":60,"start":"2018-01-01T00:00:00","end":"2018-01-02T00:00:00"}, "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"market_history_api.get_market_history", "params":{"bucket_seconds":300,"start":"2018-01-01T00:00:00","end":"2018-01-02T00:00:00"}, "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"market_history_api.get_market_history", "params":{"bucket_seconds":3600,"start":"2018-01-01T00:00:00","end":"2018-01-02T00:00:00"}, "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"market_history_api.get_market_history", "params":{"bucket_seconds":86400,"start":"2018-01-01T00:00:00","end":"2018-01-02T00:00:00"}, "id":1}' https://api.steemit.com
market_history_api.get_market_history_buckets
Returns the bucket seconds being tracked by the plugin.
Query Parameters JSON:
{}
Expected Response JSON:
{"bucket_sizes":[]}
Example curl:
curl -s --data '{"jsonrpc":"2.0", "method":"market_history_api.get_market_history_buckets", "id":1}' https://api.steemit.com
market_history_api.get_order_book
Returns the internal market order book.
Query Parameters JSON:
{"limit":500}
Expected Response JSON:
{"bids":[],"asks":[]}
Example curl:
curl -s --data '{"jsonrpc":"2.0", "method":"market_history_api.get_order_book", "params":{"limit":10}, "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"market_history_api.get_order_book", "params":{"limit":50}, "id":1}' https://api.steemit.com
market_history_api.get_recent_trades
Returns the most recent trades for the internal SBD:STEEM market.
Query Parameters JSON:
{"limit":1000}
Expected Response JSON:
{"trades":[]}
Example curl:
curl -s --data '{"jsonrpc":"2.0", "method":"market_history_api.get_recent_trades", "params":{"limit":10}, "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"market_history_api.get_recent_trades", "params":{"limit":500}, "id":1}' https://api.steemit.com
market_history_api.get_ticker
Returns the market ticker for the internal SBD:STEEM market.
Query Parameters JSON:
{}
Expected Response JSON:
{"latest":"0.00000000000000000","lowest_ask":"0.00000000000000000","highest_bid":"0.00000000000000000","percent_change":"0.00000000000000000","steem_volume":["0",3,"@@000000021"],"sbd_volume":["0",3,"@@000000013"]}
Example curl:
curl -s --data '{"jsonrpc":"2.0", "method":"market_history_api.get_ticker", "id":1}' https://api.steemit.com
market_history_api.get_trade_history
Returns the trade history for the internal SBD:STEEM market.
Query Parameters JSON:
{"start":"1970-01-01T00:00:00","end":"1970-01-01T00:00:00","limit":1000}
Expected Response JSON:
{"trades":[]}
Example curl:
curl -s --data '{"jsonrpc":"2.0", "method":"market_history_api.get_trade_history", "params":{"start":"2018-01-01T00:00:00","end":"2018-01-02T00:00:00","limit":10}, "id":1}' https://api.steemit.com
market_history_api.get_volume
Returns the market volume for the past 24 hours.
Query Parameters JSON:
{}
Expected Response JSON:
{"steem_volume":["0",3,"@@000000021"],"sbd_volume":["0",3,"@@000000013"]}
Example curl:
curl -s --data '{"jsonrpc":"2.0", "method":"market_history_api.get_volume", "id":1}' https://api.steemit.com
Network Broadcast Api
Used to broadcast transactions and blocks. These AppBase API methods are still under development and subject to change.
network_broadcast_api.broadcast_block
Used to broadcast a block.
Query Parameters JSON:
{"block":{"previous":"0000000000000000000000000000000000000000","timestamp":"1970-01-01T00:00:00","witness":"","transaction_merkle_root":"0000000000000000000000000000000000000000","extensions":[],"witness_signature":"0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000","transactions":[]}}
Expected Response JSON:
{}
Example curl:
curl -s --data '{"jsonrpc":"2.0", "method":"network_broadcast_api.broadcast_block", "params":{"block":{"previous":"0000000000000000000000000000000000000000","timestamp":"1970-01-01T00:00:00","witness":"","transaction_merkle_root":"0000000000000000000000000000000000000000","extensions":[],"witness_signature":"0000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000","transactions":[]}}, "id":1}' https://api.steemit.com
network_broadcast_api.broadcast_transaction
Used to broadcast a transaction.
Query Parameters JSON:
{"trx":{"ref_block_num":0,"ref_block_prefix":0,"expiration":"1970-01-01T00:00:00","operations":[],"extensions":[],"signatures":[]},"max_block_age":-1}
Expected Response JSON:
{}
Example curl:
curl -s --data '{"jsonrpc":"2.0", "method":"network_broadcast_api.broadcast_transaction", "params":{"trx":{"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":["100000",3,"@@000000021"],"maximum_block_size":131072,"sbd_interest_rate":1000}}]],"extensions":[],"signatures":[]}}, "id":1}' https://api.steemit.com
network_broadcast_api.broadcast_transaction_synchronous
Used to broadcast a transaction and waits for it to be processed synchronously.
Query Parameters JSON:
{"trx":{"ref_block_num":0,"ref_block_prefix":0,"expiration":"1970-01-01T00:00:00","operations":[],"extensions":[],"signatures":[]},"max_block_age":-1}
Expected Response JSON:
{"id":"0000000000000000000000000000000000000000","block_num":0,"trx_num":0,"expired":false}
Example curl:
curl -s --data '{"jsonrpc":"2.0", "method":"network_broadcast_api.broadcast_transaction_synchronous", "params":{"trx":{"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":["100000",3,"@@000000021"],"maximum_block_size":131072,"sbd_interest_rate":1000}}]],"extensions":[],"signatures":[]}}, "id":1}' https://api.steemit.com
Witness Api
Used to query values related to the witness plugin. These AppBase API methods are still under development and subject to change.
witness_api.get_account_bandwidth
Returns the available bandwidth of an account.
Query Parameters JSON:
{"account":"","type":"post"}
Expected Response JSON:
{}
witness_api.get_reserve_ratio
Returns the current reserve ratio.
Query Parameters JSON:
{}
Expected Response JSON:
{"id":0,"average_block_size":0,"current_reserve_ratio":1,"max_virtual_bandwidth":"0"}
Example curl:
curl -s --data '{"jsonrpc":"2.0", "method":"witness_api.get_account_bandwidth", "params":{"account":"steemit","type":"forum"}, "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"witness_api.get_account_bandwidth", "params":{"account":"alice","type":"market"}, "id":1}' https://api.steemit.com
Block Api
Used to query values related to the block plugin. These AppBase API methods are still under development and subject to change.
block_api.get_block
Retrieve a full, signed block of the referenced block, or null if no matching block was found.
Parameters:
block_num:int
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"=>"", "timestamp"=>"1970-01-01T00:00:00", "witness"=>"", "transaction_merkle_root"=>"", "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.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"block_api.get_block", "params":{"block_num":8675309}, "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"block_api.get_block", "params":{"block_num":62396745}, "id":1}' https://api.steemit.com
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"=>"", "timestamp"=>"1970-01-01T00:00:00", "witness"=>"", "transaction_merkle_root"=>"", "extensions"=>[]}}
Example curl:
curl -s --data '{"jsonrpc":"2.0", "method":"block_api.get_block_header", "params":{"block_num":1}, "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"block_api.get_block_header", "params":{"block_num":8675309}, "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"block_api.get_block_header", "params":{"block_num":62396745}, "id":1}' https://api.steemit.com