Documentation
Search…
Nodeos Chain API
API provides access to the blockchain information and interaction with the blockchain. For API request, it needs to perform an
POST line with required parameters. The manual presents examples of requests using curl. Return code 200 indicates successful operation.API requests supported:
get_account
The request returns an object containing various details about a specific account on the blockchain.
Params:
(name) account_name— An account that data is being requested for.(symbol) expected_core_symbol— A token name, consisting of a set of capital letters. This field is optional.
Request examples:
1
curl --request POST -d '{"account_name" : "rows"}' http://<node>/v1/chain/get_account
Copied!
1
curl --request POST -d '{"account_name" : "cyber"}' http://<node>/v1/chain/get_account
Copied!
1
curl --request POST -d '{"account_name":"alice", "symbol":"SYS"}' http://<node>/v1/chain/get_account
Copied!
Responses
Code: 200 OK
Value:
1
{
2
"account_name": "string", // Account information about which is issued
3
"head_block_num": 0, // Hashed number of the last block created
4
"head_block_time": "string", // Date and time the last block was created (YYYY-MM-DDTHH:MM:SS.sss)
5
"privileged": false,
6
"last_code_update": "string", // Date and time of the last code modification (YYYY-MM-DDTHH:MM:SS.sss)
7
"created": "string", // Point creation date and time (YYYY-MM-DDTHH:MM:SS.sss)
8
"core_liquid_balance": "string", // A string representation of tokens, composed of a float with a precision of 4, and a symbol composed of capital letters between 1-7 letters separated by a space, example 1.0000 ABC.
9
​
10
"ram_quota": 0, // A whole number
11
"net_weight": 0, // A whole number
12
"cpu_weight": 0, // A whole number
13
​
14
"net_limit": "string", // Net available resources
15
"cpu_limit": "string", // CPU available resources
16
"ram_limit": "string", // RAM available resources
17
"storage_limit": "string", // Storage available resources
18
​
19
"ram_usage": 0, // Amount of memory used
20
​
21
"permissions": "prods",
22
"total_resources": {...},
23
"self_delegated_bandwidth": {...},
24
"refund_request": {...},
25
"voter_info": {...},
26
​
27
"stake_info": "string" // Number of staked tokens on account balance
28
}
Copied!
get_block
The request returns an object containing various details about a specific block on the blockchain.
Params:
(string) block_num_or_id— A block number or a block id.
Request example:
1
curl --request POST -d '{"block_num_or_id": "6707315"}' http://<node>/v1/chain/get_block
Copied!
Responses
Code: 200 OK
Value:
1
{
2
"timestamp": "2020-04-20T16:28:09.000", // Date and time the block was created (YYYY-MM-DDTHH:MM:SS.sss)
3
"producer": "string", // Account of validator who signed the block
4
"confirmed": 21, // Number of validators confirming the block
5
"previous": "006...9bd", // Previous block ID
6
"transaction_mroot": "1434...d09", // Parent transaction ID
7
"action_mroot": "dea...469", // Parent action ID
8
"schedule_version": 59218,
9
"new_producers": null, // Account names of the new validators
10
"header_extensions": [],
11
"producer_signature": "SIG_K1_J...eR",
12
"transactions": [ // array of transactions included in the block
13
{
14
"status": "executed", // Transaction status, takes one of the following values:
15
"executed" - successful execution, lack of error messages;
16
"soft_fail" - unsuccessful execution; errors that appeared during the process were processed;
17
"hard_fail" - unsuccessful execution; errors that appeared during the process could not be processed;
18
"delayed" - transaction execution is postponed;
19
"expired" - the transaction timed out, the resources allocated for the transaction were returned to the owner
20
"cpu_usage_us": 33823, // CPU resource allocated for each transaction
21
"net_usage_words": 88, // Network resource allocated for each transaction
22
"ram_kbytes": 19, // RAM resource allocated for each transaction
23
"storage_kbytes": 0, // Storage resource allocated for each transaction
24
"trx": { // A transaction included in the block
25
"id": "17...8d",
26
"signatures": [
27
"SIG_K1_K...24d",
28
"SIG_K1_K...Fr3"
29
],
30
"compression": "none",
31
"packed_context_free_data": "",
32
"context_free_data": [],
33
"packed_trx": "a5cd...4000",
34
"transaction": {...}
35
}
36
}
37
],
38
"block_extensions": [],
39
"id": "006...58f22d10", // The block ID
40
"block_num": 6707315, // Number of the block
41
"ref_block_prefix": 744221143
42
}
Copied!
get_code
The request returns an object containing rows from the table for a specified account.
Params:
(name) account_name— Account name on which the contract is based.(bool) code_as_wasm— Binary code. Default isfalse.
Request example:
1
curl --request POST -d '{"account_name": "string", "code_as_wasm": 1}' http://<node>/v1/chain/get_block
Copied!
Responses
Code: 200 OK
Value:
1
{
2
"account_name": "string",
3
"wast": "string", // Textual information (WAST from get_code is no longer supported)
4
"wasm": "string", // Binary code
5
"code_hash": "string",
6
"abi": { // ABI object
7
"____comment": "string",
8
"version": "string",
9
"types": [
10
{...}
11
],
12
"structs": [
13
{...}
14
],
15
"actions": [
16
{...}
17
],
18
"events": [
19
{...}
20
],
21
"tables": [
22
{...}
23
],
24
"variants": []
25
}
26
}
Copied!
get_info
The request returns an object containing various details about the blockchain.
Params:
No params required.
Request example:
1
curl --request POST --data '' http://<node>/v1/chain/get_info
Copied!
Responses
Code: 200 OK
Value:
1
{
2
"server_version": "string", // Hash code representing the last commit in the marked version
3
"chain_id": "string", // Hash string of a chain ID
4
"head_block_num": 0, // A number of the last received block in chain
5
"last_irreversible_block_num": 0, // A number of the last block in a chain that is loaded into the system state
6
"last_irreversible_block_id": "string", // Hash identifier of the last block in a chain that is loaded into the system state
7
"head_block_id": "string", // Identifier of the last block in a chain
8
"head_block_time": "string", // The time when the last block appeared in a chain
9
"head_block_producer": "string", // Block producer who signed the last block in a chain
10
"virtual_block_cpu_limit": 0, // Processor limit calculated after each block
11
"virtual_block_net_limit": 0, // Network limit calculated after each block
12
"block_cpu_limit": 0, // Actual maximum processor limit
13
"block_net_limit": 0, // Actual maximum network limit
14
"server_version_string": "string" // String representation of a server version (patch version)
15
}
Copied!
get_code_hash
The request returns hash code of an object containing rows from the table for a specified account.
Params:
(name) account_name— An account for which information in form of hash code is requested.
Request example:
1
curl --request POST -d '{"account_name": "cyber.stake"}' http://<node>/v1/chain/get_code_hash
Copied!
Responses
Code: 200 OK
Value:
1
{
2
"account_name": "cyber.stake",
3
"code_hash": "3f5f05119...9d1c73a08b1"
4
}
Copied!
get_block_header_state
The request retrieves the block header state. This query can only be applied to a block that is not irreversible.
Params:
string block_num_or_id— A block_number or a block_id.
Request example:
1
curl --request POST -d '{"block_num_or_id" : "006762...9c283"}' http://<node>/v1/chain/get_block_header_state
Copied!
Responses
Code: 200 OK
Value:
1
{
2
"id":"006762...9c283", // Block ID
3
"block_num":6775398, // Block number
4
"header":{
5
"timestamp":"2020-04-23T05:21:39.000", // Time when the block appeared
6
"producer":"string", // Account of the validator who created the block
7
"confirmed":38, // Number of validators confirming the block
8
"previous":"006762...860fd5", // Previous block ID
9
"transaction_mroot":"0000...0000", // Parent transaction ID
10
"action_mroot":"97ee40...98a8", // Parent action ID
11
"schedule_version":59678, // Schedule version
12
"header_extensions":[], // Additional information
13
"producer_signature":"SIG_K1_J...e9N" // A signature of the validator who created the block
14
},
15
"dpos_proposed_irreversible_blocknum":6775366,
16
"dpos_irreversible_blocknum":6775334,
17
"bft_irreversible_blocknum":0,
18
"pending_schedule_lib_num":6775337,
19
"scheduled_shuffle_slot":213644813,
20
"pending_schedule_hash":"d55bd...f4b6",
21
"pending_schedule":{
22
"version":59679,
23
"producers":[ // Validators that are in the pending schedule
24
{"producer_name":"string","block_signing_key":"GLS7X...9ZpL"},
25
{...}
26
]
27
},
28
"active_schedule":{
29
"version":59678,
30
"producers":[ // Validators that are in the active schedule
31
{"producer_name":"string","block_signing_key":"GLS7By...vt9s"},
32
{...}
33
]
34
},
35
"blockroot_merkle":{
36
"_active_nodes":[ // Active node list
37
"006762...60fd5",
38
"..."
39
],
40
"_node_count":6775397
41
},
42
"producer_to_last_produced":[
43
["string",6775384], // Account of a validator and the last block it produced
44
[...]
45
],
46
"producer_to_last_implied_irb":[
47
["string",6775356], // Account of a validator and the last irreversible block it implied
48
[...]
49
],
50
"block_signing_key":"GLS8...QU2u",
51
"confirm_count":[1,1,2,2,2,3,...,21,22,23,24], // Number of confirmed blocks
52
"confirmations":[]
53
}
Copied!
get_abi
The request retrieves the ABI for a contract based on its account name.
Params:
(name) account_name— Account on which the contract is based.
Request example:
1
curl --request POST -d '{"account_name": "string"}' http://<node>/v1/chain/get_abi
Copied!
Responses
Code: 200 OK
Value:
1
"account_name": "string", // Account on which the contract is based
2
"abi": { // ABI object
3
"____comment": "string",
4
"version": "string",
5
"types": [
6
{...}
7
],
8
"structs": [
9
{...}
10
],
11
"actions": [
12
{...}
13
],
14
"events": [
15
{...}
16
],
17
"tables": [
18
{...}
19
],
20
"variants": []
21
}
22
}
Copied!
get_raw_code_and_abi
The request retrieves raw code and ABI for a contract based on account name.
Params:
(name) account_name— Account on which the contract is based.
Request example:
1
curl --request POST -d '{"account_name": "string"}' http://<node>/v1/chain/get_raw_code_and_abi
Copied!
Responses
Code: 200 OK
Value:
1
{
2
"account_name": "string", // Account on which the contract is based
3
"wasm": "string", // base64 encoded WASM
4
"abi": "string" // base64 encoded ABI
5
}
Copied!
get_raw_abi
The request returns an object containing rows from the specified table.
Params:
(name) account_name— Account on which the contract is based.(sha256) abi_hash— ABI hash. This field is optional.
Request example:
1
curl --request POST -d '{"account_name": "string"}' http://<node>/v1/chain/get_raw_abi
Copied!
Responses
Code: 200 OK
Value:
1
{
2
"account_name": "string", // Account on which the contract is based
3
"code_hash": "string", // Code hash
4
"abi_hash": "string", // ABI hash
5
"abi": "string" // base64 encoded ABI.
6
}
Copied!
get_table_rows
The request returns an object containing rows from the specified table as well as containing values of the table fields specified in the parameters.
Params:
(bool) json— Whether the object is converted to JSON. Default isfalse.(name) code— The name of the smart contract that controls the provided table.(string) scope— The account to which this data belongs.(name) table— The name of the table to query.(string) table_key— Type of key specified by index_position.(variant) lower_bound— Lower bound of search.(variant) upper_bound— Upper bound of search.(uint32_t) limit— Total number of table rows to retrieve. Default is10.(name) index— Position of the index used.(string) encode_type{"dec"}— The field takes the valuesdec,hex. Default isdec.(optional<bool>) reverse—trueif the search is in the reverse order. Default isfalse.(optional<bool>) show_payer— Display a RAM payer. Default isfalse.
Request example:
1
curl --request POST -d '{"json": false, "code":"cyber.token", "scope":"cyber", "table" : "accounts", "table_key" : "", "lower_bound" : "", "upper_bound" : "", "limit" : "7", "key_type" : "int64", "index" : "primary", "encode_type" : "dec", "reverse" : false, "show_payer" : true}' http://<node>/v1/chain/get_table_rows
Copied!
1
curl --request POST -d '{"json": false, "code":"rows", "scope":"rows", "table" : "values", "table_key" : "", "upper_bound" : {"secondary" : 252, "forth" : 18}, "limit" : "20", "key_type" : "int64", "index" : "multy", "encode_type" : "dec", "reverse" : false, "show_payer" : true}' http://<node>/v1/chain/get_table_rows
Copied!
1
curl --request POST -d '{"json": false, "code":"rows", "scope":"rows", "table" : "values", "table_key" : "", "limit" : "5", "key_type" : "", "index" : "primary", "upper_bound" : {"key" : 14}, "encode_type" : "dec", "reverse" : false, "show_payer" : false}' http://<node>/v1/chain/get_table_rows
Copied!
Responses
Code: 200 OK
Value:
1
{
2
vector<fc::variant> "rows": [ // One row per item, either encoded as hex String or JSON object.
3
null
4
],
5
"more": false, // "true" if the next element is not finite and if the condition 'sizeof data() < limit' is fulfilled. By default is "false".
6
"next": false // If "more" field is "true", this field contains an element located after the last in the rows field.
7
}
Copied!
get_currency_balance
The request retrieves the current balance.
Params:
(name) code— Token code.(name) account— Account for which balance is requested.(optional<string>) symbol— A string representation of a token symbol, composed of a float with a precision of 4, and a symbol composed of capital letters, for example1.0000 SYS.
Request example:
1
curl --request POST -d '{"code":"cyber.token", "account":"bob" , "symbol" : "SYS"}' http://<node>/v1/chain/get_currency_balance
Copied!
Responses
Code: 200 OK
Value:
1
{[
2
"string"
3
]}
Copied!
get_currency_stats
The request retrieves currency stats of a certain type of tokens in the system.
Params:
(name) code— Token code.(string) symbol— A string representation of a token symbol, composed of a float with a precision of 4, and a symbol composed of capital letters between 1-7 letters separated by a space, example1.0000 SYS.
Request example:
1
curl --request POST -d '{"code":"cyber.token", "account":"bob" , "symbol" : "SYS"}' http://<node>/v1/chain/get_currency_stats
Copied!
Responses
Code: 200 OK
Value:
1
{
2
"supply": "string", // Specified type tokens in circulation
3
"max_supply": "integer", // Limit of the specified type tokens in circulation
4
"account_name issuer": "string" // An account that created tokens of the specified type.
5
}
Copied!
get_producers
The request retrieves producers (validators) list.
Params:
(bool) json— Whether the producers list is converted to JSON. Default isfalse.(string) lower_bound— In conjunction with limit can be used to paginate through the results. For example,limit=10andlower_bound=10would be page2.(uint32_t) limit— Total number of producers to retrieve. Default is50.
Request example:
1
curl --request POST -d '{"json" : false, "lower_bound" : 2, "limit" : 10 }' http://<node>/v1/chain/get_producers
Copied!
Responses
Code: 200 OK
Value:
1
{
2
"rows":[ // One row per item, either encoded as hex string or JSON object
3
{...}
4
],
5
"total_producer_vote_weight": "integer",
6
"more": "string" // Fill lower_bound with this value to fetch more rows
7
}
Copied!
get_producer_schedule
The request retrieves producers (validators) list.
Params:
No params required.
Request example:
1
curl --request POST --data '' http://<node>/v1/chain/get_producer_schedule
Copied!
Responses
Code: 200 OK
Value:
1
{
2
"active": [{
3
"version": 0,
4
"producers": [{
5
"producer_name": "string",
6
"block_signing_key": "string"
7
}]
8
}],
9
"pending": [{
10
"version": 0,
11
"producers": [{
12
"producer_name": "string",
13
"block_signing_key": "string"
14
}]
15
}],
16
"proposed": [{
17
"version": 0,
18
"producers": [{
19
"producer_name": "string",
20
"block_signing_key": "string"
21
}]
22
}]
23
}
Copied!
get_scheduled_transactions
The request retrieves deferred transactions.
Params:
(bool) json— Whether the packed transaction is converted to JSON. Default isfalse.(string) lower_bound— Date/time string in the formatYYYY-MM-DDTHH:MM:SS.sssOR transaction ID.(uint32_t) limit— Total number of transactions to retrieve. Default is50.
Request example:
1
curl --request POST -d '{"json" : false, "limit" : 10 }' http://<node>/v1/chain/get_scheduled_transactions
Copied!
Responses
Code: 200 OK
Value:
1
{
2
"transactions": [
3
{...}
4
"more": "string" // fill lower_bound with this to fetch next set of transactions
5
]
6
}
Copied!
abi_json_to_bin
The request returns an object containing rows from the specified table.
Params:
(name) code— A name of row.(name) action— Action name.(variant) args— Arguments in JSON form.
Request example:
1
curl --request POST -d '{"code" : "rows", "action" : "filltable", "args" : {"fildltable" : 30} }' http://<node>/v1/chain/abi_json_to_bin
Copied!
Responses
Code: 200 OK
Value:
1
{
2
"binargs": "string"
3
}
Copied!
abi_bin_to_json
The request returns an object containing rows from the specified table.
Params:
(name) code— A name of row.(name) action— Action name.(vector<char>) binargs— String containing binary arguments.
Request example:
1
curl --request POST -d '{"code" : "rows", "action" : "filltable", "binargs" : "1e00000000000000" }' http://<node>/v1/chain/abi_bin_to_json
Copied!
Responses
Code: 200 OK
Value:
1
{
2
"string"
3
}
Copied!
get_required_keys
The request returns the required keys needed to sign a transaction.
Params:
- (object) transaction:
(string) expiration— Time in format ofYYYY-MM-DDTHH:MM:SS.sssthat transaction must be confirmed by.(integer) ref_block_num— Block number containing the transaction.(integer) ref_block_prefix— Prefix of block containing the transaction.(string/integer) max_net_usage_words— Network resource allocated for the transaction.(string/integer) max_cpu_usage_ms— CPU resource allocated for the transaction.(integer) max_ram_kbytes— RAM resource allocated for the transaction.(integer) max_storage_kbytes— Storage resource allocated for the transaction.(integer) delay_sec— Delay time (in seconds).(array of objects) actions— Actions composed of transaction.(array of integers/strings) transaction_extensions— Objects included in the transaction.
(string) available_keys— Provide the available keys.
Request example:
1
curl --request POST -d '{"transaction" : {"trx_id":"d48b...90ee8","sender":"","sender_id": "308457...031097", "payer":"cyber.token", "delay_until":"2019-03-29T05:42:03.000", "expiration":"2019-03-29T05:52:03.000", "published":"2019-03-29T05:32:03.000", "transaction":"eead9d5...59530000000000"}, "available_keys" : ["GLS62zK8V5V...YUHM3YeLZg"] }' http://<node>/v1/chain/get_required_keys
Copied!
Responses
Code: 200 OK
Value:
1
{
2
null // String containing keys. Empty string means the transaction has already been signed
3
}
Copied!
get_transaction_id
The request returns ID of a transaction using specified parameters if such transaction is in chain DB, otherwise returns a message like this one "Unknown Transaction ID: ...".
Params:
Optional set params is used.
Request examples:
1
curl --request POST -d '{"context_free_actions":[],"actions":[{"account":"cyber.token","name":"create","authorization":[{"actor":"cyber.token","permission":"active"}],"data":{"issuer":"cyber","maximum_supply":{"amount":1000000000000,"decs":4,"sym":"SYS"}},"hex_data":"0000000080ab8e470010a5d4e80000000453595300000000"}],"transaction_extensions":[]}' http://<node>/v1/chain/get_transaction_id
Copied!
1
curl --request POST -d '{"context_free_actions":[],"actions":[{"account":"cyber.token","name":"create","authorization":[{"actor":"cyber.token","permission":"active"}],"data":"0000000080ab8e470010a5d4e80000000453595300000000"}],"transaction_extensions":[]}' http://<node>/v1/chain/get_transaction_id
Copied!
Responses
Code: 200 OK
Value:
1
{
2
"trx_id": "d48b5b27f90...a6f85fc90ee8"
3
}
Copied!
get_agent_public_key
The request returns a key needed to sign a transaction if such key is in chain DB, otherwise returns an empty string.
Params:
(account_name) account— An agent for which the key is requested. An agent is a potentially active account who has the staked tokens.(symbol) symbol— Identifier of a staked token, that is a token cost accuracy in the form of decimal places number and a token name, consisting of a set of capital letters.
Request example:
1
curl --request POST -d '{"account" : "alice", "symbol" : "4,CYBER"}' http://<node>/v1/chain/get_agent_public_key
Copied!
Responses
Code: 200 OK
Value:
1
{
2
"signing_key": "GLS62zK8V5U4fsg...Wn"
3
}
Copied!
resolve_names
The request returns the resolved domain and user names retrieved from the JSON format array. The request does not successfully complete if at least one name from the array is invalid.
Params:
- Kinds of supported names:
(string) domain— A domain name.(string) @domain— A domain name.(string) [email protected]— A username is in a domain scope.(string) [email protected]@domain— A username is directly in a domain scope.
Request example:
1
curl --request POST --data '["@alice","[email protected]","[email protected]@gls"]' http://<node>/v1/chain/resolve_names
Copied!
Responses
Code: 200 OK
Value:
1
[
2
{"resolved_domain":"rhdaax5zvnd"}, // "alice" was resolved to "rhdaax5zvnd"
3
{"resolved_domain":"gls","resolved_username":"rhdaax5zvnd"}, // "golos" was resolved to "gls"
4
{"resolved_username":"ertojevqcywn"} // "bob" was resolved to "ertojevqcywn"
5
]
Copied!
get_proxy_status
The request retrieves an information for specified proxy account.
Params:
(account_name) account— A proxy account name.(symbol) symbol— Identifier of a token (provided by grantors), that is a token cost accuracy in the form of decimal places number and a token name, consisting of a set of capital letters.
Request example:
1
curl --request POST -d '{"account" : "alice", "symbol" : "4,CYBER"}' http://<node>/v1/chain/get_proxy_status
Copied!
Responses
Code: 200 OK
Value:
1
{
2
"account_name": "alice",
3
"symbol": [ // Type of tokens provided to the proxy account by grantors for voting
4
{
5
"accuracy": "4",
6
"symbol_code": "CYBER",
7
}
8
]
9
"proxylevel": 1,
10
"proxies_count": 3 // Number of grantors
11
}
Copied!
Last modified 1yr ago
Copy link
Contents
get_account
Responses
get_block
Responses
get_code
Responses
get_info
Responses
get_code_hash
Responses
get_block_header_state
Responses
get_abi
Responses
get_raw_code_and_abi
Responses
get_raw_abi
Responses
get_table_rows
Responses
get_currency_balance
Responses
get_currency_stats
Responses
get_producers
Responses
get_producer_schedule
Responses
get_scheduled_transactions
Responses
abi_json_to_bin
Responses
abi_bin_to_json
Responses
get_required_keys
Responses
get_transaction_id
Responses
get_agent_public_key
Responses
resolve_names
Responses
get_proxy_status
Responses