Steem Developer Portal

Methods:
Used to query information about accounts, transactions, and blockchain data.
To enable this API for steemd
, the following is required in config.ini
by specifying:
plugin = database_api
These AppBase API methods are still under development and subject to change.
- Since: HF11
- Related
database_api.find_account_recovery_requests
Returns a list of account recovery requests. Parameters: account:string
account (string) |
|
---|---|
"steemit" |
Queries the recovery requests for account named “steemit”. |
Query Parameters JSON
{"accounts": []}
Expected Response JSON
{"requests": []}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.find_account_recovery_requests", "params": {"accounts":["steemit"]}, "id":1}' https://api.steemit.com
database_api.find_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
{"accounts": []}
Expected Response JSON
{
"accounts": [
{
"id": 28,
"name": "steemit",
"owner": {
"weight_threshold": 1,
"account_auths": [],
"key_auths": [
[
"STM6Ezkzey8FWoEnnHHP4rxbrysJqoMmzwR2EdoD5p7FDsF64qxbQ",
1
],
[
"STM7TCZKisQnvR69CK9BaL6W4SJn2cXYwkfWYRicoVGGzhtFswxMH",
1
]
]
},
"active": {
"weight_threshold": 1,
"account_auths": [],
"key_auths": [
[
"STM5VkLha96X5EQu3HSkJdD8SEuwazWtZrzLjUT6Sc5sopgghBYrz",
1
],
[
"STM7u1BsoqLaoCu9XHi1wjWctLWSFCuvyagFjYMfga4QNWEjP7d3U",
1
]
]
},
"posting": {
"weight_threshold": 1,
"account_auths": [],
"key_auths": [
[
"STM6kXdRbWgoH9E4hvtTZeaiSbY8FmGXQavfJZ2jzkKjT5cWYgMBS",
1
],
[
"STM6tDMSSKa8Bd9ss7EjqhXPEHTWissGXJJosAU94LLpC5tsCdo61",
1
]
]
},
"memo_key": "STM5jZtLoV8YbxCxr4imnbWn61zMB24wwonpnVhfXRmv7j6fk3dTH",
"json_metadata": "",
"proxy": "",
"last_owner_update": "2018-05-31T23:32:06",
"last_account_update": "2018-05-31T23:32:06",
"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_manabar": {
"current_mana": "69835912701503862",
"last_update_time": 1538171805
},
"balance": {
"amount": "2806644634",
"precision": 3,
"nai": "@@000000021"
},
"savings_balance": {
"amount": "0",
"precision": 3,
"nai": "@@000000021"
},
"sbd_balance": {
"amount": "8716535",
"precision": 3,
"nai": "@@000000013"
},
"sbd_seconds": "0",
"sbd_seconds_last_update": "2018-11-12T02:39:39",
"sbd_last_interest_payment": "2018-11-12T02:39:39",
"savings_sbd_balance": {
"amount": "0",
"precision": 3,
"nai": "@@000000013"
},
"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": {
"amount": "0",
"precision": 3,
"nai": "@@000000013"
},
"reward_steem_balance": {
"amount": "0",
"precision": 3,
"nai": "@@000000021"
},
"reward_vesting_balance": {
"amount": "0",
"precision": 6,
"nai": "@@000000037"
},
"reward_vesting_steem": {
"amount": "0",
"precision": 3,
"nai": "@@000000021"
},
"vesting_shares": {
"amount": "90039851836689703",
"precision": 6,
"nai": "@@000000037"
},
"delegated_vesting_shares": {
"amount": "20203939135185841",
"precision": 6,
"nai": "@@000000037"
},
"received_vesting_shares": {
"amount": "0",
"precision": 6,
"nai": "@@000000037"
},
"vesting_withdraw_rate": {
"amount": "0",
"precision": 6,
"nai": "@@000000037"
},
"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": ["14953279511", 0, 0, 0],
"witnesses_voted_for": 0,
"last_post": "2016-03-30T18:30:18",
"last_root_post": "2016-03-30T18:30:18",
"last_vote_time": "2016-12-04T23:10:57",
"post_bandwidth": 0,
"pending_claimed_accounts": 0,
"is_smt": false
}
]
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.find_accounts", "params": {"accounts":["steemit"]}, "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.find_accounts", "params": {"accounts":["steemit", "alice"]}, "id":1}' https://api.steemit.com
- Since: HF11
- Related
database_api.find_change_recovery_account_requests
Returns a list of requests to change the recovery account. Parameters: account:array
account (array) |
|
---|---|
["steemit"] |
Queries the recovery requests for account named “steemit”. |
Query Parameters JSON
{"accounts": []}
Expected Response JSON
{"requests": []}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.find_change_recovery_account_requests", "params": {"accounts":["steemit"]}, "id":1}' https://api.steemit.com
database_api.find_comments
Search for comments.
Query Parameters JSON
{"start": [["", ""]], "limit": 0, "order": ""}
Expected Response JSON
{"comments": []}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.find_comments", "params": {"start":[["temp","test1"],["temp","foobar"]], "limit":10, "order":"by_account"}, "id":1}' https://api.steemit.com
- Since: HF14
- Related
database_api.find_decline_voting_rights_requests
Returns a list of requests to decline voting rights.
Query Parameters JSON
{"accounts": []}
Expected Response JSON
{"requests": []}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.find_decline_voting_rights_requests", "params": {"accounts":["temp","null"]}, "id":1}' https://api.steemit.com
- Since: HF14
- Related
database_api.find_escrows
Returns a list of escrows.
Query Parameters JSON
{"from": ""}
Expected Response JSON
{
"escrows": [
{
"id": 143,
"escrow_id": 12345,
"from": "temp",
"to": "guest123",
"agent": "smitop",
"ratification_deadline": "2038-01-19T03:14:06",
"escrow_expiration": "2038-01-19T03:14:07",
"sbd_balance": {
"amount": "0",
"precision": 3,
"nai": "@@000000013"
},
"steem_balance": {
"amount": "1",
"precision": 3,
"nai": "@@000000021"
},
"pending_fee": {
"amount": "1",
"precision": 3,
"nai": "@@000000021"
},
"to_approved": false,
"agent_approved": false,
"disputed": false
}
]
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.find_escrows", "params": {"from": "temp"}, "id":1}' https://api.steemit.com
database_api.find_limit_orders
Returns a list of limit orders.
Query Parameters JSON
{"account": ""}
Expected Response JSON
{"orders": []}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.find_limit_orders", "params": {"account":"temp"}, "id":1}' https://api.steemit.com
database_api.find_owner_histories
Returns owner authority history. Parameters: owner:string
owner (string) |
|
---|---|
"steemit" |
Queries the owner history for account named “steemit”. |
"alice" |
Queries the owner history for account named “alice”. |
Query Parameters JSON
{"owner": ""}
Expected Response JSON
{"owner_auths": []}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.find_owner_histories", "params": {"owner":"steemit"}, "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.find_owner_histories", "params": {"owner":"alice"}, "id":1}' https://api.steemit.com
- Since: HF14
- Related
database_api.find_savings_withdrawals
Returns the list of savings withdrawls for an account. Parameters: account:string
account (string) |
|
---|---|
"steemit" |
Queries the savings withdraw for account named “steemit”. |
Query Parameters JSON
{"account": ""}
Expected Response JSON
{"withdrawals": []}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.find_savings_withdrawals", "params": {"start":"temp"}, "id":1}' https://api.steemit.com
database_api.find_sbd_conversion_requests
Returns the list of SBD conversion requests for an account. Parameters: account:string
account (string) |
|
---|---|
"steemit" |
Queries a conversion request for steemit. |
"alice" |
Queries a conversion request for alice. |
Query Parameters JSON
{"account": ""}
Expected Response JSON
{"requests": []}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.find_sbd_conversion_requests", "params": {"account":"steemit"}, "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.find_sbd_conversion_requests", "params": {"account":"alice"}, "id":1}' https://api.steemit.com
- Since: HF17
- Related
database_api.find_vesting_delegation_expirations
Returns the expiring vesting delegations for an account. Parameters: account:string
account (string) |
||
---|---|---|
"steemit" |
Queries for expiring vesting for steemit . |
|
"alice" |
Queries for expiring vesting for alice . |
Query Parameters JSON
{"account": ""}
Expected Response JSON
{
"delegations": [
{
"id": 3077902,
"delegator": "steem",
"vesting_shares": {
"amount": "201417615",
"precision": 6,
"nai": "@@000000037"
},
"expiration": "2018-12-05T21:46:48"
}
]
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.find_vesting_delegation_expirations", "params": {"account":"steemit"}, "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.find_vesting_delegation_expirations", "params": {"account":"alice"}, "id":1}' https://api.steemit.com
- Since: HF17
- Related
database_api.find_vesting_delegations
Returns the list of vesting delegations for an account. Parameters: account:string
account (string) |
||
---|---|---|
"steemit" |
Queries for vesting for steemit . |
|
"alice" |
Queries for vesting for alice . |
Query Parameters JSON
{"account": ""}
Expected Response JSON
{"delegations": []}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.find_vesting_delegations", "params": {"account":"steemit"}, "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.find_vesting_delegations", "params": {"account":"alice"}, "id":1}' https://api.steemit.com
database_api.find_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
{"author": "", "permlink": ""}
Expected Response JSON
{
"votes": [
{
"id": 546191,
"voter": "anonymous",
"author": "temp",
"permlink": "test1",
"weight": "1799071158042053295",
"rshares": "432321664017",
"vote_percent": 10000,
"last_update": "2016-07-18T09:25:51",
"num_changes": -1
},
{
"id": 546192,
"voter": "xeroc",
"author": "temp",
"permlink": "test1",
"weight": "1763636725870082814",
"rshares": "525258058869",
"vote_percent": 10000,
"last_update": "2016-07-18T09:25:54",
"num_changes": -1
}
]
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.find_votes", "params": {"author":"steemit", "permlink":"firstpost"}, "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.find_votes", "params": {"author":"alice", "permlink":"a-post-by-alice"}, "id":1}' https://api.steemit.com
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": []}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.find_withdraw_vesting_routes", "params": {"account":"temp", "order":"by_destination"}, "id":1}' https://api.steemit.com
database_api.find_witnesses
Search for witnesses.
Query Parameters JSON
{"owners": []}
Expected Response JSON
{
"witnesses": [
{
"id": 0,
"owner": "initminer",
"created": "1970-01-01T00:00:00",
"url": "",
"votes": 0,
"virtual_last_update": "225400650183277777230188182",
"virtual_position": "28933178228158941342755574680549120",
"virtual_scheduled_time": "340253433742935705172215129634317850517",
"total_missed": 88,
"last_aslot": 1202,
"last_confirmed_block_num": 1092,
"pow_worker": 0,
"signing_key": "STM8GC13uCZbP44HzMLV6zPZGwVQ8Nt4Kji8PapsPiNq1BK153XTX",
"props": {
"account_creation_fee": {
"amount": "1",
"precision": 3,
"nai": "@@000000021"
},
"maximum_block_size": 131072,
"sbd_interest_rate": 1000,
"account_subsidy_budget": 797,
"account_subsidy_decay": 347321
},
"sbd_exchange_rate": {
"base": {
"amount": "0",
"precision": 3,
"nai": "@@000000021"
},
"quote": {
"amount": "0",
"precision": 3,
"nai": "@@000000021"
}
},
"last_sbd_exchange_update": "1970-01-01T00:00:00",
"last_work": "0000000000000000000000000000000000000000000000000000000000000000",
"running_version": "0.0.0",
"hardfork_version_vote": "0.0.0",
"hardfork_time_vote": "2016-03-24T16:00:00",
"available_witness_account_subsidies": 0
}
]
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.find_witnesses", "params": {"owners":["initminer"]}, "id":1}' https://api.steemit.com
database_api.get_active_witnesses
Returns the list of active witnesses.
Query Parameters JSON
{}
Expected Response JSON
{
"witnesses": [
"lukestokes.mhth",
"gtg",
"ausbitbank",
"clayop",
"yabapmatt",
"curie",
"thecryptodrive",
"roelandp",
"followbtcnews",
"timcliff",
"smooth.witness",
"bhuz",
"aggroed",
"blocktrades",
"cervantes",
"utopian-io",
"anyx",
"jesta",
"drakos",
"someguy123",
"good-karma"
]
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.get_active_witnesses", "id":1}' https://api.steemit.com
database_api.get_config
Returns information about compile-time constants. Some properties may not be present. See: Understanding Configuration Values
Query Parameters JSON
{}
Expected Response JSON
{
"IS_TEST_NET": false,
"STEEM_ENABLE_SMT": false,
"SBD_SYMBOL": null,
"STEEM_INITIAL_VOTE_POWER_RATE": 40,
"STEEM_REDUCED_VOTE_POWER_RATE": 10,
"STEEM_100_PERCENT": 10000,
"STEEM_1_PERCENT": 100,
"STEEM_ACCOUNT_RECOVERY_REQUEST_EXPIRATION_PERIOD": "86400000000",
"STEEM_ACTIVE_CHALLENGE_COOLDOWN": "86400000000",
"STEEM_ACTIVE_CHALLENGE_FEE": {
"amount": "2000",
"precision": 3,
"nai": "@@000000021"
},
"STEEM_ADDRESS_PREFIX": "STM",
"STEEM_APR_PERCENT_MULTIPLY_PER_BLOCK": "102035135585887",
"STEEM_APR_PERCENT_MULTIPLY_PER_HOUR": "119577151364285",
"STEEM_APR_PERCENT_MULTIPLY_PER_ROUND": "133921203762304",
"STEEM_APR_PERCENT_SHIFT_PER_BLOCK": 87,
"STEEM_APR_PERCENT_SHIFT_PER_HOUR": 77,
"STEEM_APR_PERCENT_SHIFT_PER_ROUND": 83,
"STEEM_BANDWIDTH_AVERAGE_WINDOW_SECONDS": 604800,
"STEEM_BANDWIDTH_PRECISION": 1000000,
"STEEM_BLOCKCHAIN_PRECISION": 1000,
"STEEM_BLOCKCHAIN_PRECISION_DIGITS": 3,
"STEEM_BLOCKCHAIN_HARDFORK_VERSION": "0.20.0",
"STEEM_BLOCKCHAIN_VERSION": "0.20.6",
"STEEM_BLOCK_INTERVAL": 3,
"STEEM_BLOCKS_PER_DAY": 28800,
"STEEM_BLOCKS_PER_HOUR": 1200,
"STEEM_BLOCKS_PER_YEAR": 10512000,
"STEEM_CASHOUT_WINDOW_SECONDS": 604800,
"STEEM_CASHOUT_WINDOW_SECONDS_PRE_HF12": 86400,
"STEEM_CASHOUT_WINDOW_SECONDS_PRE_HF17": 43200,
"STEEM_CHAIN_ID": "0000000000000000000000000000000000000000000000000000000000000000",
"STEEM_COMMENT_REWARD_FUND_NAME": "comment",
"STEEM_CONTENT_APR_PERCENT": 3875,
"STEEM_CONTENT_CONSTANT_HF0": "2000000000000",
"STEEM_CONTENT_REWARD_PERCENT": 7500,
"STEEM_CONVERSION_DELAY": "302400000000",
"STEEM_CONVERSION_DELAY_PRE_HF_16": "604800000000",
"STEEM_CREATE_ACCOUNT_DELEGATION_RATIO": 5,
"STEEM_CREATE_ACCOUNT_DELEGATION_TIME": "2592000000000",
"STEEM_CREATE_ACCOUNT_WITH_STEEM_MODIFIER": 30,
"STEEM_CURATE_APR_PERCENT": 3875,
"STEEM_DEFAULT_SBD_INTEREST_RATE": 1000,
"STEEM_EQUIHASH_K": 6,
"STEEM_EQUIHASH_N": 140,
"STEEM_FEED_HISTORY_WINDOW": 84,
"STEEM_FEED_HISTORY_WINDOW_PRE_HF_16": 168,
"STEEM_FEED_INTERVAL_BLOCKS": 1200,
"STEEM_GENESIS_TIME": "2016-03-24T16:00:00",
"STEEM_HARDFORK_REQUIRED_WITNESSES": 17,
"STEEM_INFLATION_NARROWING_PERIOD": 250000,
"STEEM_INFLATION_RATE_START_PERCENT": 978,
"STEEM_INFLATION_RATE_STOP_PERCENT": 95,
"STEEM_INIT_MINER_NAME": "initminer",
"STEEM_INIT_PUBLIC_KEY_STR": "STM8GC13uCZbP44HzMLV6zPZGwVQ8Nt4Kji8PapsPiNq1BK153XTX",
"STEEM_INIT_SUPPLY": 0,
"STEEM_INIT_TIME": "1970-01-01T00:00:00",
"STEEM_IRREVERSIBLE_THRESHOLD": 7500,
"STEEM_LIQUIDITY_APR_PERCENT": 750,
"STEEM_LIQUIDITY_REWARD_BLOCKS": 1200,
"STEEM_LIQUIDITY_REWARD_PERIOD_SEC": 3600,
"STEEM_LIQUIDITY_TIMEOUT_SEC": "604800000000",
"STEEM_MAX_ACCOUNT_CREATION_FEE": 1000000000,
"STEEM_MAX_ACCOUNT_NAME_LENGTH": 16,
"STEEM_MAX_ACCOUNT_WITNESS_VOTES": 30,
"STEEM_MAX_ASSET_WHITELIST_AUTHORITIES": 10,
"STEEM_MAX_AUTHORITY_MEMBERSHIP": 40,
"STEEM_MAX_BLOCK_SIZE": 393216000,
"STEEM_SOFT_MAX_BLOCK_SIZE": 2097152,
"STEEM_MAX_CASHOUT_WINDOW_SECONDS": 1209600,
"STEEM_MAX_COMMENT_DEPTH": 65535,
"STEEM_MAX_COMMENT_DEPTH_PRE_HF17": 6,
"STEEM_MAX_FEED_AGE_SECONDS": 604800,
"STEEM_MAX_INSTANCE_ID": "281474976710655",
"STEEM_MAX_MEMO_SIZE": 2048,
"STEEM_MAX_WITNESSES": 21,
"STEEM_MAX_MINER_WITNESSES_HF0": 1,
"STEEM_MAX_MINER_WITNESSES_HF17": 0,
"STEEM_MAX_PERMLINK_LENGTH": 256,
"STEEM_MAX_PROXY_RECURSION_DEPTH": 4,
"STEEM_MAX_RATION_DECAY_RATE": 1000000,
"STEEM_MAX_RESERVE_RATIO": 20000,
"STEEM_MAX_RUNNER_WITNESSES_HF0": 1,
"STEEM_MAX_RUNNER_WITNESSES_HF17": 1,
"STEEM_MAX_SATOSHIS": "4611686018427387903",
"STEEM_MAX_SHARE_SUPPLY": "1000000000000000",
"STEEM_MAX_SIG_CHECK_DEPTH": 2,
"STEEM_MAX_SIG_CHECK_ACCOUNTS": 125,
"STEEM_MAX_TIME_UNTIL_EXPIRATION": 3600,
"STEEM_MAX_TRANSACTION_SIZE": 65536,
"STEEM_MAX_UNDO_HISTORY": 10000,
"STEEM_MAX_URL_LENGTH": 127,
"STEEM_MAX_VOTE_CHANGES": 5,
"STEEM_MAX_VOTED_WITNESSES_HF0": 19,
"STEEM_MAX_VOTED_WITNESSES_HF17": 20,
"STEEM_MAX_WITHDRAW_ROUTES": 10,
"STEEM_MAX_WITNESS_URL_LENGTH": 2048,
"STEEM_MIN_ACCOUNT_CREATION_FEE": 1,
"STEEM_MIN_ACCOUNT_NAME_LENGTH": 3,
"STEEM_MIN_BLOCK_SIZE_LIMIT": 65536,
"STEEM_MIN_BLOCK_SIZE": 115,
"STEEM_MIN_CONTENT_REWARD": {
"amount": "1000",
"precision": 3,
"nai": "@@000000021"
},
"STEEM_MIN_CURATE_REWARD": {
"amount": "1000",
"precision": 3,
"nai": "@@000000021"
},
"STEEM_MIN_PERMLINK_LENGTH": 0,
"STEEM_MIN_REPLY_INTERVAL": 20000000,
"STEEM_MIN_REPLY_INTERVAL_HF20": 3000000,
"STEEM_MIN_ROOT_COMMENT_INTERVAL": 300000000,
"STEEM_MIN_VOTE_INTERVAL_SEC": 3,
"STEEM_MINER_ACCOUNT": "miners",
"STEEM_MINER_PAY_PERCENT": 100,
"STEEM_MIN_FEEDS": 7,
"STEEM_MINING_REWARD": {
"amount": "1000",
"precision": 3,
"nai": "@@000000021"
},
"STEEM_MINING_TIME": "2016-03-24T17:00:00",
"STEEM_MIN_LIQUIDITY_REWARD": {
"amount": "1200000",
"precision": 3,
"nai": "@@000000021"
},
"STEEM_MIN_LIQUIDITY_REWARD_PERIOD_SEC": 60000000,
"STEEM_MIN_PAYOUT_SBD": {
"amount": "20",
"precision": 3,
"nai": "@@000000013"
},
"STEEM_MIN_POW_REWARD": {
"amount": "1000",
"precision": 3,
"nai": "@@000000021"
},
"STEEM_MIN_PRODUCER_REWARD": {
"amount": "1000",
"precision": 3,
"nai": "@@000000021"
},
"STEEM_MIN_TRANSACTION_EXPIRATION_LIMIT": 15,
"STEEM_MIN_TRANSACTION_SIZE_LIMIT": 1024,
"STEEM_MIN_UNDO_HISTORY": 10,
"STEEM_NULL_ACCOUNT": "null",
"STEEM_NUM_INIT_MINERS": 1,
"STEEM_OWNER_AUTH_HISTORY_TRACKING_START_BLOCK_NUM": 3186477,
"STEEM_OWNER_AUTH_RECOVERY_PERIOD": "2592000000000",
"STEEM_OWNER_CHALLENGE_COOLDOWN": "86400000000",
"STEEM_OWNER_CHALLENGE_FEE": {
"amount": "30000",
"precision": 3,
"nai": "@@000000021"
},
"STEEM_OWNER_UPDATE_LIMIT": 3600000000,
"STEEM_POST_AVERAGE_WINDOW": 86400,
"STEEM_POST_REWARD_FUND_NAME": "post",
"STEEM_POST_WEIGHT_CONSTANT": 1600000000,
"STEEM_POW_APR_PERCENT": 750,
"STEEM_PRODUCER_APR_PERCENT": 750,
"STEEM_PROXY_TO_SELF_ACCOUNT": "",
"STEEM_SBD_INTEREST_COMPOUND_INTERVAL_SEC": 2592000,
"STEEM_SECONDS_PER_YEAR": 31536000,
"STEEM_RECENT_RSHARES_DECAY_TIME_HF19": "1296000000000",
"STEEM_RECENT_RSHARES_DECAY_TIME_HF17": "2592000000000",
"STEEM_REVERSE_AUCTION_WINDOW_SECONDS_HF6": 1800,
"STEEM_REVERSE_AUCTION_WINDOW_SECONDS_HF20": 900,
"STEEM_ROOT_POST_PARENT": "",
"STEEM_SAVINGS_WITHDRAW_REQUEST_LIMIT": 100,
"STEEM_SAVINGS_WITHDRAW_TIME": "259200000000",
"STEEM_SBD_START_PERCENT_HF14": 200,
"STEEM_SBD_START_PERCENT_HF20": 900,
"STEEM_SBD_STOP_PERCENT_HF14": 500,
"STEEM_SBD_STOP_PERCENT_HF20": 1000,
"STEEM_SECOND_CASHOUT_WINDOW": 2592000,
"STEEM_SOFT_MAX_COMMENT_DEPTH": 255,
"STEEM_START_MINER_VOTING_BLOCK": 864000,
"STEEM_START_VESTING_BLOCK": 201600,
"STEEM_TEMP_ACCOUNT": "temp",
"STEEM_UPVOTE_LOCKOUT_HF7": 60000000,
"STEEM_UPVOTE_LOCKOUT_HF17": "43200000000",
"STEEM_UPVOTE_LOCKOUT_SECONDS": 43200,
"STEEM_VESTING_FUND_PERCENT": 1500,
"STEEM_VESTING_WITHDRAW_INTERVALS": 13,
"STEEM_VESTING_WITHDRAW_INTERVALS_PRE_HF_16": 104,
"STEEM_VESTING_WITHDRAW_INTERVAL_SECONDS": 604800,
"STEEM_VOTE_DUST_THRESHOLD": 50000000,
"STEEM_VOTING_MANA_REGENERATION_SECONDS": 432000,
"STEEM_SYMBOL": null,
"VESTS_SYMBOL": null,
"STEEM_VIRTUAL_SCHEDULE_LAP_LENGTH": "18446744073709551615",
"STEEM_VIRTUAL_SCHEDULE_LAP_LENGTH2": "340282366920938463463374607431768211455",
"STEEM_MAX_LIMIT_ORDER_EXPIRATION": 2419200,
"STEEM_DELEGATION_RETURN_PERIOD_HF0": 604800,
"STEEM_DELEGATION_RETURN_PERIOD_HF20": 432000,
"STEEM_RD_MIN_DECAY_BITS": 6,
"STEEM_RD_MAX_DECAY_BITS": 32,
"STEEM_RD_DECAY_DENOM_SHIFT": 36,
"STEEM_RD_MAX_POOL_BITS": 64,
"STEEM_RD_MAX_BUDGET_1": "17179869183",
"STEEM_RD_MAX_BUDGET_2": 268435455,
"STEEM_RD_MAX_BUDGET_3": 2147483647,
"STEEM_RD_MAX_BUDGET": 268435455,
"STEEM_RD_MIN_DECAY": 64,
"STEEM_RD_MIN_BUDGET": 1,
"STEEM_RD_MAX_DECAY": 4294967295,
"STEEM_ACCOUNT_SUBSIDY_PRECISION": 10000,
"STEEM_WITNESS_SUBSIDY_BUDGET_PERCENT": 12500,
"STEEM_WITNESS_SUBSIDY_DECAY_PERCENT": 210000,
"STEEM_DEFAULT_ACCOUNT_SUBSIDY_DECAY": 347321,
"STEEM_DEFAULT_ACCOUNT_SUBSIDY_BUDGET": 797,
"STEEM_DECAY_BACKSTOP_PERCENT": 9000
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.get_config", "id":1}' https://api.steemit.com
database_api.get_current_price_feed
Returns the current price feed.
Query Parameters JSON
{}
Expected Response JSON
{
"base": {
"amount": "0",
"precision": 3,
"nai": "@@000000021"
},
"quote": {
"amount": "0",
"precision": 3,
"nai": "@@000000021"
}
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.get_current_price_feed", "id":1}' https://api.steemit.com
database_api.get_dynamic_global_properties
Returns the current dynamic global properties. See: Understanding Dynamic Global Properties
Query Parameters JSON
{}
Expected Response JSON
{
"id": 0,
"head_block_number": 0,
"head_block_id": "0000000000000000000000000000000000000000",
"time": "1970-01-01T00:00:00",
"current_witness": "",
"total_pow": "18446744073709551615",
"num_pow_witnesses": 0,
"virtual_supply": {
"amount": "0",
"precision": 3,
"nai": "@@000000021"
},
"current_supply": {
"amount": "0",
"precision": 3,
"nai": "@@000000021"
},
"confidential_supply": {
"amount": "0",
"precision": 3,
"nai": "@@000000021"
},
"init_sbd_supply": {
"amount": "0",
"precision": 3,
"nai": "@@000000013"
},
"current_sbd_supply": {
"amount": "0",
"precision": 3,
"nai": "@@000000013"
},
"confidential_sbd_supply": {
"amount": "0",
"precision": 3,
"nai": "@@000000013"
},
"total_vesting_fund_steem": {
"amount": "0",
"precision": 3,
"nai": "@@000000021"
},
"total_vesting_shares": {
"amount": "0",
"precision": 6,
"nai": "@@000000037"
},
"total_reward_fund_steem": {
"amount": "0",
"precision": 3,
"nai": "@@000000021"
},
"total_reward_shares2": "0",
"pending_rewarded_vesting_shares": {
"amount": "0",
"precision": 6,
"nai": "@@000000037"
},
"pending_rewarded_vesting_steem": {
"amount": "0",
"precision": 3,
"nai": "@@000000021"
},
"sbd_interest_rate": 0,
"sbd_print_rate": 10000,
"maximum_block_size": 0,
"required_actions_partition_percent": 0,
"current_aslot": 0,
"recent_slots_filled": "0",
"participation_count": 0,
"last_irreversible_block_num": 0,
"vote_power_reserve_rate": 40,
"delegation_return_period": 3600,
"reverse_auction_seconds": 0,
"available_account_subsidies": 0,
"sbd_stop_percent": 0,
"sbd_start_percent": 0,
"sbd_stop_adjust": 0,
"next_maintenance_time": "1970-01-01T00:00:00",
"last_budget_time": "1970-01-01T00:00:00",
"content_reward_percent": 7500,
"vesting_reward_percent": 1500,
"sps_fund_percent": 0,
"sps_interval_ledger": {
"amount": "0",
"precision": 3,
"nai": "@@000000013"
},
"downvote_pool_percent": 0,
"smt_creation_fee": {
"amount": "1000",
"precision": 3,
"nai": "@@000000013"
}
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.get_dynamic_global_properties", "id":1}' https://api.steemit.com
database_api.get_feed_history
Returns the history of price feed values.
Query Parameters JSON
{}
Expected Response JSON
{
"id": 0,
"current_median_history": {
"base": {
"amount": "0",
"precision": 3,
"nai": "@@000000021"
},
"quote": {
"amount": "0",
"precision": 3,
"nai": "@@000000021"
}
},
"price_history": []
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.get_feed_history", "id":1}' https://api.steemit.com
database_api.get_hardfork_properties
Returns the current properties about the blockchain’s hardforks.
Query Parameters JSON
{}
Expected Response JSON
{
"id": 0,
"processed_hardforks": [],
"last_hardfork": 0,
"current_hardfork_version": "0.0.0",
"next_hardfork": "0.0.0",
"next_hardfork_time": "1970-01-01T00:00:00"
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.get_hardfork_properties", "id":1}' https://api.steemit.com
database_api.get_order_book
Returns the order book.
Query Parameters JSON
{"limit": 0}
Expected Response JSON
{"asks": [], "bids": []}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.get_order_book", "params":{"limit":10}, "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.get_order_book", "params":{"limit":50}, "id":1}' https://api.steemit.com
database_api.get_potential_signatures
This method will return the set of all public keys that could possibly
sign for a given transaction. This call can be used by wallets to filter
their set of public keys to just the relevant subset prior to calling
get_required_signatures
to get the minimum subset.
Query Parameters JSON
{
"trx": {
"ref_block_num": 0,
"ref_block_prefix": 0,
"expiration": "1970-01-01T00:00:00",
"operations": [],
"extensions": [],
"signatures": []
}
}
Expected Response JSON
{"keys": []}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.get_potential_signatures", "params":{"trx":{"ref_block_num":1097,"ref_block_prefix":2181793527,"expiration":"2016-03-24T18:00:21","operations":[{"type":"pow_operation","value":{"worker_account":"cloop3","block_id":"00000449f7860b82b4fbe2f317c670e9f01d6d9a","nonce":3899,"work":{"worker":"STM7P5TDnA87Pj9T4mf6YHrhzjC1KbPZpNxLWCcVcHxNYXakpoT4F","input":"ae8e7c677119d22385f8c48026fee7aad7bba693bf788d7f27047f40b47738c0","signature":"1f38fe9a3f9989f84bd94aa5bbc88beaf09b67f825aa4450cf5105d111149ba6db560b582c7dbb026c7fc9c2eb5051815a72b17f6896ed59d3851d9a0f9883ca7a","work":"000e7b209d58f2e64b36e9bf12b999c6c7af168cc3fc41eb7f8a4bf796c174c3"},"props":{"account_creation_fee":{"amount":"100000","precision":3,"nai":"@@000000021"},"maximum_block_size":131072,"sbd_interest_rate":1000}}}],"extensions":[],"signatures":[]}}, "id":1}' https://api.steemit.com
database_api.get_required_signatures
This API will take a partially signed transaction and a set of public keys that the owner has the ability to sign for and return the minimal subset of public keys that should add signatures to the transaction.
Query Parameters JSON
{
"trx": {
"ref_block_num": 0,
"ref_block_prefix": 0,
"expiration": "1970-01-01T00:00:00",
"operations": [],
"extensions": [],
"signatures": []
},
"available_keys": []
}
Expected Response JSON
{"keys": []}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.get_required_signatures", "params":{"trx":{"ref_block_num":1097,"ref_block_prefix":2181793527,"expiration":"2016-03-24T18:00:21","operations":[{"type":"pow_operation","value":{"worker_account":"cloop3","block_id":"00000449f7860b82b4fbe2f317c670e9f01d6d9a","nonce":3899,"work":{"worker":"STM7P5TDnA87Pj9T4mf6YHrhzjC1KbPZpNxLWCcVcHxNYXakpoT4F","input":"ae8e7c677119d22385f8c48026fee7aad7bba693bf788d7f27047f40b47738c0","signature":"1f38fe9a3f9989f84bd94aa5bbc88beaf09b67f825aa4450cf5105d111149ba6db560b582c7dbb026c7fc9c2eb5051815a72b17f6896ed59d3851d9a0f9883ca7a","work":"000e7b209d58f2e64b36e9bf12b999c6c7af168cc3fc41eb7f8a4bf796c174c3"},"props":{"account_creation_fee":{"amount":"100000","precision":3,"nai":"@@000000021"},"maximum_block_size":131072,"sbd_interest_rate":1000}}}],"extensions":[],"signatures":[]},"available_keys":[]}, "id":1}' https://api.steemit.com
- Since: HF17
- Related
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": "00000000000000000000000000"}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.get_transaction_hex", "params":{"trx":{"ref_block_num":1097,"ref_block_prefix":2181793527,"expiration":"2016-03-24T18:00:21","operations":[{"type":"pow_operation","value":{"worker_account":"cloop3","block_id":"00000449f7860b82b4fbe2f317c670e9f01d6d9a","nonce":3899,"work":{"worker":"STM7P5TDnA87Pj9T4mf6YHrhzjC1KbPZpNxLWCcVcHxNYXakpoT4F","input":"ae8e7c677119d22385f8c48026fee7aad7bba693bf788d7f27047f40b47738c0","signature":"1f38fe9a3f9989f84bd94aa5bbc88beaf09b67f825aa4450cf5105d111149ba6db560b582c7dbb026c7fc9c2eb5051815a72b17f6896ed59d3851d9a0f9883ca7a","work":"000e7b209d58f2e64b36e9bf12b999c6c7af168cc3fc41eb7f8a4bf796c174c3"},"props":{"account_creation_fee":{"amount":"100000","precision":3,"nai":"@@000000021"},"maximum_block_size":131072,"sbd_interest_rate":1000}}}],"extensions":[],"signatures":[]}}, "id":1}' https://api.steemit.com
- Since: HF20
- Related
database_api.get_version
Returns the compile time versions of blockchain, steem, FC. Also returns the boot time version of the chain id (may be different from compile time value only when looking at a testnet)
Query Parameters JSON
{}
Expected Response JSON
{
"blockchain_version": "",
"steem_revision": "",
"fc_revision": "",
"chain_id": "0000000000000000000000000000000000000000000000000000000000000000"
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.get_version", "id":1}' https://api.steemit.com
database_api.get_witness_schedule
Returns the current witness schedule.
Query Parameters JSON
{}
Expected Response JSON
{
"id": 0,
"current_virtual_time": "0",
"next_shuffle_block_num": 76479392,
"current_shuffled_witnesses": [],
"num_scheduled_witnesses": 0,
"elected_weight": 132,
"timeshare_weight": 86,
"miner_weight": 125,
"witness_pay_normalization_factor": 32767,
"median_props": {
"account_creation_fee": {
"amount": "1",
"precision": 3,
"nai": "@@000000021"
},
"maximum_block_size": 131072,
"sbd_interest_rate": 1000,
"account_subsidy_budget": 797,
"account_subsidy_decay": 347321
},
"majority_version": "0.0.0",
"max_voted_witnesses": 0,
"max_miner_witnesses": 0,
"max_runner_witnesses": 0,
"hardfork_required_witnesses": 0,
"account_subsidy_rd": {
"resource_unit": 0,
"budget_per_time_unit": 0,
"pool_eq": 0,
"max_pool_size": 0,
"decay_params": {
"decay_per_time_unit": 0,
"decay_per_time_unit_denom_shift": 0
},
"min_decay": 0
},
"account_subsidy_witness_rd": {
"resource_unit": 0,
"budget_per_time_unit": 0,
"pool_eq": 0,
"max_pool_size": 0,
"decay_params": {
"decay_per_time_unit": 0,
"decay_per_time_unit_denom_shift": 0
},
"min_decay": 0
},
"min_witness_account_subsidy_decay": 0
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.get_witness_schedule", "id":1}' https://api.steemit.com
- Since: HF11
- Related
database_api.list_account_recovery_requests
Returns a list of account recovery requests. Parameters: start:string
, limit:int
, order:string
limit
is up to 1000.order
can be one of:by_account
- order by accont nameby_expiration
- order by expiration
account (string) |
limit (int) |
order (string) |
|
---|---|---|---|
"steemit" |
10 | "by_account" |
Queries the recovery requests for account named “steemit”, ordered by account name. |
["1960-01-01T00:00:00"] |
10 | "by_expiration" |
Queries the recovery requests for date, ordered by expiration. |
Query Parameters JSON
{"start": null, "limit": 0, "order": "by_name"}
Expected Response JSON
{"requests": []}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_account_recovery_requests", "params": {"start":"", "limit":10, "order":"by_account"}, "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_account_recovery_requests", "params": {"start":["1960-01-01T00:00:00"], "limit":10, "order":"by_expiration"}, "id":1}' https://api.steemit.com
database_api.list_accounts
List accounts ordered by specified key. Parameters: start:object
, limit:int
, order:string
limit
is up to 1000.order
can be one of:by_name
- order by accont nameby_proxy
- order by proxyby_next_vesting_withdrawal
- order by next next vesting withdrawal
start (object) |
limit (int) |
order (string) |
---|---|---|
"" |
10 |
"by_name" Queries for up to 10 accounts starting at the beginning, sorted by name. |
["", ""] |
10 |
"by_proxy" Queries for up to 10 accounts starting at the beginning, sorted by proxy. |
["1960-01-01T00:00:00", ""] |
10 |
"by_next_vesting_withdrawal" Queries for up to 10 accounts starting at the beginning, sorted by next vesting withdrawl. |
Also see: Paginated API Methods
Query Parameters JSON
{"start": null, "limit": 0, "order": "by_name"}
Expected Response JSON
{
"accounts": [
{
"id": 7184,
"name": "a-0",
"owner": {
"weight_threshold": 1,
"account_auths": [],
"key_auths": [
[
"STM5RrTRNDhhrMaA24SzSeE5AvmUcutb1q1VZp1imnT8p871s3UjN",
1
]
]
},
"active": {
"weight_threshold": 1,
"account_auths": [],
"key_auths": [
[
"STM5RrTRNDhhrMaA24SzSeE5AvmUcutb1q1VZp1imnT8p871s3UjN",
1
]
]
},
"posting": {
"weight_threshold": 1,
"account_auths": [],
"key_auths": [
[
"STM5RrTRNDhhrMaA24SzSeE5AvmUcutb1q1VZp1imnT8p871s3UjN",
1
]
]
},
"memo_key": "STM5RrTRNDhhrMaA24SzSeE5AvmUcutb1q1VZp1imnT8p871s3UjN",
"json_metadata": "",
"proxy": "",
"last_owner_update": "1970-01-01T00:00:00",
"last_account_update": "1970-01-01T00:00:00",
"created": "2016-04-30T12:27:12",
"mined": true,
"recovery_account": "steem",
"last_account_recovery": "1970-01-01T00:00:00",
"reset_account": "null",
"comment_count": 0,
"lifetime_vote_count": 0,
"post_count": 0,
"can_vote": true,
"voting_manabar": {
"current_mana": 10000,
"last_update_time": 1462019232
},
"balance": {
"amount": "1",
"precision": 3,
"nai": "@@000000021"
},
"savings_balance": {
"amount": "0",
"precision": 3,
"nai": "@@000000021"
},
"sbd_balance": {
"amount": "0",
"precision": 3,
"nai": "@@000000013"
},
"sbd_seconds": "0",
"sbd_seconds_last_update": "1970-01-01T00:00:00",
"sbd_last_interest_payment": "1970-01-01T00:00:00",
"savings_sbd_balance": {
"amount": "0",
"precision": 3,
"nai": "@@000000013"
},
"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": {
"amount": "0",
"precision": 3,
"nai": "@@000000013"
},
"reward_steem_balance": {
"amount": "0",
"precision": 3,
"nai": "@@000000021"
},
"reward_vesting_balance": {
"amount": "0",
"precision": 6,
"nai": "@@000000037"
},
"reward_vesting_steem": {
"amount": "0",
"precision": 3,
"nai": "@@000000021"
},
"vesting_shares": {
"amount": "13873020360",
"precision": 6,
"nai": "@@000000037"
},
"delegated_vesting_shares": {
"amount": "0",
"precision": 6,
"nai": "@@000000037"
},
"received_vesting_shares": {
"amount": "0",
"precision": 6,
"nai": "@@000000037"
},
"vesting_withdraw_rate": {
"amount": "0",
"precision": 6,
"nai": "@@000000037"
},
"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": "1970-01-01T00:00:00",
"last_root_post": "1970-01-01T00:00:00",
"last_vote_time": "1970-01-01T00:00:00",
"post_bandwidth": 0,
"pending_claimed_accounts": 0,
"is_smt": false
}
]
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_accounts", "params": {"start":"", "limit":10, "order":"by_name"}, "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_accounts", "params": {"start":["", ""], "limit":10, "order":"by_proxy"}, "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_accounts", "params": {"start":["1960-01-01T00:00:00", ""], "limit":10, "order":"by_next_vesting_withdrawal"}, "id":1}' https://api.steemit.com
- Since: HF11
- Related
database_api.list_change_recovery_account_requests
Returns a list of recovery account change requests. Parameters: start:object
, limit:int
, order:string
start
depends onorder
(see below)limit
is up to 1000.order
can be one of:by_account
- order by accountstart
is string of:account
by_effective_date
- order by effective datestart
is an array of two values:timestamp
,account
start (object) |
limit (int) |
order (string) |
|
---|---|---|---|
"" |
10 | "by_account" |
Queries first 10 requests, sort by account |
["1960-01-01T00:00:00", ""] |
10 | "by_effective_date" |
Queries first 10 requests, sort by effective date |
Also see: Paginated API Methods
Query Parameters JSON
{"start": null, "limit": 0, "order": "by_name"}
Expected Response JSON
{
"requests": [
{
"id": 99,
"account_to_recover": "alice",
"recovery_account": "bob",
"effective_on": "1960-01-01T00:00:00"
}
]
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_change_recovery_account_requests", "params": {"start":"alice", "limit":10, "order":"by_account"}, "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_change_recovery_account_requests", "params": {"start":["1960-01-01T00:00:00",""], "limit":10, "order":"by_effective_date"}, "id":1}' https://api.steemit.com
database_api.list_comments
Returns all comments, starting with the specified options. Parameters: start:array
; limit:int
; order:string
start
depends onorder
(see below)limit
is up to 1000.order
can be one of:by_cashout_time
- order by cashout timestart
is an array of one required value and two optional:timestamp
,author
,permlink
by_permlink
- order by permlinkstart
is an array of two optional values:author
,permlink
by_root
- order by rootstart
is an array of two required values and two optional:root_author
,root_permlink
,child_author
,child_permlink
by_parent
- order by parentstart
is an array of two required values and two optional:parent_author
,parent_permlink
,child_author
,child_permlink
start (array) |
limit (int) |
order (string) |
|
---|---|---|---|
["1970-01-01T00:00:00", "", ""] |
10 | "by_cashout_time" |
Queries first 10 comments, sort by cashout time |
["", ""] |
10 | "by_permlink" |
Queries first 10 comments, sort by permlink |
["steemit","firstpost", "", ""] |
10 | "by_root" |
Queries next 10 comments starting at @steemit/firstpost, sort by root |
["steemit","firstpost", "", ""] |
10 | "by_parent" |
Queries next 10 comments starting at @steemit/firstpost, sort by parent |
Also see: Paginated API Methods
Query Parameters JSON
{"start": null, "limit": 0, "order": "by_name"}
Expected Response JSON
{
"comments": [
{
"id": 66710716,
"author": "libert",
"permlink": "libert-re-runicar-re-libert-libert-re-runicar-re-libert-libert-re-runicar-ykwyxgj6-20181128t063355338z",
"category": "steem",
"parent_author": "runicar",
"parent_permlink": "re-libert-libert-re-runicar-re-libert-libert-re-runicar-ykwyxgj6-20181128t063100538z",
"title": "",
"body": "13\n\nPosted using [Partiko Android](https://steemit.com/@partiko-android)",
"json_metadata": "{\"app\":\"partiko\"}",
"last_update": "2018-11-28T06:33:57",
"created": "2018-11-28T06:33:57",
"active": "2018-11-28T06:34:30",
"last_payout": "1970-01-01T00:00:00",
"depth": 5,
"children": 1,
"net_rshares": 0,
"abs_rshares": 0,
"vote_rshares": 0,
"children_abs_rshares": 0,
"cashout_time": "2018-12-05T06:33:57",
"max_cashout_time": "1969-12-31T23:59:59",
"total_vote_weight": 0,
"reward_weight": 10000,
"total_payout_value": {
"amount": "0",
"precision": 3,
"nai": "@@000000013"
},
"curator_payout_value": {
"amount": "0",
"precision": 3,
"nai": "@@000000013"
},
"author_rewards": 0,
"net_votes": 0,
"root_author": "runicar",
"root_permlink": "ykwyxgj6",
"max_accepted_payout": {
"amount": "1000000000",
"precision": 3,
"nai": "@@000000013"
},
"percent_steem_dollars": 10000,
"allow_replies": true,
"allow_votes": true,
"allow_curation_rewards": true,
"beneficiaries": []
}
]
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_comments", "params": {"start":["1970-01-01T00:00:00","",""], "limit":10, "order":"by_cashout_time"}, "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_comments", "params": {"start":["",""], "limit":10, "order":"by_permlink"}, "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_comments", "params": {"start":["steemit","firstpost","",""], "limit":10, "order":"by_root"}, "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_comments", "params": {"start":["steemit","firstpost","",""], "limit":10, "order":"by_parent"}, "id":1}' https://api.steemit.com
- Since: HF14
- Related
database_api.list_decline_voting_rights_requests
Returns a list of decline voting rights requests. Parameters: start:object
; limit:int
; order:string
start
depends onorder
(see below)limit
is up to 1000.order
can be one of:by_account
- order by accountstart
is a string:account
by_effective_date
- order by effective datestart
is an array of two values:timestamp
,account
start (object) |
limit (int) |
order (string) |
|
---|---|---|---|
"" |
10 | "by_account" |
Queries first 10 requests, sort by account |
["1960-01-01T00:00:00", ""] |
10 | "by_effective_date" |
Queries first 10 requests, sort by effective date |
Also see: Paginated API Methods
Query Parameters JSON
{"start": null, "limit": 0, "order": "by_name"}
Expected Response JSON
{"requests": []}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_decline_voting_rights_requests", "params": {"start":"", "limit":10, "order":"by_account"}, "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_decline_voting_rights_requests", "params": {"start":["1970-01-01T00:00:00","",""], "limit":10, "order":"by_effective_date"}, "id":1}' https://api.steemit.com
- Since: HF14
- Related
database_api.list_escrows
Returns a list of escrows. Parameters: start:array
; limit:int
; order:string
start
depends onorder
(see below)limit
is up to 1000.order
can be one of:by_from_id
- order by idstart
is an array of two values:account
,escrow_id
by_ratification_deadline
- order by ratification deadlinestart
is an array of three values:is_approved
,timestamp
,escrow_id
start (array) |
limit (int) |
order (string) |
|
---|---|---|---|
["alice", 99] |
10 | "by_from_id" |
Queries first 10 requests, sort by id |
[true, "1960-01-01T00:00:00", 99] |
10 | "by_ratification_deadline" |
Queries first 10 requests, sort by ratification deadline |
Also see: Paginated API Methods
Query Parameters JSON
{"start": null, "limit": 0, "order": "by_name"}
Expected Response JSON
{
"escrows": [
{
"id": 158,
"escrow_id": 1,
"from": "addicttolife",
"to": "fundition.help",
"agent": "ongame",
"ratification_deadline": "2018-11-23T17:31:26",
"escrow_expiration": "2018-11-24T17:31:26",
"sbd_balance": {
"amount": "0",
"precision": 3,
"nai": "@@000000013"
},
"steem_balance": {
"amount": "4832",
"precision": 3,
"nai": "@@000000021"
},
"pending_fee": {
"amount": "0",
"precision": 3,
"nai": "@@000000021"
},
"to_approved": true,
"agent_approved": true,
"disputed": false
}
]
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_escrows", "params": {"start":["",0], "limit":10, "order":"by_from_id"}, "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_escrows", "params": {"start":[true, "1970-01-01T00:00:00", 0], "limit":10, "order":"by_ratification_deadline"}, "id":1}' https://api.steemit.com
database_api.list_limit_orders
Returns a list of limit orders. Parameters: start:array
; limit:int
; order:string
start
depends onorder
(see below)limit
is up to 1000.order
can be one of:by_price
- order by pricestart
is an array of two values:price
,order_type
by_account
- order by accountstart
is an array of two values:account
,order_id
start (array) |
limit (int) |
order (string) |
|
---|---|---|---|
[{"base": {"amount": "85405", "precision": 3, "nai": "@@000000021"}, "quote": {"amount": "17192", "precision": 3, "nai": "@@000000013"}}, 0] |
10 | "by_price" |
Queries first 10 requests, sort by price |
["alice", 0] |
10 | "by_effective_date" |
Queries first 10 requests, sort by account |
Also see: Paginated API Methods
Query Parameters JSON
{"start": null, "limit": 0, "order": "by_name"}
Expected Response JSON
{
"orders": [
{
"id": 3155591,
"created": "2018-12-05T06:34:21",
"expiration": "2018-12-15T06:34:20",
"seller": "teamsmooth-mm",
"orderid": 2000,
"for_sale": 197714,
"sell_price": {
"base": {
"amount": "198513",
"precision": 3,
"nai": "@@000000021"
},
"quote": {
"amount": "80000",
"precision": 3,
"nai": "@@000000013"
}
}
}
]
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_limit_orders", "params": {"start":[{"base":{"amount":"1000","precision":3,"nai":"@@000000021"},"quote":{"amount":"1","precision":3,"nai":"@@000000013"}},0], "limit":10, "order":"by_price"}, "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_limit_orders", "params": {"start":["alice",0], "limit":10, "order":"by_account"}, "id":1}' https://api.steemit.com
database_api.list_owner_histories
Returns a list of owner authority histories. Parameters: start:array
, limit:int
start (array) |
limit (int) |
|
---|---|---|
["steemit", "1970-01-01T00:00:00"] |
10 | Queries the owner history starting from account named “steemit” on “1970-01-01T00:00:00”, limit 10 results. |
["alice", "1970-01-01T00:00:00"] |
10 | Queries the owner history starting from account named “alice”, limit 10 results. |
Also see: Paginated API Methods
Query Parameters JSON
{"start": null, "limit": 0}
Expected Response JSON
{
"owner_auths": [
{
"id": 129742,
"account": "a-m",
"previous_owner_authority": {
"weight_threshold": 1,
"account_auths": [],
"key_auths": [
[
"STM7J6gXoztfTscNzmzL11DFtTPCFCTeZzsFtFxsQrQw91KnN1YxQ",
1
]
]
},
"last_valid_time": "2018-11-24T02:35:27"
}
]
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_owner_histories", "params": {"start":["steemit","1970-01-01T00:00:00"], "limit":10}, "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_owner_histories", "params": {"start":["alice","1970-01-01T00:00:00"], "limit":10}, "id":1}' https://api.steemit.com
- Since: HF14
- Related
database_api.list_savings_withdrawals
Returns a list of savings withdrawls. Parameters: start:object
, limit:int
, order:string
limit
is up to 1000.order
can be one of:by_from_id
- order by idstart
is an array of two values:account
,request_id
by_complete_from_id
- order by id (complete)start
is an array of three values:timestamp
,account
,request_id
by_to_complete
- order by completestart
is an array of three values:account
,timestamp
,order_id
start (object) |
limit (int) |
order (string) |
|
---|---|---|---|
[0] |
10 |
"by_from_id" |
Queries the savings withdraw for id. |
["2018-12-07T16:54:03", "steemit", 0] |
10 |
"by_complete_from_id" |
Queries the savings withdraw for id (completed). |
["", "1970-01-01T00:00:00", 0] |
10 |
"by_to_complete" |
Queries the savings withdraw completed. |
Also see: Paginated API Methods
Query Parameters JSON
{"start": null, "limit": 0, "order": "by_name"}
Expected Response JSON
{
"withdrawals": [
{
"id": 120083,
"from": "adafnnys",
"to": "adafnnys",
"memo": "",
"request_id": 1543942411,
"amount": {
"amount": "2413",
"precision": 3,
"nai": "@@000000013"
},
"complete": "2018-12-07T16:54:03"
}
]
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_savings_withdrawals", "params": {"start":[0], "limit":10, "order":"by_from_id"}, "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_savings_withdrawals", "params": {"start":["2018-12-07T16:54:03", "steemit", 0], "limit":10, "order":"by_complete_from_id"}, "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_savings_withdrawals", "params": {"start":["", "1970-01-01T00:00:00", 0], "limit":10, "order":"by_to_complete"}, "id":1}' https://api.steemit.com
database_api.list_sbd_conversion_requests
Returns the list of SBD conversion requests for an account. Parameters: start:array
, limit:int
, order:string
limit
is up to 1000.order
can be one of:by_account
- order by accont namestart
is an array of two values:account
,request_id
by_conversion_date
- order by conversion datestart
is an array of two values:timestamp
,request_id
start (array) |
limit (int) |
order (string) |
|
---|---|---|---|
["steemit", 0] |
10 | by_account |
Queries a conversion request for steemit, limit to 10 results, order by account name. |
["2018-12-07T16:54:03", 0] |
10 | by_conversion_date |
Queries a conversion request from this date, limit to 10 results, order by conversion date. |
Also see: Paginated API Methods
Query Parameters JSON
{"start": null, "limit": 0, "order": "by_name"}
Expected Response JSON
{
"requests": [
{
"id": 75677,
"owner": "adenijiadeshina",
"requestid": 3,
"amount": {
"amount": "311",
"precision": 3,
"nai": "@@000000013"
},
"conversion_date": "2018-12-06T20:42:42"
}
]
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_sbd_conversion_requests", "params": {"start":["steemit", 0], "limit":10, "order":"by_account"}, "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_sbd_conversion_requests", "params": {"start":["2018-12-07T16:54:03", 0], "limit":10, "order":"by_conversion_date"}, "id":1}' https://api.steemit.com
- Since: HF17
- Related
database_api.list_vesting_delegation_expirations
Returns a list of vesting delegation expirations. Parameters: start:array
, limit:int
, order:string
limit
is up to 1000.order
can be one of:by_expiration
- order by expirationstart
is an array of two values:timestamp
,expiration_id
by_account_expiration
- order by account expirationstart
is an array of two values:account
,timestamp
,expiration_id
start (array) |
limit (int) |
order (string) |
|
---|---|---|---|
["1970-01-01T00:00:00", 0] |
10 | by_expiration |
Queries delegations, limit to 10 results, order by expiration. |
["alice", "1970-01-01T00:00:00", 0] |
10 | by_account_expiration |
Queries delegation from this date, limit to 10 results, order by account expiration. |
Also see: Paginated API Methods
Query Parameters JSON
{"start": null, "limit": 0, "order": "by_name"}
Expected Response JSON
{
"delegations": [
{
"id": 3076685,
"delegator": "anonsteem",
"vesting_shares": {
"amount": "6050629930",
"precision": 6,
"nai": "@@000000037"
},
"expiration": "2018-12-05T07:07:15"
}
]
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_vesting_delegation_expirations", "params": {"start":["1970-01-01T00:00:00",0], "limit":10, "order":"by_expiration"}, "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_vesting_delegation_expirations", "params": {"start":["alice", "1970-01-01T00:00:00",0], "limit":10, "order":"by_account_expiration"}, "id":1}' https://api.steemit.com
- Since: HF17
- Related
database_api.list_vesting_delegations
Returns a list of vesting delegations. Parameters: start:array
, limit:int
, order:string
limit
is up to 1000.order
can be one of:by_delegation
- order by delegationsstart
is an array of two values:delegator
,delegatee
start (array) |
limit (int) |
order (string) |
|
---|---|---|---|
["", ""] |
10 | by_delegation |
Queries delegations, limit to 10 results, order by delegations. |
Also see: Paginated API Methods
Query Parameters JSON
{"start": null, "limit": 0, "order": "by_name"}
Expected Response JSON
{
"delegations": [
{
"id": 554317,
"delegator": "a-0-0-0",
"delegatee": "a-0-0",
"vesting_shares": {
"amount": "6141067173",
"precision": 6,
"nai": "@@000000037"
},
"min_delegation_time": "2018-01-24T22:23:54"
}
]
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_vesting_delegations", "params": {"start":["",""], "limit":10, "order":"by_delegation"}, "id":1}' https://api.steemit.com
database_api.list_votes
Returns all votes, starting with the specified voter and/or author and permlink. Parameters: start:array
; limit:int
; order:string
start
depends onorder
(see below)voter
is optionalauthor
andpermlink
are optional, but if one is blank, they must both be blank
limit
is up to 1000.order
can be one of:by_comment_voter
- order by comment voterstart
is an array of three optional values:author
,permlink
,voter
by_voter_comment
- order by voter commentstart
is an array of three optional values:voter
,author
,permlink
start (array) |
limit (int) |
order (string) |
|
---|---|---|---|
["", "", ""] |
10 | "by_comment_voter" |
Queries first 10 votes, sort by comment voter |
["", "", ""] |
10 | "by_voter_comment" |
Queries first 10 votes, sort by voter comment |
["xeroc", "vanteem-config", ""] |
10 | "by_comment_voter" |
Queries next 10 votes starting on the post @xeroc/vanteem-config , sort by comment voter |
["alice", "xeroc", "vanteem-config"] |
10 | "by_voter_comment" |
Queries next 10 votes starting at alice on the post @xeroc/vanteem-config , sort by voter comment |
Also see: Paginated API Methods
Query Parameters JSON
{
"start": null,
"limit": 0,
"order": "by_comment_voter"
}
Expected Response JSON
{
"votes": [
{
"id": 9,
"voter": "dantheman",
"author": "steemit",
"permlink": "firstpost",
"weight": "32866333630",
"rshares": 375241,
"vote_percent": 100,
"last_update": "2016-04-07T19:15:36",
"num_changes": -1
}
]
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_votes", "params": {"start":["", "", ""], "limit":10, "order":"by_comment_voter"}, "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_votes", "params": {"start":["", "", ""], "limit":10, "order":"by_voter_comment"}, "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_votes", "params": {"start":["", "", "steemit"], "limit":10, "order":"by_comment_voter"}, "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_votes", "params": {"start":["alice", "xeroc", "vanteem-config"], "limit":10, "order":"by_voter_comment"}, "id":1}' https://api.steemit.com
database_api.list_withdraw_vesting_routes
Returns a list of vesting withdraw routes. Parameters: start:array
; limit:int
; order:string
start
depends onorder
(see below)limit
is up to 1000.order
can be one of:by_withdraw_route
- order by withdraw routestart
is an array of two values:from_account
,to_account
by_destination
- order by destinationstart
is an array of two values:to_account
,route_id
start (array) |
limit (int) |
order (string) |
|
---|---|---|---|
["temp", ""] |
10 | "by_withdraw_route" |
Queries first 10 routes, sort by withdraw route |
["", 0] |
10 | "by_destination" |
Queries first 10 routes, sort by destination |
Also see: Paginated API Methods
Query Parameters JSON
{"start": null, "limit": 0, "order": "by_name"}
Expected Response JSON
{
"routes": [
{
"id": 39503,
"from_account": "temperature",
"to_account": "luckdiver",
"percent": 10000,
"auto_vest": false
}
]
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_withdraw_vesting_routes", "params": {"start":["temp",""], "limit":10, "order":"by_withdraw_route"}, "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_withdraw_vesting_routes", "params": {"start":["",0], "limit":10, "order":"by_destination"}, "id":1}' https://api.steemit.com
database_api.list_witness_votes
Returns a list of witness votes. Parameters: start:array
; limit:int
; order:string
start
depends onorder
(see below)limit
is up to 1000.order
can be one of:by_account_witness
- order by account witnessstart
is an array of two values:account
,witness
by_witness_account
- order by witness accountstart
is an array of two values:witness
,account
start (array) |
limit (int) |
order (string) |
|
---|---|---|---|
["", ""] |
10 | "by_withdraw_route" |
Queries first 10 votes, sort by account witness |
["", ""] |
10 | "by_destination" |
Queries first 10 votes, sort by witness account |
Also see: Paginated API Methods
Query Parameters JSON
{"start": null, "limit": 0, "order": "by_name"}
Expected Response JSON
{
"votes": [
{
"id": 428961,
"witness": "aggroed",
"account": "a-0magic"
}
]
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_witness_votes", "params": {"start":["",""], "limit":10, "order":"by_account_witness"}, "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_witness_votes", "params": {"start":["",""], "limit":10, "order":"by_witness_account"}, "id":1}' https://api.steemit.com
database_api.list_witnesses
Returns the list of witnesses. Parameters: start:object
; limit:int
; order:string
start
depends onorder
(see below)limit
is up to 1000.order
can be one of:by_name
- order by namestart
is string value:account
by_vote_name
- order by vote, namestart
is an array of two values:votes
,account
by_schedule_time
- order by schedule timestart
is an array of two values:virtual_scheduled_time
,account
start (object) |
limit (int) |
order (string) |
|
---|---|---|---|
"" |
10 | "by_name" |
Queries first 10 witnesses, sort by account name |
[0, ""] |
10 | "by_vote_name" |
Queries first 10 witnesses, sort by votes |
["473718186844702107410533306", "alice"] |
10 | "by_schedule_time" |
Queries first 10 witnesses, sort by schedule |
Also see: Paginated API Methods
Query Parameters JSON
{"start": null, "limit": 0, "order": "by_name"}
Expected Response JSON
{
"witnesses": [
{
"id": 6950,
"owner": "a-0",
"created": "1970-01-01T00:00:00",
"url": "",
"votes": 0,
"virtual_last_update": "0",
"virtual_position": "0",
"virtual_scheduled_time": "340282366920938463463374607431768211455",
"total_missed": 0,
"last_aslot": 1063323,
"last_confirmed_block_num": 1040423,
"pow_worker": 0,
"signing_key": "STM5RrTRNDhhrMaA24SzSeE5AvmUcutb1q1VZp1imnT8p871s3UjN",
"props": {
"account_creation_fee": {
"amount": "1",
"precision": 3,
"nai": "@@000000021"
},
"maximum_block_size": 131072,
"sbd_interest_rate": 1000,
"account_subsidy_budget": 797,
"account_subsidy_decay": 347321
},
"sbd_exchange_rate": {
"base": {
"amount": "0",
"precision": 3,
"nai": "@@000000021"
},
"quote": {
"amount": "0",
"precision": 3,
"nai": "@@000000021"
}
},
"last_sbd_exchange_update": "1970-01-01T00:00:00",
"last_work": "000000127cb0e335667f30100bc1a061175c2d789f808e0e9ac82ee70fa8e604",
"running_version": "0.0.0",
"hardfork_version_vote": "0.0.0",
"hardfork_time_vote": "2016-03-24T16:00:00",
"available_witness_account_subsidies": 0
}
]
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_witnesses", "params": {"start":"", "limit":10, "order":"by_name"}, "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_witnesses", "params": {"start":[0,""], "limit":10, "order":"by_vote_name"}, "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_witnesses", "params": {"start":["473718186844702107410533306","alice"], "limit":10, "order":"by_schedule_time"}, "id":1}' https://api.steemit.com
- Disabled
- Related
database_api.verify_account_authority
Not Implemented
Query Parameters JSON
{"account": "", "signers": []}
Expected Response JSON
{"valid": false}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.verify_account_authority", "params":{"account":"temp","signers":["STM8GC13uCZbP44HzMLV6zPZGwVQ8Nt4Kji8PapsPiNq1BK153XTX"]}, "id":1}' https://api.steemit.com
database_api.verify_authority
Returns true if the transaction has all of the required signatures, otherwise throws an exception.
Query Parameters JSON
{
"trx": {
"ref_block_num": 0,
"ref_block_prefix": 0,
"expiration": "1970-01-01T00:00:00",
"operations": [],
"extensions": [],
"signatures": []
}
}
Expected Response JSON
{"valid": false}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.verify_authority", "params":{"trx":{"ref_block_num":1097,"ref_block_prefix":2181793527,"expiration":"2016-03-24T18:00:21","operations":[{"type":"pow_operation","value":{"worker_account":"cloop3","block_id":"00000449f7860b82b4fbe2f317c670e9f01d6d9a","nonce":3899,"work":{"worker":"STM7P5TDnA87Pj9T4mf6YHrhzjC1KbPZpNxLWCcVcHxNYXakpoT4F","input":"ae8e7c677119d22385f8c48026fee7aad7bba693bf788d7f27047f40b47738c0","signature":"1f38fe9a3f9989f84bd94aa5bbc88beaf09b67f825aa4450cf5105d111149ba6db560b582c7dbb026c7fc9c2eb5051815a72b17f6896ed59d3851d9a0f9883ca7a","work":"000e7b209d58f2e64b36e9bf12b999c6c7af168cc3fc41eb7f8a4bf796c174c3"},"props":{"account_creation_fee":{"amount":"100000","precision":3,"nai":"@@000000021"},"maximum_block_size":131072,"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}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.verify_signatures", "params":{"hash": "0000000000000000000000000000000000000000000000000000000000000000", "signatures": [], "required_owner": [], "required_active": [], "required_posting": [], "required_other": []}, "id":1}' https://api.steemit.com
database_api.find_proposals
Finds proposals by proposal.id
(not proposal.proposal_id
).
Query Parameters JSON
{"proposal_ids": [0]}
Expected Response JSON
{
"proposals": [
{
"id": 0,
"proposal_id": "139925218365120",
"creator": "alice",
"receiver": "bob",
"start_date": "2019-07-01T00:00:00",
"end_date": "2019-08-01T23:59:59",
"daily_pay": {
"amount": "4800000",
"precision": 3,
"nai": "@@000000013"
},
"subject": "My Proposal",
"permlink": "creator-proposal-permlink",
"total_votes": "77351826710",
"status": "active"
}
]
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.find_proposals", "params":{"proposal_ids": [0]}, "id":1}' https://api.steemit.com
database_api.list_proposal_votes
Returns all proposal votes, starting with the specified voter or proposal.id
. Parameters: start:array
; limit:int
; order:string
; order_direction:string
; status:string
start
depends onorder
(see below)voter
- voter of the proposal (account name string)proposal.id
- id the proposal (int)
limit
is up to 1000.order
can be one of:by_voter_proposal
- order by proposal voterby_proposal_voter
- order byproposal.id
order_direction
can be one of:ascending
descending
status
all
inactive
active
expired
votable
start (array) |
limit (int) |
order (string) |
order_direction (string) |
status (string) |
|
---|---|---|---|---|---|
["alice"] |
10 | by_voter_proposal |
ascending |
active |
list 10 proposals with active status, ordered by voter, ascending |
[10] |
1000 | by_proposal_voter |
ascending |
votable |
list 1000 votes on proposal 10, ordered by proposal.id , ascending |
Also see: Paginated API Methods
Query Parameters JSON
{
"start": null,
"limit": 0,
"order": "by_name",
"order_direction": "ascending",
"status": "all"
}
Expected Response JSON
{
"proposal_votes": [
{
"id": 0,
"voter": "charlie",
"proposal": {
"id": 0,
"proposal_id": 0,
"creator": "alice",
"receiver": "bob",
"start_date": "2019-07-01T00:00:00",
"end_date": "2019-08-01T23:59:59",
"daily_pay": {
"amount": "4800000",
"precision": 3,
"nai": "@@000000013"
},
"subject": "My Proposal",
"permlink": "creator-proposal-permlink",
"total_votes": "77351826710",
"status": "active"
}
}
]
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_proposal_votes", "params":{"start": [""], "limit": 10, "order": "by_voter_proposal", "order_direction": "ascending", "status": "active"}, "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_proposal_votes", "params":{"start": [0], "limit": 10, "order": "by_proposal_voter", "order_direction": "ascending", "status": "active"}, "id":1}' https://api.steemit.com
database_api.list_proposals
Returns all proposals, starting with the specified creator or start date. Parameters: start:array
; limit:int
; order:string
; order_direction:string
; status:string
start
depends onorder
(see below)creator
- creator of the proposal (account name string)start_date
- start date of the proposal (date string)end_date
- end date of the proposal (date string)total_votes
- total votes of the proposal (int)
limit
is up to 1000.order
can be one of:by_creator
- order by proposal creatorby_start_date
- order by proposal start dateby_end_date
- order by proposal end dateby_total_votes
- order by proposal total votes
order_direction
can be one of:ascending
descending
status
all
inactive
active
expired
votable
start (array) |
limit (int) |
order (string) |
order_direction (string) |
status (string) |
|
---|---|---|---|---|---|
[""] |
10 | by_creator |
ascending |
active |
list 10 proposals with active status, ordered by creator, ascending |
["2019-08-07T16:54:03"] |
1000 | by_start_date |
ascending |
inactive |
list 1000 proposals with inactive status, ordered by start date, ascending, since 2019-08-07T16:54:03 |
["a"] |
1 | by_creator |
ascending |
expired |
list 1 proposal with expired status, ordered by creator, ascending, by accounts starting with “a” |
["alice"] |
10 | by_creator |
ascending |
all |
list 10 proposals with any status, ordered by creator, ascending, by alice |
[""] |
1000 | by_creator |
ascending |
votable |
list 1000 votable proposals, ordered by creator, ascending |
[10] |
1000 | by_total_votes |
ascending |
votable |
list 1000 votable proposals, ordered by creator, ascending, having at least 10 votes |
Also see: Paginated API Methods
Query Parameters JSON
{
"start": null,
"limit": 0,
"order": "by_name",
"order_direction": "ascending",
"status": "all"
}
Expected Response JSON
{
"proposals": [
{
"id": 0,
"proposal_id": "1103806595072",
"creator": "alice",
"receiver": "bob",
"start_date": "2019-07-01T00:00:00",
"end_date": "2019-08-01T23:59:59",
"daily_pay": {
"amount": "4800000",
"precision": 3,
"nai": "@@000000013"
},
"subject": "My Proposal",
"permlink": "creator-proposal-permlink",
"total_votes": "77351826710",
"status": "active"
}
]
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_proposals", "params":{"start": [""], "limit": 10, "order": "by_creator", "order_direction": "ascending", "status": "active"}, "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_proposals", "params":{"start": ["2019-08-07T16:54:03"], "limit": 1000, "order": "by_start_date", "order_direction": "ascending", "status": "inactive"}, "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_proposals", "params":{"start": ["a"], "limit": 1, "order": "by_creator", "order_direction": "ascending", "status": "expired"}, "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_proposals", "params":{"start": ["alice"], "limit": 10, "order": "by_creator", "order_direction": "ascending", "status": "all"}, "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_proposals", "params":{"start": [""], "limit": 1000, "order": "by_creator", "order_direction": "ascending", "status": "votable"}, "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_proposals", "params":{"start": [10], "limit": 1000, "order": "by_total_votes", "order_direction": "ascending", "status": "votable"}, "id":1}' https://api.steemit.com
- Since: HF23
- Related
database_api.find_smt_contributions
Find SMT contributions. Contributions are needed to track individual contributions on an SMT during the ICO phase.
See: Token Units, Vesting Contributions
Query Parameters JSON
{"symbol_contributors": []}
Expected Response JSON
{
"contributions": [
{
"id": 0,
"symbol": {"nai": "@@422838704", "decimals": 0},
"contributor": "alice",
"contribution_id": 0,
"contribution": {
"amount": "1000",
"precision": 3,
"nai": "@@000000021"
}
}
]
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.find_smt_contributions", "params":{"symbol_contributors": []}, "id":1}' https://api.steemit.com
- Since: HF23
- Related
database_api.find_smt_token_emissions
Find SMT emissions.
See: Content Rewards, Qualitative Discussion
Query Parameters JSON
{
"asset_symbol": {"nai": "@@422838704", "decimals": 0}
}
Expected Response JSON
{"token_emissions": []}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.find_smt_token_emissions", "params":{"asset_symbol":{"nai":"@@422838704","decimals":0}}, "id":1}' https://api.steemit.com
- Since: HF23
- Related
database_api.find_smt_tokens
Find SMT.
See: Smart Media Tokens (SMTs)
Query Parameters JSON
{"symbols": [], "ignore_precision": false}
Expected Response JSON
{"tokens": []}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.find_smt_tokens", "params":{"symbols":[],"ignore_precision":false}, "id":1}' https://api.steemit.com
- Since: HF23
- Related
database_api.get_nai_pool
Return an array of Numeric Asset Identifier (NAI) available to be used for new SMT to be created.
See: Numerical Asset Identifiers
Query Parameters JSON
{}
Expected Response JSON
{"nai_pool": []}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.get_nai_pool", "params":{}, "id":1}' https://api.steemit.com
- Since: HF23
- Related
database_api.list_smt_contributions
List SMT contributions. Contributions are needed to track individual contributions on an SMT during the ICO phase. Parameters: start:array
; limit:int
; order:string
start
depends onorder
(see below)limit
is up to 1000.order
can be one of:by_symbol_id
- order by symbolby_symbol_contributor
- order bysymbol
,contributor
, andcontribution_id
start (array) |
limit (int) |
order (string) |
|
---|---|---|---|
[{"nai": "@@422838704", "decimals": 0}, 0] |
10 | by_symbol_id |
list 10 contributions, ordered by symbol, id |
[{"nai": "@@422838704", "decimals": 0}, "alice", 0] |
10 | by_symbol_contributor |
list 10 contributions, ordered by symbol, contributor, id |
See: Token Units, Vesting Contributions
Also see: Paginated API Methods
Query Parameters JSON
{
"start": null,
"limit": 0,
"order": "by_symbol_id"
}
Expected Response JSON
{
"contributions": [
{
"id": 0,
"symbol": {"nai": "@@422838704", "decimals": 0},
"contributor": "alice",
"contribution_id": 0,
"contribution": {
"amount": "1000",
"precision": 3,
"nai": "@@000000021"
}
}
]
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_smt_contributions", "params":{"start":[{"nai": "@@422838704", "decimals": 0}, 0],"limit":10,"order":"by_symbol_id"}, "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_smt_contributions", "params":{"start":[{"nai": "@@422838704", "decimals": 0}, "alice", 0],"limit":10,"order":"by_symbol_contributor"}, "id":1}' https://api.steemit.com
- Since: HF23
- Related
database_api.list_smt_token_emissions
List SMT emissions. Parameters: start:array
; limit:int
; order:string
start
depends onorder
(see below)limit
is up to 1000.order
can be one of:by_symbol_time
- order by symbol and time
start (array) |
limit (int) |
order (string) |
|
---|---|---|---|
[{"nai": "@@422838704", "decimals": 0}, "2019-08-07T16:54:03"] |
10 | by_symbol_time |
list 10 emissions, ordered by symbol, timestamp |
See: Content Rewards, Qualitative Discussion
Also see: Paginated API Methods
Query Parameters JSON
{
"start": null,
"limit": 0,
"order": "by_symbol_time"
}
Expected Response JSON
{"token_emissions": []}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_smt_token_emissions", "params":{"start":[{"nai": "@@422838704", "decimals": 0}, "2019-08-07T16:54:03"],"limit":10,"order":"by_symbol_time"}, "id":1}' https://api.steemit.com
- Since: HF23
- Related
database_api.list_smt_tokens
List SMTs. Parameters: start:object
; limit:int
; order:string
start
depends onorder
(see below)limit
is up to 1000.order
can be one of:by_symbol
- order by symbolby_control_account
- order by control account
start (object) |
limit (int) |
order (string) |
|
---|---|---|---|
{"nai": "@@422838704", "decimals": 0} |
10 | by_symbol |
list 10 tokens, ordered by symbol |
"" |
10 | by_control_account |
list 10 tokens, ordered by control account |
["", {"nai": "@@422838704", "decimals": 0}] |
10 | by_control_account |
list 10 tokens, ordered by control account, symbol |
See: Smart Media Tokens (SMTs)
Also see: Paginated API Methods
Query Parameters JSON
{"start": null, "limit": 0, "order": "by_symbol"}
Expected Response JSON
{
"tokens": [
{
"token": {
"id": 0,
"liquid_symbol": {"nai": "@@422838704", "decimals": 0},
"control_account": "alice",
"phase": "setup",
"current_supply": 0,
"total_vesting_fund_smt": 0,
"total_vesting_shares": 0,
"total_vesting_fund_ballast": 0,
"total_vesting_shares_ballast": 0,
"pending_rewarded_vesting_shares": 0,
"pending_rewarded_vesting_smt": 0,
"reward_balance": {
"amount": "0",
"precision": 3,
"nai": "@@000000021"
},
"recent_claims": "0",
"last_reward_update": "1970-01-01T00:00:00",
"last_virtual_emission_time": "1970-01-01T00:00:00",
"allow_downvotes": true,
"market_maker": {
"steem_balance": {
"amount": "0",
"precision": 3,
"nai": "@@000000021"
},
"token_balance": {
"amount": "0",
"precision": 0,
"nai": "@@422838704"
},
"reserve_ratio": 0
},
"allow_voting": true,
"cashout_window_seconds": 3600,
"reverse_auction_window_seconds": 900,
"vote_regeneration_period_seconds": 432000,
"votes_per_regeneration_period": 50,
"content_constant": "2000000000000",
"percent_curation_rewards": 2500,
"author_reward_curve": "linear",
"curation_reward_curve": "square_root",
"max_supply": 0
}
}
]
}
Example curl
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_smt_tokens", "params":{"start":{"nai": "@@422838704", "decimals": 0},"limit":10,"order":"by_symbol"}, "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_smt_tokens", "params":{"start":"","limit":10,"order":"by_control_account"}, "id":1}' https://api.steemit.com
curl -s --data '{"jsonrpc":"2.0", "method":"database_api.list_smt_tokens", "params":{"start":["", {"nai": "@@422838704", "decimals": 0}],"limit":10,"order":"by_control_account"}, "id":1}' https://api.steemit.com