Home

Chain API

v1.0.0
Base URL
https://eos.nownodes.io/v1/chain

OAS 3.0 Nodeos Chain API Specification

Authentication

api-keyAuthapiKey

API Key: api-key in header

Chain

Chain

POST
https://eos.nownodes.io/v1/chain/get_account

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns an object containing various details about a specific account on the blockchain.

Body

application/json

JSON Object with single member "account_name"

account_namestring | string | string | stringrequired

Response

200OK

OK

POST
https://eos.nownodes.io/v1/chain/get_block

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns an object containing various details about a specific block on the blockchain.

Body

application/json
block_num_or_idstringrequired

Provide a block number or a block id

Response

200OK

OK

POST
https://eos.nownodes.io/v1/chain/get_block_info

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Similar to get_block but returns a fixed-size smaller subset of the block data.

Body

application/json
block_numintegerrequired

Provide a block number

Response

200OK

OK

POST
https://eos.nownodes.io/v1/chain/get_info

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns an object containing various details about the blockchain.

Response

200OK

OK

POST
https://eos.nownodes.io/v1/chain/push_transaction

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

This method expects a transaction in JSON format and will attempt to apply it to the blockchain.

Body

application/json
signaturesArray<items>

array of signatures required to authorize transaction

compressionboolean

Compression used, usually false

packed_context_free_datastring

json to hex

packed_trxstring

Transaction object json to hex

Response

200OK

OK

POST
https://eos.nownodes.io/v1/chain/send_transaction

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

This method expects a transaction in JSON format and will attempt to apply it to the blockchain.

Body

application/json
signaturesArray<items>

array of signatures required to authorize transaction

compressionboolean

Compression used, usually false

packed_context_free_datastring

json to hex

packed_trxstring

Transaction object json to hex

Response

200OK

OK

POST
https://eos.nownodes.io/v1/chain/push_transactions

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

This method expects a transaction in JSON format and will attempt to apply it to the blockchain.

Body

application/json
Array<items>
Show child attributes
expirationstringrequired

Time that transaction must be confirmed by.

ref_block_numintegerrequired
ref_block_prefixintegerrequired

32-bit portion of block ID

max_net_usage_wordsstring | integerrequired

A whole number

max_cpu_usage_msstring | integerrequired

A whole number

delay_secintegerrequired
context_free_actionsArray<items>required
Show child attributes
accountstring | string | string | stringrequired
namestring | string | string | stringrequired
authorizationArray<1>required
Show child attributes
actorstring | string | string | stringrequired
permissionstring | string | string | stringrequired
dataobjectrequired
hex_datastringrequired
actionsArray<items>required
Show child attributes
accountstring | string | string | stringrequired
namestring | string | string | stringrequired
authorizationArray<1>required
Show child attributes
actorstring | string | string | stringrequired
permissionstring | string | string | stringrequired
dataobjectrequired
hex_datastringrequired
transaction_extensionsArray<block_extensions>

Response

200OK

OK

POST
https://eos.nownodes.io/v1/chain/get_block_header_state

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Retrieves the glock header state

Body

application/json
block_num_or_idstringrequired

Provide a block_number or a block_id

Response

200OK

OK

POST
https://eos.nownodes.io/v1/chain/get_abi

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Retrieves the ABI for a contract based on its account name

Body

application/json
account_namestring | string | string | stringrequired

Response

200OK

OK

POST
https://eos.nownodes.io/v1/chain/get_currency_balance

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Retrieves the current balance

Body

application/json
codestring | string | string | stringrequired
accountstring | string | string | stringrequired
symbolitemsrequired

A string representation of an EOSIO 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, example 1.0000 ABC.

Response

200OK

OK

POST
https://eos.nownodes.io/v1/chain/get_currency_stats

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Retrieves currency stats

Body

application/json
codestring | string | string | string
symbolitems

A string representation of an EOSIO 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, example 1.0000 ABC.

Response

200OK

OK

POST
https://eos.nownodes.io/v1/chain/get_required_keys

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns the required keys needed to sign a transaction.

Body

application/json
transactionitemsrequired
Show child attributes
expirationstringrequired

Time that transaction must be confirmed by.

ref_block_numintegerrequired
ref_block_prefixintegerrequired

32-bit portion of block ID

max_net_usage_wordsstring | integerrequired

A whole number

max_cpu_usage_msstring | integerrequired

A whole number

delay_secintegerrequired
context_free_actionsArray<items>required
Show child attributes
accountstring | string | string | stringrequired
namestring | string | string | stringrequired
authorizationArray<1>required
Show child attributes
actorstring | string | string | stringrequired
permissionstring | string | string | stringrequired
dataobjectrequired
hex_datastringrequired
actionsArray<items>required
Show child attributes
accountstring | string | string | stringrequired
namestring | string | string | stringrequired
authorizationArray<1>required
Show child attributes
actorstring | string | string | stringrequired
permissionstring | string | string | stringrequired
dataobjectrequired
hex_datastringrequired
transaction_extensionsArray<block_extensions>
available_keysArray<items>required

Provide the available keys

Response

200OK

OK

POST
https://eos.nownodes.io/v1/chain/get_producers

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Retrieves producers list

Body

application/json
limitstringrequired

total number of producers to retrieve

lower_boundstringrequired

In conjunction with limit can be used to paginate through the results. For example, limit=10 and lower_bound=10 would be page 2

jsonboolean

return result in JSON format

Response

200OK

OK

POST
https://eos.nownodes.io/v1/chain/get_raw_code_and_abi

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Retrieves raw code and ABI for a contract based on account name

Body

application/json
account_namestring | string | string | stringrequired

Response

200OK

OK

POST
https://eos.nownodes.io/v1/chain/get_scheduled_transaction

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Retrieves the scheduled transaction

Body

application/json
lower_boundlower_bound

Date/time string in the format YYYY-MM-DDTHH:MM:SS.sss

limitinteger

The maximum number of transactions to return

jsonboolean

true/false whether the packed transaction is converted to json

Response

200OK

OK

POST
https://eos.nownodes.io/v1/chain/get_table_by_scope

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Retrieves table scope

Body

application/json
codestringrequired

name of the contract to return table data for

tablestring

Filter results by table

lower_boundstring

Filters results to return the first element that is not less than provided value in set

upper_boundstring

Filters results to return the first element that is greater than provided value in set

limitinteger<int32>10

Limit number of results returned.

reversebooleanfalse

Reverse the order of returned results

show_payerbooleanfalse

Show RAM payer

Response

200OK

OK

POST
https://eos.nownodes.io/v1/chain/get_table_rows

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns an object containing rows from the specified table.

Body

application/json
codestringrequired

The name of the smart contract that controls the provided table

tablestringrequired

The name of the table to query

scopestringrequired

The account to which this data belongs

index_positionstring

Position of the index used, accepted parameters primary, secondary, tertiary, fourth, fifth, sixth, seventh, eighth, ninth , tenth

key_typestring

Type of key specified by index_position (for example - uint64_t or name)

encode_typestring
lower_boundstring

Filters results to return the first element that is not less than provided value in set

upper_boundstring

Filters results to return the first element that is greater than provided value in set

limitinteger<int32>10

Limit number of results returned.

reversebooleanfalse

Reverse the order of returned results

show_payerbooleanfalse

Show RAM payer

Response

200OK

OK

POST
https://eos.nownodes.io/v1/chain/get_kv_table_rows

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns an object containing rows from the specified kv table.

Body

application/json
codestringrequired

The name of the smart contract that controls the provided kv table

tablestringrequired

The name of the kv table to query

index_namestringrequired

The name of primary or secondary index

encode_typestring

Encoding type to use for index_value, lower_bound, and upper_bound. Valid values are "bytes", "string", "name", "dec", or "hex"'. If not provided, the appropriate value based on the index_name's abi indicated type, for integers "dec" is the default. "bytes" are encoded as hexidecimal strings and can be used for any type of field. Example values for each type "bytes" => "0000000000000e1a", "string" => "Some value!", "name" => "eosio", "dec" => "3610", and "hex" => "e1a".

index_valuestring

Index value used for point query encoded as 'encode_type'. Cannot be used with either lower_bound or upper_bound.

lower_boundstring

Lower bound index value for ranged query. Query result includes rows specified with lower_bound. Cannot be used with index_value. If index_value and lower_bound are not provided, then lower_bound is defaulted to be the lowest value in the table for that index_name.

upper_boundstring

Upper bound index value for ranged query. Query result includes rows specified with upper_bound. Cannot be used with index_value. If index_value and upper_bound are not provided, then upper_bound is defaulted to be the highest value in the table for that index_name.

limitinteger<int32>

Limit number of results returned

reverseboolean

Reverse the order of returned results

show_payerboolean

Provide the ram payer for each row

Response

200OK

OK

POST
https://eos.nownodes.io/v1/chain/abi_json_to_bin

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns an object containing the serialized action data.

Body

application/json
codestring | string | string | string
actionstring | string | string | string
argsobject

json object of the action parameters that will be serialized.

Response

200OK

OK

POST
https://eos.nownodes.io/v1/chain/abi_bin_to_json

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns an object containing the deserialized action data.

Body

application/json
codestring | string | string | stringrequired
actionstring | string | string | stringrequired
binargsbinargsrequired

Response

200OK

OK

POST
https://eos.nownodes.io/v1/chain/get_code

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns an object containing the smart contract WASM code.

Body

application/json
account_namestring | string | string | stringrequired
code_as_wasminteger1required

This must be 1 (true)

Response

200OK

OK

POST
https://eos.nownodes.io/v1/chain/get_raw_abi

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Returns an object containing the smart contract abi.

Body

application/json
account_namestring | string | string | stringrequired

Response

200OK

OK

POST
https://eos.nownodes.io/v1/chain/get_activated_protocol_features

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Retreives the activated protocol features for producer node

Body

application/json
lower_boundinteger

Lower bound

upper_boundinteger

Upper bound

limitinteger

The limit, default is 10

search_by_block_numboolean

Flag to indicate it is has to search by block number

reverseboolean

Flag to indicate it has to search in reverse

Response

200OK

OK

POST
https://eos.nownodes.io/v1/chain/get_accounts_by_authorizers

Authorizations

ApiKeyAuthApiKeyAuth

api-key string

NOWNodes API key passed in the api-key header.

Given a set of account names and public keys, find all account permission authorities that are, in part or whole, satisfiable

Body

application/json
accountsArray<string | string | string | string | 1>

List of authorizing accounts and/or actor/permissions

Show child attributes
Any of
Any of

String representation of privileged EOSIO name type

string

String representation of basic EOSIO name type, must be 12 characters and contain only a-z and 0-5

string

String representation of EOSIO bid name type, 1-12 characters and only a-z and 0-5 are allowed

string

String representation of EOSIO name type

string
actorstring | string | string | stringrequired
permissionstring | string | string | stringrequired
keysArray<items>

List of authorizing keys

Response

200OK

OK