Accounts

Retrieve account detail

includes balance, energy and hasCode, by account address. An account with hasCode be true is a contract.

Historical account detail can be queried by specifying revision query string.

GEThttps://meter.nownodes.io/accounts/{address}

Path parameters

address*string (bytes20)

address of account

Example: "0x5034aa590125b64023a0262112b98d72e3c8e40e"

Query parameters

Response

200

OK

Body

application/json

balancestring

balance in unit WEI, presented with hex string

Example: "0x47ff1f90327aa0f8e"

energystring

energy in uint WEI, presented with hex string

Example: "0xcf624158d591398"

hasCodeboolean

whether the account has code

Example: false

Request

JavaScriptCurlPython

const response = await fetch('https://meter.nownodes.io/accounts/{address}', {
    method: 'GET',
    headers: {},
});
const data = await response.json();

Response

200

{
  "balance": "0x47ff1f90327aa0f8e",
  "energy": "0xcf624158d591398",
  "hasCode": false
}

Execute account code

to simulate contract method call, without sending transaction to block chain.

It's useful to estimate gas usage and execution result of a clause.

POSThttps://meter.nownodes.io/accounts/{address}

Path parameters

address*string (bytes20)

address of account

Example: "0x5034aa590125b64023a0262112b98d72e3c8e40e"

Query parameters

Body

application/json

arguments and environment

valuestring

amount of token to be transferred

datastring

input data for contract call

gasinteger (uint64)

max allowed gas for execution

gasPricestring

absolute gas price

callerstring

caller address (msg.sender)

Response

200

OK

Body

application/json

datastring

the output data

Example: "0x103556a73c10e38ffe2fc4aa50fc9d46ad0148f07e26417e117bd1ece9d948b5"

eventsarray of Event (object)

transfersarray of Transfer (object)

gasUsedinteger (uint64)

gas used during execution

Example: 21000

revertedboolean

Example: false

vmErrorstring

Example: ""

Request

JavaScriptCurlPython

const response = await fetch('https://meter.nownodes.io/accounts/{address}', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "value": "0xde0b6b3a7640000",
      "data": "0x5665436861696e2054686f72"
    }),
});
const data = await response.json();

Response

200

{
  "data": "0x103556a73c10e38ffe2fc4aa50fc9d46ad0148f07e26417e117bd1ece9d948b5",
  "events": [
    {
      "address": "0x7567d83b7b8d80addcb281a71d54fc7b3364ffed",
      "topics": [
        "0x4de71f2d588aa8a1ea00fe8312d92966da424d9939a511fc0be81e65fad52af8"
      ],
      "data": "0x4de71f2d588aa8a1ea00fe8312d92966da424d9939a511fc0be81e65fad52af8"
    }
  ],
  "transfers": [
    {
      "sender": "0xdb4027477b2a8fe4c83c6dafe7f86678bb1b8a8d",
      "recipient": "0x5034aa590125b64023a0262112b98d72e3c8e40e",
      "amount": "0x47fdb3c3f456c0000"
    }
  ],
  "gasUsed": 21000,
  "reverted": false,
  "vmError": ""
}

Execute bytecodes

to simulate contract deployment without sending transaction to block chain.

It's useful to estimate gas usage and contract deployment result of a clause.

TIPS:

• data in request body is the bytecodes of a contract
• data in response body is the runtime bytecodes assigned to account which the contract to be deployed

POSThttps://meter.nownodes.io/accounts

Query parameters

Body

application/json

arguments and environment

valuestring

amount of token to be transferred

datastring

input data for contract call

gasinteger (uint64)

max allowed gas for execution

gasPricestring

absolute gas price

callerstring

caller address (msg.sender)

Response

200

OK

Body

application/json

datastring

the output data

Example: "0x103556a73c10e38ffe2fc4aa50fc9d46ad0148f07e26417e117bd1ece9d948b5"

eventsarray of Event (object)

transfersarray of Transfer (object)

gasUsedinteger (uint64)

gas used during execution

Example: 21000

revertedboolean

Example: false

vmErrorstring

Example: ""

Request

JavaScriptCurlPython

const response = await fetch('https://meter.nownodes.io/accounts', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({
      "value": "0xde0b6b3a7640000",
      "data": "0x5665436861696e2054686f72"
    }),
});
const data = await response.json();

Response

200

{
  "data": "0x103556a73c10e38ffe2fc4aa50fc9d46ad0148f07e26417e117bd1ece9d948b5",
  "events": [
    {
      "address": "0x7567d83b7b8d80addcb281a71d54fc7b3364ffed",
      "topics": [
        "0x4de71f2d588aa8a1ea00fe8312d92966da424d9939a511fc0be81e65fad52af8"
      ],
      "data": "0x4de71f2d588aa8a1ea00fe8312d92966da424d9939a511fc0be81e65fad52af8"
    }
  ],
  "transfers": [
    {
      "sender": "0xdb4027477b2a8fe4c83c6dafe7f86678bb1b8a8d",
      "recipient": "0x5034aa590125b64023a0262112b98d72e3c8e40e",
      "amount": "0x47fdb3c3f456c0000"
    }
  ],
  "gasUsed": 21000,
  "reverted": false,
  "vmError": ""
}