[ Base URL: http://127.0.0.1/api ]
This API is provided for developers. It supports GET and POST requests.
?module=account&action=eth_get_balance&address={addressHash}
eth_get_balance
string (query)
A string with the name of the module to be invoked.
Must be set to: account
A string with the name of the action to be invoked.
Must be set to: eth_get_balance
The address of the account.
Either the block number as a string, or one of latest, earliest or pending latest will be the latest balance in a *consensus* block. earliest will be the first recorded balance for the address. pending will be the latest balance in consensus *or* nonconcensus blocks.
Response Body
successful operation
?module=account&action=balance&address={addressHash}
balance
Must be set to: balance
A 160-bit code used for identifying Accounts.
error
?module=account&action=balancemulti&address={addressHash1,addressHash2,addressHash3}
balancemulti
Must be set to: balancemulti
A 160-bit code used for identifying Accounts. Separate addresses by comma. Maximum of 20 addresses.
?module=account&action=pendingtxlist&address={addressHash}
pendingtxlist
Must be set to: pendingtxlist
integer (query)
A nonnegative integer that represents the page number to be used for pagination. 'offset' must be provided in conjunction.
A nonnegative integer that represents the maximum number of records to return when paginating. 'page' must be provided in conjunction.
?module=account&action=txlist&address={addressHash}
txlist
Must be set to: txlist
A string representing the order by block number direction. Defaults to descending order. Available values: asc, desc
A nonnegative integer that represents the starting block number.
A nonnegative integer that represents the ending block number.
A string representing the field to filter by. If none is given it returns transactions that match to, from, or contract address. Available values: to, from
unix timestamp (query)
Represents the starting block timestamp.
Represents the ending block timestamp.
?module=account&action=txlistinternal&txhash={transactionHash}
txlistinternal
Must be set to: txlistinternal
Transaction hash. Hash of contents of the transaction. A transcation hash or address hash is required.
A 160-bit code used for identifying accounts. An address hash or transaction hash is required.
A string representing the order by block number direction. Defaults to ascending order. Available values: asc, desc. WARNING: Only available if 'address' is provided.
A nonnegative integer that represents the starting block number. WARNING: Only available if 'address' is provided.
A nonnegative integer that represents the ending block number. WARNING: Only available if 'address' is provided.
A nonnegative integer that represents the page number to be used for pagination. 'offset' must be provided in conjunction. WARNING: Only available if 'address' is provided.
A nonnegative integer that represents the maximum number of records to return when paginating. 'page' must be provided in conjunction. WARNING: Only available if 'address' is provided.
?module=account&action=tokentx&address={addressHash}
tokentx
Must be set to: tokentx
A 160-bit code used for identifying accounts.
A 160-bit code used for identifying contracts.
A string representing the order by block number direction. Defaults to ascending order. Available values: asc, desc
?module=account&action=tokenbalance&contractaddress={contractAddressHash}&address={addressHash}
tokenbalance
Must be set to: tokenbalance
?module=account&action=tokenlist&address={addressHash}
tokenlist
Must be set to: tokenlist
?module=account&action=getminedblocks&address={addressHash}
getminedblocks
Must be set to: getminedblocks
?module=account&action=listaccounts
listaccounts
Must be set to: listaccounts
?module=logs&action=getLogs&fromBlock={blockNumber}&toBlock={blockNumber}&address={addressHash}&topic0={firstTopic}
getLogs
Must be set to: logs
Must be set to: getLogs
A nonnegative integer that represents the starting block number. The use of 'latest' is also supported.
A nonnegative integer that represents the ending block number. The use of 'latest' is also supported.
A 160-bit code used for identifying contracts. An address and/or topic{x} is required.
A string equal to the first topic. A topic{x} and/or address is required.
A string equal to the second topic. A topic{x} and/or address is required.
A string equal to the third topic. A topic{x} and/or address is required.
A string equal to the fourth topic. A topic{x} and/or address is required.
A string representing the and|or operator for topic0 and topic1. Required if topic0 and topic1 is used. Available values: and, or
A string representing the and|or operator for topic0 and topic2. Required if topic0 and topic2 is used. Available values: and, or
A string representing the and|or operator for topic0 and topic3. Required if topic0 and topic3 is used. Available values: and, or
A string representing the and|or operator for topic1 and topic2. Required if topic1 and topic2 is used. Available values: and, or
A string representing the and|or operator for topic1 and topic3. Required if topic1 and topic3 is used. Available values: and, or
A string representing the and|or operator for topic2 and topic3. Required if topic2 and topic3 is used. Available values: and, or
?module=token&action=getToken&contractaddress={contractAddressHash}
getToken
Must be set to: token
Must be set to: getToken
?module=token&action=getTokenHolders&contractaddress={contractAddressHash}
getTokenHolders
Must be set to: getTokenHolders
?module=token&action=bridgedTokenList
bridgedTokenList
Must be set to: bridgedTokenList
A nonnegative integer that represents the chain id, where original token exists.
?module=stats&action=tokensupply&contractaddress={contractAddressHash}
tokensupply
Must be set to: stats
Must be set to: tokensupply
?module=stats&action=ethsupplyexchange
ethsupplyexchange
Must be set to: ethsupplyexchange
?module=stats&action=ethsupply
ethsupply
Must be set to: ethsupply
?module=stats&action=coinsupply
coinsupply
Must be set to: coinsupply
?module=stats&action=coinprice
coinprice
Must be set to: coinprice
?module=stats&action=totalfees&date={date}
totalfees
Must be set to: totalfees
day in ISO 8601 format (yyyy-mm-dd)
?module=block&action=getblockreward&blockno={blockNumber}
getblockreward
Must be set to: block
Must be set to: getblockreward
A nonnegative integer that represents the block number.
?module=block&action=getblocknobytime×tamp={blockTimestamp}&closest={before/after}
getblocknobytime
Must be set to: getblocknobytime
A nonnegative integer that represents the block timestamp (Unix timestamp in seconds).
Direction to find the closest block number to given timestamp. Available values: before/after.
?module=block&action=eth_block_number
eth_block_number
Must be set to: eth_block_number
A nonnegative integer that represents the json rpc request id.
successful request
?module=contract&action=listcontracts
listcontracts
Must be set to: contract
Must be set to: listcontracts
verified|decompiled|unverified|not_decompiled|empty, or 1|2|3|4|5 respectively. This requests only contracts with that status.
Ensures that none of the returned contracts were decompiled with the provided version. Ignored unless filtering for decompiled contracts.
?module=contract&action=getabi&address={addressHash}
getabi
Must be set to: getabi
?module=contract&action=getsourcecode&address={addressHash}
getsourcecode
Must be set to: getsourcecode
curl POST example:
?module=contract&action=verify&addressHash={addressHash}&name={name}&compilerVersion={compilerVersion}&optimization={false}&contractSourceCode={contractSourceCode}
verify
Must be set to: verify
The address of the contract.
The name of the contract.
The compiler version for the contract.
boolean (query)
Whether or not compiler optimizations were enabled.
The source code of the contract.
The constructor argument data provided.
Whether or not automatically detect constructor argument.
The EVM version for the contract.
The number of optimization runs used during compilation
The name of the first library used.
The address of the first library used.
The name of the second library used.
The address of the second library used.
The name of the third library used.
The address of the third library used.
The name of the fourth library used.
The address of the fourth library used.
POST body example:
?module=contract&action=verify_via_sourcify&addressHash={addressHash}
verify_via_sourcify
Must be set to: verify_via_sourcify
file[] (query)
Array with sources and metadata files
?module=contract&action=verify_vyper_contract&addressHash={addressHash}&name={name}&compilerVersion={compilerVersion}&contractSourceCode={contractSourceCode}
verify_vyper_contract
Must be set to: verify_vyper_contract
?module=contract&action=verifysourcecode&codeformat={solidity-standard-json-input}&contractaddress={contractaddress}&contractname={contractname}&compilerversion={compilerversion}&sourceCode={sourceCode}
verifysourcecode
Must be set to: verifysourcecode
Format of sourceCode(supported only "solidity-standard-json-input")
The name of the contract. It could be empty string(""), just contract name("ContractName"), or filename and contract name("contracts/contract_1.sol:ContractName")
Standard input json
?module=contract&action=checkverifystatus&guid={identifierString}
checkverifystatus
Must be set to: checkverifystatus
A string used for identifying verification attempt
?module=transaction&action=gettxinfo&txhash={transactionHash}
gettxinfo
Must be set to: transaction
Must be set to: gettxinfo
Transaction hash. Hash of contents of the transaction.
A nonnegative integer that represents the log index to be used for pagination.
?module=transaction&action=gettxreceiptstatus&txhash={transactionHash}
gettxreceiptstatus
Must be set to: gettxreceiptstatus
?module=transaction&action=getstatus&txhash={transactionHash}
getstatus
Must be set to: getstatus