API Documentation

[ Base URL: http://api ]

This API is provided for developers transitioning their applications from Etherscan to BlockScout. It supports GET and POST requests.

Account ?module=account Logs ?module=logs Token ?module=token Stats ?module=stats Block ?module=block Contract ?module=contract Transaction ?module=transaction

Account ?module=account

Mimics Ethereum JSON RPC's eth_getBalance. Returns the balance as of the provided block (defaults to latest)

?module=account&action=eth_get_balance&address={addressHash}

eth_get_balance

GET POST

More Details Hide Details

Parameters

Name

Description

Module *required

string (query)

A string with the name of the module to be invoked.

Must be set to: account

Action *required

string (query)

A string with the name of the action to be invoked.

Must be set to: eth_get_balance

address *required

string (query)

The address of the account.

block

string (query)

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.

Curl

Request URL

Server Response

Code

Details

Response Body

Responses

Code

Description

200

successful operation

Example Value
Model

Result {

id: string
example: "1"

jsonrpc: string
example: "2.0"

result: string
example: "767969"

}

Get balance for address. Also available through a GraphQL 'addresses' query. If the balance hasn't been updated in a long time, we will double check with the node to fetch the absolute latest balance. This will not be reflected in the current request, but once it is updated, subsequent requests will show the updated balance. If you want to know whether or not we are checking for another balance, use the `balancemulti` action. That contains a property called `stale` that will let you know to recheck that balance in the near future.

?module=account&action=balance&address={addressHash}

balance

GET POST

More Details Hide Details

Parameters

Name

Description

Module *required

string (query)

A string with the name of the module to be invoked.

Must be set to: account

Action *required

string (query)

A string with the name of the action to be invoked.

Must be set to: balance

address *required

string (query)

A 160-bit code used for identifying Accounts.

Curl

Request URL

Server Response

Code

Details

Response Body

Responses

Code

Description

200

successful operation

Example Value
Model

Result {

message: string
example: "OK"

result: wei
example: "663046792267785498951364"

status

status

enum: ["0", "1"]

enum
interpretation

"0"

error

"1"

}

200

error

Example Value

Get balance for multiple addresses. Also available through a GraphQL 'addresses' query. If the balance hasn't been updated in a long time, we will double check with the node to fetch the absolute latest balance. This will not be reflected in the current request, but once it is updated, subsequent requests will show the updated balance. You can know that this is taking place via the `stale` attribute, which is set to `true` if a new balance is being fetched.

?module=account&action=balancemulti&address={addressHash1,addressHash2,addressHash3}

balancemulti

GET POST

More Details Hide Details

Parameters

Name

Description

Module *required

string (query)

A string with the name of the module to be invoked.

Must be set to: account

Action *required

string (query)

A string with the name of the action to be invoked.

Must be set to: balancemulti

address *required

string (query)

A 160-bit code used for identifying Accounts. Separate addresses by comma. Maximum of 20 addresses.

Curl

Request URL

Server Response

Code

Details

Response Body

Responses

Code

Description

200

successful operation

Example Value
Model

Result {

message: string
example: "OK"

result: array
[AddressBalance]

status

status

enum: ["0", "1"]

enum
interpretation

"0"

error

"1"

}

AddressBalance {

address: address hash
example: "0x95426f2bc716022fcf1def006dbc4bb81f5b5164"

balance: wei
example: "663046792267785498951364"

stale: boolean
example: true

}

200

error

Example Value

Get pending transactions by address.

?module=account&action=pendingtxlist&address={addressHash}

pendingtxlist

GET POST

More Details Hide Details

Parameters

Name

Description

Module *required

string (query)

A string with the name of the module to be invoked.

Must be set to: account

Action *required

string (query)

A string with the name of the action to be invoked.

Must be set to: pendingtxlist

address *required

string (query)

A 160-bit code used for identifying Accounts.

page

integer (query)

A nonnegative integer that represents the page number to be used for pagination. 'offset' must be provided in conjunction.

offset

integer (query)

A nonnegative integer that represents the maximum number of records to return when paginating. 'page' must be provided in conjunction.

Curl

Request URL

Server Response

Code

Details

Response Body

Responses

Code

Description

200

successful operation

Example Value
Model

Result {

message: string
example: "OK"

result: array
[Transaction]

status

status

enum: ["0", "1"]

enum
interpretation

"0"

error

"1"

}

Transaction {

blockHash: block hash
example: "0xd3cabad6adab0b52eb632c386ea194036805713682c62cb589b5abcd76de2159"

blockNumber: block number
example: "34092"

confirmations: confirmations
example: "6005998"

contractAddress: address hash
example: "0x95426f2bc716022fcf1def006dbc4bb81f5b5164"

cumulativeGasUsed: gas
example: "122261"

from: address hash
example: "0x95426f2bc716022fcf1def006dbc4bb81f5b5164"

gas: gas
example: "122261"

gasPrice: wei
example: "663046792267785498951364"

gasUsed: gas
example: "122261"

hash: transaction hash
example: "0x9c81f44c29ff0226f835cd0a8a2f2a7eca6db52a711f8211b566fd15d3e0e8d4"

input: input
example: "0x797af627d02e23b68e085092cd0d47d6cfb54be025f37b5989c0264398f534c08af7dea9"

isError

error

enum: ["0", "1"]

enum
interpretation

"0"

"1"

error

nonce: nonce
example: "0"

timeStamp: timestamp
example: "1439232889"

to: address hash
example: "0x95426f2bc716022fcf1def006dbc4bb81f5b5164"

transactionIndex: transaction index
example: "0"

txreceipt_status

status

enum: ["0", "1"]

enum
interpretation

"0"

error

"1"

value: wei
example: "663046792267785498951364"

}

200

error

Example Value

Get transactions by address. Up to a maximum of 10,000 transactions. Also available through a GraphQL 'address' query.

?module=account&action=txlist&address={addressHash}

txlist

GET POST

More Details Hide Details

Parameters

Name

Description

Module *required

string (query)

A string with the name of the module to be invoked.

Must be set to: account

Action *required

string (query)

A string with the name of the action to be invoked.

Must be set to: txlist

address *required

string (query)

A 160-bit code used for identifying Accounts.

sort

string (query)

A string representing the order by block number direction. Defaults to descending order. Available values: asc, desc

start_block

integer (query)

A nonnegative integer that represents the starting block number.

end_block

integer (query)

A nonnegative integer that represents the ending block number.

page

integer (query)

A nonnegative integer that represents the page number to be used for pagination. 'offset' must be provided in conjunction.

offset

integer (query)

A nonnegative integer that represents the maximum number of records to return when paginating. 'page' must be provided in conjunction.

filter_by

string (query)

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

start_timestamp

unix timestamp (query)

Represents the starting block timestamp.

end_timestamp

unix timestamp (query)

Represents the ending block timestamp.

Curl

Request URL

Server Response

Code

Details

Response Body

Responses

Code

Description

200

successful operation

Example Value
Model

Result {

message: string
example: "OK"

result: array
[Transaction]

status

status

enum: ["0", "1"]

enum
interpretation

"0"

error

"1"

}

Transaction {

blockHash: block hash
example: "0xd3cabad6adab0b52eb632c386ea194036805713682c62cb589b5abcd76de2159"

blockNumber: block number
example: "34092"

confirmations: confirmations
example: "6005998"

contractAddress: address hash
example: "0x95426f2bc716022fcf1def006dbc4bb81f5b5164"

cumulativeGasUsed: gas
example: "122261"

from: address hash
example: "0x95426f2bc716022fcf1def006dbc4bb81f5b5164"

gas: gas
example: "122261"

gasPrice: wei
example: "663046792267785498951364"

gasUsed: gas
example: "122261"

hash: transaction hash
example: "0x9c81f44c29ff0226f835cd0a8a2f2a7eca6db52a711f8211b566fd15d3e0e8d4"

input: input
example: "0x797af627d02e23b68e085092cd0d47d6cfb54be025f37b5989c0264398f534c08af7dea9"

isError

error

enum: ["0", "1"]

enum
interpretation

"0"

"1"

error

nonce: nonce
example: "0"

timeStamp: timestamp
example: "1439232889"

to: address hash
example: "0x95426f2bc716022fcf1def006dbc4bb81f5b5164"

transactionIndex: transaction index
example: "0"

txreceipt_status

status

enum: ["0", "1"]

enum
interpretation

"0"

error

"1"

value: wei
example: "663046792267785498951364"

}

200

error

Example Value

Get internal transactions by transaction or address hash. Up to a maximum of 10,000 internal transactions. Also available through a GraphQL 'transaction' query.

?module=account&action=txlistinternal&txhash={transactionHash}

txlistinternal

GET POST

More Details Hide Details

Parameters

Name

Description

Module *required

string (query)

A string with the name of the module to be invoked.

Must be set to: account

Action *required

string (query)

A string with the name of the action to be invoked.

Must be set to: txlistinternal

txhash *required

string (query)

Transaction hash. Hash of contents of the transaction. A transcation hash or address hash is required.

address

string (query)

A 160-bit code used for identifying accounts. An address hash or transaction hash is required.

sort

string (query)

A string representing the order by block number direction. Defaults to ascending order. Available values: asc, desc. WARNING: Only available if 'address' is provided.

start_block

integer (query)

A nonnegative integer that represents the starting block number. WARNING: Only available if 'address' is provided.

end_block

integer (query)

A nonnegative integer that represents the ending block number. WARNING: Only available if 'address' is provided.

page

integer (query)

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.

offset

integer (query)

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.

Curl

Request URL

Server Response

Code

Details

Response Body

Responses

Code

Description

200

successful operation

Example Value
Model

Result {

message: string
example: "OK"

result: array
[InternalTransaction]

status

status

enum: ["0", "1"]

enum
interpretation

"0"

error

"1"

}

InternalTransaction {

blockNumber: block number
example: "34092"

callType: type
example: "delegatecall"

contractAddress: address hash
example: "0x95426f2bc716022fcf1def006dbc4bb81f5b5164"

errCode: string
example: "Out of gas"

from: address hash
example: "0x95426f2bc716022fcf1def006dbc4bb81f5b5164"

gas: gas
example: "122261"

gasUsed: gas
example: "122261"

input: input
example: "0x797af627d02e23b68e085092cd0d47d6cfb54be025f37b5989c0264398f534c08af7dea9"

isError

error

enum: ["0", "1"]

enum
interpretation

"0"

"1"

rejected/cancelled

timeStamp: timestamp
example: "1439232889"

to: address hash
example: "0x95426f2bc716022fcf1def006dbc4bb81f5b5164"

type: type
example: "create"

value: wei
example: "663046792267785498951364"

}

200

error

Example Value

Get token transfer events by address. Up to a maximum of 10,000 token transfer events. Also available through a GraphQL 'token_transfers' query.

?module=account&action=tokentx&address={addressHash}

tokentx

GET POST

More Details Hide Details

Parameters

Name

Description

Module *required

string (query)

A string with the name of the module to be invoked.

Must be set to: account

Action *required

string (query)

A string with the name of the action to be invoked.

Must be set to: tokentx

address *required

string (query)

A 160-bit code used for identifying accounts.

contractaddress

string (query)

A 160-bit code used for identifying contracts.

sort

string (query)

A string representing the order by block number direction. Defaults to ascending order. Available values: asc, desc

start_block

integer (query)

A nonnegative integer that represents the starting block number.

end_block

integer (query)

A nonnegative integer that represents the ending block number.

page

integer (query)

A nonnegative integer that represents the page number to be used for pagination. 'offset' must be provided in conjunction.

offset

integer (query)

A nonnegative integer that represents the maximum number of records to return when paginating. 'page' must be provided in conjunction.

Curl

Request URL

Server Response

Code

Details

Response Body

Responses

Code

Description

200

successful operation

Example Value
Model

Result {

message: string
example: "OK"

result: array
[TokenTransfer]

status

status

enum: ["0", "1"]

enum
interpretation

"0"

error

"1"

}

TokenTransfer {

blockHash: block hash
example: "0xd3cabad6adab0b52eb632c386ea194036805713682c62cb589b5abcd76de2159"

blockNumber: block number
example: "34092"

confirmations: confirmations
example: "6005998"

contractAddress: address hash
example: "0x95426f2bc716022fcf1def006dbc4bb81f5b5164"

cumulativeGasUsed: gas
example: "122261"

from: address hash
example: "0x95426f2bc716022fcf1def006dbc4bb81f5b5164"

gas: gas
example: "122261"

gasPrice: wei
example: "663046792267785498951364"

gasUsed: gas
example: "122261"

hash: transaction hash
example: "0x9c81f44c29ff0226f835cd0a8a2f2a7eca6db52a711f8211b566fd15d3e0e8d4"

input: input
example: "0x797af627d02e23b68e085092cd0d47d6cfb54be025f37b5989c0264398f534c08af7dea9"

nonce: nonce
example: "0"

timeStamp: timestamp
example: "1439232889"

to: address hash
example: "0x95426f2bc716022fcf1def006dbc4bb81f5b5164"

tokenDecimal: integer
example: "18"

tokenID: integer
example: "0"

tokenIDs: array
[Token ID]

tokenName: string
example: "Some Token Name"

tokenSymbol: string
example: "SYMBOL"

transactionIndex: transaction index
example: "0"

value: integer
example: "663046792267785498951364"

values: array
[Transferred amount]

}

200

error

Example Value

Get token account balance for token contract address.

?module=account&action=tokenbalance&contractaddress={contractAddressHash}&address={addressHash}

tokenbalance

GET POST

More Details Hide Details

Parameters

Name

Description

Module *required

string (query)

A string with the name of the module to be invoked.

Must be set to: account

Action *required

string (query)

A string with the name of the action to be invoked.

Must be set to: tokenbalance

contractaddress *required

string (query)

A 160-bit code used for identifying contracts.

address *required

string (query)

A 160-bit code used for identifying accounts.

Curl

Request URL

Server Response

Code

Details

Response Body

Responses

Code

Description

200

successful operation

Example Value
Model

Result {

message: string
example: "OK"

result: integer
example: "135499"

status

status

enum: ["0", "1"]

enum
interpretation

"0"

error

"1"

}

200

error

Example Value

Get list of tokens owned by address.

?module=account&action=tokenlist&address={addressHash}

tokenlist

GET POST

More Details Hide Details

Parameters

Name

Description

Module *required

string (query)

A string with the name of the module to be invoked.

Must be set to: account

Action *required

string (query)

A string with the name of the action to be invoked.

Must be set to: tokenlist

address *required

string (query)

A 160-bit code used for identifying accounts.

Curl

Request URL

Server Response

Code

Details

Response Body

Responses

Code

Description

200

successful operation

Example Value
Model

Result {

message: string
example: "OK"

result: array
[TokenBalance]

status

status

enum: ["0", "1"]

enum
interpretation

"0"

error

"1"

}

TokenBalance {

balance: integer
example: "135499"

contractAddress: address hash
example: "0x95426f2bc716022fcf1def006dbc4bb81f5b5164"

decimals: integer
example: "18"

name: string
example: "Some Token Name"

symbol: string
example: "SYMBOL"

}

200

error

Example Value

Get list of blocks mined by address.

?module=account&action=getminedblocks&address={addressHash}

getminedblocks

GET POST

More Details Hide Details

Parameters

Name

Description

Module *required

string (query)

A string with the name of the module to be invoked.

Must be set to: account

Action *required

string (query)

A string with the name of the action to be invoked.

Must be set to: getminedblocks

address *required

string (query)

A 160-bit code used for identifying accounts.

page

integer (query)

A nonnegative integer that represents the page number to be used for pagination. 'offset' must be provided in conjunction.

offset

integer (query)

A nonnegative integer that represents the maximum number of records to return when paginating. 'page' must be provided in conjunction.

Curl

Request URL

Server Response

Code

Details

Response Body

Responses

Code

Description

200

successful operation

Example Value
Model

Result {

message: string
example: "OK"

result: array
[Block]

status

status

enum: ["0", "1"]

enum
interpretation

"0"

error

"1"

}

Block {

blockNumber: block number
example: "34092"

timeStamp: timestamp
example: "1480072029"

}

200

error

Example Value

Get a list of accounts and their balances, sorted ascending by the time they were first seen by the explorer.

?module=account&action=listaccounts

listaccounts

GET POST

More Details Hide Details

Parameters

Name

Description

Module *required

string (query)

A string with the name of the module to be invoked.

Must be set to: account

Action *required

string (query)

A string with the name of the action to be invoked.

Must be set to: listaccounts

page

integer (query)

A nonnegative integer that represents the page number to be used for pagination. 'offset' must be provided in conjunction.

offset

integer (query)

A nonnegative integer that represents the maximum number of records to return when paginating. 'page' must be provided in conjunction.

Curl

Request URL

Server Response

Code

Details

Response Body

Responses

Code

Description

200

successful operation

Example Value
Model

Result {

message: string
example: "OK"

result: array
[Account]

status

status

enum: ["0", "1"]

enum
interpretation

"0"

error

"1"

}

Account {

address: address hash
example: "0x95426f2bc716022fcf1def006dbc4bb81f5b5164"

balance: wei
example: "663046792267785498951364"

}

Logs ?module=logs

Get event logs for an address and/or topics. Up to a maximum of 1,000 event logs.

?module=logs&action=getLogs&fromBlock={blockNumber}&toBlock={blockNumber}&address={addressHash}&topic0={firstTopic}

getLogs

GET POST

More Details Hide Details

Parameters

Name

Description

Module *required

string (query)

A string with the name of the module to be invoked.

Must be set to: logs

Action *required

string (query)

A string with the name of the action to be invoked.

Must be set to: getLogs

fromBlock *required

integer (query)

A nonnegative integer that represents the starting block number. The use of 'latest' is also supported.

toBlock *required

integer (query)

A nonnegative integer that represents the ending block number. The use of 'latest' is also supported.

address *required

string (query)

A 160-bit code used for identifying contracts. An address and/or topic{x} is required.

topic0 *required

string (query)

A string equal to the first topic. A topic{x} and/or address is required.

topic1

string (query)

A string equal to the second topic. A topic{x} and/or address is required.

topic2

string (query)

A string equal to the third topic. A topic{x} and/or address is required.

topic3

string (query)

A string equal to the fourth topic. A topic{x} and/or address is required.

topic0_1_opr

string (query)

A string representing the and|or operator for topic0 and topic1. Required if topic0 and topic1 is used. Available values: and, or

topic0_2_opr

string (query)

A string representing the and|or operator for topic0 and topic2. Required if topic0 and topic2 is used. Available values: and, or

topic0_3_opr

string (query)

A string representing the and|or operator for topic0 and topic3. Required if topic0 and topic3 is used. Available values: and, or

topic1_2_opr

string (query)

A string representing the and|or operator for topic1 and topic2. Required if topic1 and topic2 is used. Available values: and, or

topic1_3_opr

string (query)

A string representing the and|or operator for topic1 and topic3. Required if topic1 and topic3 is used. Available values: and, or

topic2_3_opr

string (query)

A string representing the and|or operator for topic2 and topic3. Required if topic2 and topic3 is used. Available values: and, or

Curl

Request URL

Server Response

Code

Details

Response Body

Responses

Code

Description

200

successful operation

Example Value
Model

Result {

message: string
example: "OK"

result: array
[Log]

status

status

enum: ["0", "1"]

enum
interpretation

"0"

error

"1"

}

Log {

address: address hash
example: "0x95426f2bc716022fcf1def006dbc4bb81f5b5164"

blockNumber: block number
example: "0x5c958"

data: data
example: "0x"

gasPrice: wei
example: "0xba43b7400"

gasUsed: gas
example: "0x10682"

logIndex: hexadecimal
example: "0x"

timeStamp: timestamp
example: "0x561d688c"

topics: topics
example: ["0xf63780e752c6a54a94fc52715dbc5518a3b4c3c2833d301a204226548a2a8545"]

transactionHash: transaction hash
example: "0x9c81f44c29ff0226f835cd0a8a2f2a7eca6db52a711f8211b566fd15d3e0e8d4"

transactionIndex: hexadecimal
example: "0x"

}

200

error

Example Value

Token ?module=token

Get ERC-20 or ERC-721 token by contract address.

?module=token&action=getToken&contractaddress={contractAddressHash}

getToken

GET POST

More Details Hide Details

Parameters

Name

Description

Module *required

string (query)

A string with the name of the module to be invoked.

Must be set to: token

Action *required

string (query)

A string with the name of the action to be invoked.

Must be set to: getToken

contractaddress *required

string (query)

A 160-bit code used for identifying contracts.

Curl

Request URL

Server Response

Code

Details

Response Body

Responses

Code

Description

200

successful operation

Example Value
Model

Result {

message: string
example: "OK"

result: Token

status

status

enum: ["0", "1"]

enum
interpretation

"0"

error

"1"

}

Token {

cataloged: boolean
example: true

contractAddress: address hash
example: "0x95426f2bc716022fcf1def006dbc4bb81f5b5164"

decimals: integer
example: "18"

name: string
example: "Some Token Name"

symbol: string
example: "SYMBOL"

totalSupply: integer
example: "1000000000"

type

token type

enum: ["ERC-20", "ERC-721"]

enum
interpretation

"ERC-20"

ERC-20 token standard

"ERC-721"

ERC-721 token standard

}

200

error

Example Value

Get token holders by contract address.

?module=token&action=getTokenHolders&contractaddress={contractAddressHash}

getTokenHolders

GET POST

More Details Hide Details

Parameters

Name

Description

Module *required

string (query)

A string with the name of the module to be invoked.

Must be set to: token

Action *required

string (query)

A string with the name of the action to be invoked.

Must be set to: getTokenHolders

contractaddress *required

string (query)

A 160-bit code used for identifying contracts.

page

integer (query)

A nonnegative integer that represents the page number to be used for pagination. 'offset' must be provided in conjunction.

offset

integer (query)

A nonnegative integer that represents the maximum number of records to return when paginating. 'page' must be provided in conjunction.

Curl

Request URL

Server Response

Code

Details

Response Body

Responses

Code

Description

200

successful operation

Example Value
Model

Result {

message: string
example: "OK"

result: array
[Token holder Detail]

status

status

enum: ["0", "1"]

enum
interpretation

"0"

error

"1"

}

Token holder Detail {

address: address hash
example: "0x95426f2bc716022fcf1def006dbc4bb81f5b5164"

value: value
example: "1000000000000000000"

}

200

error

Example Value

Stats ?module=stats

Get ERC-20 or ERC-721 token total supply by contract address.

?module=stats&action=tokensupply&contractaddress={contractAddressHash}

tokensupply

GET POST

More Details Hide Details

Parameters

Name

Description

Module *required

string (query)

A string with the name of the module to be invoked.

Must be set to: stats

Action *required

string (query)

A string with the name of the action to be invoked.

Must be set to: tokensupply

contractaddress *required

string (query)

A 160-bit code used for identifying contracts.

Curl

Request URL

Server Response

Code

Details

Response Body

Responses

Code

Description

200

successful operation

Example Value
Model

Result {

message: string
example: "OK"

result: integer
example: "1000000000"

status

status

enum: ["0", "1"]

enum
interpretation

"0"

error

"1"

}

200

error

Example Value

Get total supply in Wei from exchange.

?module=stats&action=ethsupplyexchange

ethsupplyexchange

GET POST

More Details Hide Details

Parameters

Name

Description

Module *required

string (query)

A string with the name of the module to be invoked.

Must be set to: stats

Action *required

string (query)

A string with the name of the action to be invoked.

Must be set to: ethsupplyexchange

Curl

Request URL

Server Response

Code

Details

Response Body

Responses

Code

Description

200

successful operation

Example Value
Model

Result {

message: string
example: "OK"

result: integer
example: "101959776311500000000000000"

description: The total supply.

status

status

enum: ["0", "1"]

enum
interpretation

"0"

error

"1"

}

Get total supply in Wei from DB.

?module=stats&action=ethsupply

ethsupply

GET POST

More Details Hide Details

Parameters

Name

Description

Module *required

string (query)

A string with the name of the module to be invoked.

Must be set to: stats

Action *required

string (query)

A string with the name of the action to be invoked.

Must be set to: ethsupply

Curl

Request URL

Server Response

Code

Details

Response Body

Responses

Code

Description

200

successful operation

Example Value
Model

Result {

message: string
example: "OK"

result: integer
example: "101959776311500000000000000"

description: The total supply in Wei from DB.

status

status

enum: ["0", "1"]

enum
interpretation

"0"

error

"1"

}

Get total coin supply from DB minus burnt number.

?module=stats&action=coinsupply

coinsupply

GET POST

More Details Hide Details

Parameters

Name

Description

Module *required

string (query)

A string with the name of the module to be invoked.

Must be set to: stats

Action *required

string (query)

A string with the name of the action to be invoked.

Must be set to: coinsupply

Curl

Request URL

Server Response

Code

Details

Response Body

Responses

Code

Description

200

successful operation

Example Value
Model

Result {

result: integer
example: 101959776.3115

description: The total supply from DB minus burnt number in coin dimension.

}

Get latest price of native coin in USD and BTC.

?module=stats&action=coinprice

coinprice

GET POST

More Details Hide Details

Parameters

Name

Description

Module *required

string (query)

A string with the name of the module to be invoked.

Must be set to: stats

Action *required

string (query)

A string with the name of the action to be invoked.

Must be set to: coinprice

Curl

Request URL

Server Response

Code

Details

Response Body

Responses

Code

Description

200

successful operation

Example Value
Model

Result {

message: string
example: "OK"

result: CoinPrice

status

status

enum: ["0", "1"]

enum
interpretation

"0"

error

"1"

}

CoinPrice {

coin_btc: coin_btc
example: "0.03161"

coin_btc_timestamp: timestamp
example: "1537234460"

coin_usd: coin_usd
example: "197.57"

coin_usd_timestamp: timestamp
example: "1537234460"

}

Gets total transaction fees in Wei are paid by users to validators per day.

?module=stats&action=totalfees&date={date}

totalfees

GET POST

More Details Hide Details

Parameters

Name

Description

Module *required

string (query)

A string with the name of the module to be invoked.

Must be set to: stats

Action *required

string (query)

A string with the name of the action to be invoked.

Must be set to: totalfees

date *required

string (query)

day in ISO 8601 format (yyyy-mm-dd)

Curl

Request URL

Server Response

Code

Details

Response Body

Responses

Code

Description

200

successful operation

Example Value
Model

Result {

message: string
example: "OK"

result: TotalFees

status

status

enum: ["0", "1"]

enum
interpretation

"0"

error

"1"

}

TotalFees {

total_fees: total_fees
example: "75411956011480008034"

}

200

error

Example Value

Block ?module=block

Get block reward by block number.

?module=block&action=getblockreward&blockno={blockNumber}

getblockreward

GET POST

More Details Hide Details

Parameters

Name

Description

Module *required

string (query)

A string with the name of the module to be invoked.

Must be set to: block

Action *required

string (query)

A string with the name of the action to be invoked.

Must be set to: getblockreward

blockno *required

integer (query)

A nonnegative integer that represents the block number.

Curl

Request URL

Server Response

Code

Details

Response Body

Responses

Code

Description

200

successful operation

Example Value
Model

Result {

message: string
example: "OK"

result: BlockReward

status

status

enum: ["0", "1"]

enum
interpretation

"0"

error

"1"

}

BlockReward {

blockMiner: address hash
example: "0x95426f2bc716022fcf1def006dbc4bb81f5b5164"

blockNumber: block number
example: "34092"

blockReward: block reward
example: "5003251945421042780"

timeStamp: timestamp
example: "1480072029"

uncleInclusionReward: null

uncles: null

}

200

error

Example Value

Get Block Number by Timestamp.

?module=block&action=getblocknobytime×tamp={blockTimestamp}&closest={before/after}

getblocknobytime

GET POST

More Details Hide Details

Parameters

Name

Description

Module *required

string (query)

A string with the name of the module to be invoked.

Must be set to: block

Action *required

string (query)

A string with the name of the action to be invoked.

Must be set to: getblocknobytime

timestamp *required

integer (query)

A nonnegative integer that represents the block timestamp (Unix timestamp in seconds).

closest *required

string (query)

Direction to find the closest block number to given timestamp. Available values: before/after.

Curl

Request URL

Server Response

Code

Details

Response Body

Responses

Code

Description

200

successful operation

Example Value
Model

Result {

message: string
example: "OK"

result: BlockNo

status

status

enum: ["0", "1"]

enum
interpretation

"0"

error

"1"

}

BlockNo {

blockNumber: block number
example: "34092"

}

200

error

Example Value

Mimics Ethereum JSON RPC's eth_blockNumber. Returns the lastest block number

?module=block&action=eth_block_number

eth_block_number

GET POST

More Details Hide Details

Parameters

Name

Description

Module *required

string (query)

A string with the name of the module to be invoked.

Must be set to: block

Action *required

string (query)

A string with the name of the action to be invoked.

Must be set to: eth_block_number

id

integer (query)

A nonnegative integer that represents the json rpc request id.

Curl

Request URL

Server Response

Code

Details

Response Body

Responses

Code

Description

200

successful request

Example Value
Model

Result {

id: string
example: "1"

jsonrpc: string
example: "2.0"

result: string
example: "767969"

}

Contract ?module=contract

Get a list of contracts, sorted ascending by the time they were first seen by the explorer. If you provide the filters `not_decompiled`(`4`) or `not_verified(4)` the results will not be sorted for performance reasons.

?module=contract&action=listcontracts

listcontracts

GET POST

More Details Hide Details

Parameters

Name

Description

Module *required

string (query)

A string with the name of the module to be invoked.

Must be set to: contract

Action *required

string (query)

A string with the name of the action to be invoked.

Must be set to: listcontracts

page

integer (query)

A nonnegative integer that represents the page number to be used for pagination. 'offset' must be provided in conjunction.

offset

integer (query)

A nonnegative integer that represents the maximum number of records to return when paginating. 'page' must be provided in conjunction.

filter

string (query)

not_decompiled_with_version

string (query)

Ensures that none of the returned contracts were decompiled with the provided version. Ignored unless filtering for decompiled contracts.

verified_at_start_timestamp

unix timestamp (query)

Represents the starting timestamp when contracts verified. Taking into account only with `verified` filter.

verified_at_end_timestamp

unix timestamp (query)

Represents the ending timestamp when contracts verified. Taking into account only with `verified` filter.

Curl

Request URL

Server Response

Code

Details

Response Body

Responses

Code

Description

200

successful operation

Example Value
Model

Result {

message: string
example: "OK"

result: array
[Contract]

status

status

enum: ["0", "1"]

enum
interpretation

"0"

error

"1"

}

Contract {

ABI: ABI
example: "[{ \"type\":\"event\", \"inputs\": [{\"name\":\"a\",\"type\":\"uint256\",\"indexed\":true},{\"name\":\"b\",\"type\":\"bytes32\",\"indexed\":false}], \"name\":\"Event\" }, { \"type\":\"event\", \"inputs\": [{\"name\":\"a\",\"type\":\"uint256\",\"indexed\":true},{\"name\":\"b\",\"type\":\"bytes32\",\"indexed\":false}], \"name\":\"Event2\" }, { \"type\":\"function\", \"inputs\": [{\"name\":\"a\",\"type\":\"uint256\"}], \"name\":\"foo\", \"outputs\": [] }]"

Address: address hash
example: "0x95426f2bc716022fcf1def006dbc4bb81f5b5164"

ContractName: string
example: "Some name"

OptimizationUsed

optimization used

enum: ["0", "1"]

enum
interpretation

"0"

false

"1"

true

}

Get ABI for verified contract. Also available through a GraphQL 'addresses' query.

?module=contract&action=getabi&address={addressHash}

getabi

GET POST

More Details Hide Details

Parameters

Name

Description

Module *required

string (query)

A string with the name of the module to be invoked.

Must be set to: contract

Action *required

string (query)

A string with the name of the action to be invoked.

Must be set to: getabi

address *required

string (query)

A 160-bit code used for identifying contracts.

Curl

Request URL

Server Response

Code

Details

Response Body

Responses

Code

Description

200

successful operation

Example Value
Model

Result {

message: string
example: "OK"

result: abi

status

status

enum: ["0", "1"]

enum
interpretation

"0"

error

"1"

}

200

error

Example Value

Get contract source code for verified contract. Also available through a GraphQL 'addresses' query.

?module=contract&action=getsourcecode&address={addressHash}

getsourcecode

GET POST

More Details Hide Details

Parameters

Name

Description

Module *required

string (query)

A string with the name of the module to be invoked.

Must be set to: contract

Action *required

string (query)

A string with the name of the action to be invoked.

Must be set to: getsourcecode

address *required

string (query)

A 160-bit code used for identifying contracts.

Curl

Request URL

Server Response

Code

Details

Response Body

Responses

Code

Description

200

successful operation

Example Value
Model

Result {

message: string
example: "OK"

result: array
[Contract]

status

status

enum: ["0", "1"]

enum
interpretation

"0"

error

"1"

}

Contract {

ABI: ABI
example: "[{ \"type\":\"event\", \"inputs\": [{\"name\":\"a\",\"type\":\"uint256\",\"indexed\":true},{\"name\":\"b\",\"type\":\"bytes32\",\"indexed\":false}], \"name\":\"Event\" }, { \"type\":\"event\", \"inputs\": [{\"name\":\"a\",\"type\":\"uint256\",\"indexed\":true},{\"name\":\"b\",\"type\":\"bytes32\",\"indexed\":false}], \"name\":\"Event2\" }, { \"type\":\"function\", \"inputs\": [{\"name\":\"a\",\"type\":\"uint256\"}], \"name\":\"foo\", \"outputs\": [] }]"

Address: address hash
example: "0x95426f2bc716022fcf1def006dbc4bb81f5b5164"

ContractName: string
example: "Some name"

DecompiledSourceCode: contract decompiled source code
example: const name() = 'CryptoKitties' const GEN0_STARTING_PRICE() = 10^16 const GEN0_AUCTION_DURATION() = 86400 const GEN0_CREATION_LIMIT() = 45000 const symbol() = 'CK' const PROMO_CREATION_LIMIT() = 5000 def storage: ceoAddress is addr # mask(160, 0) at storage #0 cfoAddress is addr # mask(160, 0) at storage #1 stor1.768 is uint16 => uint256 # mask(256, 768) at storage #1 cooAddress is addr # mask(160, 0) at storage #2 stor2.0 is uint256 => uint256 # mask(256, 0) at storage #2 paused is uint8 # mask(8, 160) at storage #2 stor2.256 is uint256 => uint256 # mask(256, 256) at storage #2 stor3 is uint32 # ...<continues>

DecompilerVersion: decompiler version
example: decompiler.version

OptimizationUsed

optimization used

enum: ["0", "1"]

enum
interpretation

"0"

false

"1"

true

SourceCode: contract source code
example: "pragma solidity >0.4.24; contract Test { constructor() public { b = hex"12345678901234567890123456789012"; } event Event(uint indexed a, bytes32 b); event Event2(uint indexed a, bytes32 b); function foo(uint a) public { emit Event(a, b); } bytes32 b; }"

}

200

error

Example Value

Verify a contract with its source code and contract creation information.

curl POST example:

curl -d '{"addressHash":"0xc63BB6555C90846afACaC08A0F0Aa5caFCB382a1","compilerVersion":"v0.5.4+commit.9549d8ff", "contractSourceCode":"pragma solidity ^0.5.4; contract Test { }","name":"Test","optimization":false}' -H "Content-Type: application/json" -X POST "https://blockscout.com/poa/sokol/api?module=contract&action=verify"

?module=contract&action=verify&addressHash={addressHash}&name={name}&compilerVersion={compilerVersion}&optimization={false}&contractSourceCode={contractSourceCode}

verify

GET POST

More Details Hide Details

Parameters

Name

Description

Module *required

string (query)

A string with the name of the module to be invoked.

Must be set to: contract

Action *required

string (query)

A string with the name of the action to be invoked.

Must be set to: verify

addressHash *required

string (query)

The address of the contract.

name *required

string (query)

The name of the contract.

compilerVersion *required

string (query)

The compiler version for the contract.

optimization *required

boolean (query)

Whether or not compiler optimizations were enabled.

contractSourceCode *required

string (query)

The source code of the contract.

constructorArguments

string (query)

The constructor argument data provided.

autodetectConstructorArguments

boolean (query)

Whether or not automatically detect constructor argument.

evmVersion

string (query)

The EVM version for the contract.

optimizationRuns

integer (query)

The number of optimization runs used during compilation

library1Name

string (query)

The name of the first library used.

library1Address

string (query)

The address of the first library used.

library2Name

string (query)

The name of the second library used.

library2Address

string (query)

The address of the second library used.

library3Name

string (query)

The name of the third library used.

library3Address

string (query)

The address of the third library used.

library4Name

string (query)

The name of the fourth library used.

library4Address

string (query)

The address of the fourth library used.

library5Name

string (query)

The name of the fourth library used.

library5Address

string (query)

The address of the fourth library used.

Curl

Request URL

Server Response

Code

Details

Response Body

Responses

Code

Description

200

successful operation

Example Value
Model

Contract {

ABI: ABI
example: "[{ \"type\":\"event\", \"inputs\": [{\"name\":\"a\",\"type\":\"uint256\",\"indexed\":true},{\"name\":\"b\",\"type\":\"bytes32\",\"indexed\":false}], \"name\":\"Event\" }, { \"type\":\"event\", \"inputs\": [{\"name\":\"a\",\"type\":\"uint256\",\"indexed\":true},{\"name\":\"b\",\"type\":\"bytes32\",\"indexed\":false}], \"name\":\"Event2\" }, { \"type\":\"function\", \"inputs\": [{\"name\":\"a\",\"type\":\"uint256\"}], \"name\":\"foo\", \"outputs\": [] }]"

Address: address hash
example: "0x95426f2bc716022fcf1def006dbc4bb81f5b5164"

ContractName: string
example: "Some name"

OptimizationUsed

optimization used

enum: ["0", "1"]

enum
interpretation

"0"

false

"1"

true

}

200

error

Example Value

Verify a contract through Sourcify.
a) if smart-contract already verified on Sourcify, it will automatically fetch the data from the repo
b) otherwise you have to upload source files and JSON metadata file(s).

POST body example:

--6e1e4c11657c62dc1e4349d024de9e28
Content-Disposition: form-data; name="addressHash"

0xb77b7443e0F32F1FEBf0BE0fBd7124D135d0a525

--6e1e4c11657c62dc1e4349d024de9e28
Content-Disposition: form-data; name="files[0]"; filename="contract.sol"
Content-Type: application/json

...Source code...

--6e1e4c11657c62dc1e4349d024de9e28
Content-Disposition: form-data; name="files[1]"; filename="metadata.json"
Content-Type: application/json

...JSON metadata...

--6e1e4c11657c62dc1e4349d024de9e28--

?module=contract&action=verify_via_sourcify&addressHash={addressHash}

verify_via_sourcify

GET POST

More Details Hide Details

Parameters

Name

Description

Module *required

string (query)

A string with the name of the module to be invoked.

Must be set to: contract

Action *required

string (query)

A string with the name of the action to be invoked.

Must be set to: verify_via_sourcify

addressHash *required

string (query)

The address of the contract.

files

file[] (query)

Array with sources and metadata files

Curl

Request URL

Server Response

Code

Details

Response Body

Responses

Code

Description

200

successful operation

Example Value
Model

Contract {

ABI: ABI
example: "[{ \"type\":\"event\", \"inputs\": [{\"name\":\"a\",\"type\":\"uint256\",\"indexed\":true},{\"name\":\"b\",\"type\":\"bytes32\",\"indexed\":false}], \"name\":\"Event\" }, { \"type\":\"event\", \"inputs\": [{\"name\":\"a\",\"type\":\"uint256\",\"indexed\":true},{\"name\":\"b\",\"type\":\"bytes32\",\"indexed\":false}], \"name\":\"Event2\" }, { \"type\":\"function\", \"inputs\": [{\"name\":\"a\",\"type\":\"uint256\"}], \"name\":\"foo\", \"outputs\": [] }]"

Address: address hash
example: "0x95426f2bc716022fcf1def006dbc4bb81f5b5164"

ContractName: string
example: "Some name"

OptimizationUsed

optimization used

enum: ["0", "1"]

enum
interpretation

"0"

false

"1"

true

}

200

error

Example Value

Verify a vyper contract with its source code and contract creation information.

curl POST example:

curl --location --request POST 'http://localhost:4000/api?module=contract&action=verify_vyper_contract' --form 'contractSourceCode="SOURCE_CODE"' --form 'name="Vyper_contract"' --form 'addressHash="0xE60B1B8bD493569a3E945be50A6c89d29a560Fa1"' --form 'compilerVersion="v0.2.12"'

?module=contract&action=verify_vyper_contract&addressHash={addressHash}&name={name}&compilerVersion={compilerVersion}&contractSourceCode={contractSourceCode}

verify_vyper_contract

GET POST

More Details Hide Details

Parameters

Name

Description

Module *required

string (query)

A string with the name of the module to be invoked.

Must be set to: contract

Action *required

string (query)

A string with the name of the action to be invoked.

Must be set to: verify_vyper_contract

addressHash *required

string (query)

The address of the contract.

name *required

string (query)

The name of the contract.

compilerVersion *required

string (query)

The compiler version for the contract.

contractSourceCode *required

string (query)

The source code of the contract.

constructorArguments

string (query)

The constructor argument data provided.

Curl

Request URL

Server Response

Code

Details

Response Body

Responses

Code

Description

200

successful operation

Example Value
Model

Contract {

ABI: ABI
example: "[{ \"type\":\"event\", \"inputs\": [{\"name\":\"a\",\"type\":\"uint256\",\"indexed\":true},{\"name\":\"b\",\"type\":\"bytes32\",\"indexed\":false}], \"name\":\"Event\" }, { \"type\":\"event\", \"inputs\": [{\"name\":\"a\",\"type\":\"uint256\",\"indexed\":true},{\"name\":\"b\",\"type\":\"bytes32\",\"indexed\":false}], \"name\":\"Event2\" }, { \"type\":\"function\", \"inputs\": [{\"name\":\"a\",\"type\":\"uint256\"}], \"name\":\"foo\", \"outputs\": [] }]"

Address: address hash
example: "0x95426f2bc716022fcf1def006dbc4bb81f5b5164"

ContractName: string
example: "Some name"

OptimizationUsed

optimization used

enum: ["0", "1"]

enum
interpretation

"0"

false

"1"

true

}

200

error

Example Value

Verify a contract with Standard input JSON file. Its interface the same as Etherscan's API endpoint

?module=contract&action=verifysourcecode&codeformat={solidity-standard-json-input}&contractaddress={contractaddress}&contractname={contractname}&compilerversion={compilerversion}&sourceCode={sourceCode}

verifysourcecode

GET POST

More Details Hide Details

Parameters

Name

Description

Module *required

string (query)

A string with the name of the module to be invoked.

Must be set to: contract

Action *required

string (query)

A string with the name of the action to be invoked.

Must be set to: verifysourcecode

codeformat *required

string (query)

Format of sourceCode(supported only "solidity-standard-json-input")

contractaddress *required

string (query)

The address of the contract.

contractname *required

string (query)

The name of the contract. It could be empty string(""), just contract name("ContractName"), or filename and contract name("contracts/contract_1.sol:ContractName")

compilerversion *required

string (query)

The compiler version for the contract.

sourceCode *required

string (query)

Standard input json

constructorArguements

string (query)

The constructor argument data provided.

autodetectConstructorArguments

boolean (query)

Whether or not automatically detect constructor argument.

Curl

Request URL

Server Response

Code

Details

Response Body

Responses

Code

Description

200

successful operation

Example Value
Model

UID {

UID: string
example: b080b96bd06ad1c9341c2afb7e3730311388544961acde94

}

Return status of the verification attempt (works in addition to verifysourcecode method)

?module=contract&action=checkverifystatus&guid={identifierString}

checkverifystatus

GET POST

More Details Hide Details

Parameters

Name

Description

Module *required

string (query)

A string with the name of the module to be invoked.

Must be set to: contract

Action *required

string (query)

A string with the name of the action to be invoked.

Must be set to: checkverifystatus

guid *required

string (query)

A string used for identifying verification attempt

Curl

Request URL

Server Response

Code

Details

Response Body

Responses

Code

Description

200

successful operation

Example Value
Model

Status {

status: string
example: `Pending in queue` | `Pass - Verified` | `Fail - Unable to verify` | `Unknown UID`

}

Transaction ?module=transaction

Get transaction info.

?module=transaction&action=gettxinfo&txhash={transactionHash}

gettxinfo

GET POST

More Details Hide Details

Parameters

Name

Description

Module *required

string (query)

A string with the name of the module to be invoked.

Must be set to: transaction

Action *required

string (query)

A string with the name of the action to be invoked.

Must be set to: gettxinfo

txhash *required

string (query)

Transaction hash. Hash of contents of the transaction.

index

integer (query)

A nonnegative integer that represents the log index to be used for pagination.

Curl

Request URL

Server Response

Code

Details

Response Body

Responses

Code

Description

200

successful operation

Example Value
Model

Result {

message: string
example: "OK"

result: TransactionInfo

status

status

enum: ["0", "1"]

enum
interpretation

"0"

error

"1"

}

TransactionInfo {

blockNumber: block number
example: "34092"

confirmations: confirmations
example: "6005998"

from: address hash
example: "0x95426f2bc716022fcf1def006dbc4bb81f5b5164"

gasLimit: wei
example: "663046792267785498951364"

gasPrice: wei
example: "663046792267785498951364"

gasUsed: gas
example: "122261"

hash: transaction hash
example: "0x9c81f44c29ff0226f835cd0a8a2f2a7eca6db52a711f8211b566fd15d3e0e8d4"

input: input
example: "0x797af627d02e23b68e085092cd0d47d6cfb54be025f37b5989c0264398f534c08af7dea9"

logs: array
[Log Detail]

revertReason: revert_reason
example: "No credit of that type"

success: boolean
example: true

timeStamp: timestamp
example: "1439232889"

to: address hash
example: "0x95426f2bc716022fcf1def006dbc4bb81f5b5164"

value: wei
example: "663046792267785498951364"

}

200

error

Example Value

Get transaction receipt status. Also available through a GraphQL 'transaction' query.

?module=transaction&action=gettxreceiptstatus&txhash={transactionHash}

gettxreceiptstatus

GET POST

More Details Hide Details

Parameters

Name

Description

Module *required

string (query)

A string with the name of the module to be invoked.

Must be set to: transaction

Action *required

string (query)

A string with the name of the action to be invoked.

Must be set to: gettxreceiptstatus

txhash *required

string (query)

Transaction hash. Hash of contents of the transaction.

Curl

Request URL

Server Response

Code

Details

Response Body

Responses

Code

Description

200

successful operation

Example Value
Model

Result {

message: string
example: "OK"

result: TransactionReceiptStatus

status

status

enum: ["0", "1"]

enum
interpretation

"0"

error

"1"

}

TransactionReceiptStatus {

status

status

enum: ["0", "1"]

enum
interpretation

"0"

fail

"1"

pass

}

200

error

Example Value

Get error status and error message. Also available through a GraphQL 'transaction' query.

?module=transaction&action=getstatus&txhash={transactionHash}

getstatus

GET POST

More Details Hide Details

Parameters

Name

Description

Module *required

string (query)

A string with the name of the module to be invoked.

Must be set to: transaction

Action *required

string (query)

A string with the name of the action to be invoked.

Must be set to: getstatus

txhash *required

string (query)

Transaction hash. Hash of contents of the transaction.

Curl

Request URL

Server Response

Code

Details

Response Body

Responses

Code

Description

200

successful operation

Example Value
Model

Result {

message: string
example: "OK"

result: TransactionStatus

status

status

enum: ["0", "1"]

enum
interpretation

"0"

error

"1"

}

TransactionStatus {

errDescription: string
example: "Out of gas"

isError

isError

enum: ["0", "1"]

enum
interpretation

"0"

pass

"1"

error

}

200

error

Example Value

API Documentation

Account ?module=account

Mimics Ethereum JSON RPC's eth_getBalance. Returns the balance as of the provided block (defaults to latest)

Parameters Try it out Cancel

Name

Description

Module *required

Action *required

address *required

block

Curl

Request URL

Server Response

Code

Details

Responses

Code

Description

Result {

}

Parameters Try it out Cancel

Name

Description

Module *required

Action *required

address *required

Curl

Request URL

Server Response

Code

Details

Responses

Code

Description

Result {

}

Parameters Try it out Cancel

Name

Description

Module *required

Action *required

address *required

Curl

Request URL

Server Response

Code

Details

Responses

Code

Description

Result {

}

AddressBalance {

}

Get pending transactions by address.

Parameters Try it out Cancel

Name

Description

Module *required

Action *required

address *required

page

offset

Curl

Request URL

Server Response

Code

Details

Responses

Code

Description

Result {

}

Transaction {

}

Get transactions by address. Up to a maximum of 10,000 transactions. Also available through a GraphQL 'address' query.

Parameters Try it out Cancel

Name

Description

Module *required

Parameters

Parameters

Parameters

Parameters

Parameters

Parameters

Parameters