BlockBook API

v1.0.0

Base URLs

https://trx-blockbook.nownodes.ioNOWNodes TRON BlockBook endpoint.

https://trx.nownodes.ioNOWNodes TRON endpoint.

OpenAPI description for TRON NOWNodes API.

Authentication

api-keyAuthapiKey

NOWNodes API key passed in the api-key header.

API Key: api-key in header

MAINNET / Blockbook

BlockBook

BlockBook operations.

Get BlockBook and backend status

GET

https://trx-blockbook.nownodes.io/api/v2

Returns general information about the BlockBook instance and the connected Tron backend node.

Response

200OK

HTTP 200 response for getBlockBookStatus. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get BlockBook and backend status

curl -X GET 'https://trx-blockbook.nownodes.io/api/v2'

const response = await fetch('https://trx-blockbook.nownodes.io/api/v2', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://trx-blockbook.nownodes.io/api/v2')
data = response.json()

{
  "blockbook": {
    "coin": "Tron",
    "network": "TRX",
    "host": "5232582baca8",
    "version": "devel",
    "gitCommit": "e765114",
    "buildTime": "2026-06-21T13:43:21+0000",
    "syncMode": true,
    "initialSync": false,
    "inSync": true,
    "bestHeight": 84251947,
    "lastBlockTime": "2026-07-07T12:02:35.660176389Z",
    "inSyncMempool": true,
    "lastMempoolTime": "2026-07-07T12:02:35.583214121Z",
    "mempoolSize": 510,
    "decimals": 6,
    "dbSize": 1962794790846,
    "hasFiatRates": true,
    "currentFiatRatesTime": "2026-07-07T12:01:01.746315369Z",
    "historicalFiatRatesTime": "2026-07-07T00:00:00Z",
    "about": "Blockbook - blockchain indexer for Trezor Suite https://trezor.io/trezor-suite. Do not use for any other purpose."
  },
  "backend": {
    "chain": "mainnet",
    "blocks": 84251948,
    "bestBlockHash": "000000000505952c4494b95cf3ef1f3cc039e5ac1f29e1a780513e1aa7cb4d74",
    "difficulty": "0",
    "version": "TRON/v4.8.1.1/Linux/Java1.8"
  }
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Get block hash by block height

GET

https://trx-blockbook.nownodes.io/api/v2/block-index/{height}

Returns the block hash corresponding to the specified block height in the Tron blockchain.

Parameters

heightinteger>= 0requiredpath

Block height for which the block hash is requested

Response

200OK

HTTP 200 response for getBlockHashByHeight. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get block hash by block height

curl -X GET 'https://trx-blockbook.nownodes.io/api/v2/block-index/{height}'

const response = await fetch('https://trx-blockbook.nownodes.io/api/v2/block-index/{height}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://trx-blockbook.nownodes.io/api/v2/block-index/{height}')
data = response.json()

{
  "blockHash": "000000000502e9686b96165061a0c1deaa8818cb4c2950a60d0d713865b106d3"
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Get block details by block height

GET

https://trx-blockbook.nownodes.io/api/v2/block/{blockHeightOrHash}

Returns detailed information about a block at the specified height or hash, including block metadata and a list of transactions.

Parameters

heightinteger>= 0requiredpath

Block height (integer) or block hash (string) to identify the block.

blockHeightOrHashstringrequiredpath

TRON block number.

Response

200OK

HTTP 200 response for getBlockByHeight. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get block details by block height

curl -X GET 'https://trx-blockbook.nownodes.io/api/v2/block/{blockHeightOrHash}'

const response = await fetch('https://trx-blockbook.nownodes.io/api/v2/block/{blockHeightOrHash}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://trx-blockbook.nownodes.io/api/v2/block/{blockHeightOrHash}')
data = response.json()

{
  "hash": "000000000502e9686b96165061a0c1deaa8818cb4c2950a60d0d713865b106d3",
  "height": 84076904,
  "time": 1782900468,
  "txs": 647,
  "tx": [
    "aaeb5bfd0d5f5a4ba8c825bdc8bc6f6ceaec896f11f31c1374d9285dc0c12906",
    "cbaa44a75303cbc59a3e54a4e45a51603a7075009f7c4ca4c3685f93e1ce0cfb"
  ]
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Get detailed transaction information

GET

https://trx-blockbook.nownodes.io/api/v2/tx-specific/{txid}

Returns a detailed transaction object including raw hex data, inputs, outputs, and block-related metadata.

Parameters

txidstringrequiredpath

Transaction identifier (TXID)

Response

200OK

HTTP 200 response for getTransactionSpecific. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get detailed transaction information

curl -X GET 'https://trx-blockbook.nownodes.io/api/v2/tx-specific/{txid}'

const response = await fetch('https://trx-blockbook.nownodes.io/api/v2/tx-specific/{txid}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://trx-blockbook.nownodes.io/api/v2/tx-specific/{txid}')
data = response.json()

{
  "txid": "aaeb5bfd0d5f5a4ba8c825bdc8bc6f6ceaec896f11f31c1374d9285dc0c12906",
  "blockHash": "000000000502e9686b96165061a0c1deaa8818cb4c2950a60d0d713865b106d3",
  "blockHeight": 84076904,
  "confirmations": 1,
  "value": "7",
  "fees": "0",
  "vin": [],
  "vout": []
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Get transaction details by transaction ID

GET

https://trx-blockbook.nownodes.io/api/v2/tx/{txid}

Returns a simplified transaction representation in BlockBook v2 format. Values are represented in weis as strings.

Parameters

txidstringrequiredpath

Transaction identifier (TXID)

Response

200OK

HTTP 200 response for getTransactionV2. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get transaction details by transaction ID

curl -X GET 'https://trx-blockbook.nownodes.io/api/v2/tx/{txid}'

const response = await fetch('https://trx-blockbook.nownodes.io/api/v2/tx/{txid}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://trx-blockbook.nownodes.io/api/v2/tx/{txid}')
data = response.json()

{
  "txid": "aaeb5bfd0d5f5a4ba8c825bdc8bc6f6ceaec896f11f31c1374d9285dc0c12906",
  "blockHash": "000000000502e9686b96165061a0c1deaa8818cb4c2950a60d0d713865b106d3",
  "blockHeight": 84076904,
  "confirmations": 1,
  "value": "7",
  "fees": "0",
  "vin": [],
  "vout": []
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Get address details

GET

https://trx-blockbook.nownodes.io/api/v2/address/{address}

Returns information about a specific address, including balances, transaction count, and transaction IDs.

Parameters

addressstringrequiredpath

TRON address in base58 format.

pageinteger<int32>>= 11query

Page number of the returned transaction list. Pagination starts from 1.

pageSizeinteger<int32>[1, 1000]1000query

Maximum number of transactions returned on one page.

frominteger<int64>>= 0query

Start block height filter for transactions, inclusive.

tointeger<int64>>= 0query

End block height filter for transactions, inclusive.

detailsstringbasictokenstokenBalancestxidstxslighttxstxidsquery

Controls how much transaction or token detail is included in the response. Supported values: basic, tokens, tokenBalances, txids, txslight, txs.

tokensstringusednonzeroderivedquery

Token list mode for the address response. Use used to include tokens used by the address, nonzero to include only non-zero balances, or derived to include derived token information when supported.

secondarybooleanfalsequery

When true, includes secondary currency values in supported balance and transaction fields.

contractstringquery

Smart-contract address used to filter token-related address data.

Response

200OK

HTTP 200 response for getAddress. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get address details

curl -X GET 'https://trx-blockbook.nownodes.io/api/v2/address/{address}'

const response = await fetch('https://trx-blockbook.nownodes.io/api/v2/address/{address}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://trx-blockbook.nownodes.io/api/v2/address/{address}')
data = response.json()

{
  "page": 1,
  "totalPages": 1,
  "itemsOnPage": 2,
  "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
  "balance": "1978237590707",
  "totalReceived": "1978237590707",
  "totalSent": "0",
  "txs": 2,
  "transactions": [
    {
      "txid": "aaeb5bfd0d5f5a4ba8c825bdc8bc6f6ceaec896f11f31c1374d9285dc0c12906",
      "blockHeight": 84076904,
      "confirmations": 1
    }
  ]
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Get balance history for an address

GET

https://trx-blockbook.nownodes.io/api/v2/balancehistory/{address}

Returns the balance history of a given address, including amounts received, sent, and sent to self, grouped by time intervals.

Parameters

addressstringrequiredpath

The Tron address to retrieve balance history for

Response

200OK

HTTP 200 response for getBalanceHistoryByAddress. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get balance history for an address

curl -X GET 'https://trx-blockbook.nownodes.io/api/v2/balancehistory/{address}'

const response = await fetch('https://trx-blockbook.nownodes.io/api/v2/balancehistory/{address}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://trx-blockbook.nownodes.io/api/v2/balancehistory/{address}')
data = response.json()

{
  "page": 1,
  "totalPages": 1,
  "itemsOnPage": 2,
  "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
  "balance": "1978237590707",
  "totalReceived": "1978237590707",
  "totalSent": "0",
  "txs": 2,
  "transactions": [
    {
      "txid": "aaeb5bfd0d5f5a4ba8c825bdc8bc6f6ceaec896f11f31c1374d9285dc0c12906",
      "blockHeight": 84076904,
      "confirmations": 1
    }
  ]
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Get list of tickers at a specific timestamp

GET

https://trx-blockbook.nownodes.io/api/v2/tickers-list

Returns a list of cryptocurrency tickers and their rates at the specified timestamp.

Parameters

timestampintegerrequiredquery

Unix timestamp to retrieve ticker data for

Response

200OK

HTTP 200 response for getTickersList. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get list of tickers at a specific timestamp

curl -X GET 'https://trx-blockbook.nownodes.io/api/v2/tickers-list'

const response = await fetch('https://trx-blockbook.nownodes.io/api/v2/tickers-list', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://trx-blockbook.nownodes.io/api/v2/tickers-list')
data = response.json()

[
  {
    "symbol": "TRX",
    "price": "0.2874",
    "marketCap": "27123456789",
    "volume24h": "734567890",
    "change24h": "1.84"
  },
  {
    "symbol": "USDT",
    "price": "1.0000",
    "marketCap": "112345678901",
    "volume24h": "65234567890",
    "change24h": "0.01"
  }
]

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Get XPUB/Descriptor Details

GET

https://trx-blockbook.nownodes.io/api/v2/xpub/{xpubOrDescriptor}

Returns balances and transaction history for the given extended public key (XPUB) or output descriptor.

Parameters

xpubOrDescriptorstringrequiredpath

Extended public key or output descriptor to query in Blockbook.

pageinteger<int32>>= 11query

Page number of the returned transaction list. Pagination starts from 1.

pageSizeinteger<int32>[1, 1000]1000query

Maximum number of transactions returned on one page.

frominteger<int64>>= 0query

Start block height filter for transactions, inclusive.

tointeger<int64>>= 0query

End block height filter for transactions, inclusive.

detailsstringbasictokenstokenBalancestxidstxslighttxstxidsquery

Controls how much transaction or token detail is included in the response. Supported values: basic, tokens, tokenBalances, txids, txslight, txs.

Response

200OK

HTTP 200 response for {xpubOrDescriptor}. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get XPUB/Descriptor Details

curl -X GET 'https://trx-blockbook.nownodes.io/api/v2/xpub/{xpubOrDescriptor}'

const response = await fetch('https://trx-blockbook.nownodes.io/api/v2/xpub/{xpubOrDescriptor}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://trx-blockbook.nownodes.io/api/v2/xpub/{xpubOrDescriptor}')
data = response.json()

{
  "page": 1,
  "totalPages": 1,
  "itemsOnPage": 2,
  "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
  "balance": "1978237590707",
  "totalReceived": "1978237590707",
  "totalSent": "0",
  "txs": 2,
  "transactions": [
    {
      "txid": "aaeb5bfd0d5f5a4ba8c825bdc8bc6f6ceaec896f11f31c1374d9285dc0c12906",
      "blockHeight": 84076904,
      "confirmations": 1
    }
  ]
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Broadcast raw transaction

GET

https://trx-blockbook.nownodes.io/api/v2/sendtx/{hexTxData}

Broadcasts a raw transaction in hexadecimal format to the network.
Returns the transaction ID if successfully broadcast. Kindly note that if sendtx is too long, the hexadecimal transaction may be cut off. In this case, it is preferable to use the POST version of the sendtx method.

Parameters

hexTxDatastringrequiredpath

Raw transaction data in hexadecimal string format.

Response

200OK

HTTP 200 response for {hexTxData}. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Broadcast raw transaction

curl -X GET 'https://trx-blockbook.nownodes.io/api/v2/sendtx/{hexTxData}'

const response = await fetch('https://trx-blockbook.nownodes.io/api/v2/sendtx/{hexTxData}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://trx-blockbook.nownodes.io/api/v2/sendtx/{hexTxData}')
data = response.json()

{
  "result": "Transaction submitted"
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Broadcast raw transaction via POST body

POST

https://trx-blockbook.nownodes.io/api/v2/sendtx

Broadcasts a raw transaction provided in hexadecimal format via the request body.
Returns the transaction ID if successfully broadcast.

Body

application/json

Raw transaction data in hexadecimal format

Request value.

hexstring

Raw transaction in hexadecimal format

Response

200OK

HTTP 200 response for sendtx. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Broadcast raw transaction via POST body

curl -X POST 'https://trx-blockbook.nownodes.io/api/v2/sendtx/' \
  -H 'Content-Type: application/json' \
  -d '{
    "hex": "0200000001abcdef...00000000"
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/api/v2/sendtx/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "hex": "0200000001abcdef...00000000"
    }),
});

const data = await response.json();

import requests

payload = {
  "hex": "0200000001abcdef...00000000"
}

response = requests.post('https://trx-blockbook.nownodes.io/api/v2/sendtx/', json=payload)
data = response.json()

Request Body

{
  "hex": "0200000001abcdef...00000000"
}

{
  "result": "Transaction submitted"
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

BlockBook (legacy unversioned)

BlockBook (legacy unversioned) operations.

Get BlockBook and backend status

GET

https://trx-blockbook.nownodes.io/api

Returns general information about the BlockBook instance and the connected Tron backend node.

Response

200OK

HTTP 200 response for getBlockBookStatus. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get BlockBook and backend status

curl -X GET 'https://trx-blockbook.nownodes.io/api'

const response = await fetch('https://trx-blockbook.nownodes.io/api', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://trx-blockbook.nownodes.io/api')
data = response.json()

{
  "blockbook": {
    "coin": "Tron",
    "network": "TRX",
    "host": "5232582baca8",
    "version": "devel",
    "gitCommit": "e765114",
    "buildTime": "2026-06-21T13:43:21+0000",
    "syncMode": true,
    "initialSync": false,
    "inSync": true,
    "bestHeight": 84251947,
    "lastBlockTime": "2026-07-07T12:02:35.660176389Z",
    "inSyncMempool": true,
    "lastMempoolTime": "2026-07-07T12:02:35.583214121Z",
    "mempoolSize": 510,
    "decimals": 6,
    "dbSize": 1962794790846,
    "hasFiatRates": true,
    "currentFiatRatesTime": "2026-07-07T12:01:01.746315369Z",
    "historicalFiatRatesTime": "2026-07-07T00:00:00Z",
    "about": "Blockbook - blockchain indexer for Trezor Suite https://trezor.io/trezor-suite. Do not use for any other purpose."
  },
  "backend": {
    "chain": "mainnet",
    "blocks": 84251948,
    "bestBlockHash": "000000000505952c4494b95cf3ef1f3cc039e5ac1f29e1a780513e1aa7cb4d74",
    "difficulty": "0",
    "version": "TRON/v4.8.1.1/Linux/Java1.8"
  }
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Get block hash by block height

GET

https://trx-blockbook.nownodes.io/api/block-index/{height}

Returns the block hash corresponding to the specified block height in the Tron blockchain.

Parameters

heightinteger>= 0requiredpath

Block height for which the block hash is requested

Response

200OK

HTTP 200 response for getBlockHashByHeight. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get block hash by block height

curl -X GET 'https://trx-blockbook.nownodes.io/api/block-index/{height}'

const response = await fetch('https://trx-blockbook.nownodes.io/api/block-index/{height}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://trx-blockbook.nownodes.io/api/block-index/{height}')
data = response.json()

{
  "blockHash": "000000000502e9686b96165061a0c1deaa8818cb4c2950a60d0d713865b106d3"
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Get block details by block height

GET

https://trx-blockbook.nownodes.io/api/block/{blockHeightOrHash}

Returns detailed block information using the legacy unversioned BlockBook API format. Values are represented in TRX units.

Parameters

heightinteger>= 0requiredpath

Block height (integer) or block hash (string) to identify the block.

blockHeightOrHashstringrequiredpath

TRON block number.

Response

200OK

HTTP 200 response for getBlockByHeightLegacy. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get block details by block height

curl -X GET 'https://trx-blockbook.nownodes.io/api/block/{blockHeightOrHash}'

const response = await fetch('https://trx-blockbook.nownodes.io/api/block/{blockHeightOrHash}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://trx-blockbook.nownodes.io/api/block/{blockHeightOrHash}')
data = response.json()

{
  "hash": "000000000502e9686b96165061a0c1deaa8818cb4c2950a60d0d713865b106d3",
  "height": 84076904,
  "time": 1782900468,
  "txs": 647,
  "tx": [
    "aaeb5bfd0d5f5a4ba8c825bdc8bc6f6ceaec896f11f31c1374d9285dc0c12906",
    "cbaa44a75303cbc59a3e54a4e45a51603a7075009f7c4ca4c3685f93e1ce0cfb"
  ]
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Get detailed transaction information

GET

https://trx-blockbook.nownodes.io/api/tx-specific/{txid}

Returns detailed transaction information using the legacy unversioned BlockBook API. Includes raw transaction hex, inputs, outputs, and block-related metadata.

Parameters

txidstringrequiredpath

Transaction identifier (TXID)

Response

200OK

HTTP 200 response for getTransactionSpecificLegacy. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get detailed transaction information

curl -X GET 'https://trx-blockbook.nownodes.io/api/tx-specific/{txid}'

const response = await fetch('https://trx-blockbook.nownodes.io/api/tx-specific/{txid}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://trx-blockbook.nownodes.io/api/tx-specific/{txid}')
data = response.json()

{
  "txid": "aaeb5bfd0d5f5a4ba8c825bdc8bc6f6ceaec896f11f31c1374d9285dc0c12906",
  "blockHash": "000000000502e9686b96165061a0c1deaa8818cb4c2950a60d0d713865b106d3",
  "blockHeight": 84076904,
  "confirmations": 1,
  "value": "7",
  "fees": "0",
  "vin": [],
  "vout": []
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Get transaction details by transaction ID

GET

https://trx-blockbook.nownodes.io/api/tx/{txid}

Returns a transaction in BlockBook unversioned legacy format. This is the older format, for backward compatibility.

Parameters

txidstringrequiredpath

Transaction identifier (TXID)

Response

200OK

HTTP 200 response for getTransactionV1. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get transaction details by transaction ID

curl -X GET 'https://trx-blockbook.nownodes.io/api/tx/{txid}'

const response = await fetch('https://trx-blockbook.nownodes.io/api/tx/{txid}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://trx-blockbook.nownodes.io/api/tx/{txid}')
data = response.json()

{
  "txid": "aaeb5bfd0d5f5a4ba8c825bdc8bc6f6ceaec896f11f31c1374d9285dc0c12906",
  "blockHash": "000000000502e9686b96165061a0c1deaa8818cb4c2950a60d0d713865b106d3",
  "blockHeight": 84076904,
  "confirmations": 1,
  "value": "7",
  "fees": "0",
  "vin": [],
  "vout": []
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Get address details

GET

https://trx-blockbook.nownodes.io/api/address/{address}

Returns information about a specific address, including balances, transaction count, and transaction IDs.

Parameters

addressstringrequiredpath

TRON address in base58 format.

pageinteger<int32>>= 11query

Page number of the returned transaction list. Pagination starts from 1.

pageSizeinteger<int32>[1, 1000]1000query

Maximum number of transactions returned on one page.

frominteger<int64>>= 0query

Start block height filter for transactions, inclusive.

tointeger<int64>>= 0query

End block height filter for transactions, inclusive.

detailsstringbasictokenstokenBalancestxidstxslighttxstxidsquery

Controls how much transaction or token detail is included in the response. Supported values: basic, tokens, tokenBalances, txids, txslight, txs.

tokensstringusednonzeroderivedquery

Token list mode for the address response. Use used to include tokens used by the address, nonzero to include only non-zero balances, or derived to include derived token information when supported.

secondarybooleanfalsequery

When true, includes secondary currency values in supported balance and transaction fields.

contractstringquery

Smart-contract address used to filter token-related address data.

Response

200OK

HTTP 200 response for getAddressV1. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get address details

curl -X GET 'https://trx-blockbook.nownodes.io/api/address/{address}'

const response = await fetch('https://trx-blockbook.nownodes.io/api/address/{address}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://trx-blockbook.nownodes.io/api/address/{address}')
data = response.json()

{
  "page": 1,
  "totalPages": 1,
  "itemsOnPage": 2,
  "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
  "balance": "1978237590707",
  "totalReceived": "1978237590707",
  "totalSent": "0",
  "txs": 2,
  "transactions": [
    {
      "txid": "aaeb5bfd0d5f5a4ba8c825bdc8bc6f6ceaec896f11f31c1374d9285dc0c12906",
      "blockHeight": 84076904,
      "confirmations": 1
    }
  ]
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Estimate transaction fee per kilobyte

GET

https://trx-blockbook.nownodes.io/api/estimatefee/{blocks}

Estimates the fee (in coins) per kilobyte needed for a transaction to be confirmed within a certain number of blocks.

Parameters

blocksintegerrequiredpath

Number of blocks within which the transaction should be confirmed

Response

200OK

HTTP 200 response for estimateFeeV1. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Estimate transaction fee per kilobyte

curl -X GET 'https://trx-blockbook.nownodes.io/api/estimatefee/{blocks}'

const response = await fetch('https://trx-blockbook.nownodes.io/api/estimatefee/{blocks}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://trx-blockbook.nownodes.io/api/estimatefee/{blocks}')
data = response.json()

{
  "result": "0.01013364"
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Get block filter by block height

GET

https://trx-blockbook.nownodes.io/api/block-filters/{height}

Returns blockbook and backend information for a specific block height.

Parameters

heightintegerrequiredpath

The height of the block to retrieve information for

Response

200OK

HTTP 200 response for getBlockFilterByHeight. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get block filter by block height

curl -X GET 'https://trx-blockbook.nownodes.io/api/block-filters/{height}'

const response = await fetch('https://trx-blockbook.nownodes.io/api/block-filters/{height}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://trx-blockbook.nownodes.io/api/block-filters/{height}')
data = response.json()

{
  "blockbook": {
    "coin": "Tron",
    "network": "TRX",
    "host": "5232582baca8",
    "version": "devel",
    "gitCommit": "e765114",
    "buildTime": "2026-06-21T13:43:21+0000",
    "syncMode": true,
    "initialSync": false,
    "inSync": true,
    "bestHeight": 84251947,
    "lastBlockTime": "2026-07-07T12:02:35.660176389Z",
    "inSyncMempool": true,
    "lastMempoolTime": "2026-07-07T12:02:35.583214121Z",
    "mempoolSize": 510,
    "decimals": 6,
    "dbSize": 1962794790846,
    "hasFiatRates": true,
    "currentFiatRatesTime": "2026-07-07T12:01:01.746315369Z",
    "historicalFiatRatesTime": "2026-07-07T00:00:00Z",
    "about": "Blockbook - blockchain indexer for Trezor Suite https://trezor.io/trezor-suite. Do not use for any other purpose."
  },
  "backend": {
    "chain": "mainnet",
    "blocks": 84251948,
    "bestBlockHash": "000000000505952c4494b95cf3ef1f3cc039e5ac1f29e1a780513e1aa7cb4d74",
    "difficulty": "0",
    "version": "TRON/v4.8.1.1/Linux/Java1.8"
  }
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Get balance history for an address

GET

https://trx-blockbook.nownodes.io/api/balancehistory/{address}

Returns the balance history of a given address, including amounts received, sent, and sent to self, grouped by time intervals.

Parameters

addressstringrequiredpath

The Tron address to retrieve balance history for

Response

200OK

HTTP 200 response for getBalanceHistory. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get balance history for an address

curl -X GET 'https://trx-blockbook.nownodes.io/api/balancehistory/{address}'

const response = await fetch('https://trx-blockbook.nownodes.io/api/balancehistory/{address}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://trx-blockbook.nownodes.io/api/balancehistory/{address}')
data = response.json()

{
  "page": 1,
  "totalPages": 1,
  "itemsOnPage": 2,
  "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
  "balance": "1978237590707",
  "totalReceived": "1978237590707",
  "totalSent": "0",
  "txs": 2,
  "transactions": [
    {
      "txid": "aaeb5bfd0d5f5a4ba8c825bdc8bc6f6ceaec896f11f31c1374d9285dc0c12906",
      "blockHeight": 84076904,
      "confirmations": 1
    }
  ]
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Get XPUB/Descriptor Details (Legacy)

GET

https://trx-blockbook.nownodes.io/api/xpub/{xpubOrDescriptor}

Returns balances and transaction history for the given extended public key (XPUB) or output descriptor using legacy endpoint.

Parameters

xpubOrDescriptorstringrequiredpath

Extended public key or output descriptor to query in Blockbook.

pageinteger<int32>>= 11query

Page number of the returned transaction list. Pagination starts from 1.

pageSizeinteger<int32>[1, 1000]1000query

Maximum number of transactions returned on one page.

frominteger<int64>>= 0query

Start block height filter for transactions, inclusive.

tointeger<int64>>= 0query

End block height filter for transactions, inclusive.

detailsstringbasictokenstokenBalancestxidstxslighttxstxidsquery

Controls how much transaction or token detail is included in the response. Supported values: basic, tokens, tokenBalances, txids, txslight, txs.

Response

200OK

HTTP 200 response for {xpubOrDescriptor}. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get XPUB/Descriptor Details (Legacy)

curl -X GET 'https://trx-blockbook.nownodes.io/api/xpub/{xpubOrDescriptor}'

const response = await fetch('https://trx-blockbook.nownodes.io/api/xpub/{xpubOrDescriptor}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://trx-blockbook.nownodes.io/api/xpub/{xpubOrDescriptor}')
data = response.json()

{
  "page": 1,
  "totalPages": 1,
  "itemsOnPage": 2,
  "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
  "balance": "1978237590707",
  "totalReceived": "1978237590707",
  "totalSent": "0",
  "txs": 2,
  "transactions": [
    {
      "txid": "aaeb5bfd0d5f5a4ba8c825bdc8bc6f6ceaec896f11f31c1374d9285dc0c12906",
      "blockHeight": 84076904,
      "confirmations": 1
    }
  ]
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Broadcast raw transaction

GET

https://trx-blockbook.nownodes.io/api/sendtx/{hexTxData}

Parameters

hexTxDatastringrequiredpath

Raw transaction data in hexadecimal string format.

Response

200OK

HTTP 200 response for {hexTxData}. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Broadcast raw transaction

curl -X GET 'https://trx-blockbook.nownodes.io/api/sendtx/{hexTxData}'

const response = await fetch('https://trx-blockbook.nownodes.io/api/sendtx/{hexTxData}', {
  method: 'GET',
});

const data = await response.json();

import requests

response = requests.get('https://trx-blockbook.nownodes.io/api/sendtx/{hexTxData}')
data = response.json()

{
  "result": "Transaction submitted"
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Broadcast raw transaction via POST body

POST

https://trx-blockbook.nownodes.io/api/sendtx

Broadcasts a raw transaction provided in hexadecimal format via the request body.
Returns the transaction ID if successfully broadcast.

Body

application/json

Raw transaction data in hexadecimal format

Request value.

hexstring

Raw transaction in hexadecimal format

Response

200OK

HTTP 200 response for sendtx. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Broadcast raw transaction via POST body

curl -X POST 'https://trx-blockbook.nownodes.io/api/sendtx/' \
  -H 'Content-Type: application/json' \
  -d '{
    "hex": "0200000001abcdef...00000000"
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/api/sendtx/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "hex": "0200000001abcdef...00000000"
    }),
});

const data = await response.json();

import requests

payload = {
  "hex": "0200000001abcdef...00000000"
}

response = requests.post('https://trx-blockbook.nownodes.io/api/sendtx/', json=payload)
data = response.json()

Request Body

{
  "hex": "0200000001abcdef...00000000"
}

{
  "result": "Transaction submitted"
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

MAINNET / EVM

eth_accounts

eth_accounts operations.

Ethereum method - eth_accounts

POST

https://trx-blockbook.nownodes.io/jsonrpc

Returns an array of addresses controlled by the client.

Body

application/json

Request value.

jsonrpcstringrequired

JSON-RPC version identifier

methodstringrequired

Name of the JSON-RPC method

paramsarrayrequired

No parameters are required for this method. This must be an empty array.

idintegerrequired

Unique identifier for the JSON-RPC request

Response

200OK

HTTP 200 response for eth_accounts. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Ethereum method - eth_accounts

curl -X POST 'https://trx-blockbook.nownodes.io/jsonrpc' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_accounts",
    "params": [],
    "id": 1
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/jsonrpc', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "eth_accounts",
      "params": [],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_accounts",
  "params": [],
  "id": 1
}

response = requests.post('https://trx-blockbook.nownodes.io/jsonrpc', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_accounts",
  "params": [],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": []
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: invalid parameter for eth_accounts"
  }
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

eth_blockNumber

eth_blockNumber operations.

Ethereum method - eth_blockNumber

POST

https://trx-blockbook.nownodes.io/jsonrpc

Returns the number of the latest block on the chain in hexadecimal format.

Body

application/json

Request value.

jsonrpcstringrequired

The JSON-RPC protocol version

methodstringrequired

Name of the method being called

paramsarrayrequired

This method does not take parameters; always send an empty array.

idintegerrequired

A unique ID for the request

Response

200OK

HTTP 200 response for eth_blockNumber. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Ethereum method - eth_blockNumber

curl -X POST 'https://trx-blockbook.nownodes.io/jsonrpc' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_blockNumber",
    "params": [],
    "id": 1
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/jsonrpc', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "eth_blockNumber",
      "params": [],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_blockNumber",
  "params": [],
  "id": 1
}

response = requests.post('https://trx-blockbook.nownodes.io/jsonrpc', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_blockNumber",
  "params": [],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x502e969"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: invalid parameter for eth_blockNumber"
  }
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

eth_call

eth_call operations.

Ethereum method - eth_call

POST

https://trx-blockbook.nownodes.io/jsonrpc

Executes a call to a contract or address and returns the result without broadcasting a transaction.

Body

application/json

Request value.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

paramsArray<object | string>required

The first object specifies the call transaction object. The second (optional) parameter specifies the block context.

Show child attributes

Single array item value.

One of

fromstring

Address the call is sent from (optional)

tostringrequired

Target address for the call (required)

gasstring

Gas provided for the call, as hex

gasPricestring

Gas price in wei, as hex

valuestring

Amount of ETH sent, as hex (optional)

datastring

Compiled contract method call data

(Optional) Integer block number, or the string "latest", "earliest", or "pending".

string

idintegerrequired

Client request identifier echoed by the server.

Response

200OK

HTTP 200 response for eth_call. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Ethereum method - eth_call

curl -X POST 'https://trx-blockbook.nownodes.io/jsonrpc' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_call",
    "params": [
      {
        "from": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
        "to": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
        "gas": "0x76c0",
        "gasPrice": "0x9184e72a000",
        "value": "0x0",
        "data": "0x70a08231000000000000000000000000a0df350d2637096571f7a701cbc1c5fd..."
      }
    ],
    "id": 1
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/jsonrpc', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "eth_call",
      "params": [
        {
          "from": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
          "to": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
          "gas": "0x76c0",
          "gasPrice": "0x9184e72a000",
          "value": "0x0",
          "data": "0x70a08231000000000000000000000000a0df350d2637096571f7a701cbc1c5fd..."
        }
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_call",
  "params": [
    {
      "from": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
      "to": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
      "gas": "0x76c0",
      "gasPrice": "0x9184e72a000",
      "value": "0x0",
      "data": "0x70a08231000000000000000000000000a0df350d2637096571f7a701cbc1c5fd..."
    }
  ],
  "id": 1
}

response = requests.post('https://trx-blockbook.nownodes.io/jsonrpc', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_call",
  "params": [
    {
      "from": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
      "to": "0xdAC17F958D2ee523a2206206994597C13D831ec7",
      "gas": "0x76c0",
      "gasPrice": "0x9184e72a000",
      "value": "0x0",
      "data": "0x70a08231000000000000000000000000a0df350d2637096571f7a701cbc1c5fd..."
    }
  ],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: invalid parameter for eth_call"
  }
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

eth_chainId

eth_chainId operations.

Ethereum method - eth_chainId

POST

https://trx-blockbook.nownodes.io/jsonrpc

Returns the hexadecimal string of the current chain ID.

Body

application/json

Request value.

jsonrpcstringrequired

JSON-RPC protocol version

methodstringrequired

Name of the method to call

paramsarrayrequired

This method does not require parameters. Use an empty array.

idintegerrequired

Unique identifier for the request

Response

200OK

HTTP 200 response for eth_chainId. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Ethereum method - eth_chainId

curl -X POST 'https://trx-blockbook.nownodes.io/jsonrpc' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_chainId",
    "params": [],
    "id": 1
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/jsonrpc', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "eth_chainId",
      "params": [],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_chainId",
  "params": [],
  "id": 1
}

response = requests.post('https://trx-blockbook.nownodes.io/jsonrpc', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_chainId",
  "params": [],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x2b6653dc"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: invalid parameter for eth_chainId"
  }
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

eth_coinbase

eth_coinbase operations.

eth_coinbase

POST

https://trx-blockbook.nownodes.io/jsonrpc

Returns the Ethereum coinbase address (i.e., the address that receives mining rewards).

Body

application/json

Request value.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringeth_coinbaserequired

JSON-RPC method name.

paramsarrayrequired

This method takes no parameters.

idintegerrequired

Client request identifier echoed by the server.

Response

200OK

HTTP 200 response for eth_coinbase. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

eth_coinbase

curl -X POST 'https://trx-blockbook.nownodes.io/jsonrpc' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_coinbase",
    "params": [],
    "id": 1
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/jsonrpc', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "eth_coinbase",
      "params": [],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_coinbase",
  "params": [],
  "id": 1
}

response = requests.post('https://trx-blockbook.nownodes.io/jsonrpc', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_coinbase",
  "params": [],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x5aeda56215b167893e80b4fe645ba6d5bab767de"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: invalid parameter for eth_coinbase"
  }
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

eth_estimateGas

eth_estimateGas operations.

Estimate Gas for Transaction

POST

https://trx-blockbook.nownodes.io/jsonrpc

Simulates a transaction and returns an estimate of how much gas would be used.

Body

application/json

Request value.

jsonrpcstringrequired

JSON-RPC protocol version

methodstringrequired

The method name

paramsArray<object | string>required

The transaction call object and an optional block tag.

Show child attributes

Single array item value.

One of

fromstring

Address the transaction is sent from (optional)

tostringrequired

Destination address of the call

gasstring

Gas limit provided for execution (optional)

gasPricestring

Gas price in wei (optional)

valuestring

Amount of ETH to send, in hexadecimal wei (optional)

datastring

The compiled input data for the transaction (optional)

Optional block tag (e.g., "latest", "earliest", or a block number)

string

idintegerrequired

Request identifier

Response

200OK

HTTP 200 response for eth_estimateGas. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Estimate Gas for Transaction

curl -X POST 'https://trx-blockbook.nownodes.io/jsonrpc' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_estimateGas",
    "params": [
      {
        "from": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
        "to": "0x6b175474e89094c44da98b954eedeac495271d0f",
        "gas": "0x76c0",
        "gasPrice": "0x9184e72a000",
        "value": "0x0",
        "data": "0x70a08231000000000000000000000000a0df350d2637096571f7a701cbc1c5fd"
      }
    ],
    "id": 1
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/jsonrpc', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "eth_estimateGas",
      "params": [
        {
          "from": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
          "to": "0x6b175474e89094c44da98b954eedeac495271d0f",
          "gas": "0x76c0",
          "gasPrice": "0x9184e72a000",
          "value": "0x0",
          "data": "0x70a08231000000000000000000000000a0df350d2637096571f7a701cbc1c5fd"
        }
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_estimateGas",
  "params": [
    {
      "from": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
      "to": "0x6b175474e89094c44da98b954eedeac495271d0f",
      "gas": "0x76c0",
      "gasPrice": "0x9184e72a000",
      "value": "0x0",
      "data": "0x70a08231000000000000000000000000a0df350d2637096571f7a701cbc1c5fd"
    }
  ],
  "id": 1
}

response = requests.post('https://trx-blockbook.nownodes.io/jsonrpc', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_estimateGas",
  "params": [
    {
      "from": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
      "to": "0x6b175474e89094c44da98b954eedeac495271d0f",
      "gas": "0x76c0",
      "gasPrice": "0x9184e72a000",
      "value": "0x0",
      "data": "0x70a08231000000000000000000000000a0df350d2637096571f7a701cbc1c5fd"
    }
  ],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x0"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: invalid parameter for eth_estimateGas"
  }
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

eth_feeHistory

eth_feeHistory operations.

eth_feeHistory

POST

https://trx-blockbook.nownodes.io/jsonrpc

Returns fee market information for a range of blocks. This is typically used by wallets and other tools to estimate appropriate gas prices.

Body

application/json

Request value.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

paramsArray<string | integer | Array<number>>required

Parameters:

blockCount — number of blocks in the requested range.
newestBlock — highest block number in the requested range (can be "latest").
rewardPercentiles — list of percentile values to sample priority fees from each block (optional).

Show child attributes

Single array item value.

Any of

Single array item value.

string

Single array item value.

integer

Array<number>

idintegerrequired

Client request identifier echoed by the server.

Response

200OK

HTTP 200 response for eth_feeHistory. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

eth_feeHistory

curl -X POST 'https://trx-blockbook.nownodes.io/jsonrpc' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_feeHistory",
    "params": [
      "0x5",
      "latest",
      [
        10,
        50,
        90
      ]
    ],
    "id": 1
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/jsonrpc', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "eth_feeHistory",
      "params": [
        "0x5",
        "latest",
        [
          10,
          50,
          90
        ]
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_feeHistory",
  "params": [
    "0x5",
    "latest",
    [
      10,
      50,
      90
    ]
  ],
  "id": 1
}

response = requests.post('https://trx-blockbook.nownodes.io/jsonrpc', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_feeHistory",
  "params": [
    "0x5",
    "latest",
    [
      10,
      50,
      90
    ]
  ],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "oldestBlock": "0x502e969",
    "baseFeePerGas": [
      "0x0",
      "0x0"
    ],
    "gasUsedRatio": [
      0,
      0
    ],
    "reward": [
      [
        "0x0"
      ],
      [
        "0x0"
      ]
    ]
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: invalid parameter for eth_feeHistory"
  }
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

eth_gasPrice

eth_gasPrice operations.

Get Suggested Gas Price

POST

https://trx-blockbook.nownodes.io/jsonrpc

Returns the current gas price in wei as a hexadecimal string. This value is a node estimate based on recent blocks and mempool activity.

Body

application/json

Request value.

jsonrpcstringrequired

JSON-RPC version

methodstringrequired

JSON-RPC method name

paramsarrayrequired

This method takes an empty array.

idintegerrequired

Request identifier

Response

200OK

HTTP 200 response for eth_gasPrice. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get Suggested Gas Price

curl -X POST 'https://trx-blockbook.nownodes.io/jsonrpc' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_gasPrice",
    "params": [],
    "id": 1
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/jsonrpc', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "eth_gasPrice",
      "params": [],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_gasPrice",
  "params": [],
  "id": 1
}

response = requests.post('https://trx-blockbook.nownodes.io/jsonrpc', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_gasPrice",
  "params": [],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x0"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: invalid parameter for eth_gasPrice"
  }
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

eth_getBalance

eth_getBalance operations.

Get ETH Balance of an Address

POST

https://trx-blockbook.nownodes.io/jsonrpc

Retrieves the balance (in wei) of a given Ethereum address. You can specify the block parameter to get the balance at a specific block.

Body

application/json

Request value.

jsonrpcstringrequired

JSON-RPC version

methodstringrequired

JSON-RPC method name

paramsArray<string>required

Array with 2 parameters:

Address (20-byte hex string with '0x' prefix)
Block tag (e.g., 'latest', 'earliest', 'pending', or block number in hex)

idintegerrequired

Request ID

Response

200OK

HTTP 200 response for eth_getBalance. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get ETH Balance of an Address

curl -X POST 'https://trx-blockbook.nownodes.io/jsonrpc' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_getBalance",
    "params": [
      "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
      "latest"
    ],
    "id": 1
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/jsonrpc', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "eth_getBalance",
      "params": [
        "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
        "latest"
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_getBalance",
  "params": [
    "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
    "latest"
  ],
  "id": 1
}

response = requests.post('https://trx-blockbook.nownodes.io/jsonrpc', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_getBalance",
  "params": [
    "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
    "latest"
  ],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x0"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: invalid parameter for eth_getBalance"
  }
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

eth_getBlockByHash

eth_getBlockByHash operations.

Get Block by Hash

POST

https://trx-blockbook.nownodes.io/jsonrpc

Returns the block information for the specified block hash. The second parameter indicates whether to return full transaction objects or just transaction hashes.

Body

application/json

Request value.

jsonrpcstringrequired

JSON-RPC version

methodstringrequired

JSON-RPC method name

paramsArray<string>required

Array of parameters:

Block hash (string)
Boolean flag — if true, return full transactions; if false, only hashes.

idintegerrequired

Request ID

Response

200OK

HTTP 200 response for eth_getBlockByHash. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get Block by Hash

curl -X POST 'https://trx-blockbook.nownodes.io/jsonrpc' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_getBlockByHash",
    "params": [
      "0x7f9d3a8f8a6b6d4415a93b0f8d8a2bfc5a44d5e7a3cb1a3a5cf3a0f8d1c6c1d2",
      false
    ],
    "id": 1
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/jsonrpc', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "eth_getBlockByHash",
      "params": [
        "0x7f9d3a8f8a6b6d4415a93b0f8d8a2bfc5a44d5e7a3cb1a3a5cf3a0f8d1c6c1d2",
        false
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_getBlockByHash",
  "params": [
    "0x7f9d3a8f8a6b6d4415a93b0f8d8a2bfc5a44d5e7a3cb1a3a5cf3a0f8d1c6c1d2",
    false
  ],
  "id": 1
}

response = requests.post('https://trx-blockbook.nownodes.io/jsonrpc', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_getBlockByHash",
  "params": [
    "0x7f9d3a8f8a6b6d4415a93b0f8d8a2bfc5a44d5e7a3cb1a3a5cf3a0f8d1c6c1d2",
    false
  ],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "baseFeePerGas": "0x0",
    "difficulty": "0x0",
    "extraData": "0x",
    "gasLimit": "0x0",
    "gasUsed": "0x0",
    "hash": "0x000000000502e9686b96165061a0c1deaa8818cb4c2950a60d0d713865b106d3",
    "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
    "miner": "0x5aeda56215b167893e80b4fe645ba6d5bab767de",
    "number": "0x502e969",
    "parentHash": "0x000000000502e9672a443fb644045f8f397e84a212750096eb0bbb0ed563e389",
    "receiptsRoot": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
    "size": "0x24e",
    "stateRoot": "0x1111111111111111111111111111111111111111111111111111111111111111",
    "timestamp": "0x6a44e834",
    "transactions": [],
    "uncles": []
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: invalid parameter for eth_getBlockByHash"
  }
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

eth_getBlockByNumber

eth_getBlockByNumber operations.

Get Block by Number

POST

https://trx-blockbook.nownodes.io/jsonrpc

Returns the block information for the specified block number. The second parameter indicates whether to return full transaction objects or just transaction hashes.

Body

application/json

Request value.

jsonrpcstringrequired

JSON-RPC version

methodstringrequired

JSON-RPC method name

paramsArray<string>required

Array of parameters:

Block number (hex string, e.g., "0x1b4") or special tags ("latest", "earliest", "pending")
Boolean flag — if true, return full transactions; if false, only hashes.

idintegerrequired

Request ID

Response

200OK

HTTP 200 response for eth_getBlockByNumber. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get Block by Number

curl -X POST 'https://trx-blockbook.nownodes.io/jsonrpc' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_getBlockByNumber",
    "params": [
      "0x1b4",
      false
    ],
    "id": 1
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/jsonrpc', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "eth_getBlockByNumber",
      "params": [
        "0x1b4",
        false
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_getBlockByNumber",
  "params": [
    "0x1b4",
    false
  ],
  "id": 1
}

response = requests.post('https://trx-blockbook.nownodes.io/jsonrpc', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_getBlockByNumber",
  "params": [
    "0x1b4",
    false
  ],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "baseFeePerGas": "0x0",
    "difficulty": "0x0",
    "extraData": "0x",
    "gasLimit": "0x0",
    "gasUsed": "0x0",
    "hash": "0x000000000502e9686b96165061a0c1deaa8818cb4c2950a60d0d713865b106d3",
    "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
    "miner": "0x5aeda56215b167893e80b4fe645ba6d5bab767de",
    "number": "0x502e969",
    "parentHash": "0x000000000502e9672a443fb644045f8f397e84a212750096eb0bbb0ed563e389",
    "receiptsRoot": "0x0000000000000000000000000000000000000000000000000000000000000000",
    "sha3Uncles": "0x1dcc4de8dec75d7aab85b567b6ccd41ad312451b948a7413f0a142fd40d49347",
    "size": "0x24e",
    "stateRoot": "0x1111111111111111111111111111111111111111111111111111111111111111",
    "timestamp": "0x6a44e834",
    "transactions": [],
    "uncles": []
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: invalid parameter for eth_getBlockByNumber"
  }
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

eth_getBlockReceipts

eth_getBlockReceipts operations.

Get All Transaction Receipts for a Block

POST

https://trx-blockbook.nownodes.io/jsonrpc

Returns an array of transaction receipts for every transaction in the block specified by block number or block hash.

Body

application/json

Request value.

jsonrpcstringrequired

JSON-RPC version

methodstringrequired

JSON-RPC method name

paramsArray<string>required

One parameter:

Block identifier, which can be either:
- block number as hex string (e.g. "0x10d4f")
- or block hash as hex string (0x-prefixed)

idintegerrequired

Request identifier

Response

200OK

HTTP 200 response for eth_getBlockReceipts. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get All Transaction Receipts for a Block

curl -X POST 'https://trx-blockbook.nownodes.io/jsonrpc' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_getBlockReceipts",
    "params": [
      "0x10d4f"
    ],
    "id": 1
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/jsonrpc', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "eth_getBlockReceipts",
      "params": [
        "0x10d4f"
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_getBlockReceipts",
  "params": [
    "0x10d4f"
  ],
  "id": 1
}

response = requests.post('https://trx-blockbook.nownodes.io/jsonrpc', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_getBlockReceipts",
  "params": [
    "0x10d4f"
  ],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": []
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: invalid parameter for eth_getBlockReceipts"
  }
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

eth_getBlockTransactionCountByHash

eth_getBlockTransactionCountByHash operations.

Get Transaction Count by Block Hash

POST

https://trx-blockbook.nownodes.io/jsonrpc

Returns the number of transactions contained in the block with the given hash.

Body

application/json

Request value.

jsonrpcstringrequired

JSON-RPC version

methodstringrequired

JSON-RPC method name

paramsArray<string>required

Array containing a single parameter:

Block hash as a hex string (32 bytes with 0x prefix)

idintegerrequired

Request ID

Response

200OK

HTTP 200 response for eth_getBlockTransactionCountByHash. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get Transaction Count by Block Hash

curl -X POST 'https://trx-blockbook.nownodes.io/jsonrpc' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_getBlockTransactionCountByHash",
    "params": [
      "0x9b559a3d7ee67a0a8bb96ec93c93a0db3f9c66a355a3eb9f3f519c0f26a27c79"
    ],
    "id": 1
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/jsonrpc', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "eth_getBlockTransactionCountByHash",
      "params": [
        "0x9b559a3d7ee67a0a8bb96ec93c93a0db3f9c66a355a3eb9f3f519c0f26a27c79"
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_getBlockTransactionCountByHash",
  "params": [
    "0x9b559a3d7ee67a0a8bb96ec93c93a0db3f9c66a355a3eb9f3f519c0f26a27c79"
  ],
  "id": 1
}

response = requests.post('https://trx-blockbook.nownodes.io/jsonrpc', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_getBlockTransactionCountByHash",
  "params": [
    "0x9b559a3d7ee67a0a8bb96ec93c93a0db3f9c66a355a3eb9f3f519c0f26a27c79"
  ],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x0"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: invalid parameter for eth_getBlockTransactionCountByHash"
  }
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

eth_getBlockTransactionCountByNumber

eth_getBlockTransactionCountByNumber operations.

Get Transaction Count by Block Number

POST

https://trx-blockbook.nownodes.io/jsonrpc

Returns the number of transactions contained in the block with the given block number.

Body

application/json

Request value.

jsonrpcstringrequired

JSON-RPC version

methodstringrequired

JSON-RPC method name

paramsArray<string>required

Array containing a single parameter:

Block number as a hex string (e.g. "0x10d4f" for block 69007) or
predefined block tags such as "latest", "earliest", or "pending"

idintegerrequired

Request ID

Response

200OK

HTTP 200 response for eth_getBlockTransactionCountByNumber. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get Transaction Count by Block Number

curl -X POST 'https://trx-blockbook.nownodes.io/jsonrpc' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_getBlockTransactionCountByNumber",
    "params": [
      "0x10d4f"
    ],
    "id": 1
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/jsonrpc', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "eth_getBlockTransactionCountByNumber",
      "params": [
        "0x10d4f"
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_getBlockTransactionCountByNumber",
  "params": [
    "0x10d4f"
  ],
  "id": 1
}

response = requests.post('https://trx-blockbook.nownodes.io/jsonrpc', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_getBlockTransactionCountByNumber",
  "params": [
    "0x10d4f"
  ],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x0"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: invalid parameter for eth_getBlockTransactionCountByNumber"
  }
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

eth_getCode

eth_getCode operations.

Get Contract Bytecode at Address

POST

https://trx-blockbook.nownodes.io/jsonrpc

Returns the contract code stored at a given address. If the address is an externally owned account (EOA), it returns "0x".

Body

application/json

Request value.

jsonrpcstringrequired

JSON-RPC version.

methodstringrequired

JSON-RPC method name.

paramsArray<string>required

Parameters array with two elements:

The address to get the code for (hex string, 0x-prefixed).
The block number or block tag (e.g., "latest", "earliest", "pending").

idintegerrequired

Request identifier.

Response

200OK

HTTP 200 response for eth_getCode. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get Contract Bytecode at Address

curl -X POST 'https://trx-blockbook.nownodes.io/jsonrpc' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_getCode",
    "params": [
      "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
      "latest"
    ],
    "id": 1
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/jsonrpc', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "eth_getCode",
      "params": [
        "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
        "latest"
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_getCode",
  "params": [
    "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
    "latest"
  ],
  "id": 1
}

response = requests.post('https://trx-blockbook.nownodes.io/jsonrpc', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_getCode",
  "params": [
    "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
    "latest"
  ],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: invalid parameter for eth_getCode"
  }
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

eth_getFilterChanges

eth_getFilterChanges operations.

Get Filter Changes

POST

https://trx-blockbook.nownodes.io/jsonrpc

Returns an array of logs that occurred since the last poll for the specified filter ID. The filter must have been previously created with eth_newFilter or eth_newBlockFilter or eth_newPendingTransactionFilter.

Body

application/json

Request value.

jsonrpcstringrequired

JSON-RPC version.

methodstringrequired

JSON-RPC method name.

paramsArray<string>required

Parameters array with a single element:

The filter ID (hex string).

idintegerrequired

Request identifier.

Response

200OK

HTTP 200 response for eth_getFilterChanges. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get Filter Changes

curl -X POST 'https://trx-blockbook.nownodes.io/jsonrpc' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_getFilterChanges",
    "params": [
      "0x16"
    ],
    "id": 1
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/jsonrpc', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "eth_getFilterChanges",
      "params": [
        "0x16"
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_getFilterChanges",
  "params": [
    "0x16"
  ],
  "id": 1
}

response = requests.post('https://trx-blockbook.nownodes.io/jsonrpc', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_getFilterChanges",
  "params": [
    "0x16"
  ],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": []
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: invalid parameter for eth_getFilterChanges"
  }
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

eth_getFilterLogs

eth_getFilterLogs operations.

Get Filter Logs

POST

https://trx-blockbook.nownodes.io/jsonrpc

Returns all logs matching a filter with the specified filter ID. The filter must have been previously created with eth_newFilter.

Body

application/json

Request value.

jsonrpcstringrequired

JSON-RPC version.

methodstringrequired

JSON-RPC method name.

paramsArray<string>required

Parameters array with one element:

The filter ID (hex string).

idintegerrequired

Request identifier.

Response

200OK

HTTP 200 response for eth_getFilterLogs. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get Filter Logs

curl -X POST 'https://trx-blockbook.nownodes.io/jsonrpc' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_getFilterLogs",
    "params": [
      "0x16"
    ],
    "id": 1
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/jsonrpc', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "eth_getFilterLogs",
      "params": [
        "0x16"
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_getFilterLogs",
  "params": [
    "0x16"
  ],
  "id": 1
}

response = requests.post('https://trx-blockbook.nownodes.io/jsonrpc', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_getFilterLogs",
  "params": [
    "0x16"
  ],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": []
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: invalid parameter for eth_getFilterLogs"
  }
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

eth_getLogs

eth_getLogs operations.

Get Logs

POST

https://trx-blockbook.nownodes.io/jsonrpc

Returns an array of logs that match the filter criteria specified in the params. The filter object supports filtering by block range, addresses, and topics.

Body

application/json

Request value.

jsonrpcstringrequired

JSON-RPC version.

methodstringrequired

JSON-RPC method name.

paramsArray<object>required

Parameters array with one element: the filter object.

Show child attributes

fromBlockstring

Starting block number (hex string) or "earliest", "latest", "pending".

toBlockstring

Ending block number (hex string) or "earliest", "latest", "pending".

addressstring | Array<string>

Contract address or list of addresses from which logs should originate.

topicsarray

Array of topic filters. Each topic can be a string, null, or an array of strings for OR filtering.

idintegerrequired

Request identifier.

Response

200OK

HTTP 200 response for eth_getLogs. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get Logs

curl -X POST 'https://trx-blockbook.nownodes.io/jsonrpc' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_getLogs",
    "params": [
      {
        "fromBlock": "0x1b4",
        "toBlock": "0x1f4",
        "address": "0x1234567890abcdef1234567890abcdef12345678",
        "topics": [
          "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
          null,
          [
            "0x000000000000000000000000a7d9ddbe1f17865597fbd27ec712455208b6b76d",
            "0x000000000000000000000000bb9bc244d798123fde783fcc1c72d3bb8c189413"
          ]
        ]
      }
    ],
    "id": 1
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/jsonrpc', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "eth_getLogs",
      "params": [
        {
          "fromBlock": "0x1b4",
          "toBlock": "0x1f4",
          "address": "0x1234567890abcdef1234567890abcdef12345678",
          "topics": [
            "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
            null,
            [
              "0x000000000000000000000000a7d9ddbe1f17865597fbd27ec712455208b6b76d",
              "0x000000000000000000000000bb9bc244d798123fde783fcc1c72d3bb8c189413"
            ]
          ]
        }
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_getLogs",
  "params": [
    {
      "fromBlock": "0x1b4",
      "toBlock": "0x1f4",
      "address": "0x1234567890abcdef1234567890abcdef12345678",
      "topics": [
        "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
        null,
        [
          "0x000000000000000000000000a7d9ddbe1f17865597fbd27ec712455208b6b76d",
          "0x000000000000000000000000bb9bc244d798123fde783fcc1c72d3bb8c189413"
        ]
      ]
    }
  ],
  "id": 1
}

response = requests.post('https://trx-blockbook.nownodes.io/jsonrpc', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_getLogs",
  "params": [
    {
      "fromBlock": "0x1b4",
      "toBlock": "0x1f4",
      "address": "0x1234567890abcdef1234567890abcdef12345678",
      "topics": [
        "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
        null,
        [
          "0x000000000000000000000000a7d9ddbe1f17865597fbd27ec712455208b6b76d",
          "0x000000000000000000000000bb9bc244d798123fde783fcc1c72d3bb8c189413"
        ]
      ]
    }
  ],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": []
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: invalid parameter for eth_getLogs"
  }
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

eth_getStorageAt

eth_getStorageAt operations.

Get Storage At

POST

https://trx-blockbook.nownodes.io/jsonrpc

Returns the value stored at position in the storage of the contract at address at the given blockNumber.

Body

application/json

Request value.

jsonrpcstringrequired

JSON-RPC version.

methodstringrequired

JSON-RPC method name.

paramsArray<string>required

Parameters array:

address: string - Contract address to query storage from.
position: string - Storage slot position (hex string).
block number: string - Block number or keywords ("latest", "earliest", "pending").

idintegerrequired

Request identifier.

Response

200OK

HTTP 200 response for eth_getStorageAt. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get Storage At

curl -X POST 'https://trx-blockbook.nownodes.io/jsonrpc' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_getStorageAt",
    "params": [
      "0x1234567890abcdef1234567890abcdef12345678",
      "0x0",
      "latest"
    ],
    "id": 1
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/jsonrpc', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "eth_getStorageAt",
      "params": [
        "0x1234567890abcdef1234567890abcdef12345678",
        "0x0",
        "latest"
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_getStorageAt",
  "params": [
    "0x1234567890abcdef1234567890abcdef12345678",
    "0x0",
    "latest"
  ],
  "id": 1
}

response = requests.post('https://trx-blockbook.nownodes.io/jsonrpc', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_getStorageAt",
  "params": [
    "0x1234567890abcdef1234567890abcdef12345678",
    "0x0",
    "latest"
  ],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: invalid parameter for eth_getStorageAt"
  }
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

eth_getTransactionByBlockHashAndIndex

eth_getTransactionByBlockHashAndIndex operations.

Get Transaction by Block Hash and Index

POST

https://trx-blockbook.nownodes.io/jsonrpc

Retrieves the transaction from a block using the block's hash and the transaction's index position within the block.

Body

application/json

Request value.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

paramsArray<string>required

Parameters:

blockHash (string): The 32-byte hash of the block.
transactionIndex (string): The transaction index (hex).

idintegerrequired

Client request identifier echoed by the server.

Response

200OK

HTTP 200 response for eth_getTransactionByBlockHashAndIndex. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get Transaction by Block Hash and Index

curl -X POST 'https://trx-blockbook.nownodes.io/jsonrpc' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_getTransactionByBlockHashAndIndex",
    "params": [
      "item_example"
    ],
    "id": 1
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/jsonrpc', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "eth_getTransactionByBlockHashAndIndex",
      "params": [
        "item_example"
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_getTransactionByBlockHashAndIndex",
  "params": [
    "item_example"
  ],
  "id": 1
}

response = requests.post('https://trx-blockbook.nownodes.io/jsonrpc', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_getTransactionByBlockHashAndIndex",
  "params": [
    "0xb3b20624a42dffdf1af8e8a6c9b338360585cc309831785f2138e1f9c35a1f09",
    "0x0"
  ],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "blockHash": "0x000000000502e9686b96165061a0c1deaa8818cb4c2950a60d0d713865b106d3",
    "blockNumber": "0x502e969",
    "from": "0x5aeda56215b167893e80b4fe645ba6d5bab767de",
    "gas": "0x5208",
    "gasPrice": "0x0",
    "hash": "0xaaeb5bfd0d5f5a4ba8c825bdc8bc6f6ceaec896f11f31c1374d9285dc0c12906",
    "input": "0x",
    "nonce": "0x0",
    "to": "0x5aeda56215b167893e80b4fe645ba6d5bab767de",
    "transactionIndex": "0x0",
    "value": "0x0",
    "type": "0x0",
    "v": "0x0",
    "r": "0x1",
    "s": "0x1"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: invalid parameter for eth_getTransactionByBlockHashAndIndex"
  }
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

eth_getTransactionByBlockNumberAndIndex

eth_getTransactionByBlockNumberAndIndex operations.

Get Transaction by Block Number and Index

POST

https://trx-blockbook.nownodes.io/jsonrpc

Returns the information about a transaction using the block number and the transaction index within the block.

Body

application/json

Request value.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

paramsArray<string>required

Parameters:

Block number in hex format (e.g., "0x5daf3b")
Transaction index in the block (e.g., "0x0")

idintegerrequired

Client request identifier echoed by the server.

Response

200OK

HTTP 200 response for eth_getTransactionByBlockNumberAndIndex. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get Transaction by Block Number and Index

curl -X POST 'https://trx-blockbook.nownodes.io/jsonrpc' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_getTransactionByBlockNumberAndIndex",
    "params": [
      "item_example"
    ],
    "id": 1
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/jsonrpc', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "eth_getTransactionByBlockNumberAndIndex",
      "params": [
        "item_example"
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_getTransactionByBlockNumberAndIndex",
  "params": [
    "item_example"
  ],
  "id": 1
}

response = requests.post('https://trx-blockbook.nownodes.io/jsonrpc', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_getTransactionByBlockNumberAndIndex",
  "params": [
    "0x5daf3b",
    "0x0"
  ],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "blockHash": "0x000000000502e9686b96165061a0c1deaa8818cb4c2950a60d0d713865b106d3",
    "blockNumber": "0x502e969",
    "from": "0x5aeda56215b167893e80b4fe645ba6d5bab767de",
    "gas": "0x5208",
    "gasPrice": "0x0",
    "hash": "0xaaeb5bfd0d5f5a4ba8c825bdc8bc6f6ceaec896f11f31c1374d9285dc0c12906",
    "input": "0x",
    "nonce": "0x0",
    "to": "0x5aeda56215b167893e80b4fe645ba6d5bab767de",
    "transactionIndex": "0x0",
    "value": "0x0",
    "type": "0x0",
    "v": "0x0",
    "r": "0x1",
    "s": "0x1"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: invalid parameter for eth_getTransactionByBlockNumberAndIndex"
  }
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

eth_getTransactionByHash

eth_getTransactionByHash operations.

Get transaction by hash

POST

https://trx-blockbook.nownodes.io/jsonrpc

Calls the eth_getTransactionByHash operation.

Body

application/json

Request value.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

paramsArray<string>required

Array containing a single transaction hash

idintegerrequired

Client request identifier echoed by the server.

Response

200OK

HTTP 200 response for eth_getTransactionByHash. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get transaction by hash

curl -X POST 'https://trx-blockbook.nownodes.io/jsonrpc' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_getTransactionByHash",
    "params": [
      "0x3f1c7f9e684bbd292f3b849df4c03ff4ffbd83ad2c6cb136a20ee2ebded7df72"
    ],
    "id": 1
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/jsonrpc', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "eth_getTransactionByHash",
      "params": [
        "0x3f1c7f9e684bbd292f3b849df4c03ff4ffbd83ad2c6cb136a20ee2ebded7df72"
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_getTransactionByHash",
  "params": [
    "0x3f1c7f9e684bbd292f3b849df4c03ff4ffbd83ad2c6cb136a20ee2ebded7df72"
  ],
  "id": 1
}

response = requests.post('https://trx-blockbook.nownodes.io/jsonrpc', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_getTransactionByHash",
  "params": [
    "0x3f1c7f9e684bbd292f3b849df4c03ff4ffbd83ad2c6cb136a20ee2ebded7df72"
  ],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "blockHash": "0x000000000502e9686b96165061a0c1deaa8818cb4c2950a60d0d713865b106d3",
    "blockNumber": "0x502e969",
    "from": "0x5aeda56215b167893e80b4fe645ba6d5bab767de",
    "gas": "0x5208",
    "gasPrice": "0x0",
    "hash": "0xaaeb5bfd0d5f5a4ba8c825bdc8bc6f6ceaec896f11f31c1374d9285dc0c12906",
    "input": "0x",
    "nonce": "0x0",
    "to": "0x5aeda56215b167893e80b4fe645ba6d5bab767de",
    "transactionIndex": "0x0",
    "value": "0x0",
    "type": "0x0",
    "v": "0x0",
    "r": "0x1",
    "s": "0x1"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: invalid parameter for eth_getTransactionByHash"
  }
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

eth_getTransactionCount

eth_getTransactionCount operations.

Get transaction count (nonce) for address

POST

https://trx-blockbook.nownodes.io/jsonrpc

Calls the eth_getTransactionCount operation.

Body

application/json

Request value.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

paramsArray<string>required

address: The address to check for transaction count.
block: The block parameter (e.g., "latest", "earliest", "pending").

idintegerrequired

Client request identifier echoed by the server.

Response

200OK

HTTP 200 response for eth_getTransactionCount. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get transaction count (nonce) for address

curl -X POST 'https://trx-blockbook.nownodes.io/jsonrpc' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_getTransactionCount",
    "params": [
      "0x742d35cc6634c0532925a3b844bc454e4438f44e",
      "latest"
    ],
    "id": 1
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/jsonrpc', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "eth_getTransactionCount",
      "params": [
        "0x742d35cc6634c0532925a3b844bc454e4438f44e",
        "latest"
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_getTransactionCount",
  "params": [
    "0x742d35cc6634c0532925a3b844bc454e4438f44e",
    "latest"
  ],
  "id": 1
}

response = requests.post('https://trx-blockbook.nownodes.io/jsonrpc', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_getTransactionCount",
  "params": [
    "0x742d35cc6634c0532925a3b844bc454e4438f44e",
    "latest"
  ],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x0"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: invalid parameter for eth_getTransactionCount"
  }
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

eth_getTransactionReceipt

eth_getTransactionReceipt operations.

Get transaction receipt by hash

POST

https://trx-blockbook.nownodes.io/jsonrpc

Calls the eth_getTransactionReceipt operation.

Body

application/json

Request value.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

paramsArray<string>required

Ordered JSON-RPC method parameters.

idintegerrequired

Client request identifier echoed by the server.

Response

200OK

HTTP 200 response for eth_getTransactionReceipt. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get transaction receipt by hash

curl -X POST 'https://trx-blockbook.nownodes.io/jsonrpc' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_getTransactionReceipt",
    "params": [
      "0x5d1c7b4c8f3474891e1f632f85e7205b6d1a0e0ccbb5cfb1d3a2cf0e9d6f1df7"
    ],
    "id": 1
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/jsonrpc', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "eth_getTransactionReceipt",
      "params": [
        "0x5d1c7b4c8f3474891e1f632f85e7205b6d1a0e0ccbb5cfb1d3a2cf0e9d6f1df7"
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_getTransactionReceipt",
  "params": [
    "0x5d1c7b4c8f3474891e1f632f85e7205b6d1a0e0ccbb5cfb1d3a2cf0e9d6f1df7"
  ],
  "id": 1
}

response = requests.post('https://trx-blockbook.nownodes.io/jsonrpc', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_getTransactionReceipt",
  "params": [
    "0x5d1c7b4c8f3474891e1f632f85e7205b6d1a0e0ccbb5cfb1d3a2cf0e9d6f1df7"
  ],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "blockHash": "0x000000000502e9686b96165061a0c1deaa8818cb4c2950a60d0d713865b106d3",
    "blockNumber": "0x502e969",
    "contractAddress": null,
    "cumulativeGasUsed": "0x0",
    "effectiveGasPrice": "0x0",
    "from": "0x5aeda56215b167893e80b4fe645ba6d5bab767de",
    "gasUsed": "0x0",
    "logs": [],
    "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
    "status": "0x1",
    "to": "0x5aeda56215b167893e80b4fe645ba6d5bab767de",
    "transactionHash": "0xaaeb5bfd0d5f5a4ba8c825bdc8bc6f6ceaec896f11f31c1374d9285dc0c12906",
    "transactionIndex": "0x0",
    "type": "0x0"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: invalid parameter for eth_getTransactionReceipt"
  }
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

eth_getUncleByBlockHashAndIndex

eth_getUncleByBlockHashAndIndex operations.

Get uncle block by block hash and index

POST

https://trx-blockbook.nownodes.io/jsonrpc

Calls the eth_getUncleByBlockHashAndIndex operation.

Body

application/json

Request value.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

paramsArray<string>required

blockHash: 32-byte block hash
index: the uncle index as hex (e.g., "0x0" for the first uncle)

idintegerrequired

Client request identifier echoed by the server.

Response

200OK

HTTP 200 response for eth_getUncleByBlockHashAndIndex. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get uncle block by block hash and index

curl -X POST 'https://trx-blockbook.nownodes.io/jsonrpc' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_getUncleByBlockHashAndIndex",
    "params": [
      "0x9b559a28a108e15b95e4e30b8a4a1e301dcdb4f3f7f0f79fd859f568f9d9ff34",
      "0x0"
    ],
    "id": 1
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/jsonrpc', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "eth_getUncleByBlockHashAndIndex",
      "params": [
        "0x9b559a28a108e15b95e4e30b8a4a1e301dcdb4f3f7f0f79fd859f568f9d9ff34",
        "0x0"
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_getUncleByBlockHashAndIndex",
  "params": [
    "0x9b559a28a108e15b95e4e30b8a4a1e301dcdb4f3f7f0f79fd859f568f9d9ff34",
    "0x0"
  ],
  "id": 1
}

response = requests.post('https://trx-blockbook.nownodes.io/jsonrpc', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_getUncleByBlockHashAndIndex",
  "params": [
    "0x9b559a28a108e15b95e4e30b8a4a1e301dcdb4f3f7f0f79fd859f568f9d9ff34",
    "0x0"
  ],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x0"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: invalid parameter for eth_getUncleByBlockHashAndIndex"
  }
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

eth_getUncleByBlockNumberAndIndex

eth_getUncleByBlockNumberAndIndex operations.

Get uncle block by block number and index

POST

https://trx-blockbook.nownodes.io/jsonrpc

Calls the eth_getUncleByBlockNumberAndIndex operation.

Body

application/json

Request value.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

paramsArray<string>required

blockNumber: The block number as hex string (e.g., "0x10fb78"), or "latest", "earliest", "pending".
index: The uncle index as hex (e.g., "0x0" for the first uncle).

idintegerrequired

Client request identifier echoed by the server.

Response

200OK

HTTP 200 response for eth_getUncleByBlockNumberAndIndex. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get uncle block by block number and index

curl -X POST 'https://trx-blockbook.nownodes.io/jsonrpc' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_getUncleByBlockNumberAndIndex",
    "params": [
      "0x5daf3b",
      "0x0"
    ],
    "id": 1
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/jsonrpc', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "eth_getUncleByBlockNumberAndIndex",
      "params": [
        "0x5daf3b",
        "0x0"
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_getUncleByBlockNumberAndIndex",
  "params": [
    "0x5daf3b",
    "0x0"
  ],
  "id": 1
}

response = requests.post('https://trx-blockbook.nownodes.io/jsonrpc', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_getUncleByBlockNumberAndIndex",
  "params": [
    "0x5daf3b",
    "0x0"
  ],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x0"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: invalid parameter for eth_getUncleByBlockNumberAndIndex"
  }
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

eth_getUncleCountByBlockHash

eth_getUncleCountByBlockHash operations.

Get the number of uncle blocks by block hash

POST

https://trx-blockbook.nownodes.io/jsonrpc

Calls the eth_getUncleCountByBlockHash operation.

Body

application/json

Request value.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

paramsArray<string>required

An array containing the block hash.

idintegerrequired

Client request identifier echoed by the server.

Response

200OK

HTTP 200 response for eth_getUncleCountByBlockHash. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get the number of uncle blocks by block hash

curl -X POST 'https://trx-blockbook.nownodes.io/jsonrpc' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_getUncleCountByBlockHash",
    "params": [
      "0x9b559a937406429b662b9bd5b2be3c7a2ed36b5a0dbcf0d07a987f695705daec"
    ],
    "id": 1
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/jsonrpc', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "eth_getUncleCountByBlockHash",
      "params": [
        "0x9b559a937406429b662b9bd5b2be3c7a2ed36b5a0dbcf0d07a987f695705daec"
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_getUncleCountByBlockHash",
  "params": [
    "0x9b559a937406429b662b9bd5b2be3c7a2ed36b5a0dbcf0d07a987f695705daec"
  ],
  "id": 1
}

response = requests.post('https://trx-blockbook.nownodes.io/jsonrpc', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_getUncleCountByBlockHash",
  "params": [
    "0x9b559a937406429b662b9bd5b2be3c7a2ed36b5a0dbcf0d07a987f695705daec"
  ],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x0"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: invalid parameter for eth_getUncleCountByBlockHash"
  }
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

eth_getUncleCountByBlockNumber

eth_getUncleCountByBlockNumber operations.

Get the number of uncle blocks by block number

POST

https://trx-blockbook.nownodes.io/jsonrpc

Calls the eth_getUncleCountByBlockNumber operation.

Body

application/json

Request value.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

paramsArray<string>required

An array containing the block number as a hex string.

idintegerrequired

Client request identifier echoed by the server.

Response

200OK

HTTP 200 response for eth_getUncleCountByBlockNumber. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get the number of uncle blocks by block number

curl -X POST 'https://trx-blockbook.nownodes.io/jsonrpc' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_getUncleCountByBlockNumber",
    "params": [
      "0x10d4f"
    ],
    "id": 1
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/jsonrpc', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "eth_getUncleCountByBlockNumber",
      "params": [
        "0x10d4f"
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_getUncleCountByBlockNumber",
  "params": [
    "0x10d4f"
  ],
  "id": 1
}

response = requests.post('https://trx-blockbook.nownodes.io/jsonrpc', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_getUncleCountByBlockNumber",
  "params": [
    "0x10d4f"
  ],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x0"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: invalid parameter for eth_getUncleCountByBlockNumber"
  }
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

eth_hashrate

eth_hashrate operations.

eth_hashrate

POST

https://trx-blockbook.nownodes.io/jsonrpc

Returns the current mining hashrate reported by the client.

Body

application/json

Request value.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringeth_hashraterequired

JSON-RPC method name.

paramsarrayrequired

This method takes no parameters.

idintegerrequired

Client request identifier echoed by the server.

Response

200OK

HTTP 200 response for eth_hashrate. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

eth_hashrate

curl -X POST 'https://trx-blockbook.nownodes.io/jsonrpc' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_hashrate",
    "params": [],
    "id": 1
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/jsonrpc', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "eth_hashrate",
      "params": [],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_hashrate",
  "params": [],
  "id": 1
}

response = requests.post('https://trx-blockbook.nownodes.io/jsonrpc', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_hashrate",
  "params": [],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x0"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: invalid parameter for eth_hashrate"
  }
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

eth_maxPriorityFeePerGas

eth_maxPriorityFeePerGas operations.

Get recommended maxPriorityFeePerGas value

POST

https://trx-blockbook.nownodes.io/jsonrpc

Calls the eth_maxPriorityFeePerGas operation.

Body

application/json

Request value.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

paramsarrayrequired

No parameters are required.

idintegerrequired

Client request identifier echoed by the server.

Response

200OK

HTTP 200 response for eth_maxPriorityFeePerGas. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get recommended maxPriorityFeePerGas value

curl -X POST 'https://trx-blockbook.nownodes.io/jsonrpc' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_maxPriorityFeePerGas",
    "params": [],
    "id": 1
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/jsonrpc', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "eth_maxPriorityFeePerGas",
      "params": [],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_maxPriorityFeePerGas",
  "params": [],
  "id": 1
}

response = requests.post('https://trx-blockbook.nownodes.io/jsonrpc', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_maxPriorityFeePerGas",
  "params": [],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x0"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: invalid parameter for eth_maxPriorityFeePerGas"
  }
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

eth_mining

eth_mining operations.

eth_mining

POST

https://trx-blockbook.nownodes.io/jsonrpc

Checks whether the Ethereum client is actively mining.

Body

application/json

Request value.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringeth_miningrequired

JSON-RPC method name.

paramsarrayrequired

This method does not accept parameters.

idintegerrequired

Client request identifier echoed by the server.

Response

200OK

HTTP 200 response for eth_mining. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

eth_mining

curl -X POST 'https://trx-blockbook.nownodes.io/jsonrpc' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_mining",
    "params": [],
    "id": 1
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/jsonrpc', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "eth_mining",
      "params": [],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_mining",
  "params": [],
  "id": 1
}

response = requests.post('https://trx-blockbook.nownodes.io/jsonrpc', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_mining",
  "params": [],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": true
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: invalid parameter for eth_mining"
  }
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

eth_newBlockFilter

eth_newBlockFilter operations.

Create a new block filter

POST

https://trx-blockbook.nownodes.io/jsonrpc

Calls the eth_newBlockFilter operation.

Body

application/json

Request value.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

paramsArray<any>required

This method does not require any parameters.

idintegerrequired

Client request identifier echoed by the server.

Response

200OK

HTTP 200 response for eth_newBlockFilter. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Create a new block filter

curl -X POST 'https://trx-blockbook.nownodes.io/jsonrpc' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_newBlockFilter",
    "params": [],
    "id": 1
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/jsonrpc', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "eth_newBlockFilter",
      "params": [],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_newBlockFilter",
  "params": [],
  "id": 1
}

response = requests.post('https://trx-blockbook.nownodes.io/jsonrpc', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_newBlockFilter",
  "params": [],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x1"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: invalid parameter for eth_newBlockFilter"
  }
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

eth_newFilter

eth_newFilter operations.

Create a new log filter

POST

https://trx-blockbook.nownodes.io/jsonrpc

Calls the eth_newFilter operation.

Body

application/json

Request value.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

paramsArray<object>required

Array with one object describing the filter options.

Show child attributes

fromBlockstring

Starting block number or tag ("latest", "earliest", "pending").

toBlockstring

Ending block number or tag.

addressstring | Array<string> | null

TRON account address in base58 format.

topicsArray<string | Array<string>> | null

Array of topic filters. Topics are 32-byte hashes identifying events.

Show child attributes

Single array item value.

One of

Single array item value.

string

Array<string>

idintegerrequired

Client request identifier echoed by the server.

Response

200OK

HTTP 200 response for eth_newFilter. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Create a new log filter

curl -X POST 'https://trx-blockbook.nownodes.io/jsonrpc' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_newFilter",
    "params": [
      {
        "fromBlock": "latest",
        "toBlock": "latest",
        "address": "0x1234567890abcdef1234567890abcdef12345678",
        "topics": [
          "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"
        ]
      }
    ],
    "id": 1
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/jsonrpc', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "eth_newFilter",
      "params": [
        {
          "fromBlock": "latest",
          "toBlock": "latest",
          "address": "0x1234567890abcdef1234567890abcdef12345678",
          "topics": [
            "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"
          ]
        }
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_newFilter",
  "params": [
    {
      "fromBlock": "latest",
      "toBlock": "latest",
      "address": "0x1234567890abcdef1234567890abcdef12345678",
      "topics": [
        "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"
      ]
    }
  ],
  "id": 1
}

response = requests.post('https://trx-blockbook.nownodes.io/jsonrpc', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_newFilter",
  "params": [
    {
      "fromBlock": "latest",
      "toBlock": "latest",
      "address": "0x1234567890abcdef1234567890abcdef12345678",
      "topics": [
        "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef"
      ]
    }
  ],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x1"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: invalid parameter for eth_newFilter"
  }
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

eth_newPendingTransactionFilter

eth_newPendingTransactionFilter operations.

Create a filter for pending transactions

POST

https://trx-blockbook.nownodes.io/jsonrpc

Calls the eth_newPendingTransactionFilter operation.

Body

application/json

Request value.

jsonrpcstringrequired

JSON-RPC version

methodstringrequired

JSON-RPC method name

paramsArray<any>required

No parameters required for this method

idintegerrequired

Request identifier

Response

200OK

HTTP 200 response for eth_newPendingTransactionFilter. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Create a filter for pending transactions

curl -X POST 'https://trx-blockbook.nownodes.io/jsonrpc' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_newPendingTransactionFilter",
    "params": [],
    "id": 1
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/jsonrpc', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "eth_newPendingTransactionFilter",
      "params": [],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_newPendingTransactionFilter",
  "params": [],
  "id": 1
}

response = requests.post('https://trx-blockbook.nownodes.io/jsonrpc', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_newPendingTransactionFilter",
  "params": [],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "blockHash": "0x000000000502e9686b96165061a0c1deaa8818cb4c2950a60d0d713865b106d3",
    "blockNumber": "0x502e969",
    "from": "0x5aeda56215b167893e80b4fe645ba6d5bab767de",
    "gas": "0x5208",
    "gasPrice": "0x0",
    "hash": "0xaaeb5bfd0d5f5a4ba8c825bdc8bc6f6ceaec896f11f31c1374d9285dc0c12906",
    "input": "0x",
    "nonce": "0x0",
    "to": "0x5aeda56215b167893e80b4fe645ba6d5bab767de",
    "transactionIndex": "0x0",
    "value": "0x0",
    "type": "0x0",
    "v": "0x0",
    "r": "0x1",
    "s": "0x1"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: invalid parameter for eth_newPendingTransactionFilter"
  }
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

eth_sendRawTransaction

eth_sendRawTransaction operations.

Send a raw signed transaction

POST

https://trx-blockbook.nownodes.io/jsonrpc

Calls the eth_sendRawTransaction operation.

Body

application/json

Request value.

jsonrpcstringrequired

JSON-RPC version

methodstringrequired

Method name

paramsArray<string>required

Array containing a single signed transaction data (hex string)

idintegerrequired

Request ID

Response

200OK

HTTP 200 response for eth_sendRawTransaction. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Send a raw signed transaction

curl -X POST 'https://trx-blockbook.nownodes.io/jsonrpc' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_sendRawTransaction",
    "params": [
      "0xf86b808504a817c800825208940000000000000000000000000000000000000000880de0b6b3a76400008026a0980..."
    ],
    "id": 1
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/jsonrpc', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "eth_sendRawTransaction",
      "params": [
        "0xf86b808504a817c800825208940000000000000000000000000000000000000000880de0b6b3a76400008026a0980..."
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_sendRawTransaction",
  "params": [
    "0xf86b808504a817c800825208940000000000000000000000000000000000000000880de0b6b3a76400008026a0980..."
  ],
  "id": 1
}

response = requests.post('https://trx-blockbook.nownodes.io/jsonrpc', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_sendRawTransaction",
  "params": [
    "0xf86b808504a817c800825208940000000000000000000000000000000000000000880de0b6b3a76400008026a0c6a6..."
  ],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "blockHash": "0x000000000502e9686b96165061a0c1deaa8818cb4c2950a60d0d713865b106d3",
    "blockNumber": "0x502e969",
    "from": "0x5aeda56215b167893e80b4fe645ba6d5bab767de",
    "gas": "0x5208",
    "gasPrice": "0x0",
    "hash": "0xaaeb5bfd0d5f5a4ba8c825bdc8bc6f6ceaec896f11f31c1374d9285dc0c12906",
    "input": "0x",
    "nonce": "0x0",
    "to": "0x5aeda56215b167893e80b4fe645ba6d5bab767de",
    "transactionIndex": "0x0",
    "value": "0x0",
    "type": "0x0",
    "v": "0x0",
    "r": "0x1",
    "s": "0x1"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: invalid parameter for eth_sendRawTransaction"
  }
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

eth_sendTransaction

eth_sendTransaction operations.

Send a transaction using node-managed account

POST

https://trx-blockbook.nownodes.io/jsonrpc

Calls the eth_sendTransaction operation.

Body

application/json

Request value.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

paramsArray<object>required

Transaction object

Show child attributes

fromstring

Address the transaction is sent from

tostring

Address the transaction is directed to

gasstring

Gas provided for the transaction (hex)

gasPricestring

Gas price in wei (hex)

valuestring

Value sent with the transaction in wei (hex)

datastring

(Optional) Data for contract interaction

idintegerrequired

Client request identifier echoed by the server.

Response

200OK

HTTP 200 response for eth_sendTransaction. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Send a transaction using node-managed account

curl -X POST 'https://trx-blockbook.nownodes.io/jsonrpc' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_sendTransaction",
    "params": [
      {
        "from": "0x6A0bF1017C6e6Dd9D2BA447E2AAd951F13F7F7C3",
        "to": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
        "gas": "0x5208",
        "gasPrice": "0x3b9aca00",
        "value": "0x16345785d8a0000",
        "data": "0x"
      }
    ],
    "id": 1
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/jsonrpc', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "eth_sendTransaction",
      "params": [
        {
          "from": "0x6A0bF1017C6e6Dd9D2BA447E2AAd951F13F7F7C3",
          "to": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
          "gas": "0x5208",
          "gasPrice": "0x3b9aca00",
          "value": "0x16345785d8a0000",
          "data": "0x"
        }
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_sendTransaction",
  "params": [
    {
      "from": "0x6A0bF1017C6e6Dd9D2BA447E2AAd951F13F7F7C3",
      "to": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
      "gas": "0x5208",
      "gasPrice": "0x3b9aca00",
      "value": "0x16345785d8a0000",
      "data": "0x"
    }
  ],
  "id": 1
}

response = requests.post('https://trx-blockbook.nownodes.io/jsonrpc', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_sendTransaction",
  "params": [
    {
      "from": "0x6A0bF1017C6e6Dd9D2BA447E2AAd951F13F7F7C3",
      "to": "0x742d35Cc6634C0532925a3b844Bc454e4438f44e",
      "gas": "0x5208",
      "gasPrice": "0x3b9aca00",
      "value": "0x16345785d8a0000",
      "data": "0x"
    }
  ],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "blockHash": "0x000000000502e9686b96165061a0c1deaa8818cb4c2950a60d0d713865b106d3",
    "blockNumber": "0x502e969",
    "from": "0x5aeda56215b167893e80b4fe645ba6d5bab767de",
    "gas": "0x5208",
    "gasPrice": "0x0",
    "hash": "0xaaeb5bfd0d5f5a4ba8c825bdc8bc6f6ceaec896f11f31c1374d9285dc0c12906",
    "input": "0x",
    "nonce": "0x0",
    "to": "0x5aeda56215b167893e80b4fe645ba6d5bab767de",
    "transactionIndex": "0x0",
    "value": "0x0",
    "type": "0x0",
    "v": "0x0",
    "r": "0x1",
    "s": "0x1"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: invalid parameter for eth_sendTransaction"
  }
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

eth_sign

eth_sign operations.

Sign arbitrary data using eth_sign

POST

https://trx-blockbook.nownodes.io/jsonrpc

Calls the eth_sign operation.

Body

application/json

Request value.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

paramsArray<string>required

[address, data]

address: The account that will sign the data
data: The data to be signed (must be a hex string)

idintegerrequired

Client request identifier echoed by the server.

Response

200OK

HTTP 200 response for eth_sign. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Sign arbitrary data using eth_sign

curl -X POST 'https://trx-blockbook.nownodes.io/jsonrpc' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_sign",
    "params": [
      "item_example"
    ],
    "id": 1
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/jsonrpc', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "eth_sign",
      "params": [
        "item_example"
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_sign",
  "params": [
    "item_example"
  ],
  "id": 1
}

response = requests.post('https://trx-blockbook.nownodes.io/jsonrpc', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_sign",
  "params": [
    "0x6A0bF1017C6e6Dd9D2BA447E2AAd951F13F7F7C3",
    "0x68656c6c6f20776f726c64"
  ],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x1"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: invalid parameter for eth_sign"
  }
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

eth_signTransaction

eth_signTransaction operations.

eth_signTransaction

POST

https://trx-blockbook.nownodes.io/jsonrpc

Signs a transaction locally with the private key of the specified account.

Body

application/json

Request value.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringeth_signTransactionrequired

JSON-RPC method name.

paramsArray<object>required

Array with a single object representing the transaction to sign.

Show child attributes

fromstringrequired

The address of the account that will sign the transaction.

tostring

The destination address of the transaction.

gasstring

Gas limit for the transaction, as a hex string.

gasPricestring

Gas price in wei, as a hex string.

valuestring

Amount of wei to send, as a hex string.

datastring

Data payload of the transaction, hex encoded.

noncestring

Nonce of the transaction, as a hex string.

chainIdinteger

The chain ID to protect against replay attacks.

idintegerrequired

Client request identifier echoed by the server.

Response

200OK

HTTP 200 response for eth_signTransaction. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

eth_signTransaction

curl -X POST 'https://trx-blockbook.nownodes.io/jsonrpc' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_signTransaction",
    "params": [
      {
        "from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
        "to": "0x85a3d76e3a6a4b16b5b442c1b11a03bdcc0a9f30",
        "gas": "0x5208",
        "gasPrice": "0x4a817c800",
        "value": "0xde0b6b3a7640000",
        "data": "0x",
        "nonce": "0x1",
        "chainId": 1
      }
    ],
    "id": 1
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/jsonrpc', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "eth_signTransaction",
      "params": [
        {
          "from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
          "to": "0x85a3d76e3a6a4b16b5b442c1b11a03bdcc0a9f30",
          "gas": "0x5208",
          "gasPrice": "0x4a817c800",
          "value": "0xde0b6b3a7640000",
          "data": "0x",
          "nonce": "0x1",
          "chainId": 1
        }
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_signTransaction",
  "params": [
    {
      "from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
      "to": "0x85a3d76e3a6a4b16b5b442c1b11a03bdcc0a9f30",
      "gas": "0x5208",
      "gasPrice": "0x4a817c800",
      "value": "0xde0b6b3a7640000",
      "data": "0x",
      "nonce": "0x1",
      "chainId": 1
    }
  ],
  "id": 1
}

response = requests.post('https://trx-blockbook.nownodes.io/jsonrpc', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_signTransaction",
  "params": [
    {
      "from": "0x407d73d8a49eeb85d32cf465507dd71d507100c1",
      "to": "0x85a3d76e3a6a4b16b5b442c1b11a03bdcc0a9f30",
      "gas": "0x5208",
      "gasPrice": "0x4a817c800",
      "value": "0xde0b6b3a7640000",
      "data": "0x",
      "nonce": "0x1",
      "chainId": 1
    }
  ],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "blockHash": "0x000000000502e9686b96165061a0c1deaa8818cb4c2950a60d0d713865b106d3",
    "blockNumber": "0x502e969",
    "from": "0x5aeda56215b167893e80b4fe645ba6d5bab767de",
    "gas": "0x5208",
    "gasPrice": "0x0",
    "hash": "0xaaeb5bfd0d5f5a4ba8c825bdc8bc6f6ceaec896f11f31c1374d9285dc0c12906",
    "input": "0x",
    "nonce": "0x0",
    "to": "0x5aeda56215b167893e80b4fe645ba6d5bab767de",
    "transactionIndex": "0x0",
    "value": "0x0",
    "type": "0x0",
    "v": "0x0",
    "r": "0x1",
    "s": "0x1"
  }
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: invalid parameter for eth_signTransaction"
  }
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

eth_syncing

eth_syncing operations.

Check if node is syncing

POST

https://trx-blockbook.nownodes.io/jsonrpc

Calls the eth_syncing operation.

Body

application/json

Request value.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

paramsarrayrequired

Must be an empty array.

idintegerrequired

Client request identifier echoed by the server.

Response

200OK

HTTP 200 response for eth_syncing. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Check if node is syncing

curl -X POST 'https://trx-blockbook.nownodes.io/jsonrpc' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_syncing",
    "params": [],
    "id": 1
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/jsonrpc', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "eth_syncing",
      "params": [],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_syncing",
  "params": [],
  "id": 1
}

response = requests.post('https://trx-blockbook.nownodes.io/jsonrpc', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_syncing",
  "params": [],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": false
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: invalid parameter for eth_syncing"
  }
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

eth_uninstallFilter

eth_uninstallFilter operations.

Uninstall an existing filter

POST

https://trx-blockbook.nownodes.io/jsonrpc

Calls the eth_uninstallFilter operation.

Body

application/json

Request value.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

paramsArray<string>required

Ordered JSON-RPC method parameters.

idintegerrequired

Client request identifier echoed by the server.

Response

200OK

HTTP 200 response for eth_uninstallFilter. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Uninstall an existing filter

curl -X POST 'https://trx-blockbook.nownodes.io/jsonrpc' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "eth_uninstallFilter",
    "params": [
      "0x16"
    ],
    "id": 1
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/jsonrpc', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "eth_uninstallFilter",
      "params": [
        "0x16"
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "eth_uninstallFilter",
  "params": [
    "0x16"
  ],
  "id": 1
}

response = requests.post('https://trx-blockbook.nownodes.io/jsonrpc', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "method": "eth_uninstallFilter",
  "params": [
    "0x16"
  ],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x1"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: invalid parameter for eth_uninstallFilter"
  }
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

net_listening

net_listening operations.

net_listening

POST

https://trx-blockbook.nownodes.io/jsonrpc

Checks if the client is listening for network connections.

Body

application/json

Request value.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringnet_listeningrequired

JSON-RPC method name.

paramsarrayrequired

This method takes no parameters.

idintegerrequired

Client request identifier echoed by the server.

Response

200OK

HTTP 200 response for net_listening. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

net_listening

curl -X POST 'https://trx-blockbook.nownodes.io/jsonrpc' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "net_listening",
    "params": [],
    "id": 1
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/jsonrpc', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "net_listening",
      "params": [],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "net_listening",
  "params": [],
  "id": 1
}

response = requests.post('https://trx-blockbook.nownodes.io/jsonrpc', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "method": "net_listening",
  "params": [],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": true
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: invalid parameter for net_listening"
  }
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

net_peerCount

net_peerCount operations.

net_peerCount

POST

https://trx-blockbook.nownodes.io/jsonrpc

Returns the number of peers currently connected to the client.

Body

application/json

Request value.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringnet_peerCountrequired

JSON-RPC method name.

paramsarrayrequired

This method takes no parameters.

idintegerrequired

Client request identifier echoed by the server.

Response

200OK

HTTP 200 response for net_peerCount. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

net_peerCount

curl -X POST 'https://trx-blockbook.nownodes.io/jsonrpc' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "net_peerCount",
    "params": [],
    "id": 1
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/jsonrpc', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "net_peerCount",
      "params": [],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "net_peerCount",
  "params": [],
  "id": 1
}

response = requests.post('https://trx-blockbook.nownodes.io/jsonrpc', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "method": "net_peerCount",
  "params": [],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x0"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: invalid parameter for net_peerCount"
  }
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

net_version

net_version operations.

net_version

POST

https://trx-blockbook.nownodes.io/jsonrpc

Returns the current network ID of the Ethereum client.

Body

application/json

Request value.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringnet_versionrequired

JSON-RPC method name.

paramsarrayrequired

This method takes no parameters.

idintegerrequired

Client request identifier echoed by the server.

Response

200OK

HTTP 200 response for net_version. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

net_version

curl -X POST 'https://trx-blockbook.nownodes.io/jsonrpc' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "net_version",
    "params": [],
    "id": 1
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/jsonrpc', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "net_version",
      "params": [],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "net_version",
  "params": [],
  "id": 1
}

response = requests.post('https://trx-blockbook.nownodes.io/jsonrpc', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "method": "net_version",
  "params": [],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x2b6653dc"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: invalid parameter for net_version"
  }
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

web3_clientVersion

web3_clientVersion operations.

web3_clientVersion

POST

https://trx-blockbook.nownodes.io/jsonrpc

Returns the current Ethereum client version.

Body

application/json

Request value.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringweb3_clientVersionrequired

JSON-RPC method name.

paramsarrayrequired

This method takes no parameters.

idintegerrequired

Client request identifier echoed by the server.

Response

200OK

HTTP 200 response for web3_clientVersion. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

web3_clientVersion

curl -X POST 'https://trx-blockbook.nownodes.io/jsonrpc' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "web3_clientVersion",
    "params": [],
    "id": 1
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/jsonrpc', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "web3_clientVersion",
      "params": [],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "web3_clientVersion",
  "params": [],
  "id": 1
}

response = requests.post('https://trx-blockbook.nownodes.io/jsonrpc', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "method": "web3_clientVersion",
  "params": [],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "java-tron/v4.8.0/linux"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: invalid parameter for web3_clientVersion"
  }
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

web3_sha3

web3_sha3 operations.

web3_sha3

POST

https://trx-blockbook.nownodes.io/jsonrpc

Computes the Keccak-256 (SHA-3) hash of the given hex-encoded data.

Body

application/json

Request value.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringweb3_sha3required

JSON-RPC method name.

paramsArray<string>required

Array containing a single hex-encoded data string to hash.

idintegerrequired

Client request identifier echoed by the server.

Response

200OK

HTTP 200 response for web3_sha3. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

web3_sha3

curl -X POST 'https://trx-blockbook.nownodes.io/jsonrpc' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "method": "web3_sha3",
    "params": [
      "0x68656c6c6f"
    ],
    "id": 1
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/jsonrpc', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "method": "web3_sha3",
      "params": [
        "0x68656c6c6f"
      ],
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "method": "web3_sha3",
  "params": [
    "0x68656c6c6f"
  ],
  "id": 1
}

response = requests.post('https://trx-blockbook.nownodes.io/jsonrpc', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "method": "web3_sha3",
  "params": [
    "0x68656c6c6f"
  ],
  "id": 1
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": "0x"
}

{
  "jsonrpc": "2.0",
  "id": 1,
  "error": {
    "code": -32602,
    "message": "invalid argument 0: invalid parameter for web3_sha3"
  }
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

MAINNET / node-wallet-solidity

Account Resources

Account Resources operations.

Get Account Details

POST

https://trx-blockbook.nownodes.io/walletsolidity/getaccount

Retrieves comprehensive information about a TRON account including TRX balance, bandwidth (net) usage, energy resources, votes for Super Representatives, and multi-signature permission structures. This endpoint queries the solidified (confirmed) state of the blockchain.

Body

application/json

Request body containing the account address to query

Request value.

addressstringrequired

The TRON address to query. Can be Base58Check encoded (if visible=true) or hex format. Base58 addresses typically start with 'T' on mainnet.

visiblebooleanrequired

If true, indicates the address is provided in Base58Check format. If false, the address is expected in hex format.

Response

200OK

HTTP 200 response for getAccount. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get Account Details

curl -X POST 'https://trx-blockbook.nownodes.io/walletsolidity/getaccount' \
  -H 'Content-Type: application/json' \
  -d '{
    "address": "TVWVSxWjNp4c5EUbvvjr5qWdZKLDpzaBoZ",
    "visible": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/walletsolidity/getaccount', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "address": "TVWVSxWjNp4c5EUbvvjr5qWdZKLDpzaBoZ",
      "visible": true
    }),
});

const data = await response.json();

import requests

payload = {
  "address": "TVWVSxWjNp4c5EUbvvjr5qWdZKLDpzaBoZ",
  "visible": True
}

response = requests.post('https://trx-blockbook.nownodes.io/walletsolidity/getaccount', json=payload)
data = response.json()

Request Body

{
  "address": "TVWVSxWjNp4c5EUbvvjr5qWdZKLDpzaBoZ",
  "visible": true
}

{
  "account_name": "CreatedByContract",
  "type": "Contract",
  "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
  "balance": 1978237590707,
  "net_window_size": 28800000,
  "net_window_optimized": true,
  "account_resource": {
    "energy_window_size": 28800000,
    "energy_window_optimized": true
  },
  "frozenV2": [
    {},
    {
      "type": "ENERGY"
    },
    {
      "type": "TRON_POWER"
    }
  ],
  "assetV2": [
    {
      "key": "1004108",
      "value": 10199700
    },
    {
      "key": "1002963",
      "value": 5000000
    },
    {
      "key": "1003812",
      "value": 18231000000
    }
  ]
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Get delegated resource information

POST

https://trx-blockbook.nownodes.io/walletsolidity/getdelegatedresource

Query the resource delegation from one account to another. Returns information about bandwidth and energy delegation.

Body

application/json

Request value.

fromAddressstringrequired

Delegator address in hex string format

toAddressstringrequired

Delegatee address in hex string format

visibleboolean

Whether the address is in base58 format

Response

200OK

HTTP 200 response for getdelegatedresource. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get delegated resource information

curl -X POST 'https://trx-blockbook.nownodes.io/walletsolidity/getdelegatedresource' \
  -H 'Content-Type: application/json' \
  -d '{
    "fromAddress": "41e9d79cc47518930bc322d9bf7cddd260a0260a8d",
    "toAddress": "41a614f8037446a6a6d6a6a6d6a6a6d6a6a6d6a6a6d",
    "visible": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/walletsolidity/getdelegatedresource', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "fromAddress": "41e9d79cc47518930bc322d9bf7cddd260a0260a8d",
      "toAddress": "41a614f8037446a6a6d6a6a6d6a6a6d6a6a6d6a6a6d",
      "visible": true
    }),
});

const data = await response.json();

import requests

payload = {
  "fromAddress": "41e9d79cc47518930bc322d9bf7cddd260a0260a8d",
  "toAddress": "41a614f8037446a6a6d6a6a6d6a6a6d6a6a6d6a6a6d",
  "visible": True
}

response = requests.post('https://trx-blockbook.nownodes.io/walletsolidity/getdelegatedresource', json=payload)
data = response.json()

Request Body

{
  "fromAddress": "41e9d79cc47518930bc322d9bf7cddd260a0260a8d",
  "toAddress": "41a614f8037446a6a6d6a6a6d6a6a6d6a6a6d6a6a6d",
  "visible": true
}

{
  "txID": "aaeb5bfd0d5f5a4ba8c825bdc8bc6f6ceaec896f11f31c1374d9285dc0c12906",
  "raw_data": {
    "contract": [
      {
        "parameter": {
          "value": {
            "amount": 7,
            "owner_address": "41A614F803B6FD780986A42C78EC9C7F77E6DED13C",
            "to_address": "41ac27ae19688035bf9b3f5f3baa488315f157770a"
          },
          "type_url": "type.googleapis.com/protocol.TransferContract"
        },
        "type": "TransferContract"
      }
    ],
    "ref_block_bytes": "e956",
    "ref_block_hash": "b0413c405002bec9",
    "expiration": 1782900528000,
    "timestamp": 1782900471309
  },
  "raw_data_hex": "0a02e9562208b0413c405002bec94080a79ce9f1335a65080112610a2d747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e5472616e73666572436f6e747261637412300a15413e715d653654406b1707aa6dda01b43f8acadfe6121541ac27ae19688035bf9b3f5f3baa488315f157770a1807"
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Get delegated resource account index

POST

https://trx-blockbook.nownodes.io/walletsolidity/getdelegatedresourceaccountindex

Query the delegation relationships for an account. Returns information about both from and to delegation relationships.

Body

application/json

Request value.

valuestringrequired

Account address in hex string format

visibleboolean

Whether the address is in base58 format

Response

200OK

HTTP 200 response for getdelegatedresourceaccountindex. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get delegated resource account index

curl -X POST 'https://trx-blockbook.nownodes.io/walletsolidity/getdelegatedresourceaccountindex' \
  -H 'Content-Type: application/json' \
  -d '{
    "value": "41e9d79cc47518930bc322d9bf7cddd260a0260a8d",
    "visible": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/walletsolidity/getdelegatedresourceaccountindex', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "value": "41e9d79cc47518930bc322d9bf7cddd260a0260a8d",
      "visible": true
    }),
});

const data = await response.json();

import requests

payload = {
  "value": "41e9d79cc47518930bc322d9bf7cddd260a0260a8d",
  "visible": True
}

response = requests.post('https://trx-blockbook.nownodes.io/walletsolidity/getdelegatedresourceaccountindex', json=payload)
data = response.json()

Request Body

{
  "value": "41e9d79cc47518930bc322d9bf7cddd260a0260a8d",
  "visible": true
}

{
  "size": 12
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Get account by ID

POST

https://trx-blockbook.nownodes.io/walletsolidity/getaccountbyid

Query account information by account ID. This is an alternative method to get account details.

Body

application/json

Request value.

account_idstringrequired

Account ID in hex string format

visibleboolean

Whether the address is in base58 format

Response

200OK

HTTP 200 response for getaccountbyid. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get account by ID

curl -X POST 'https://trx-blockbook.nownodes.io/walletsolidity/getaccountbyid' \
  -H 'Content-Type: application/json' \
  -d '{
    "account_id": "41e9d79cc47518930bc322d9bf7cddd260a0260a8d",
    "visible": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/walletsolidity/getaccountbyid', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "account_id": "41e9d79cc47518930bc322d9bf7cddd260a0260a8d",
      "visible": true
    }),
});

const data = await response.json();

import requests

payload = {
  "account_id": "41e9d79cc47518930bc322d9bf7cddd260a0260a8d",
  "visible": True
}

response = requests.post('https://trx-blockbook.nownodes.io/walletsolidity/getaccountbyid', json=payload)
data = response.json()

Request Body

{
  "account_id": "41e9d79cc47518930bc322d9bf7cddd260a0260a8d",
  "visible": true
}

{
  "account_name": "CreatedByContract",
  "type": "Contract",
  "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
  "balance": 1978237590707,
  "net_window_size": 28800000,
  "net_window_optimized": true,
  "account_resource": {
    "energy_window_size": 28800000,
    "energy_window_optimized": true
  },
  "frozenV2": [
    {},
    {
      "type": "ENERGY"
    },
    {
      "type": "TRON_POWER"
    }
  ],
  "assetV2": [
    {
      "key": "1004108",
      "value": 10199700
    },
    {
      "key": "1002963",
      "value": 5000000
    },
    {
      "key": "1003812",
      "value": 18231000000
    }
  ]
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Get available unfreeze count

POST

https://trx-blockbook.nownodes.io/walletsolidity/getavailableunfreezecount

Query the number of available unfreeze operations for an account. Accounts can unfreeze staked TRX after the freeze period expires.

Body

application/json

Request value.

owner_addressstringrequired

Account address in hex string format

visibleboolean

Whether the address is in base58 format

Response

200OK

HTTP 200 response for getavailableunfreezecount. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get available unfreeze count

curl -X POST 'https://trx-blockbook.nownodes.io/walletsolidity/getavailableunfreezecount' \
  -H 'Content-Type: application/json' \
  -d '{
    "owner_address": "41e9d79cc47518930bc322d9bf7cddd260a0260a8d",
    "visible": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/walletsolidity/getavailableunfreezecount', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "owner_address": "41e9d79cc47518930bc322d9bf7cddd260a0260a8d",
      "visible": true
    }),
});

const data = await response.json();

import requests

payload = {
  "owner_address": "41e9d79cc47518930bc322d9bf7cddd260a0260a8d",
  "visible": True
}

response = requests.post('https://trx-blockbook.nownodes.io/walletsolidity/getavailableunfreezecount', json=payload)
data = response.json()

Request Body

{
  "owner_address": "41e9d79cc47518930bc322d9bf7cddd260a0260a8d",
  "visible": true
}

{
  "size": 12
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Get withdrawable unfreeze amount

POST

https://trx-blockbook.nownodes.io/walletsolidity/getcanwithdrawunfreezeamount

Query the amount of TRX that can be withdrawn from unfrozen balance at a specific timestamp.

Body

application/json

Request value.

owner_addressstringrequired

Account address in hex string format

timestampintegerrequired

Specific timestamp to check withdrawable amount

visibleboolean

Whether the address is in base58 format

Response

200OK

HTTP 200 response for getcanwithdrawunfreezeamount. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get withdrawable unfreeze amount

curl -X POST 'https://trx-blockbook.nownodes.io/walletsolidity/getcanwithdrawunfreezeamount' \
  -H 'Content-Type: application/json' \
  -d '{
    "owner_address": "41e9d79cc47518930bc322d9bf7cddd260a0260a8d",
    "timestamp": 1572015660000,
    "visible": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/walletsolidity/getcanwithdrawunfreezeamount', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "owner_address": "41e9d79cc47518930bc322d9bf7cddd260a0260a8d",
      "timestamp": 1572015660000,
      "visible": true
    }),
});

const data = await response.json();

import requests

payload = {
  "owner_address": "41e9d79cc47518930bc322d9bf7cddd260a0260a8d",
  "timestamp": 1572015660000,
  "visible": True
}

response = requests.post('https://trx-blockbook.nownodes.io/walletsolidity/getcanwithdrawunfreezeamount', json=payload)
data = response.json()

Request Body

{
  "owner_address": "41e9d79cc47518930bc322d9bf7cddd260a0260a8d",
  "timestamp": 1572015660000,
  "visible": true
}

{
  "txID": "aaeb5bfd0d5f5a4ba8c825bdc8bc6f6ceaec896f11f31c1374d9285dc0c12906",
  "raw_data": {
    "contract": [
      {
        "parameter": {
          "value": {
            "amount": 7,
            "owner_address": "41A614F803B6FD780986A42C78EC9C7F77E6DED13C",
            "to_address": "41ac27ae19688035bf9b3f5f3baa488315f157770a"
          },
          "type_url": "type.googleapis.com/protocol.TransferContract"
        },
        "type": "TransferContract"
      }
    ],
    "ref_block_bytes": "e956",
    "ref_block_hash": "b0413c405002bec9",
    "expiration": 1782900528000,
    "timestamp": 1782900471309
  },
  "raw_data_hex": "0a02e9562208b0413c405002bec94080a79ce9f1335a65080112610a2d747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e5472616e73666572436f6e747261637412300a15413e715d653654406b1707aa6dda01b43f8acadfe6121541ac27ae19688035bf9b3f5f3baa488315f157770a1807"
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Get maximum delegatable size

POST

https://trx-blockbook.nownodes.io/walletsolidity/getcandelegatedmaxsize

Query the maximum amount of resources that can be delegated for a specific type.

Body

application/json

Request value.

owner_addressstringrequired

Account address in hex string format

typeinteger01required

Resource type (0 for bandwidth, 1 for energy)

visibleboolean

Whether the address is in base58 format

Response

200OK

HTTP 200 response for getcandelegatedmaxsize. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get maximum delegatable size

curl -X POST 'https://trx-blockbook.nownodes.io/walletsolidity/getcandelegatedmaxsize' \
  -H 'Content-Type: application/json' \
  -d '{
    "owner_address": "41e9d79cc47518930bc322d9bf7cddd260a0260a8d",
    "type": 0,
    "visible": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/walletsolidity/getcandelegatedmaxsize', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "owner_address": "41e9d79cc47518930bc322d9bf7cddd260a0260a8d",
      "type": 0,
      "visible": true
    }),
});

const data = await response.json();

import requests

payload = {
  "owner_address": "41e9d79cc47518930bc322d9bf7cddd260a0260a8d",
  "type": 0,
  "visible": True
}

response = requests.post('https://trx-blockbook.nownodes.io/walletsolidity/getcandelegatedmaxsize', json=payload)
data = response.json()

Request Body

{
  "owner_address": "41e9d79cc47518930bc322d9bf7cddd260a0260a8d",
  "type": 0,
  "visible": true
}

{
  "txID": "aaeb5bfd0d5f5a4ba8c825bdc8bc6f6ceaec896f11f31c1374d9285dc0c12906",
  "raw_data": {
    "contract": [
      {
        "parameter": {
          "value": {
            "amount": 7,
            "owner_address": "41A614F803B6FD780986A42C78EC9C7F77E6DED13C",
            "to_address": "41ac27ae19688035bf9b3f5f3baa488315f157770a"
          },
          "type_url": "type.googleapis.com/protocol.TransferContract"
        },
        "type": "TransferContract"
      }
    ],
    "ref_block_bytes": "e956",
    "ref_block_hash": "b0413c405002bec9",
    "expiration": 1782900528000,
    "timestamp": 1782900471309
  },
  "raw_data_hex": "0a02e9562208b0413c405002bec94080a79ce9f1335a65080112610a2d747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e5472616e73666572436f6e747261637412300a15413e715d653654406b1707aa6dda01b43f8acadfe6121541ac27ae19688035bf9b3f5f3baa488315f157770a1807"
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Get delegated resource information (V2)

POST

https://trx-blockbook.nownodes.io/walletsolidity/getdelegatedresourcev2

Query the resource delegation from one account to another (updated version). Provides enhanced delegation information.

Body

application/json

Request value.

fromAddressstringrequired

Delegator address in hex string format

toAddressstringrequired

Delegatee address in hex string format

visibleboolean

Whether the address is in base58 format

Response

200OK

HTTP 200 response for getdelegatedresourcev2. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get delegated resource information (V2)

curl -X POST 'https://trx-blockbook.nownodes.io/walletsolidity/getdelegatedresourcev2' \
  -H 'Content-Type: application/json' \
  -d '{
    "fromAddress": "41e9d79cc47518930bc322d9bf7cddd260a0260a8d",
    "toAddress": "41a614f8037446a6a6d6a6a6d6a6a6d6a6a6d6a6a6d",
    "visible": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/walletsolidity/getdelegatedresourcev2', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "fromAddress": "41e9d79cc47518930bc322d9bf7cddd260a0260a8d",
      "toAddress": "41a614f8037446a6a6d6a6a6d6a6a6d6a6a6d6a6a6d",
      "visible": true
    }),
});

const data = await response.json();

import requests

payload = {
  "fromAddress": "41e9d79cc47518930bc322d9bf7cddd260a0260a8d",
  "toAddress": "41a614f8037446a6a6d6a6a6d6a6a6d6a6a6d6a6a6d",
  "visible": True
}

response = requests.post('https://trx-blockbook.nownodes.io/walletsolidity/getdelegatedresourcev2', json=payload)
data = response.json()

Request Body

{
  "fromAddress": "41e9d79cc47518930bc322d9bf7cddd260a0260a8d",
  "toAddress": "41a614f8037446a6a6d6a6a6d6a6a6d6a6a6d6a6a6d",
  "visible": true
}

{
  "txID": "aaeb5bfd0d5f5a4ba8c825bdc8bc6f6ceaec896f11f31c1374d9285dc0c12906",
  "raw_data": {
    "contract": [
      {
        "parameter": {
          "value": {
            "amount": 7,
            "owner_address": "41A614F803B6FD780986A42C78EC9C7F77E6DED13C",
            "to_address": "41ac27ae19688035bf9b3f5f3baa488315f157770a"
          },
          "type_url": "type.googleapis.com/protocol.TransferContract"
        },
        "type": "TransferContract"
      }
    ],
    "ref_block_bytes": "e956",
    "ref_block_hash": "b0413c405002bec9",
    "expiration": 1782900528000,
    "timestamp": 1782900471309
  },
  "raw_data_hex": "0a02e9562208b0413c405002bec94080a79ce9f1335a65080112610a2d747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e5472616e73666572436f6e747261637412300a15413e715d653654406b1707aa6dda01b43f8acadfe6121541ac27ae19688035bf9b3f5f3baa488315f157770a1807"
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Get delegated resource account index (V2)

POST

https://trx-blockbook.nownodes.io/walletsolidity/getdelegatedresourceaccountindexv2

Query the delegation relationships for an account (updated version). Provides enhanced delegation relationship information.

Body

application/json

Request value.

valuestringrequired

Account address in hex string format

visibleboolean

Whether the address is in base58 format

Response

200OK

HTTP 200 response for getdelegatedresourceaccountindexv2. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get delegated resource account index (V2)

curl -X POST 'https://trx-blockbook.nownodes.io/walletsolidity/getdelegatedresourceaccountindexv2' \
  -H 'Content-Type: application/json' \
  -d '{
    "value": "41e9d79cc47518930bc322d9bf7cddd260a0260a8d",
    "visible": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/walletsolidity/getdelegatedresourceaccountindexv2', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "value": "41e9d79cc47518930bc322d9bf7cddd260a0260a8d",
      "visible": true
    }),
});

const data = await response.json();

import requests

payload = {
  "value": "41e9d79cc47518930bc322d9bf7cddd260a0260a8d",
  "visible": True
}

response = requests.post('https://trx-blockbook.nownodes.io/walletsolidity/getdelegatedresourceaccountindexv2', json=payload)
data = response.json()

Request Body

{
  "value": "41e9d79cc47518930bc322d9bf7cddd260a0260a8d",
  "visible": true
}

{
  "size": 12
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Voting & SRs

Voting & SRs operations.

Get list of all Super Representatives (Witnesses)

POST

https://trx-blockbook.nownodes.io/walletsolidity/listwitnesses

Query the complete list of all Super Representatives (witnesses) from the solidity node. Super Representatives are the block producers in TRON's DPoS consensus mechanism. This method returns detailed information about each SR including their voting statistics, performance metrics, and current status.

The solidity node provides confirmed state data, making this method suitable for applications that require consistent and verified SR information.

Body

application/json

Request value.

visibleboolean

When set to true, addresses will be returned in base58 format. When false or omitted, addresses are returned in hex string format.

Response

200OK

HTTP 200 response for listwitnesses. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get list of all Super Representatives (Witnesses)

curl -X POST 'https://trx-blockbook.nownodes.io/walletsolidity/listwitnesses' \
  -H 'Content-Type: application/json' \
  -d '{
    "visible": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/walletsolidity/listwitnesses', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "visible": true
    }),
});

const data = await response.json();

import requests

payload = {
  "visible": True
}

response = requests.post('https://trx-blockbook.nownodes.io/walletsolidity/listwitnesses', json=payload)
data = response.json()

Request Body

{
  "visible": true
}

{
  "witnesses": [
    {
      "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
      "voteCount": 1234567,
      "url": "https://tronscan.org"
    }
  ]
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

TRC-10 Token

TRC-10 Token operations.

Get all TRC-10 token list

POST

https://trx-blockbook.nownodes.io/walletsolidity/getassetissuelist

Query the complete list of all TRC-10 tokens issued on the TRON network. TRC-10 tokens are native tokens on TRON that don't require a smart contract. Returns detailed information about each token including name, ID, supply, and issuer.

Body

application/json

Request value.

visibleboolean

Whether addresses should be returned in base58 format

Response

200OK

HTTP 200 response for getassetissuelist. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get all TRC-10 token list

curl -X POST 'https://trx-blockbook.nownodes.io/walletsolidity/getassetissuelist' \
  -H 'Content-Type: application/json' \
  -d '{
    "visible": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/walletsolidity/getassetissuelist', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "visible": true
    }),
});

const data = await response.json();

import requests

payload = {
  "visible": True
}

response = requests.post('https://trx-blockbook.nownodes.io/walletsolidity/getassetissuelist', json=payload)
data = response.json()

Request Body

{
  "visible": true
}

{
  "assetIssue": [
    {
      "id": "1004108",
      "name": "TRX",
      "abbr": "trx",
      "total_supply": 100000000
    }
  ]
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Get paginated TRC-10 token list

POST

https://trx-blockbook.nownodes.io/walletsolidity/getpaginatedassetissuelist

Query TRC-10 tokens in pagination format. Useful for applications that need to display tokens in pages or handle large datasets.

Body

application/json

Request value.

offsetintegerrequired

Starting index for pagination

limitintegerrequired

Number of tokens to return

visibleboolean

Whether addresses should be returned in base58 format

Response

200OK

HTTP 200 response for getpaginatedassetissuelist. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get paginated TRC-10 token list

curl -X POST 'https://trx-blockbook.nownodes.io/walletsolidity/getpaginatedassetissuelist' \
  -H 'Content-Type: application/json' \
  -d '{
    "offset": 0,
    "limit": 20,
    "visible": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/walletsolidity/getpaginatedassetissuelist', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "offset": 0,
      "limit": 20,
      "visible": true
    }),
});

const data = await response.json();

import requests

payload = {
  "offset": 0,
  "limit": 20,
  "visible": True
}

response = requests.post('https://trx-blockbook.nownodes.io/walletsolidity/getpaginatedassetissuelist', json=payload)
data = response.json()

Request Body

{
  "offset": 0,
  "limit": 20,
  "visible": true
}

{
  "assetIssue": [
    {
      "id": "1004108",
      "name": "TRX",
      "abbr": "trx",
      "total_supply": 100000000
    }
  ]
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Get TRC-10 token by name

POST

https://trx-blockbook.nownodes.io/walletsolidity/getassetissuebyname

Query a specific TRC-10 token by its name. The name should be provided in hex string format.

Body

application/json

Request value.

valuestringrequired

Token name in hex string format

visibleboolean

Whether addresses should be returned in base58 format

Response

200OK

HTTP 200 response for getassetissuebyname. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get TRC-10 token by name

curl -X POST 'https://trx-blockbook.nownodes.io/walletsolidity/getassetissuebyname' \
  -H 'Content-Type: application/json' \
  -d '{
    "value": "54726F6E546F6B656E",
    "visible": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/walletsolidity/getassetissuebyname', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "value": "54726F6E546F6B656E",
      "visible": true
    }),
});

const data = await response.json();

import requests

payload = {
  "value": "54726F6E546F6B656E",
  "visible": True
}

response = requests.post('https://trx-blockbook.nownodes.io/walletsolidity/getassetissuebyname', json=payload)
data = response.json()

Request Body

{
  "value": "54726F6E546F6B656E",
  "visible": true
}

{
  "assetIssue": [
    {
      "id": "1004108",
      "name": "TRX",
      "abbr": "trx",
      "total_supply": 100000000
    }
  ]
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Get TRC-10 tokens by name

POST

https://trx-blockbook.nownodes.io/walletsolidity/getassetissuelistbyname

Query TRC-10 tokens by name. This method can return multiple tokens if there are tokens with similar names.

Body

application/json

Request value.

valuestringrequired

Token name in hex string format

visibleboolean

Whether addresses should be returned in base58 format

Response

200OK

HTTP 200 response for getassetissuelistbyname. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get TRC-10 tokens by name

curl -X POST 'https://trx-blockbook.nownodes.io/walletsolidity/getassetissuelistbyname' \
  -H 'Content-Type: application/json' \
  -d '{
    "value": "54726F6E546F6B656E",
    "visible": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/walletsolidity/getassetissuelistbyname', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "value": "54726F6E546F6B656E",
      "visible": true
    }),
});

const data = await response.json();

import requests

payload = {
  "value": "54726F6E546F6B656E",
  "visible": True
}

response = requests.post('https://trx-blockbook.nownodes.io/walletsolidity/getassetissuelistbyname', json=payload)
data = response.json()

Request Body

{
  "value": "54726F6E546F6B656E",
  "visible": true
}

{
  "assetIssue": [
    {
      "id": "1004108",
      "name": "TRX",
      "abbr": "trx",
      "total_supply": 100000000
    }
  ]
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Get TRC-10 token by ID

POST

https://trx-blockbook.nownodes.io/walletsolidity/getassetissuebyid

Query a specific TRC-10 token by its unique token ID. Token IDs are numerical strings assigned during token creation.

Body

application/json

Request value.

valuestringrequired

Token ID

visibleboolean

Whether addresses should be returned in base58 format

Response

200OK

HTTP 200 response for getassetissuebyid. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get TRC-10 token by ID

curl -X POST 'https://trx-blockbook.nownodes.io/walletsolidity/getassetissuebyid' \
  -H 'Content-Type: application/json' \
  -d '{
    "value": "1000001",
    "visible": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/walletsolidity/getassetissuebyid', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "value": "1000001",
      "visible": true
    }),
});

const data = await response.json();

import requests

payload = {
  "value": "1000001",
  "visible": True
}

response = requests.post('https://trx-blockbook.nownodes.io/walletsolidity/getassetissuebyid', json=payload)
data = response.json()

Request Body

{
  "value": "1000001",
  "visible": true
}

{
  "assetIssue": [
    {
      "id": "1004108",
      "name": "TRX",
      "abbr": "trx",
      "total_supply": 100000000
    }
  ]
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Blocks

Blocks operations.

Get latest block from solidity node

POST

https://trx-blockbook.nownodes.io/walletsolidity/getnowblock

Query the latest block from the solidity node. The solidity node provides confirmed block data that has been verified and is irreversible. This method returns the most recent block that has achieved finality.

Body

application/json

Request value.

visibleboolean

Whether addresses should be returned in base58 format

Response

200OK

HTTP 200 response for getnowblock. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get latest block from solidity node

curl -X POST 'https://trx-blockbook.nownodes.io/walletsolidity/getnowblock' \
  -H 'Content-Type: application/json' \
  -d '{
    "visible": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/walletsolidity/getnowblock', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "visible": true
    }),
});

const data = await response.json();

import requests

payload = {
  "visible": True
}

response = requests.post('https://trx-blockbook.nownodes.io/walletsolidity/getnowblock', json=payload)
data = response.json()

Request Body

{
  "visible": true
}

{
  "blockID": "000000000502e9686b96165061a0c1deaa8818cb4c2950a60d0d713865b106d3",
  "block_header": {
    "raw_data": {
      "number": 84076904,
      "txTrieRoot": "2Zh5uiwkHw6fRtdxtEdE7GKjfZbZ5VhjtJXK9F6FpoJUK3oLXY",
      "witness_address": "TGyrSc9ZmTdbYziuk1SKEmdtCdETafewJ9",
      "parentHash": "000000000502e9672a443fb644045f8f397e84a212750096eb0bbb0ed563e389",
      "version": 35,
      "timestamp": 1782900468000
    },
    "witness_signature": "2b7c8962776874363cd645f8c36cdf9427d8163e8d8c5e827d5bcc7db64351d25dfc5b67183be748e264995649ecf1cc05c254eca694472a9fb73522951fff2601"
  },
  "transactions": [
    {
      "ret": [
        {
          "contractRet": "SUCCESS"
        }
      ],
      "txID": "aaeb5bfd0d5f5a4ba8c825bdc8bc6f6ceaec896f11f31c1374d9285dc0c12906",
      "raw_data": {
        "contract": [
          {
            "type": "TransferContract",
            "parameter": {
              "type_url": "type.googleapis.com/protocol.TransferContract",
              "value": {
                "amount": 7,
                "owner_address": "413e715d653654406b1707aa6dda01b43f8acadfe6",
                "to_address": "41ac27ae19688035bf9b3f5f3baa488315f157770a"
              }
            }
          }
        ],
        "ref_block_bytes": "e956",
        "ref_block_hash": "b0413c405002bec9",
        "expiration": 1782900528000,
        "timestamp": 1782900471309
      },
      "raw_data_hex": "0a02e9562208b0413c405002bec94080a79ce9f1335a65080112610a2d747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e5472616e73666572436f6e747261637412300a15413e715d653654406b1707aa6dda01b43f8acadfe6121541ac27ae19688035bf9b3f5f3baa488315f157770a1802708dec98e9f133"
    }
  ]
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Get block by number from solidity node

POST

https://trx-blockbook.nownodes.io/walletsolidity/getblockbynum

Query a specific block by block number from the solidity node. Returns the complete block information including all transactions.

Body

application/json

Request value.

numintegerrequired

Block number to query

visibleboolean

Whether addresses should be returned in base58 format

Response

200OK

HTTP 200 response for getblockbynum. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get block by number from solidity node

curl -X POST 'https://trx-blockbook.nownodes.io/walletsolidity/getblockbynum' \
  -H 'Content-Type: application/json' \
  -d '{
    "num": 12345678,
    "visible": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/walletsolidity/getblockbynum', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "num": 12345678,
      "visible": true
    }),
});

const data = await response.json();

import requests

payload = {
  "num": 12345678,
  "visible": True
}

response = requests.post('https://trx-blockbook.nownodes.io/walletsolidity/getblockbynum', json=payload)
data = response.json()

Request Body

{
  "num": 12345678,
  "visible": true
}

{
  "blockID": "000000000502e9686b96165061a0c1deaa8818cb4c2950a60d0d713865b106d3",
  "block_header": {
    "raw_data": {
      "number": 84076904,
      "txTrieRoot": "2Zh5uiwkHw6fRtdxtEdE7GKjfZbZ5VhjtJXK9F6FpoJUK3oLXY",
      "witness_address": "TGyrSc9ZmTdbYziuk1SKEmdtCdETafewJ9",
      "parentHash": "000000000502e9672a443fb644045f8f397e84a212750096eb0bbb0ed563e389",
      "version": 35,
      "timestamp": 1782900468000
    },
    "witness_signature": "2b7c8962776874363cd645f8c36cdf9427d8163e8d8c5e827d5bcc7db64351d25dfc5b67183be748e264995649ecf1cc05c254eca694472a9fb73522951fff2601"
  },
  "transactions": [
    {
      "ret": [
        {
          "contractRet": "SUCCESS"
        }
      ],
      "txID": "aaeb5bfd0d5f5a4ba8c825bdc8bc6f6ceaec896f11f31c1374d9285dc0c12906",
      "raw_data": {
        "contract": [
          {
            "type": "TransferContract",
            "parameter": {
              "type_url": "type.googleapis.com/protocol.TransferContract",
              "value": {
                "amount": 7,
                "owner_address": "413e715d653654406b1707aa6dda01b43f8acadfe6",
                "to_address": "41ac27ae19688035bf9b3f5f3baa488315f157770a"
              }
            }
          }
        ],
        "ref_block_bytes": "e956",
        "ref_block_hash": "b0413c405002bec9",
        "expiration": 1782900528000,
        "timestamp": 1782900471309
      },
      "raw_data_hex": "0a02e9562208b0413c405002bec94080a79ce9f1335a65080112610a2d747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e5472616e73666572436f6e747261637412300a15413e715d653654406b1707aa6dda01b43f8acadfe6121541ac27ae19688035bf9b3f5f3baa488315f157770a1802708dec98e9f133"
    }
  ]
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Get block by ID from solidity node

POST

https://trx-blockbook.nownodes.io/walletsolidity/getblockbyid

Query a specific block by block hash (ID) from the solidity node. The block ID is the hash of the block header.

Body

application/json

Request value.

valuestringrequired

Block hash in hex string format

visibleboolean

Whether addresses should be returned in base58 format

Response

200OK

HTTP 200 response for getblockbyid. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get block by ID from solidity node

curl -X POST 'https://trx-blockbook.nownodes.io/walletsolidity/getblockbyid' \
  -H 'Content-Type: application/json' \
  -d '{
    "value": "0000000000a6b3a4b3a4b3a4b3a4b3a4b3a4b3a4b3a4b3a4b3a4b3a4b3a4b3a4",
    "visible": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/walletsolidity/getblockbyid', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "value": "0000000000a6b3a4b3a4b3a4b3a4b3a4b3a4b3a4b3a4b3a4b3a4b3a4b3a4b3a4",
      "visible": true
    }),
});

const data = await response.json();

import requests

payload = {
  "value": "0000000000a6b3a4b3a4b3a4b3a4b3a4b3a4b3a4b3a4b3a4b3a4b3a4b3a4b3a4",
  "visible": True
}

response = requests.post('https://trx-blockbook.nownodes.io/walletsolidity/getblockbyid', json=payload)
data = response.json()

Request Body

{
  "value": "0000000000a6b3a4b3a4b3a4b3a4b3a4b3a4b3a4b3a4b3a4b3a4b3a4b3a4b3a4",
  "visible": true
}

{
  "blockID": "000000000502e9686b96165061a0c1deaa8818cb4c2950a60d0d713865b106d3",
  "block_header": {
    "raw_data": {
      "number": 84076904,
      "txTrieRoot": "2Zh5uiwkHw6fRtdxtEdE7GKjfZbZ5VhjtJXK9F6FpoJUK3oLXY",
      "witness_address": "TGyrSc9ZmTdbYziuk1SKEmdtCdETafewJ9",
      "parentHash": "000000000502e9672a443fb644045f8f397e84a212750096eb0bbb0ed563e389",
      "version": 35,
      "timestamp": 1782900468000
    },
    "witness_signature": "2b7c8962776874363cd645f8c36cdf9427d8163e8d8c5e827d5bcc7db64351d25dfc5b67183be748e264995649ecf1cc05c254eca694472a9fb73522951fff2601"
  },
  "transactions": [
    {
      "ret": [
        {
          "contractRet": "SUCCESS"
        }
      ],
      "txID": "aaeb5bfd0d5f5a4ba8c825bdc8bc6f6ceaec896f11f31c1374d9285dc0c12906",
      "raw_data": {
        "contract": [
          {
            "type": "TransferContract",
            "parameter": {
              "type_url": "type.googleapis.com/protocol.TransferContract",
              "value": {
                "amount": 7,
                "owner_address": "413e715d653654406b1707aa6dda01b43f8acadfe6",
                "to_address": "41ac27ae19688035bf9b3f5f3baa488315f157770a"
              }
            }
          }
        ],
        "ref_block_bytes": "e956",
        "ref_block_hash": "b0413c405002bec9",
        "expiration": 1782900528000,
        "timestamp": 1782900471309
      },
      "raw_data_hex": "0a02e9562208b0413c405002bec94080a79ce9f1335a65080112610a2d747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e5472616e73666572436f6e747261637412300a15413e715d653654406b1707aa6dda01b43f8acadfe6121541ac27ae19688035bf9b3f5f3baa488315f157770a1802708dec98e9f133"
    }
  ]
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Get blocks by range

POST

https://trx-blockbook.nownodes.io/walletsolidity/getblockbylimitnext

Query a range of blocks by start and end block numbers. Returns blocks from start number to end number (inclusive).

Body

application/json

Request value.

startNumintegerrequired

Starting block number

endNumintegerrequired

Ending block number

visibleboolean

Whether addresses should be returned in base58 format

Response

200OK

HTTP 200 response for getblockbylimitnext. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get blocks by range

curl -X POST 'https://trx-blockbook.nownodes.io/walletsolidity/getblockbylimitnext' \
  -H 'Content-Type: application/json' \
  -d '{
    "startNum": 12345670,
    "endNum": 12345678,
    "visible": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/walletsolidity/getblockbylimitnext', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "startNum": 12345670,
      "endNum": 12345678,
      "visible": true
    }),
});

const data = await response.json();

import requests

payload = {
  "startNum": 12345670,
  "endNum": 12345678,
  "visible": True
}

response = requests.post('https://trx-blockbook.nownodes.io/walletsolidity/getblockbylimitnext', json=payload)
data = response.json()

Request Body

{
  "startNum": 12345670,
  "endNum": 12345678,
  "visible": true
}

{
  "blockID": "000000000502e9686b96165061a0c1deaa8818cb4c2950a60d0d713865b106d3",
  "block_header": {
    "raw_data": {
      "number": 84076904,
      "txTrieRoot": "2Zh5uiwkHw6fRtdxtEdE7GKjfZbZ5VhjtJXK9F6FpoJUK3oLXY",
      "witness_address": "TGyrSc9ZmTdbYziuk1SKEmdtCdETafewJ9",
      "parentHash": "000000000502e9672a443fb644045f8f397e84a212750096eb0bbb0ed563e389",
      "version": 35,
      "timestamp": 1782900468000
    },
    "witness_signature": "2b7c8962776874363cd645f8c36cdf9427d8163e8d8c5e827d5bcc7db64351d25dfc5b67183be748e264995649ecf1cc05c254eca694472a9fb73522951fff2601"
  },
  "transactions": [
    {
      "ret": [
        {
          "contractRet": "SUCCESS"
        }
      ],
      "txID": "aaeb5bfd0d5f5a4ba8c825bdc8bc6f6ceaec896f11f31c1374d9285dc0c12906",
      "raw_data": {
        "contract": [
          {
            "type": "TransferContract",
            "parameter": {
              "type_url": "type.googleapis.com/protocol.TransferContract",
              "value": {
                "amount": 7,
                "owner_address": "413e715d653654406b1707aa6dda01b43f8acadfe6",
                "to_address": "41ac27ae19688035bf9b3f5f3baa488315f157770a"
              }
            }
          }
        ],
        "ref_block_bytes": "e956",
        "ref_block_hash": "b0413c405002bec9",
        "expiration": 1782900528000,
        "timestamp": 1782900471309
      },
      "raw_data_hex": "0a02e9562208b0413c405002bec94080a79ce9f1335a65080112610a2d747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e5472616e73666572436f6e747261637412300a15413e715d653654406b1707aa6dda01b43f8acadfe6121541ac27ae19688035bf9b3f5f3baa488315f157770a1802708dec98e9f133"
    }
  ]
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Get latest blocks

POST

https://trx-blockbook.nownodes.io/walletsolidity/getblockbylatestnum

Query the most recent N blocks from the solidity node. Returns the specified number of latest confirmed blocks.

Body

application/json

Request value.

numintegerrequired

Number of latest blocks to return

visibleboolean

Whether addresses should be returned in base58 format

Response

200OK

HTTP 200 response for getblockbylatestnum. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get latest blocks

curl -X POST 'https://trx-blockbook.nownodes.io/walletsolidity/getblockbylatestnum' \
  -H 'Content-Type: application/json' \
  -d '{
    "num": 10,
    "visible": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/walletsolidity/getblockbylatestnum', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "num": 10,
      "visible": true
    }),
});

const data = await response.json();

import requests

payload = {
  "num": 10,
  "visible": True
}

response = requests.post('https://trx-blockbook.nownodes.io/walletsolidity/getblockbylatestnum', json=payload)
data = response.json()

Request Body

{
  "num": 10,
  "visible": true
}

{
  "blockID": "000000000502e9686b96165061a0c1deaa8818cb4c2950a60d0d713865b106d3",
  "block_header": {
    "raw_data": {
      "number": 84076904,
      "txTrieRoot": "2Zh5uiwkHw6fRtdxtEdE7GKjfZbZ5VhjtJXK9F6FpoJUK3oLXY",
      "witness_address": "TGyrSc9ZmTdbYziuk1SKEmdtCdETafewJ9",
      "parentHash": "000000000502e9672a443fb644045f8f397e84a212750096eb0bbb0ed563e389",
      "version": 35,
      "timestamp": 1782900468000
    },
    "witness_signature": "2b7c8962776874363cd645f8c36cdf9427d8163e8d8c5e827d5bcc7db64351d25dfc5b67183be748e264995649ecf1cc05c254eca694472a9fb73522951fff2601"
  },
  "transactions": [
    {
      "ret": [
        {
          "contractRet": "SUCCESS"
        }
      ],
      "txID": "aaeb5bfd0d5f5a4ba8c825bdc8bc6f6ceaec896f11f31c1374d9285dc0c12906",
      "raw_data": {
        "contract": [
          {
            "type": "TransferContract",
            "parameter": {
              "type_url": "type.googleapis.com/protocol.TransferContract",
              "value": {
                "amount": 7,
                "owner_address": "413e715d653654406b1707aa6dda01b43f8acadfe6",
                "to_address": "41ac27ae19688035bf9b3f5f3baa488315f157770a"
              }
            }
          }
        ],
        "ref_block_bytes": "e956",
        "ref_block_hash": "b0413c405002bec9",
        "expiration": 1782900528000,
        "timestamp": 1782900471309
      },
      "raw_data_hex": "0a02e9562208b0413c405002bec94080a79ce9f1335a65080112610a2d747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e5472616e73666572436f6e747261637412300a15413e715d653654406b1707aa6dda01b43f8acadfe6121541ac27ae19688035bf9b3f5f3baa488315f157770a1802708dec98e9f133"
    }
  ]
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Get node information

POST

https://trx-blockbook.nownodes.io/wallet/getnodeinfo

Query information about the connected TRON node. Returns details about the node's configuration, network status, and current block information. This method queries the full node, providing real-time network data.

Body

application/json

Request value.

visibleboolean

Whether addresses should be returned in base58 format

Response

200OK

HTTP 200 response for getnodeinfo. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get node information

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/getnodeinfo' \
  -H 'Content-Type: application/json' \
  -d '{
    "visible": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/getnodeinfo', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "visible": true
    }),
});

const data = await response.json();

import requests

payload = {
  "visible": True
}

response = requests.post('https://trx-blockbook.nownodes.io/wallet/getnodeinfo', json=payload)
data = response.json()

Request Body

{
  "visible": true
}

{
  "result": true,
  "blockID": "000000000502e9686b96165061a0c1deaa8818cb4c2950a60d0d713865b106d3"
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Transactions

Transactions operations.

Get transaction by ID

POST

https://trx-blockbook.nownodes.io/walletsolidity/gettransactionbyid

Query a specific transaction by its transaction ID (hash) from the solidity node. Returns the complete transaction details including raw data and signatures. The solidity node provides confirmed transaction data that has been included in a block.

Body

application/json

Request value.

valuestringrequired

Transaction ID (hash) in hex string format

visibleboolean

Whether addresses should be returned in base58 format

Response

200OK

HTTP 200 response for gettransactionbyid. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get transaction by ID

curl -X POST 'https://trx-blockbook.nownodes.io/walletsolidity/gettransactionbyid' \
  -H 'Content-Type: application/json' \
  -d '{
    "value": "abc123def456abc123def456abc123def456abc123def456abc123def456abc123",
    "visible": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/walletsolidity/gettransactionbyid', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "value": "abc123def456abc123def456abc123def456abc123def456abc123def456abc123",
      "visible": true
    }),
});

const data = await response.json();

import requests

payload = {
  "value": "abc123def456abc123def456abc123def456abc123def456abc123def456abc123",
  "visible": True
}

response = requests.post('https://trx-blockbook.nownodes.io/walletsolidity/gettransactionbyid', json=payload)
data = response.json()

Request Body

{
  "value": "abc123def456abc123def456abc123def456abc123def456abc123def456abc123",
  "visible": true
}

{
  "ret": [
    {
      "contractRet": "SUCCESS"
    }
  ],
  "signature": [
    "9ceb80179660af030bada0cd69e13ef73a91146b4c036c92e4b2389b6d66749d717ccf5af0f66d83bc7676d10f1682ac0aec596f4194d3b39d06922cade1452f00"
  ],
  "txID": "aaeb5bfd0d5f5a4ba8c825bdc8bc6f6ceaec896f11f31c1374d9285dc0c12906",
  "raw_data": {
    "contract": [
      {
        "parameter": {
          "value": {
            "amount": 7,
            "owner_address": "41A614F803B6FD780986A42C78EC9C7F77E6DED13C",
            "to_address": "41ac27ae19688035bf9b3f5f3baa488315f157770a"
          },
          "type_url": "type.googleapis.com/protocol.TransferContract"
        },
        "type": "TransferContract"
      }
    ],
    "ref_block_bytes": "e956",
    "ref_block_hash": "b0413c405002bec9",
    "expiration": 1782900528000,
    "timestamp": 1782900471309
  },
  "raw_data_hex": "0a02e9562208b0413c405002bec94080a79ce9f1335a65080112610a2d747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e5472616e73666572436f6e747261637412300a15413e715d653654406b1707aa6dda01b43f8acadfe6121541ac27ae19688035bf9b3f5f3baa488315f157770a1807"
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Get transaction count by block number

POST

https://trx-blockbook.nownodes.io/walletsolidity/gettransactioncountbyblocknum

Query the number of transactions in a specific block by block number. Returns the total count of transactions contained in the specified block.

Body

application/json

Request value.

numintegerrequired

Block number

visibleboolean

Whether addresses should be returned in base58 format

Response

200OK

HTTP 200 response for gettransactioncountbyblocknum. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get transaction count by block number

curl -X POST 'https://trx-blockbook.nownodes.io/walletsolidity/gettransactioncountbyblocknum' \
  -H 'Content-Type: application/json' \
  -d '{
    "num": 12345678,
    "visible": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/walletsolidity/gettransactioncountbyblocknum', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "num": 12345678,
      "visible": true
    }),
});

const data = await response.json();

import requests

payload = {
  "num": 12345678,
  "visible": True
}

response = requests.post('https://trx-blockbook.nownodes.io/walletsolidity/gettransactioncountbyblocknum', json=payload)
data = response.json()

Request Body

{
  "num": 12345678,
  "visible": true
}

{
  "transactionCount": 647
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Get transaction information by ID

POST

https://trx-blockbook.nownodes.io/walletsolidity/gettransactioninfobyid

Query detailed transaction information by transaction ID. Returns additional execution details including fee information, internal transactions, and contract execution results that are not available in the basic transaction data.

Body

application/json

Request value.

valuestringrequired

Transaction ID (hash) in hex string format

visibleboolean

Whether addresses should be returned in base58 format

Response

200OK

HTTP 200 response for gettransactioninfobyid. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get transaction information by ID

curl -X POST 'https://trx-blockbook.nownodes.io/walletsolidity/gettransactioninfobyid' \
  -H 'Content-Type: application/json' \
  -d '{
    "value": "abc123def456abc123def456abc123def456abc123def456abc123def456abc123",
    "visible": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/walletsolidity/gettransactioninfobyid', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "value": "abc123def456abc123def456abc123def456abc123def456abc123def456abc123",
      "visible": true
    }),
});

const data = await response.json();

import requests

payload = {
  "value": "abc123def456abc123def456abc123def456abc123def456abc123def456abc123",
  "visible": True
}

response = requests.post('https://trx-blockbook.nownodes.io/walletsolidity/gettransactioninfobyid', json=payload)
data = response.json()

Request Body

{
  "value": "abc123def456abc123def456abc123def456abc123def456abc123def456abc123",
  "visible": true
}

{
  "result": true,
  "blockID": "000000000502e9686b96165061a0c1deaa8818cb4c2950a60d0d713865b106d3"
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Get transaction information by block number

POST

https://trx-blockbook.nownodes.io/walletsolidity/gettransactioninfobyblocknum

Query transaction information for all transactions in a specific block. Returns detailed execution information for each transaction in the block.

Body

application/json

Request value.

numintegerrequired

Block number

visibleboolean

Whether addresses should be returned in base58 format

Response

200OK

HTTP 200 response for gettransactioninfobyblocknum. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get transaction information by block number

curl -X POST 'https://trx-blockbook.nownodes.io/walletsolidity/gettransactioninfobyblocknum' \
  -H 'Content-Type: application/json' \
  -d '{
    "num": 12345678,
    "visible": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/walletsolidity/gettransactioninfobyblocknum', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "num": 12345678,
      "visible": true
    }),
});

const data = await response.json();

import requests

payload = {
  "num": 12345678,
  "visible": True
}

response = requests.post('https://trx-blockbook.nownodes.io/walletsolidity/gettransactioninfobyblocknum', json=payload)
data = response.json()

Request Body

{
  "num": 12345678,
  "visible": true
}

{
  "result": true,
  "blockID": "000000000502e9686b96165061a0c1deaa8818cb4c2950a60d0d713865b106d3"
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

DEX Exchanges

DEX Exchanges operations.

Get DEX exchange by ID

POST

https://trx-blockbook.nownodes.io/walletsolidity/getexchangebyid

Query information about a specific decentralized exchange (DEX) by its exchange ID. Returns detailed information about the token pair, liquidity pools, and exchange statistics. DEX exchanges on TRON allow trading between TRX and TRC-10 tokens through automated market maker (AMM) pools.

Body

application/json

Request value.

idintegerrequired

The unique identifier of the exchange

visibleboolean

Whether addresses should be returned in base58 format

Response

200OK

HTTP 200 response for getexchangebyid. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

404Not Found

Exchange not found

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get DEX exchange by ID

curl -X POST 'https://trx-blockbook.nownodes.io/walletsolidity/getexchangebyid' \
  -H 'Content-Type: application/json' \
  -d '{
    "id": 1,
    "visible": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/walletsolidity/getexchangebyid', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "id": 1,
      "visible": true
    }),
});

const data = await response.json();

import requests

payload = {
  "id": 1,
  "visible": True
}

response = requests.post('https://trx-blockbook.nownodes.io/walletsolidity/getexchangebyid', json=payload)
data = response.json()

Request Body

{
  "id": 1,
  "visible": true
}

{
  "txID": "aaeb5bfd0d5f5a4ba8c825bdc8bc6f6ceaec896f11f31c1374d9285dc0c12906",
  "raw_data": {
    "contract": [
      {
        "parameter": {
          "value": {
            "amount": 7,
            "owner_address": "41A614F803B6FD780986A42C78EC9C7F77E6DED13C",
            "to_address": "41ac27ae19688035bf9b3f5f3baa488315f157770a"
          },
          "type_url": "type.googleapis.com/protocol.TransferContract"
        },
        "type": "TransferContract"
      }
    ],
    "ref_block_bytes": "e956",
    "ref_block_hash": "b0413c405002bec9",
    "expiration": 1782900528000,
    "timestamp": 1782900471309
  },
  "raw_data_hex": "0a02e9562208b0413c405002bec94080a79ce9f1335a65080112610a2d747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e5472616e73666572436f6e747261637412300a15413e715d653654406b1707aa6dda01b43f8acadfe6121541ac27ae19688035bf9b3f5f3baa488315f157770a1807"
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

{
  "Error": "Exchange not found"
}

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Get all DEX exchanges list

POST

https://trx-blockbook.nownodes.io/walletsolidity/listexchanges

Query the complete list of all decentralized exchanges (DEX) on the TRON network. Returns information about all available trading pairs and their current liquidity. The list is typically sorted by exchange ID in ascending order.

Body

application/json

Request value.

visibleboolean

Whether addresses should be returned in base58 format

Response

200OK

HTTP 200 response for listexchanges. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get all DEX exchanges list

curl -X POST 'https://trx-blockbook.nownodes.io/walletsolidity/listexchanges' \
  -H 'Content-Type: application/json' \
  -d '{
    "visible": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/walletsolidity/listexchanges', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "visible": true
    }),
});

const data = await response.json();

import requests

payload = {
  "visible": True
}

response = requests.post('https://trx-blockbook.nownodes.io/walletsolidity/listexchanges', json=payload)
data = response.json()

Request Body

{
  "visible": true
}

{
  "txID": "aaeb5bfd0d5f5a4ba8c825bdc8bc6f6ceaec896f11f31c1374d9285dc0c12906",
  "raw_data": {
    "contract": [
      {
        "parameter": {
          "value": {
            "amount": 7,
            "owner_address": "41A614F803B6FD780986A42C78EC9C7F77E6DED13C",
            "to_address": "41ac27ae19688035bf9b3f5f3baa488315f157770a"
          },
          "type_url": "type.googleapis.com/protocol.TransferContract"
        },
        "type": "TransferContract"
      }
    ],
    "ref_block_bytes": "e956",
    "ref_block_hash": "b0413c405002bec9",
    "expiration": 1782900528000,
    "timestamp": 1782900471309
  },
  "raw_data_hex": "0a02e9562208b0413c405002bec94080a79ce9f1335a65080112610a2d747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e5472616e73666572436f6e747261637412300a15413e715d653654406b1707aa6dda01b43f8acadfe6121541ac27ae19688035bf9b3f5f3baa488315f157770a1807"
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

MAINNET / node-wallet

Account

Account operations.

Validate address

POST

https://trx-blockbook.nownodes.io/wallet/validateaddress

Validates whether a given address is a valid TRON address in either base58 or hex format. Returns validation result and address details.

Body

application/json

Request value.

addressstringrequired

The address to validate. Can be in base58 format (starts with 'T') or hex format.

Response

200OK

HTTP 200 response for validateaddress. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Validate address

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/validateaddress' \
  -H 'Content-Type: application/json' \
  -d '{
    "address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE"
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/validateaddress', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE"
    }),
});

const data = await response.json();

import requests

payload = {
  "address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE"
}

response = requests.post('https://trx-blockbook.nownodes.io/wallet/validateaddress', json=payload)
data = response.json()

Request Body

{
  "address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE"
}

{
  "result": true,
  "message": "Address is valid"
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Create account

POST

https://trx-blockbook.nownodes.io/wallet/createaccount

Creates a new account on the TRON blockchain. This operation requires the creator to pay a fee and have sufficient balance. The account creation must be signed and broadcast to the network.

Body

application/json

Request value.

owner_addressstringrequired

The address of the account creator (must have sufficient TRX for fee). In base58 format starting with 'T'.

account_addressstringrequired

The address of the new account to be created. In base58 format starting with 'T'.

visibleboolean

Whether addresses are provided in base58 format. Set to true for base58 addresses.

Response

200OK

HTTP 200 response for createaccount. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Create account

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/createaccount' \
  -H 'Content-Type: application/json' \
  -d '{
    "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
    "account_address": "TFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF",
    "visible": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/createaccount', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
      "account_address": "TFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF",
      "visible": true
    }),
});

const data = await response.json();

import requests

payload = {
  "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
  "account_address": "TFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF",
  "visible": True
}

response = requests.post('https://trx-blockbook.nownodes.io/wallet/createaccount', json=payload)
data = response.json()

Request Body

{
  "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
  "account_address": "TFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF",
  "visible": true
}

{
  "size": 12
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Get account information

POST

https://trx-blockbook.nownodes.io/wallet/getaccount

Returns comprehensive information about an account including balance, resource usage, permissions, and token holdings.

Body

application/json

Request value.

addressstringrequired

The account address to query. In base58 format starting with 'T'.

visibleboolean

Whether the address is provided in base58 format. Set to true for base58 addresses.

Response

200OK

HTTP 200 response for getaccount. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get account information

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/getaccount' \
  -H 'Content-Type: application/json' \
  -d '{
    "address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
    "visible": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/getaccount', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
      "visible": true
    }),
});

const data = await response.json();

import requests

payload = {
  "address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
  "visible": True
}

response = requests.post('https://trx-blockbook.nownodes.io/wallet/getaccount', json=payload)
data = response.json()

Request Body

{
  "address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
  "visible": true
}

{
  "account_name": "CreatedByContract",
  "type": "Contract",
  "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
  "balance": 1978237590707,
  "net_window_size": 28800000,
  "net_window_optimized": true,
  "account_resource": {
    "energy_window_size": 28800000,
    "energy_window_optimized": true
  },
  "frozenV2": [
    {},
    {
      "type": "ENERGY"
    },
    {
      "type": "TRON_POWER"
    }
  ],
  "assetV2": [
    {
      "key": "1004108",
      "value": 10199700
    },
    {
      "key": "1002963",
      "value": 5000000
    },
    {
      "key": "1003812",
      "value": 18231000000
    }
  ]
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Update account

POST

https://trx-blockbook.nownodes.io/wallet/updateaccount

Update account information such as account name. This operation requires a fee and must be signed and broadcast to the network.

Body

application/json

Request value.

account_namestringrequired

The new account name in hex string format. Maximum 32 bytes when converted to hex.

owner_addressstringrequired

The account owner address in base58 format.

visibleboolean

Whether the address is in base58 format.

Response

200OK

HTTP 200 response for updateaccount. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Update account

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/updateaccount' \
  -H 'Content-Type: application/json' \
  -d '{
    "account_name": "1234567890abcdef",
    "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
    "visible": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/updateaccount', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "account_name": "1234567890abcdef",
      "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
      "visible": true
    }),
});

const data = await response.json();

import requests

payload = {
  "account_name": "1234567890abcdef",
  "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
  "visible": True
}

response = requests.post('https://trx-blockbook.nownodes.io/wallet/updateaccount', json=payload)
data = response.json()

Request Body

{
  "account_name": "1234567890abcdef",
  "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
  "visible": true
}

{
  "size": 12
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Update account permission

POST

https://trx-blockbook.nownodes.io/wallet/accountpermissionupdate

Update account permissions including owner permission and active permissions. This is a critical security operation that requires careful consideration. The transaction must be signed and broadcast to the network.

Body

application/json

Request value.

owner_addressstringrequired

The account owner address in base58 format.

ownerobject

New owner permission settings. This is a critical permission that controls the account.

Show child attributes

permission_namestring

Permission name for owner permission

thresholdinteger

Threshold value that must be met for operations

keysArray<object>

List of keys with their weights

Show child attributes

addressstring

Key address in base58 format

weightinteger

Weight of the key

activesArray<object>

Active permission settings for daily operations.

Show child attributes

typestring

Permission type

idinteger

Permission ID

permission_namestring

Permission name

thresholdinteger

Threshold value

operationsstring

Allowed operations in hex format

keysArray<object>

Keys value.

Show child attributes

addressstring

Key address

weightinteger

Key weight

visibleboolean

Whether addresses are in base58 format.

Response

200OK

HTTP 200 response for accountpermissionupdate. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Update account permission

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/accountpermissionupdate' \
  -H 'Content-Type: application/json' \
  -d '{
    "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
    "owner": {
      "permission_name": "owner",
      "threshold": 2,
      "keys": [
        {
          "address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
          "weight": 1
        }
      ]
    },
    "actives": [
      {
        "type": "Active",
        "id": 2,
        "permission_name": "active",
        "threshold": 1,
        "operations": "7fff1fc0033e0000000000000000000000000000000000000000000000000000",
        "keys": [
          {
            "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
            "weight": 1
          }
        ]
      }
    ],
    "visible": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/accountpermissionupdate', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
      "owner": {
        "permission_name": "owner",
        "threshold": 2,
        "keys": [
          {
            "address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
            "weight": 1
          }
        ]
      },
      "actives": [
        {
          "type": "Active",
          "id": 2,
          "permission_name": "active",
          "threshold": 1,
          "operations": "7fff1fc0033e0000000000000000000000000000000000000000000000000000",
          "keys": [
            {
              "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
              "weight": 1
            }
          ]
        }
      ],
      "visible": true
    }),
});

const data = await response.json();

import requests

payload = {
  "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
  "owner": {
    "permission_name": "owner",
    "threshold": 2,
    "keys": [
      {
        "address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
        "weight": 1
      }
    ]
  },
  "actives": [
    {
      "type": "Active",
      "id": 2,
      "permission_name": "active",
      "threshold": 1,
      "operations": "7fff1fc0033e0000000000000000000000000000000000000000000000000000",
      "keys": [
        {
          "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
          "weight": 1
        }
      ]
    }
  ],
  "visible": True
}

response = requests.post('https://trx-blockbook.nownodes.io/wallet/accountpermissionupdate', json=payload)
data = response.json()

Request Body

{
  "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
  "owner": {
    "permission_name": "owner",
    "threshold": 2,
    "keys": [
      {
        "address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
        "weight": 1
      }
    ]
  },
  "actives": [
    {
      "type": "Active",
      "id": 2,
      "permission_name": "active",
      "threshold": 1,
      "operations": "7fff1fc0033e0000000000000000000000000000000000000000000000000000",
      "keys": [
        {
          "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
          "weight": 1
        }
      ]
    }
  ],
  "visible": true
}

{
  "size": 12
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Get account balance

POST

https://trx-blockbook.nownodes.io/wallet/getaccountbalance

Returns the current TRX balance of an account. This method provides a simple way to query only the balance without other account details.

Body

application/json

Request value.

account_identifierobjectrequired

Account identifier object containing the address.

Show child attributes

addressstring

The account address in base58 format.

block_identifierobjectrequired

Optional block identifier to get balance at a specific block height.

Show child attributes

hashstring

Block hash

numberinteger

Block number

visibleboolean

Whether the address is in base58 format.

Response

200OK

HTTP 200 response for getaccountbalance. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get account balance

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/getaccountbalance' \
  -H 'Content-Type: application/json' \
  -d '{
    "account_identifier": {
      "address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE"
    },
    "block_identifier": {
      "hash": "0000000000035a98bf3cde4c71d98b62f5c4c5438a5c7b801e84c9e74f96d9e9",
      "number": 12345678
    },
    "visible": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/getaccountbalance', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "account_identifier": {
        "address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE"
      },
      "block_identifier": {
        "hash": "0000000000035a98bf3cde4c71d98b62f5c4c5438a5c7b801e84c9e74f96d9e9",
        "number": 12345678
      },
      "visible": true
    }),
});

const data = await response.json();

import requests

payload = {
  "account_identifier": {
    "address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE"
  },
  "block_identifier": {
    "hash": "0000000000035a98bf3cde4c71d98b62f5c4c5438a5c7b801e84c9e74f96d9e9",
    "number": 12345678
  },
  "visible": True
}

response = requests.post('https://trx-blockbook.nownodes.io/wallet/getaccountbalance', json=payload)
data = response.json()

Request Body

{
  "account_identifier": {
    "address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE"
  },
  "block_identifier": {
    "hash": "0000000000035a98bf3cde4c71d98b62f5c4c5438a5c7b801e84c9e74f96d9e9",
    "number": 12345678
  },
  "visible": true
}

{
  "account_name": "CreatedByContract",
  "type": "Contract",
  "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
  "balance": 1978237590707,
  "net_window_size": 28800000,
  "net_window_optimized": true,
  "account_resource": {
    "energy_window_size": 28800000,
    "energy_window_optimized": true
  },
  "frozenV2": [
    {},
    {
      "type": "ENERGY"
    },
    {
      "type": "TRON_POWER"
    }
  ],
  "assetV2": [
    {
      "key": "1004108",
      "value": 10199700
    },
    {
      "key": "1002963",
      "value": 5000000
    },
    {
      "key": "1003812",
      "value": 18231000000
    }
  ]
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Set account ID

POST

https://trx-blockbook.nownodes.io/wallet/setaccountid

Set a human-readable account ID for an account. This operation requires a fee and must be signed and broadcast to the network. Account ID must be unique across the network.

Body

application/json

Request value.

account_idstringrequired

The account ID to set. Must be unique across the network. Maximum 32 bytes.

owner_addressstringrequired

The account owner address in base58 format.

visibleboolean

Whether the address is in base58 format.

Response

200OK

HTTP 200 response for setaccountid. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Set account ID

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/setaccountid' \
  -H 'Content-Type: application/json' \
  -d '{
    "account_id": "my_account_id",
    "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
    "visible": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/setaccountid', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "account_id": "my_account_id",
      "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
      "visible": true
    }),
});

const data = await response.json();

import requests

payload = {
  "account_id": "my_account_id",
  "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
  "visible": True
}

response = requests.post('https://trx-blockbook.nownodes.io/wallet/setaccountid', json=payload)
data = response.json()

Request Body

{
  "account_id": "my_account_id",
  "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
  "visible": true
}

{
  "size": 12
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Get account by ID

POST

https://trx-blockbook.nownodes.io/wallet/getaccountbyid

Returns account information by account ID. Account ID is a unique identifier that can be set for an account.

Body

application/json

Request value.

account_idstringrequired

The account ID to look up.

visibleboolean

Whether to return address in base58 format.

Response

200OK

HTTP 200 response for getaccountbyid. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get account by ID

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/getaccountbyid' \
  -H 'Content-Type: application/json' \
  -d '{
    "account_id": "my_account_id",
    "visible": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/getaccountbyid', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "account_id": "my_account_id",
      "visible": true
    }),
});

const data = await response.json();

import requests

payload = {
  "account_id": "my_account_id",
  "visible": True
}

response = requests.post('https://trx-blockbook.nownodes.io/wallet/getaccountbyid', json=payload)
data = response.json()

Request Body

{
  "account_id": "my_account_id",
  "visible": true
}

{
  "account_name": "CreatedByContract",
  "type": "Contract",
  "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
  "balance": 1978237590707,
  "net_window_size": 28800000,
  "net_window_optimized": true,
  "account_resource": {
    "energy_window_size": 28800000,
    "energy_window_optimized": true
  },
  "frozenV2": [
    {},
    {
      "type": "ENERGY"
    },
    {
      "type": "TRON_POWER"
    }
  ],
  "assetV2": [
    {
      "key": "1004108",
      "value": 10199700
    },
    {
      "key": "1002963",
      "value": 5000000
    },
    {
      "key": "1003812",
      "value": 18231000000
    }
  ]
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Transfers and Transactions

Transfers and Transactions operations.

Create transaction

POST

https://trx-blockbook.nownodes.io/wallet/createtransaction

Creates a new transaction for transferring TRX between accounts. This method constructs the transaction but does not sign or broadcast it. The returned transaction must be signed before it can be broadcast to the network.

Body

application/json

Request value.

to_addressstringrequired

The recipient's address in base58 format (starts with 'T').

owner_addressstringrequired

The sender's address in base58 format (starts with 'T').

amountinteger<int64>required

The amount to send in SUN (1 TRX = 1,000,000 SUN). Must be a positive integer.

visibleboolean

Whether addresses are provided in base58 format. Set to true for base58 addresses.

permission_idinteger

The permission ID to use for the transaction (for multi-signature accounts). If not specified, uses the default active permission.

Response

200OK

HTTP 200 response for createtransaction. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Create transaction

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/createtransaction' \
  -H 'Content-Type: application/json' \
  -d '{
    "to_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
    "owner_address": "TFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF",
    "amount": 1000000,
    "visible": true,
    "permission_id": 2
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/createtransaction', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "to_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
      "owner_address": "TFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF",
      "amount": 1000000,
      "visible": true,
      "permission_id": 2
    }),
});

const data = await response.json();

import requests

payload = {
  "to_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
  "owner_address": "TFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF",
  "amount": 1000000,
  "visible": True,
  "permission_id": 2
}

response = requests.post('https://trx-blockbook.nownodes.io/wallet/createtransaction', json=payload)
data = response.json()

Request Body

{
  "to_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
  "owner_address": "TFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF",
  "amount": 1000000,
  "visible": true,
  "permission_id": 2
}

{
  "ret": [
    {
      "contractRet": "SUCCESS"
    }
  ],
  "signature": [
    "9ceb80179660af030bada0cd69e13ef73a91146b4c036c92e4b2389b6d66749d717ccf5af0f66d83bc7676d10f1682ac0aec596f4194d3b39d06922cade1452f00"
  ],
  "txID": "aaeb5bfd0d5f5a4ba8c825bdc8bc6f6ceaec896f11f31c1374d9285dc0c12906",
  "raw_data": {
    "contract": [
      {
        "parameter": {
          "value": {
            "amount": 7,
            "owner_address": "41A614F803B6FD780986A42C78EC9C7F77E6DED13C",
            "to_address": "41ac27ae19688035bf9b3f5f3baa488315f157770a"
          },
          "type_url": "type.googleapis.com/protocol.TransferContract"
        },
        "type": "TransferContract"
      }
    ],
    "ref_block_bytes": "e956",
    "ref_block_hash": "b0413c405002bec9",
    "expiration": 1782900528000,
    "timestamp": 1782900471309
  },
  "raw_data_hex": "0a02e9562208b0413c405002bec94080a79ce9f1335a65080112610a2d747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e5472616e73666572436f6e747261637412300a15413e715d653654406b1707aa6dda01b43f8acadfe6121541ac27ae19688035bf9b3f5f3baa488315f157770a1807"
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Broadcast transaction

POST

https://trx-blockbook.nownodes.io/wallet/broadcasttransaction

Broadcasts a signed transaction to the network for processing. The transaction must be properly signed before broadcasting. Once broadcast, the transaction will be processed by the network and included in a block.

Body

application/json

Request value.

transactionobjectrequired

The signed transaction object to broadcast. This should be the transaction object returned by createtransaction with added signatures.

Show child attributes

visibleboolean

Whether the transaction uses visible addresses

txIDstring

The transaction ID

raw_dataobject

The raw transaction data

raw_data_hexstring

Hex-encoded raw transaction data

signatureArray<string>required

Array of transaction signatures in hex format. For single-signature transactions, array should contain one signature. For multi-signature transactions, array should contain all required signatures.

visibleboolean

Whether the transaction uses visible addresses.

Response

200OK

HTTP 200 response for broadcasttransaction. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Broadcast transaction

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/broadcasttransaction' \
  -H 'Content-Type: application/json' \
  -d '{
    "transaction": {
      "visible": true,
      "txID": "aaeb5bfd0d5f5a4ba8c825bdc8bc6f6ceaec896f11f31c1374d9285dc0c12906",
      "raw_data": "raw_data_example",
      "raw_data_hex": "raw_data_hex_example"
    },
    "signature": [
      "3045022100a1b2c3d4e5f67890123456789012345678901234567890123456789012345678902200f1e2d3c4b5a697887766554433221100aabbccddeeff00998877665544332211"
    ],
    "visible": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/broadcasttransaction', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "transaction": {
        "visible": true,
        "txID": "aaeb5bfd0d5f5a4ba8c825bdc8bc6f6ceaec896f11f31c1374d9285dc0c12906",
        "raw_data": "raw_data_example",
        "raw_data_hex": "raw_data_hex_example"
      },
      "signature": [
        "3045022100a1b2c3d4e5f67890123456789012345678901234567890123456789012345678902200f1e2d3c4b5a697887766554433221100aabbccddeeff00998877665544332211"
      ],
      "visible": true
    }),
});

const data = await response.json();

import requests

payload = {
  "transaction": {
    "visible": True,
    "txID": "aaeb5bfd0d5f5a4ba8c825bdc8bc6f6ceaec896f11f31c1374d9285dc0c12906",
    "raw_data": "raw_data_example",
    "raw_data_hex": "raw_data_hex_example"
  },
  "signature": [
    "3045022100a1b2c3d4e5f67890123456789012345678901234567890123456789012345678902200f1e2d3c4b5a697887766554433221100aabbccddeeff00998877665544332211"
  ],
  "visible": True
}

response = requests.post('https://trx-blockbook.nownodes.io/wallet/broadcasttransaction', json=payload)
data = response.json()

Request Body

{
  "transaction": {
    "visible": true,
    "txID": "aaeb5bfd0d5f5a4ba8c825bdc8bc6f6ceaec896f11f31c1374d9285dc0c12906",
    "raw_data": "raw_data_example",
    "raw_data_hex": "raw_data_hex_example"
  },
  "signature": [
    "3045022100a1b2c3d4e5f67890123456789012345678901234567890123456789012345678902200f1e2d3c4b5a697887766554433221100aabbccddeeff00998877665544332211"
  ],
  "visible": true
}

{
  "ret": [
    {
      "contractRet": "SUCCESS"
    }
  ],
  "signature": [
    "9ceb80179660af030bada0cd69e13ef73a91146b4c036c92e4b2389b6d66749d717ccf5af0f66d83bc7676d10f1682ac0aec596f4194d3b39d06922cade1452f00"
  ],
  "txID": "aaeb5bfd0d5f5a4ba8c825bdc8bc6f6ceaec896f11f31c1374d9285dc0c12906",
  "raw_data": {
    "contract": [
      {
        "parameter": {
          "value": {
            "amount": 7,
            "owner_address": "41A614F803B6FD780986A42C78EC9C7F77E6DED13C",
            "to_address": "41ac27ae19688035bf9b3f5f3baa488315f157770a"
          },
          "type_url": "type.googleapis.com/protocol.TransferContract"
        },
        "type": "TransferContract"
      }
    ],
    "ref_block_bytes": "e956",
    "ref_block_hash": "b0413c405002bec9",
    "expiration": 1782900528000,
    "timestamp": 1782900471309
  },
  "raw_data_hex": "0a02e9562208b0413c405002bec94080a79ce9f1335a65080112610a2d747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e5472616e73666572436f6e747261637412300a15413e715d653654406b1707aa6dda01b43f8acadfe6121541ac27ae19688035bf9b3f5f3baa488315f157770a1807"
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Broadcast hex transaction

POST

https://trx-blockbook.nownodes.io/wallet/broadcasthex

Broadcasts a fully signed transaction in hex format to the network. This method accepts the complete signed transaction as a hex string. Useful for broadcasting transactions that were signed offline or by external tools.

Body

application/json

Request value.

transactionstringrequired

The complete signed transaction in hex format. This should include the raw transaction data plus all signatures.

Response

200OK

HTTP 200 response for broadcasthex. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Broadcast hex transaction

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/broadcasthex' \
  -H 'Content-Type: application/json' \
  -d '{
    "transaction": "0a02a1b22208c3d4e5f67890123440a0c58ba6ad053a740a1541a614f803b6fd780986a42c78ec9c7f77e6ded13c121541ffffffffffffffffffffffffffffffffffffffffff1880c2d72f12413045022100a1b2c3d4e5f67890123456789012345678901234567890123456789012345678902200f1e2d3c4b5a697887766554433221100aabbccddeeff00998877665544332211"
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/broadcasthex', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "transaction": "0a02a1b22208c3d4e5f67890123440a0c58ba6ad053a740a1541a614f803b6fd780986a42c78ec9c7f77e6ded13c121541ffffffffffffffffffffffffffffffffffffffffff1880c2d72f12413045022100a1b2c3d4e5f67890123456789012345678901234567890123456789012345678902200f1e2d3c4b5a697887766554433221100aabbccddeeff00998877665544332211"
    }),
});

const data = await response.json();

import requests

payload = {
  "transaction": "0a02a1b22208c3d4e5f67890123440a0c58ba6ad053a740a1541a614f803b6fd780986a42c78ec9c7f77e6ded13c121541ffffffffffffffffffffffffffffffffffffffffff1880c2d72f12413045022100a1b2c3d4e5f67890123456789012345678901234567890123456789012345678902200f1e2d3c4b5a697887766554433221100aabbccddeeff00998877665544332211"
}

response = requests.post('https://trx-blockbook.nownodes.io/wallet/broadcasthex', json=payload)
data = response.json()

Request Body

{
  "transaction": "0a02a1b22208c3d4e5f67890123440a0c58ba6ad053a740a1541a614f803b6fd780986a42c78ec9c7f77e6ded13c121541ffffffffffffffffffffffffffffffffffffffffff1880c2d72f12413045022100a1b2c3d4e5f67890123456789012345678901234567890123456789012345678902200f1e2d3c4b5a697887766554433221100aabbccddeeff00998877665544332211"
}

{
  "ret": [
    {
      "contractRet": "SUCCESS"
    }
  ],
  "signature": [
    "9ceb80179660af030bada0cd69e13ef73a91146b4c036c92e4b2389b6d66749d717ccf5af0f66d83bc7676d10f1682ac0aec596f4194d3b39d06922cade1452f00"
  ],
  "txID": "aaeb5bfd0d5f5a4ba8c825bdc8bc6f6ceaec896f11f31c1374d9285dc0c12906",
  "raw_data": {
    "contract": [
      {
        "parameter": {
          "value": {
            "amount": 7,
            "owner_address": "41A614F803B6FD780986A42C78EC9C7F77E6DED13C",
            "to_address": "41ac27ae19688035bf9b3f5f3baa488315f157770a"
          },
          "type_url": "type.googleapis.com/protocol.TransferContract"
        },
        "type": "TransferContract"
      }
    ],
    "ref_block_bytes": "e956",
    "ref_block_hash": "b0413c405002bec9",
    "expiration": 1782900528000,
    "timestamp": 1782900471309
  },
  "raw_data_hex": "0a02e9562208b0413c405002bec94080a79ce9f1335a65080112610a2d747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e5472616e73666572436f6e747261637412300a15413e715d653654406b1707aa6dda01b43f8acadfe6121541ac27ae19688035bf9b3f5f3baa488315f157770a1807"
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Get sign weight

POST

https://trx-blockbook.nownodes.io/wallet/getsignweight

Returns the current signing weight of a transaction. This method is useful for multi-signature accounts to check if a transaction has sufficient signatures. It analyzes the provided signatures and calculates the current approval weight.

Body

application/json

Request value.

transactionobjectrequired

The transaction object with signatures to analyze.

Show child attributes

visibleboolean

Whether the transaction uses visible addresses

txIDstring

The transaction ID

raw_dataobject

The raw transaction data

raw_data_hexstring

Hex-encoded raw transaction data

signatureArray<string>

Array of signatures

visibleboolean

Whether the transaction uses visible addresses.

permission_idinteger

The permission ID to check against. If not specified, checks against the active permission.

Response

200OK

HTTP 200 response for getsignweight. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get sign weight

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/getsignweight' \
  -H 'Content-Type: application/json' \
  -d '{
    "transaction": {
      "visible": true,
      "txID": "aaeb5bfd0d5f5a4ba8c825bdc8bc6f6ceaec896f11f31c1374d9285dc0c12906",
      "raw_data": "raw_data_example",
      "raw_data_hex": "raw_data_hex_example",
      "signature": [
        "item_example"
      ]
    },
    "visible": true,
    "permission_id": 2
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/getsignweight', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "transaction": {
        "visible": true,
        "txID": "aaeb5bfd0d5f5a4ba8c825bdc8bc6f6ceaec896f11f31c1374d9285dc0c12906",
        "raw_data": "raw_data_example",
        "raw_data_hex": "raw_data_hex_example",
        "signature": [
          "item_example"
        ]
      },
      "visible": true,
      "permission_id": 2
    }),
});

const data = await response.json();

import requests

payload = {
  "transaction": {
    "visible": True,
    "txID": "aaeb5bfd0d5f5a4ba8c825bdc8bc6f6ceaec896f11f31c1374d9285dc0c12906",
    "raw_data": "raw_data_example",
    "raw_data_hex": "raw_data_hex_example",
    "signature": [
      "item_example"
    ]
  },
  "visible": True,
  "permission_id": 2
}

response = requests.post('https://trx-blockbook.nownodes.io/wallet/getsignweight', json=payload)
data = response.json()

Request Body

{
  "transaction": {
    "visible": true,
    "txID": "aaeb5bfd0d5f5a4ba8c825bdc8bc6f6ceaec896f11f31c1374d9285dc0c12906",
    "raw_data": "raw_data_example",
    "raw_data_hex": "raw_data_hex_example",
    "signature": [
      "item_example"
    ]
  },
  "visible": true,
  "permission_id": 2
}

{
  "result": true,
  "blockID": "000000000502e9686b96165061a0c1deaa8818cb4c2950a60d0d713865b106d3"
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Get approved list

POST

https://trx-blockbook.nownodes.io/wallet/getapprovedlist

Returns the list of approved addresses and their approved amounts for a specific contract. This is useful for checking token allowances in TRC20 contracts.

Body

application/json

Request value.

owner_addressstringrequired

The account owner address in base58 format.

visibleboolean

Whether the address is in base58 format.

Response

200OK

HTTP 200 response for getapprovedlist. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get approved list

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/getapprovedlist' \
  -H 'Content-Type: application/json' \
  -d '{
    "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
    "visible": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/getapprovedlist', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
      "visible": true
    }),
});

const data = await response.json();

import requests

payload = {
  "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
  "visible": True
}

response = requests.post('https://trx-blockbook.nownodes.io/wallet/getapprovedlist', json=payload)
data = response.json()

Request Body

{
  "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
  "visible": true
}

{
  "result": true,
  "blockID": "000000000502e9686b96165061a0c1deaa8818cb4c2950a60d0d713865b106d3"
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Resources

Resources operations.

Get account resource information

POST

https://trx-blockbook.nownodes.io/wallet/getaccountresource

Returns comprehensive resource information for an account including energy, bandwidth, frozen balances, and delegation details for both bandwidth and energy.

Body

application/json

Request value.

addressstringrequired

The account address in base58 format.

visibleboolean

Whether the address is in base58 format.

Response

200OK

HTTP 200 response for getaccountresource. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get account resource information

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/getaccountresource' \
  -H 'Content-Type: application/json' \
  -d '{
    "address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
    "visible": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/getaccountresource', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
      "visible": true
    }),
});

const data = await response.json();

import requests

payload = {
  "address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
  "visible": True
}

response = requests.post('https://trx-blockbook.nownodes.io/wallet/getaccountresource', json=payload)
data = response.json()

Request Body

{
  "address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
  "visible": true
}

{
  "size": 12
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Get account network information

POST

https://trx-blockbook.nownodes.io/wallet/getaccountnet

Returns network resource information for an account including bandwidth usage and limits. Focuses specifically on bandwidth-related resources.

Body

application/json

Request value.

addressstringrequired

The account address in base58 format.

visibleboolean

Whether the address is in base58 format.

Response

200OK

HTTP 200 response for getaccountnet. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get account network information

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/getaccountnet' \
  -H 'Content-Type: application/json' \
  -d '{
    "address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
    "visible": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/getaccountnet', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
      "visible": true
    }),
});

const data = await response.json();

import requests

payload = {
  "address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
  "visible": True
}

response = requests.post('https://trx-blockbook.nownodes.io/wallet/getaccountnet', json=payload)
data = response.json()

Request Body

{
  "address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
  "visible": true
}

{
  "size": 12
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Unfreeze balance

POST

https://trx-blockbook.nownodes.io/wallet/unfreezebalance

Unfreezes previously frozen TRX balance for bandwidth or energy. Frozen balances have a minimum freeze period and can be unfrozen after this period. This operation requires a fee and must be signed and broadcast.

Body

application/json

Request value.

owner_addressstringrequired

The account owner address in base58 format.

resourcestringBANDWIDTHENERGY

The resource type to unfreeze. BANDWIDTH - for bandwidth resources ENERGY - for energy resources

receiver_addressstring

Optional receiver address for delegated resources. If provided, unfreezes delegated resources.

visibleboolean

Whether addresses are in base58 format.

Response

200OK

HTTP 200 response for unfreezebalance. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Unfreeze balance

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/unfreezebalance' \
  -H 'Content-Type: application/json' \
  -d '{
    "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
    "resource": "BANDWIDTH",
    "receiver_address": "TFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF",
    "visible": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/unfreezebalance', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
      "resource": "BANDWIDTH",
      "receiver_address": "TFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF",
      "visible": true
    }),
});

const data = await response.json();

import requests

payload = {
  "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
  "resource": "BANDWIDTH",
  "receiver_address": "TFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF",
  "visible": True
}

response = requests.post('https://trx-blockbook.nownodes.io/wallet/unfreezebalance', json=payload)
data = response.json()

Request Body

{
  "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
  "resource": "BANDWIDTH",
  "receiver_address": "TFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF",
  "visible": true
}

{
  "txID": "aaeb5bfd0d5f5a4ba8c825bdc8bc6f6ceaec896f11f31c1374d9285dc0c12906",
  "raw_data": {
    "contract": [
      {
        "parameter": {
          "value": {
            "amount": 7,
            "owner_address": "41A614F803B6FD780986A42C78EC9C7F77E6DED13C",
            "to_address": "41ac27ae19688035bf9b3f5f3baa488315f157770a"
          },
          "type_url": "type.googleapis.com/protocol.TransferContract"
        },
        "type": "TransferContract"
      }
    ],
    "ref_block_bytes": "e956",
    "ref_block_hash": "b0413c405002bec9",
    "expiration": 1782900528000,
    "timestamp": 1782900471309
  },
  "raw_data_hex": "0a02e9562208b0413c405002bec94080a79ce9f1335a65080112610a2d747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e5472616e73666572436f6e747261637412300a15413e715d653654406b1707aa6dda01b43f8acadfe6121541ac27ae19688035bf9b3f5f3baa488315f157770a1807"
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Get delegated resource

POST

https://trx-blockbook.nownodes.io/wallet/getdelegatedresource

Returns information about resources delegated from one account to another. Shows both bandwidth and energy delegation details.

Body

application/json

Request value.

fromAddressstringrequired

The delegator address in base58 format.

toAddressstringrequired

The delegatee address in base58 format.

visibleboolean

Whether addresses are in base58 format.

Response

200OK

HTTP 200 response for getdelegatedresource. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get delegated resource

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/getdelegatedresource' \
  -H 'Content-Type: application/json' \
  -d '{
    "fromAddress": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
    "toAddress": "TFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF",
    "visible": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/getdelegatedresource', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "fromAddress": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
      "toAddress": "TFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF",
      "visible": true
    }),
});

const data = await response.json();

import requests

payload = {
  "fromAddress": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
  "toAddress": "TFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF",
  "visible": True
}

response = requests.post('https://trx-blockbook.nownodes.io/wallet/getdelegatedresource', json=payload)
data = response.json()

Request Body

{
  "fromAddress": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
  "toAddress": "TFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF",
  "visible": true
}

{
  "txID": "aaeb5bfd0d5f5a4ba8c825bdc8bc6f6ceaec896f11f31c1374d9285dc0c12906",
  "raw_data": {
    "contract": [
      {
        "parameter": {
          "value": {
            "amount": 7,
            "owner_address": "41A614F803B6FD780986A42C78EC9C7F77E6DED13C",
            "to_address": "41ac27ae19688035bf9b3f5f3baa488315f157770a"
          },
          "type_url": "type.googleapis.com/protocol.TransferContract"
        },
        "type": "TransferContract"
      }
    ],
    "ref_block_bytes": "e956",
    "ref_block_hash": "b0413c405002bec9",
    "expiration": 1782900528000,
    "timestamp": 1782900471309
  },
  "raw_data_hex": "0a02e9562208b0413c405002bec94080a79ce9f1335a65080112610a2d747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e5472616e73666572436f6e747261637412300a15413e715d653654406b1707aa6dda01b43f8acadfe6121541ac27ae19688035bf9b3f5f3baa488315f157770a1807"
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Get delegated resource account index

POST

https://trx-blockbook.nownodes.io/wallet/getdelegatedresourceaccountindex

Returns the delegated resource account index showing all delegation relationships for an account. Shows both incoming and outgoing delegations.

Body

application/json

Request value.

valuestringrequired

The account address in base58 format.

visibleboolean

Whether the address is in base58 format.

Response

200OK

HTTP 200 response for getdelegatedresourceaccountindex. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get delegated resource account index

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/getdelegatedresourceaccountindex' \
  -H 'Content-Type: application/json' \
  -d '{
    "value": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
    "visible": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/getdelegatedresourceaccountindex', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "value": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
      "visible": true
    }),
});

const data = await response.json();

import requests

payload = {
  "value": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
  "visible": True
}

response = requests.post('https://trx-blockbook.nownodes.io/wallet/getdelegatedresourceaccountindex', json=payload)
data = response.json()

Request Body

{
  "value": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
  "visible": true
}

{
  "size": 12
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Freeze balance V2

POST

https://trx-blockbook.nownodes.io/wallet/freezebalancev2

Freezes TRX balance to obtain resources (bandwidth or energy) in the new resource model. This is the updated version of freeze balance with improved resource management. The frozen balance contributes to the account's resource limits.

Body

application/json

Request value.

owner_addressstringrequired

The account owner address in base58 format.

frozen_balanceinteger<int64>required

The amount of TRX to freeze in SUN.

resourcestringBANDWIDTHENERGYrequired

The resource type to obtain. BANDWIDTH - for bandwidth resources ENERGY - for energy resources

visibleboolean

Whether the address is in base58 format.

Response

200OK

HTTP 200 response for freezebalancev2. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Freeze balance V2

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/freezebalancev2' \
  -H 'Content-Type: application/json' \
  -d '{
    "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
    "frozen_balance": 100000000,
    "resource": "BANDWIDTH",
    "visible": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/freezebalancev2', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
      "frozen_balance": 100000000,
      "resource": "BANDWIDTH",
      "visible": true
    }),
});

const data = await response.json();

import requests

payload = {
  "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
  "frozen_balance": 100000000,
  "resource": "BANDWIDTH",
  "visible": True
}

response = requests.post('https://trx-blockbook.nownodes.io/wallet/freezebalancev2', json=payload)
data = response.json()

Request Body

{
  "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
  "frozen_balance": 100000000,
  "resource": "BANDWIDTH",
  "visible": true
}

{
  "txID": "aaeb5bfd0d5f5a4ba8c825bdc8bc6f6ceaec896f11f31c1374d9285dc0c12906",
  "raw_data": {
    "contract": [
      {
        "parameter": {
          "value": {
            "amount": 7,
            "owner_address": "41A614F803B6FD780986A42C78EC9C7F77E6DED13C",
            "to_address": "41ac27ae19688035bf9b3f5f3baa488315f157770a"
          },
          "type_url": "type.googleapis.com/protocol.TransferContract"
        },
        "type": "TransferContract"
      }
    ],
    "ref_block_bytes": "e956",
    "ref_block_hash": "b0413c405002bec9",
    "expiration": 1782900528000,
    "timestamp": 1782900471309
  },
  "raw_data_hex": "0a02e9562208b0413c405002bec94080a79ce9f1335a65080112610a2d747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e5472616e73666572436f6e747261637412300a15413e715d653654406b1707aa6dda01b43f8acadfe6121541ac27ae19688035bf9b3f5f3baa488315f157770a1807"
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Unfreeze balance V2

POST

https://trx-blockbook.nownodes.io/wallet/unfreezebalancev2

Unfreezes previously frozen TRX balance in the new resource model. Allows unfreezing specific amounts of frozen balance for bandwidth or energy.

Body

application/json

Request value.

owner_addressstringrequired

The account owner address in base58 format.

resourcestringBANDWIDTHENERGYrequired

The resource type to unfreeze. BANDWIDTH - for bandwidth resources ENERGY - for energy resources

unfreeze_balanceinteger<int64>required

The amount of TRX to unfreeze in SUN.

visibleboolean

Whether the address is in base58 format.

Response

200OK

HTTP 200 response for unfreezebalancev2. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Unfreeze balance V2

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/unfreezebalancev2' \
  -H 'Content-Type: application/json' \
  -d '{
    "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
    "resource": "BANDWIDTH",
    "unfreeze_balance": 50000000,
    "visible": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/unfreezebalancev2', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
      "resource": "BANDWIDTH",
      "unfreeze_balance": 50000000,
      "visible": true
    }),
});

const data = await response.json();

import requests

payload = {
  "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
  "resource": "BANDWIDTH",
  "unfreeze_balance": 50000000,
  "visible": True
}

response = requests.post('https://trx-blockbook.nownodes.io/wallet/unfreezebalancev2', json=payload)
data = response.json()

Request Body

{
  "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
  "resource": "BANDWIDTH",
  "unfreeze_balance": 50000000,
  "visible": true
}

{
  "txID": "aaeb5bfd0d5f5a4ba8c825bdc8bc6f6ceaec896f11f31c1374d9285dc0c12906",
  "raw_data": {
    "contract": [
      {
        "parameter": {
          "value": {
            "amount": 7,
            "owner_address": "41A614F803B6FD780986A42C78EC9C7F77E6DED13C",
            "to_address": "41ac27ae19688035bf9b3f5f3baa488315f157770a"
          },
          "type_url": "type.googleapis.com/protocol.TransferContract"
        },
        "type": "TransferContract"
      }
    ],
    "ref_block_bytes": "e956",
    "ref_block_hash": "b0413c405002bec9",
    "expiration": 1782900528000,
    "timestamp": 1782900471309
  },
  "raw_data_hex": "0a02e9562208b0413c405002bec94080a79ce9f1335a65080112610a2d747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e5472616e73666572436f6e747261637412300a15413e715d653654406b1707aa6dda01b43f8acadfe6121541ac27ae19688035bf9b3f5f3baa488315f157770a1807"
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Cancel all unfreeze V2

POST

https://trx-blockbook.nownodes.io/wallet/cancelallunfreezev2

Cancels all pending unfreeze operations for an account in the new resource model. This prevents scheduled unfreezes from occurring.

Body

application/json

Request value.

owner_addressstringrequired

The account owner address in base58 format.

visibleboolean

Whether the address is in base58 format.

Response

200OK

HTTP 200 response for cancelallunfreezev2. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Cancel all unfreeze V2

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/cancelallunfreezev2' \
  -H 'Content-Type: application/json' \
  -d '{
    "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
    "visible": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/cancelallunfreezev2', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
      "visible": true
    }),
});

const data = await response.json();

import requests

payload = {
  "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
  "visible": True
}

response = requests.post('https://trx-blockbook.nownodes.io/wallet/cancelallunfreezev2', json=payload)
data = response.json()

Request Body

{
  "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
  "visible": true
}

{
  "txID": "aaeb5bfd0d5f5a4ba8c825bdc8bc6f6ceaec896f11f31c1374d9285dc0c12906",
  "raw_data": {
    "contract": [
      {
        "parameter": {
          "value": {
            "amount": 7,
            "owner_address": "41A614F803B6FD780986A42C78EC9C7F77E6DED13C",
            "to_address": "41ac27ae19688035bf9b3f5f3baa488315f157770a"
          },
          "type_url": "type.googleapis.com/protocol.TransferContract"
        },
        "type": "TransferContract"
      }
    ],
    "ref_block_bytes": "e956",
    "ref_block_hash": "b0413c405002bec9",
    "expiration": 1782900528000,
    "timestamp": 1782900471309
  },
  "raw_data_hex": "0a02e9562208b0413c405002bec94080a79ce9f1335a65080112610a2d747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e5472616e73666572436f6e747261637412300a15413e715d653654406b1707aa6dda01b43f8acadfe6121541ac27ae19688035bf9b3f5f3baa488315f157770a1807"
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Delegate resource

POST

https://trx-blockbook.nownodes.io/wallet/delegateresource

Delegates resources (bandwidth or energy) to another account. The delegator freezes TRX and the delegatee can use the corresponding resources.

Body

application/json

Request value.

owner_addressstringrequired

The delegator address in base58 format.

resourcestringBANDWIDTHENERGYrequired

The resource type to delegate. BANDWIDTH - for bandwidth resources ENERGY - for energy resources

balanceinteger<int64>required

The amount of TRX to freeze and delegate in SUN.

receiver_addressstringrequired

The delegatee address in base58 format.

lockboolean

Whether to lock the delegation (cannot be undelegated until expiration).

visibleboolean

Whether addresses are in base58 format.

Response

200OK

HTTP 200 response for delegateresource. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Delegate resource

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/delegateresource' \
  -H 'Content-Type: application/json' \
  -d '{
    "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
    "resource": "BANDWIDTH",
    "balance": 100000000,
    "receiver_address": "TFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF",
    "lock": false,
    "visible": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/delegateresource', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
      "resource": "BANDWIDTH",
      "balance": 100000000,
      "receiver_address": "TFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF",
      "lock": false,
      "visible": true
    }),
});

const data = await response.json();

import requests

payload = {
  "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
  "resource": "BANDWIDTH",
  "balance": 100000000,
  "receiver_address": "TFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF",
  "lock": False,
  "visible": True
}

response = requests.post('https://trx-blockbook.nownodes.io/wallet/delegateresource', json=payload)
data = response.json()

Request Body

{
  "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
  "resource": "BANDWIDTH",
  "balance": 100000000,
  "receiver_address": "TFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF",
  "lock": false,
  "visible": true
}

{
  "txID": "aaeb5bfd0d5f5a4ba8c825bdc8bc6f6ceaec896f11f31c1374d9285dc0c12906",
  "raw_data": {
    "contract": [
      {
        "parameter": {
          "value": {
            "amount": 7,
            "owner_address": "41A614F803B6FD780986A42C78EC9C7F77E6DED13C",
            "to_address": "41ac27ae19688035bf9b3f5f3baa488315f157770a"
          },
          "type_url": "type.googleapis.com/protocol.TransferContract"
        },
        "type": "TransferContract"
      }
    ],
    "ref_block_bytes": "e956",
    "ref_block_hash": "b0413c405002bec9",
    "expiration": 1782900528000,
    "timestamp": 1782900471309
  },
  "raw_data_hex": "0a02e9562208b0413c405002bec94080a79ce9f1335a65080112610a2d747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e5472616e73666572436f6e747261637412300a15413e715d653654406b1707aa6dda01b43f8acadfe6121541ac27ae19688035bf9b3f5f3baa488315f157770a1807"
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Undelegate resource

POST

https://trx-blockbook.nownodes.io/wallet/undelegateresource

Undelegates previously delegated resources. This starts the unfreeze process for delegated resources.

Body

application/json

Request value.

owner_addressstringrequired

The delegator address in base58 format.

resourcestringBANDWIDTHENERGYrequired

The resource type to undelegate. BANDWIDTH - for bandwidth resources ENERGY - for energy resources

balanceinteger<int64>required

The amount of TRX to undelegate in SUN.

receiver_addressstringrequired

The delegatee address in base58 format.

visibleboolean

Whether addresses are in base58 format.

Response

200OK

HTTP 200 response for undelegateresource. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Undelegate resource

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/undelegateresource' \
  -H 'Content-Type: application/json' \
  -d '{
    "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
    "resource": "BANDWIDTH",
    "balance": 100000000,
    "receiver_address": "TFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF",
    "visible": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/undelegateresource', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
      "resource": "BANDWIDTH",
      "balance": 100000000,
      "receiver_address": "TFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF",
      "visible": true
    }),
});

const data = await response.json();

import requests

payload = {
  "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
  "resource": "BANDWIDTH",
  "balance": 100000000,
  "receiver_address": "TFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF",
  "visible": True
}

response = requests.post('https://trx-blockbook.nownodes.io/wallet/undelegateresource', json=payload)
data = response.json()

Request Body

{
  "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
  "resource": "BANDWIDTH",
  "balance": 100000000,
  "receiver_address": "TFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF",
  "visible": true
}

{
  "txID": "aaeb5bfd0d5f5a4ba8c825bdc8bc6f6ceaec896f11f31c1374d9285dc0c12906",
  "raw_data": {
    "contract": [
      {
        "parameter": {
          "value": {
            "amount": 7,
            "owner_address": "41A614F803B6FD780986A42C78EC9C7F77E6DED13C",
            "to_address": "41ac27ae19688035bf9b3f5f3baa488315f157770a"
          },
          "type_url": "type.googleapis.com/protocol.TransferContract"
        },
        "type": "TransferContract"
      }
    ],
    "ref_block_bytes": "e956",
    "ref_block_hash": "b0413c405002bec9",
    "expiration": 1782900528000,
    "timestamp": 1782900471309
  },
  "raw_data_hex": "0a02e9562208b0413c405002bec94080a79ce9f1335a65080112610a2d747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e5472616e73666572436f6e747261637412300a15413e715d653654406b1707aa6dda01b43f8acadfe6121541ac27ae19688035bf9b3f5f3baa488315f157770a1807"
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Withdraw expire unfreeze

POST

https://trx-blockbook.nownodes.io/wallet/withdrawexpireunfreeze

Withdraws unfrozen TRX that has completed the unfreeze period. After unfreezing balance, there is a waiting period before it can be withdrawn.

Body

application/json

Request value.

owner_addressstringrequired

The account owner address in base58 format.

visibleboolean

Whether the address is in base58 format.

Response

200OK

HTTP 200 response for withdrawexpireunfreeze. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Withdraw expire unfreeze

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/withdrawexpireunfreeze' \
  -H 'Content-Type: application/json' \
  -d '{
    "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
    "visible": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/withdrawexpireunfreeze', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
      "visible": true
    }),
});

const data = await response.json();

import requests

payload = {
  "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
  "visible": True
}

response = requests.post('https://trx-blockbook.nownodes.io/wallet/withdrawexpireunfreeze', json=payload)
data = response.json()

Request Body

{
  "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
  "visible": true
}

{
  "txID": "aaeb5bfd0d5f5a4ba8c825bdc8bc6f6ceaec896f11f31c1374d9285dc0c12906",
  "raw_data": {
    "contract": [
      {
        "parameter": {
          "value": {
            "amount": 7,
            "owner_address": "41A614F803B6FD780986A42C78EC9C7F77E6DED13C",
            "to_address": "41ac27ae19688035bf9b3f5f3baa488315f157770a"
          },
          "type_url": "type.googleapis.com/protocol.TransferContract"
        },
        "type": "TransferContract"
      }
    ],
    "ref_block_bytes": "e956",
    "ref_block_hash": "b0413c405002bec9",
    "expiration": 1782900528000,
    "timestamp": 1782900471309
  },
  "raw_data_hex": "0a02e9562208b0413c405002bec94080a79ce9f1335a65080112610a2d747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e5472616e73666572436f6e747261637412300a15413e715d653654406b1707aa6dda01b43f8acadfe6121541ac27ae19688035bf9b3f5f3baa488315f157770a1807"
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Get available unfreeze count

POST

https://trx-blockbook.nownodes.io/wallet/getavailableunfreezecount

Returns the number of available unfreeze operations for an account. There are limits on how many times an account can unfreeze balance within a period.

Body

application/json

Request value.

owner_addressstringrequired

The account owner address in base58 format.

visibleboolean

Whether the address is in base58 format.

Response

200OK

HTTP 200 response for getavailableunfreezecount. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get available unfreeze count

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/getavailableunfreezecount' \
  -H 'Content-Type: application/json' \
  -d '{
    "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
    "visible": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/getavailableunfreezecount', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
      "visible": true
    }),
});

const data = await response.json();

import requests

payload = {
  "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
  "visible": True
}

response = requests.post('https://trx-blockbook.nownodes.io/wallet/getavailableunfreezecount', json=payload)
data = response.json()

Request Body

{
  "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
  "visible": true
}

{
  "size": 12
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Get can withdraw unfreeze amount

POST

https://trx-blockbook.nownodes.io/wallet/getcanwithdrawunfreezeamount

Returns the amount of TRX that can be withdrawn from unfrozen balance. Shows the available amount that has completed the unfreeze waiting period.

Body

application/json

Request value.

owner_addressstringrequired

The account owner address in base58 format.

visibleboolean

Whether the address is in base58 format.

Response

200OK

HTTP 200 response for getcanwithdrawunfreezeamount. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get can withdraw unfreeze amount

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/getcanwithdrawunfreezeamount' \
  -H 'Content-Type: application/json' \
  -d '{
    "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
    "visible": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/getcanwithdrawunfreezeamount', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
      "visible": true
    }),
});

const data = await response.json();

import requests

payload = {
  "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
  "visible": True
}

response = requests.post('https://trx-blockbook.nownodes.io/wallet/getcanwithdrawunfreezeamount', json=payload)
data = response.json()

Request Body

{
  "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
  "visible": true
}

{
  "txID": "aaeb5bfd0d5f5a4ba8c825bdc8bc6f6ceaec896f11f31c1374d9285dc0c12906",
  "raw_data": {
    "contract": [
      {
        "parameter": {
          "value": {
            "amount": 7,
            "owner_address": "41A614F803B6FD780986A42C78EC9C7F77E6DED13C",
            "to_address": "41ac27ae19688035bf9b3f5f3baa488315f157770a"
          },
          "type_url": "type.googleapis.com/protocol.TransferContract"
        },
        "type": "TransferContract"
      }
    ],
    "ref_block_bytes": "e956",
    "ref_block_hash": "b0413c405002bec9",
    "expiration": 1782900528000,
    "timestamp": 1782900471309
  },
  "raw_data_hex": "0a02e9562208b0413c405002bec94080a79ce9f1335a65080112610a2d747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e5472616e73666572436f6e747261637412300a15413e715d653654406b1707aa6dda01b43f8acadfe6121541ac27ae19688035bf9b3f5f3baa488315f157770a1807"
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Get can delegated max size

POST

https://trx-blockbook.nownodes.io/wallet/getcandelegatedmaxsize

Returns the maximum amount of resources that can be delegated to a specific account. Takes into account the delegator's frozen balance and network limits.

Body

application/json

Request value.

owner_addressstringrequired

The delegator address in base58 format.

typeinteger01required

The resource type. 0 - for bandwidth resources 1 - for energy resources

visibleboolean

Whether the address is in base58 format.

Response

200OK

HTTP 200 response for getcandelegatedmaxsize. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get can delegated max size

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/getcandelegatedmaxsize' \
  -H 'Content-Type: application/json' \
  -d '{
    "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
    "type": 0,
    "visible": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/getcandelegatedmaxsize', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
      "type": 0,
      "visible": true
    }),
});

const data = await response.json();

import requests

payload = {
  "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
  "type": 0,
  "visible": True
}

response = requests.post('https://trx-blockbook.nownodes.io/wallet/getcandelegatedmaxsize', json=payload)
data = response.json()

Request Body

{
  "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
  "type": 0,
  "visible": true
}

{
  "txID": "aaeb5bfd0d5f5a4ba8c825bdc8bc6f6ceaec896f11f31c1374d9285dc0c12906",
  "raw_data": {
    "contract": [
      {
        "parameter": {
          "value": {
            "amount": 7,
            "owner_address": "41A614F803B6FD780986A42C78EC9C7F77E6DED13C",
            "to_address": "41ac27ae19688035bf9b3f5f3baa488315f157770a"
          },
          "type_url": "type.googleapis.com/protocol.TransferContract"
        },
        "type": "TransferContract"
      }
    ],
    "ref_block_bytes": "e956",
    "ref_block_hash": "b0413c405002bec9",
    "expiration": 1782900528000,
    "timestamp": 1782900471309
  },
  "raw_data_hex": "0a02e9562208b0413c405002bec94080a79ce9f1335a65080112610a2d747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e5472616e73666572436f6e747261637412300a15413e715d653654406b1707aa6dda01b43f8acadfe6121541ac27ae19688035bf9b3f5f3baa488315f157770a1807"
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Get delegated resource V2

POST

https://trx-blockbook.nownodes.io/wallet/getdelegatedresourcev2

Returns detailed information about delegated resources in the new resource model. Shows delegation details for both bandwidth and energy with enhanced information.

Body

application/json

Request value.

fromAddressstringrequired

The delegator address in base58 format.

toAddressstringrequired

The delegatee address in base58 format.

visibleboolean

Whether addresses are in base58 format.

Response

200OK

HTTP 200 response for getdelegatedresourcev2. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get delegated resource V2

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/getdelegatedresourcev2' \
  -H 'Content-Type: application/json' \
  -d '{
    "fromAddress": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
    "toAddress": "TFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF",
    "visible": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/getdelegatedresourcev2', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "fromAddress": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
      "toAddress": "TFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF",
      "visible": true
    }),
});

const data = await response.json();

import requests

payload = {
  "fromAddress": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
  "toAddress": "TFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF",
  "visible": True
}

response = requests.post('https://trx-blockbook.nownodes.io/wallet/getdelegatedresourcev2', json=payload)
data = response.json()

Request Body

{
  "fromAddress": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
  "toAddress": "TFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF",
  "visible": true
}

{
  "txID": "aaeb5bfd0d5f5a4ba8c825bdc8bc6f6ceaec896f11f31c1374d9285dc0c12906",
  "raw_data": {
    "contract": [
      {
        "parameter": {
          "value": {
            "amount": 7,
            "owner_address": "41A614F803B6FD780986A42C78EC9C7F77E6DED13C",
            "to_address": "41ac27ae19688035bf9b3f5f3baa488315f157770a"
          },
          "type_url": "type.googleapis.com/protocol.TransferContract"
        },
        "type": "TransferContract"
      }
    ],
    "ref_block_bytes": "e956",
    "ref_block_hash": "b0413c405002bec9",
    "expiration": 1782900528000,
    "timestamp": 1782900471309
  },
  "raw_data_hex": "0a02e9562208b0413c405002bec94080a79ce9f1335a65080112610a2d747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e5472616e73666572436f6e747261637412300a15413e715d653654406b1707aa6dda01b43f8acadfe6121541ac27ae19688035bf9b3f5f3baa488315f157770a1807"
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Get delegated resource account index V2

POST

https://trx-blockbook.nownodes.io/wallet/getdelegatedresourceaccountindexv2

Returns the delegated resource account index in the new resource model. Shows comprehensive delegation relationships with enhanced details.

Body

application/json

Request value.

valuestringrequired

The account address in base58 format.

visibleboolean

Whether the address is in base58 format.

Response

200OK

HTTP 200 response for getdelegatedresourceaccountindexv2. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get delegated resource account index V2

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/getdelegatedresourceaccountindexv2' \
  -H 'Content-Type: application/json' \
  -d '{
    "value": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
    "visible": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/getdelegatedresourceaccountindexv2', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "value": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
      "visible": true
    }),
});

const data = await response.json();

import requests

payload = {
  "value": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
  "visible": True
}

response = requests.post('https://trx-blockbook.nownodes.io/wallet/getdelegatedresourceaccountindexv2', json=payload)
data = response.json()

Request Body

{
  "value": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
  "visible": true
}

{
  "size": 12
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Query the Network

Query the Network operations.

Get current block

POST

https://trx-blockbook.nownodes.io/wallet/getnowblock

Returns the most recent block that has been added to the blockchain. This provides real-time access to the latest block information.

Body

application/json

No parameters required for this endpoint.

object

Response

200OK

HTTP 200 response for getnowblock. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get current block

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/getnowblock' \
  -H 'Content-Type: application/json' \
  -d '"request_example"'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/getnowblock', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify("request_example"),
});

const data = await response.json();

import requests

payload = "request_example"

response = requests.post('https://trx-blockbook.nownodes.io/wallet/getnowblock', json=payload)
data = response.json()

Request Body

"request_example"

{
  "blockID": "000000000502e9686b96165061a0c1deaa8818cb4c2950a60d0d713865b106d3",
  "block_header": {
    "raw_data": {
      "number": 84076904,
      "txTrieRoot": "2Zh5uiwkHw6fRtdxtEdE7GKjfZbZ5VhjtJXK9F6FpoJUK3oLXY",
      "witness_address": "TGyrSc9ZmTdbYziuk1SKEmdtCdETafewJ9",
      "parentHash": "000000000502e9672a443fb644045f8f397e84a212750096eb0bbb0ed563e389",
      "version": 35,
      "timestamp": 1782900468000
    },
    "witness_signature": "2b7c8962776874363cd645f8c36cdf9427d8163e8d8c5e827d5bcc7db64351d25dfc5b67183be748e264995649ecf1cc05c254eca694472a9fb73522951fff2601"
  },
  "transactions": [
    {
      "ret": [
        {
          "contractRet": "SUCCESS"
        }
      ],
      "txID": "aaeb5bfd0d5f5a4ba8c825bdc8bc6f6ceaec896f11f31c1374d9285dc0c12906",
      "raw_data": {
        "contract": [
          {
            "type": "TransferContract",
            "parameter": {
              "type_url": "type.googleapis.com/protocol.TransferContract",
              "value": {
                "amount": 7,
                "owner_address": "413e715d653654406b1707aa6dda01b43f8acadfe6",
                "to_address": "41ac27ae19688035bf9b3f5f3baa488315f157770a"
              }
            }
          }
        ],
        "ref_block_bytes": "e956",
        "ref_block_hash": "b0413c405002bec9",
        "expiration": 1782900528000,
        "timestamp": 1782900471309
      },
      "raw_data_hex": "0a02e9562208b0413c405002bec94080a79ce9f1335a65080112610a2d747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e5472616e73666572436f6e747261637412300a15413e715d653654406b1707aa6dda01b43f8acadfe6121541ac27ae19688035bf9b3f5f3baa488315f157770a1802708dec98e9f133"
    }
  ]
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Get block by ID or number

POST

https://trx-blockbook.nownodes.io/wallet/getblock

Returns a specific block by either its block ID (hash) or block number. Only one of id_or_num parameters should be provided.

Body

application/json

Request value.

id_or_numstring

The block ID (hash) or block number as string. Can be either hex hash or numeric string.

detailboolean

Whether to include full transaction details. If false, only transaction IDs are returned.

Response

200OK

HTTP 200 response for getblock. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get block by ID or number

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/getblock' \
  -H 'Content-Type: application/json' \
  -d '{
    "id_or_num": "12345678",
    "detail": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/getblock', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "id_or_num": "12345678",
      "detail": true
    }),
});

const data = await response.json();

import requests

payload = {
  "id_or_num": "12345678",
  "detail": True
}

response = requests.post('https://trx-blockbook.nownodes.io/wallet/getblock', json=payload)
data = response.json()

Request Body

{
  "id_or_num": "12345678",
  "detail": true
}

{
  "blockID": "000000000502e9686b96165061a0c1deaa8818cb4c2950a60d0d713865b106d3",
  "block_header": {
    "raw_data": {
      "number": 84076904,
      "txTrieRoot": "2Zh5uiwkHw6fRtdxtEdE7GKjfZbZ5VhjtJXK9F6FpoJUK3oLXY",
      "witness_address": "TGyrSc9ZmTdbYziuk1SKEmdtCdETafewJ9",
      "parentHash": "000000000502e9672a443fb644045f8f397e84a212750096eb0bbb0ed563e389",
      "version": 35,
      "timestamp": 1782900468000
    },
    "witness_signature": "2b7c8962776874363cd645f8c36cdf9427d8163e8d8c5e827d5bcc7db64351d25dfc5b67183be748e264995649ecf1cc05c254eca694472a9fb73522951fff2601"
  },
  "transactions": [
    {
      "ret": [
        {
          "contractRet": "SUCCESS"
        }
      ],
      "txID": "aaeb5bfd0d5f5a4ba8c825bdc8bc6f6ceaec896f11f31c1374d9285dc0c12906",
      "raw_data": {
        "contract": [
          {
            "type": "TransferContract",
            "parameter": {
              "type_url": "type.googleapis.com/protocol.TransferContract",
              "value": {
                "amount": 7,
                "owner_address": "413e715d653654406b1707aa6dda01b43f8acadfe6",
                "to_address": "41ac27ae19688035bf9b3f5f3baa488315f157770a"
              }
            }
          }
        ],
        "ref_block_bytes": "e956",
        "ref_block_hash": "b0413c405002bec9",
        "expiration": 1782900528000,
        "timestamp": 1782900471309
      },
      "raw_data_hex": "0a02e9562208b0413c405002bec94080a79ce9f1335a65080112610a2d747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e5472616e73666572436f6e747261637412300a15413e715d653654406b1707aa6dda01b43f8acadfe6121541ac27ae19688035bf9b3f5f3baa488315f157770a1802708dec98e9f133"
    }
  ]
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Get block by number

POST

https://trx-blockbook.nownodes.io/wallet/getblockbynum

Returns a specific block by its block number (height). This is the preferred method for retrieving blocks by their sequence number.

Body

application/json

Request value.

numintegerrequired

The block number (height) to retrieve. Must be a valid block number that exists on the chain.

Response

200OK

HTTP 200 response for getblockbynum. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get block by number

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/getblockbynum' \
  -H 'Content-Type: application/json' \
  -d '{
    "num": 12345678
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/getblockbynum', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "num": 12345678
    }),
});

const data = await response.json();

import requests

payload = {
  "num": 12345678
}

response = requests.post('https://trx-blockbook.nownodes.io/wallet/getblockbynum', json=payload)
data = response.json()

Request Body

{
  "num": 12345678
}

{
  "blockID": "000000000502e9686b96165061a0c1deaa8818cb4c2950a60d0d713865b106d3",
  "block_header": {
    "raw_data": {
      "number": 84076904,
      "txTrieRoot": "2Zh5uiwkHw6fRtdxtEdE7GKjfZbZ5VhjtJXK9F6FpoJUK3oLXY",
      "witness_address": "TGyrSc9ZmTdbYziuk1SKEmdtCdETafewJ9",
      "parentHash": "000000000502e9672a443fb644045f8f397e84a212750096eb0bbb0ed563e389",
      "version": 35,
      "timestamp": 1782900468000
    },
    "witness_signature": "2b7c8962776874363cd645f8c36cdf9427d8163e8d8c5e827d5bcc7db64351d25dfc5b67183be748e264995649ecf1cc05c254eca694472a9fb73522951fff2601"
  },
  "transactions": [
    {
      "ret": [
        {
          "contractRet": "SUCCESS"
        }
      ],
      "txID": "aaeb5bfd0d5f5a4ba8c825bdc8bc6f6ceaec896f11f31c1374d9285dc0c12906",
      "raw_data": {
        "contract": [
          {
            "type": "TransferContract",
            "parameter": {
              "type_url": "type.googleapis.com/protocol.TransferContract",
              "value": {
                "amount": 7,
                "owner_address": "413e715d653654406b1707aa6dda01b43f8acadfe6",
                "to_address": "41ac27ae19688035bf9b3f5f3baa488315f157770a"
              }
            }
          }
        ],
        "ref_block_bytes": "e956",
        "ref_block_hash": "b0413c405002bec9",
        "expiration": 1782900528000,
        "timestamp": 1782900471309
      },
      "raw_data_hex": "0a02e9562208b0413c405002bec94080a79ce9f1335a65080112610a2d747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e5472616e73666572436f6e747261637412300a15413e715d653654406b1707aa6dda01b43f8acadfe6121541ac27ae19688035bf9b3f5f3baa488315f157770a1802708dec98e9f133"
    }
  ]
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Get block by ID

POST

https://trx-blockbook.nownodes.io/wallet/getblockbyid

Returns a specific block by its block ID (hash). Useful when you have the block hash but not the block number.

Body

application/json

Request value.

valuestringrequired

The block ID (hash) in hex format.

Response

200OK

HTTP 200 response for getblockbyid. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get block by ID

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/getblockbyid' \
  -H 'Content-Type: application/json' \
  -d '{
    "value": "0000000000035a98bf3cde4c71d98b62f5c4c5438a5c7b801e84c9e74f96d9e9"
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/getblockbyid', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "value": "0000000000035a98bf3cde4c71d98b62f5c4c5438a5c7b801e84c9e74f96d9e9"
    }),
});

const data = await response.json();

import requests

payload = {
  "value": "0000000000035a98bf3cde4c71d98b62f5c4c5438a5c7b801e84c9e74f96d9e9"
}

response = requests.post('https://trx-blockbook.nownodes.io/wallet/getblockbyid', json=payload)
data = response.json()

Request Body

{
  "value": "0000000000035a98bf3cde4c71d98b62f5c4c5438a5c7b801e84c9e74f96d9e9"
}

{
  "blockID": "000000000502e9686b96165061a0c1deaa8818cb4c2950a60d0d713865b106d3",
  "block_header": {
    "raw_data": {
      "number": 84076904,
      "txTrieRoot": "2Zh5uiwkHw6fRtdxtEdE7GKjfZbZ5VhjtJXK9F6FpoJUK3oLXY",
      "witness_address": "TGyrSc9ZmTdbYziuk1SKEmdtCdETafewJ9",
      "parentHash": "000000000502e9672a443fb644045f8f397e84a212750096eb0bbb0ed563e389",
      "version": 35,
      "timestamp": 1782900468000
    },
    "witness_signature": "2b7c8962776874363cd645f8c36cdf9427d8163e8d8c5e827d5bcc7db64351d25dfc5b67183be748e264995649ecf1cc05c254eca694472a9fb73522951fff2601"
  },
  "transactions": [
    {
      "ret": [
        {
          "contractRet": "SUCCESS"
        }
      ],
      "txID": "aaeb5bfd0d5f5a4ba8c825bdc8bc6f6ceaec896f11f31c1374d9285dc0c12906",
      "raw_data": {
        "contract": [
          {
            "type": "TransferContract",
            "parameter": {
              "type_url": "type.googleapis.com/protocol.TransferContract",
              "value": {
                "amount": 7,
                "owner_address": "413e715d653654406b1707aa6dda01b43f8acadfe6",
                "to_address": "41ac27ae19688035bf9b3f5f3baa488315f157770a"
              }
            }
          }
        ],
        "ref_block_bytes": "e956",
        "ref_block_hash": "b0413c405002bec9",
        "expiration": 1782900528000,
        "timestamp": 1782900471309
      },
      "raw_data_hex": "0a02e9562208b0413c405002bec94080a79ce9f1335a65080112610a2d747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e5472616e73666572436f6e747261637412300a15413e715d653654406b1707aa6dda01b43f8acadfe6121541ac27ae19688035bf9b3f5f3baa488315f157770a1802708dec98e9f133"
    }
  ]
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Get blocks by latest count

POST

https://trx-blockbook.nownodes.io/wallet/getblockbylatestnum

Returns the most recent N blocks from the current chain head. Useful for getting recent block history.

Body

application/json

Request value.

numintegerrequired

The number of recent blocks to retrieve. Maximum value may be limited by node configuration.

Response

200OK

HTTP 200 response for getblockbylatestnum. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get blocks by latest count

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/getblockbylatestnum' \
  -H 'Content-Type: application/json' \
  -d '{
    "num": 10
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/getblockbylatestnum', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "num": 10
    }),
});

const data = await response.json();

import requests

payload = {
  "num": 10
}

response = requests.post('https://trx-blockbook.nownodes.io/wallet/getblockbylatestnum', json=payload)
data = response.json()

Request Body

{
  "num": 10
}

{
  "blockID": "000000000502e9686b96165061a0c1deaa8818cb4c2950a60d0d713865b106d3",
  "block_header": {
    "raw_data": {
      "number": 84076904,
      "txTrieRoot": "2Zh5uiwkHw6fRtdxtEdE7GKjfZbZ5VhjtJXK9F6FpoJUK3oLXY",
      "witness_address": "TGyrSc9ZmTdbYziuk1SKEmdtCdETafewJ9",
      "parentHash": "000000000502e9672a443fb644045f8f397e84a212750096eb0bbb0ed563e389",
      "version": 35,
      "timestamp": 1782900468000
    },
    "witness_signature": "2b7c8962776874363cd645f8c36cdf9427d8163e8d8c5e827d5bcc7db64351d25dfc5b67183be748e264995649ecf1cc05c254eca694472a9fb73522951fff2601"
  },
  "transactions": [
    {
      "ret": [
        {
          "contractRet": "SUCCESS"
        }
      ],
      "txID": "aaeb5bfd0d5f5a4ba8c825bdc8bc6f6ceaec896f11f31c1374d9285dc0c12906",
      "raw_data": {
        "contract": [
          {
            "type": "TransferContract",
            "parameter": {
              "type_url": "type.googleapis.com/protocol.TransferContract",
              "value": {
                "amount": 7,
                "owner_address": "413e715d653654406b1707aa6dda01b43f8acadfe6",
                "to_address": "41ac27ae19688035bf9b3f5f3baa488315f157770a"
              }
            }
          }
        ],
        "ref_block_bytes": "e956",
        "ref_block_hash": "b0413c405002bec9",
        "expiration": 1782900528000,
        "timestamp": 1782900471309
      },
      "raw_data_hex": "0a02e9562208b0413c405002bec94080a79ce9f1335a65080112610a2d747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e5472616e73666572436f6e747261637412300a15413e715d653654406b1707aa6dda01b43f8acadfe6121541ac27ae19688035bf9b3f5f3baa488315f157770a1802708dec98e9f133"
    }
  ]
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Get blocks by range

POST

https://trx-blockbook.nownodes.io/wallet/getblockbylimitnext

Returns blocks within a specified range of block numbers. Useful for paginating through block history.

Body

application/json

Request value.

startNumintegerrequired

The starting block number (inclusive).

endNumintegerrequired

The ending block number (inclusive). Must be greater than or equal to startNum.

Response

200OK

HTTP 200 response for getblockbylimitnext. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get blocks by range

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/getblockbylimitnext' \
  -H 'Content-Type: application/json' \
  -d '{
    "startNum": 12345670,
    "endNum": 12345678
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/getblockbylimitnext', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "startNum": 12345670,
      "endNum": 12345678
    }),
});

const data = await response.json();

import requests

payload = {
  "startNum": 12345670,
  "endNum": 12345678
}

response = requests.post('https://trx-blockbook.nownodes.io/wallet/getblockbylimitnext', json=payload)
data = response.json()

Request Body

{
  "startNum": 12345670,
  "endNum": 12345678
}

{
  "blockID": "000000000502e9686b96165061a0c1deaa8818cb4c2950a60d0d713865b106d3",
  "block_header": {
    "raw_data": {
      "number": 84076904,
      "txTrieRoot": "2Zh5uiwkHw6fRtdxtEdE7GKjfZbZ5VhjtJXK9F6FpoJUK3oLXY",
      "witness_address": "TGyrSc9ZmTdbYziuk1SKEmdtCdETafewJ9",
      "parentHash": "000000000502e9672a443fb644045f8f397e84a212750096eb0bbb0ed563e389",
      "version": 35,
      "timestamp": 1782900468000
    },
    "witness_signature": "2b7c8962776874363cd645f8c36cdf9427d8163e8d8c5e827d5bcc7db64351d25dfc5b67183be748e264995649ecf1cc05c254eca694472a9fb73522951fff2601"
  },
  "transactions": [
    {
      "ret": [
        {
          "contractRet": "SUCCESS"
        }
      ],
      "txID": "aaeb5bfd0d5f5a4ba8c825bdc8bc6f6ceaec896f11f31c1374d9285dc0c12906",
      "raw_data": {
        "contract": [
          {
            "type": "TransferContract",
            "parameter": {
              "type_url": "type.googleapis.com/protocol.TransferContract",
              "value": {
                "amount": 7,
                "owner_address": "413e715d653654406b1707aa6dda01b43f8acadfe6",
                "to_address": "41ac27ae19688035bf9b3f5f3baa488315f157770a"
              }
            }
          }
        ],
        "ref_block_bytes": "e956",
        "ref_block_hash": "b0413c405002bec9",
        "expiration": 1782900528000,
        "timestamp": 1782900471309
      },
      "raw_data_hex": "0a02e9562208b0413c405002bec94080a79ce9f1335a65080112610a2d747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e5472616e73666572436f6e747261637412300a15413e715d653654406b1707aa6dda01b43f8acadfe6121541ac27ae19688035bf9b3f5f3baa488315f157770a1802708dec98e9f133"
    }
  ]
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Get block balance

POST

https://trx-blockbook.nownodes.io/wallet/getblockbalance

Returns balance information for a specific block. Shows the TRX balance changes and distributions at a particular block height.

Body

application/json

Request value.

block_identifierobjectrequired

Block identifier specifying which block to query.

Show child attributes

hashstring

Block hash

numberinteger

Block number

Response

200OK

HTTP 200 response for getblockbalance. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get block balance

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/getblockbalance' \
  -H 'Content-Type: application/json' \
  -d '{
    "block_identifier": {
      "hash": "hash_example",
      "number": 84076904
    }
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/getblockbalance', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "block_identifier": {
        "hash": "hash_example",
        "number": 84076904
      }
    }),
});

const data = await response.json();

import requests

payload = {
  "block_identifier": {
    "hash": "hash_example",
    "number": 84076904
  }
}

response = requests.post('https://trx-blockbook.nownodes.io/wallet/getblockbalance', json=payload)
data = response.json()

Request Body

{
  "block_identifier": {
    "hash": "hash_example",
    "number": 84076904
  }
}

{
  "blockID": "000000000502e9686b96165061a0c1deaa8818cb4c2950a60d0d713865b106d3",
  "block_header": {
    "raw_data": {
      "number": 84076904,
      "txTrieRoot": "2Zh5uiwkHw6fRtdxtEdE7GKjfZbZ5VhjtJXK9F6FpoJUK3oLXY",
      "witness_address": "TGyrSc9ZmTdbYziuk1SKEmdtCdETafewJ9",
      "parentHash": "000000000502e9672a443fb644045f8f397e84a212750096eb0bbb0ed563e389",
      "version": 35,
      "timestamp": 1782900468000
    },
    "witness_signature": "2b7c8962776874363cd645f8c36cdf9427d8163e8d8c5e827d5bcc7db64351d25dfc5b67183be748e264995649ecf1cc05c254eca694472a9fb73522951fff2601"
  },
  "transactions": [
    {
      "ret": [
        {
          "contractRet": "SUCCESS"
        }
      ],
      "txID": "aaeb5bfd0d5f5a4ba8c825bdc8bc6f6ceaec896f11f31c1374d9285dc0c12906",
      "raw_data": {
        "contract": [
          {
            "type": "TransferContract",
            "parameter": {
              "type_url": "type.googleapis.com/protocol.TransferContract",
              "value": {
                "amount": 7,
                "owner_address": "413e715d653654406b1707aa6dda01b43f8acadfe6",
                "to_address": "41ac27ae19688035bf9b3f5f3baa488315f157770a"
              }
            }
          }
        ],
        "ref_block_bytes": "e956",
        "ref_block_hash": "b0413c405002bec9",
        "expiration": 1782900528000,
        "timestamp": 1782900471309
      },
      "raw_data_hex": "0a02e9562208b0413c405002bec94080a79ce9f1335a65080112610a2d747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e5472616e73666572436f6e747261637412300a15413e715d653654406b1707aa6dda01b43f8acadfe6121541ac27ae19688035bf9b3f5f3baa488315f157770a1802708dec98e9f133"
    }
  ]
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Get transaction by ID

POST

https://trx-blockbook.nownodes.io/wallet/gettransactionbyid

Returns detailed information about a specific transaction by its transaction ID. Includes complete transaction data and metadata.

Body

application/json

Request value.

valuestringrequired

The transaction ID (hash) in hex format.

Response

200OK

HTTP 200 response for gettransactionbyid. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get transaction by ID

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/gettransactionbyid' \
  -H 'Content-Type: application/json' \
  -d '{
    "value": "a1b2c3d4e5f67890123456789012345678901234567890123456789012345678"
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/gettransactionbyid', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "value": "a1b2c3d4e5f67890123456789012345678901234567890123456789012345678"
    }),
});

const data = await response.json();

import requests

payload = {
  "value": "a1b2c3d4e5f67890123456789012345678901234567890123456789012345678"
}

response = requests.post('https://trx-blockbook.nownodes.io/wallet/gettransactionbyid', json=payload)
data = response.json()

Request Body

{
  "value": "a1b2c3d4e5f67890123456789012345678901234567890123456789012345678"
}

{
  "ret": [
    {
      "contractRet": "SUCCESS"
    }
  ],
  "signature": [
    "9ceb80179660af030bada0cd69e13ef73a91146b4c036c92e4b2389b6d66749d717ccf5af0f66d83bc7676d10f1682ac0aec596f4194d3b39d06922cade1452f00"
  ],
  "txID": "aaeb5bfd0d5f5a4ba8c825bdc8bc6f6ceaec896f11f31c1374d9285dc0c12906",
  "raw_data": {
    "contract": [
      {
        "parameter": {
          "value": {
            "amount": 7,
            "owner_address": "41A614F803B6FD780986A42C78EC9C7F77E6DED13C",
            "to_address": "41ac27ae19688035bf9b3f5f3baa488315f157770a"
          },
          "type_url": "type.googleapis.com/protocol.TransferContract"
        },
        "type": "TransferContract"
      }
    ],
    "ref_block_bytes": "e956",
    "ref_block_hash": "b0413c405002bec9",
    "expiration": 1782900528000,
    "timestamp": 1782900471309
  },
  "raw_data_hex": "0a02e9562208b0413c405002bec94080a79ce9f1335a65080112610a2d747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e5472616e73666572436f6e747261637412300a15413e715d653654406b1707aa6dda01b43f8acadfe6121541ac27ae19688035bf9b3f5f3baa488315f157770a1807"
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Get transaction information by ID

POST

https://trx-blockbook.nownodes.io/wallet/gettransactioninfobyid

Returns comprehensive information about a transaction including execution details, fee information, and resource usage. This provides more detailed information than gettransactionbyid.

Body

application/json

Request value.

valuestringrequired

The transaction ID (hash) in hex format.

Response

200OK

HTTP 200 response for gettransactioninfobyid. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get transaction information by ID

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/gettransactioninfobyid' \
  -H 'Content-Type: application/json' \
  -d '{
    "value": "a1b2c3d4e5f67890123456789012345678901234567890123456789012345678"
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/gettransactioninfobyid', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "value": "a1b2c3d4e5f67890123456789012345678901234567890123456789012345678"
    }),
});

const data = await response.json();

import requests

payload = {
  "value": "a1b2c3d4e5f67890123456789012345678901234567890123456789012345678"
}

response = requests.post('https://trx-blockbook.nownodes.io/wallet/gettransactioninfobyid', json=payload)
data = response.json()

Request Body

{
  "value": "a1b2c3d4e5f67890123456789012345678901234567890123456789012345678"
}

{
  "result": true,
  "blockID": "000000000502e9686b96165061a0c1deaa8818cb4c2950a60d0d713865b106d3"
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Get transaction count by block number

POST

https://trx-blockbook.nownodes.io/wallet/gettransactioncountbyblocknum

Returns the number of transactions in a specific block. Useful for analyzing block activity and network throughput.

Body

application/json

Request value.

numintegerrequired

The block number to query.

Response

200OK

HTTP 200 response for gettransactioncountbyblocknum. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get transaction count by block number

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/gettransactioncountbyblocknum' \
  -H 'Content-Type: application/json' \
  -d '{
    "num": 12345678
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/gettransactioncountbyblocknum', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "num": 12345678
    }),
});

const data = await response.json();

import requests

payload = {
  "num": 12345678
}

response = requests.post('https://trx-blockbook.nownodes.io/wallet/gettransactioncountbyblocknum', json=payload)
data = response.json()

Request Body

{
  "num": 12345678
}

{
  "transactionCount": 647
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Get transaction information by block number

POST

https://trx-blockbook.nownodes.io/wallet/gettransactioninfobyblocknum

Returns transaction information for all transactions in a specific block. Provides complete details for every transaction in the block.

Body

application/json

Request value.

numintegerrequired

The block number to query.

Response

200OK

HTTP 200 response for gettransactioninfobyblocknum. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get transaction information by block number

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/gettransactioninfobyblocknum' \
  -H 'Content-Type: application/json' \
  -d '{
    "num": 12345678
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/gettransactioninfobyblocknum', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "num": 12345678
    }),
});

const data = await response.json();

import requests

payload = {
  "num": 12345678
}

response = requests.post('https://trx-blockbook.nownodes.io/wallet/gettransactioninfobyblocknum', json=payload)
data = response.json()

Request Body

{
  "num": 12345678
}

{
  "result": true,
  "blockID": "000000000502e9686b96165061a0c1deaa8818cb4c2950a60d0d713865b106d3"
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

List nodes

POST

https://trx-blockbook.nownodes.io/wallet/listnodes

Returns information about nodes currently connected to the network. Shows the peer-to-peer network topology.

Body

application/json

No parameters required for this endpoint.

object

Response

200OK

HTTP 200 response for listnodes. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

List nodes

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/listnodes' \
  -H 'Content-Type: application/json' \
  -d '"request_example"'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/listnodes', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify("request_example"),
});

const data = await response.json();

import requests

payload = "request_example"

response = requests.post('https://trx-blockbook.nownodes.io/wallet/listnodes', json=payload)
data = response.json()

Request Body

"request_example"

{
  "nodes": [
    {
      "address": {
        "host": "34.143.247.77",
        "port": 18888
      }
    }
  ]
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Get node information

POST

https://trx-blockbook.nownodes.io/wallet/getnodeinfo

Returns comprehensive information about the current node including version, network status, peer connections, and performance metrics.

Body

application/json

No parameters required for this endpoint.

object

Response

200OK

HTTP 200 response for getnodeinfo. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get node information

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/getnodeinfo' \
  -H 'Content-Type: application/json' \
  -d '"request_example"'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/getnodeinfo', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify("request_example"),
});

const data = await response.json();

import requests

payload = "request_example"

response = requests.post('https://trx-blockbook.nownodes.io/wallet/getnodeinfo', json=payload)
data = response.json()

Request Body

"request_example"

{
  "result": true,
  "blockID": "000000000502e9686b96165061a0c1deaa8818cb4c2950a60d0d713865b106d3"
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Get chain parameters

POST

https://trx-blockbook.nownodes.io/wallet/getchainparameters

Returns the current chain parameters and configuration. Shows network-wide settings and governance parameters.

Body

application/json

No parameters required for this endpoint.

object

Response

200OK

HTTP 200 response for getchainparameters. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get chain parameters

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/getchainparameters' \
  -H 'Content-Type: application/json' \
  -d '"request_example"'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/getchainparameters', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify("request_example"),
});

const data = await response.json();

import requests

payload = "request_example"

response = requests.post('https://trx-blockbook.nownodes.io/wallet/getchainparameters', json=payload)
data = response.json()

Request Body

"request_example"

{
  "result": true,
  "blockID": "000000000502e9686b96165061a0c1deaa8818cb4c2950a60d0d713865b106d3"
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Get energy prices

POST

https://trx-blockbook.nownodes.io/wallet/getenergyprices

Returns current energy prices and market information. Useful for estimating transaction costs for smart contract operations.

Body

application/json

No parameters required for this endpoint.

object

Response

200OK

HTTP 200 response for getenergyprices. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get energy prices

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/getenergyprices' \
  -H 'Content-Type: application/json' \
  -d '"request_example"'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/getenergyprices', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify("request_example"),
});

const data = await response.json();

import requests

payload = "request_example"

response = requests.post('https://trx-blockbook.nownodes.io/wallet/getenergyprices', json=payload)
data = response.json()

Request Body

"request_example"

{
  "result": true,
  "blockID": "000000000502e9686b96165061a0c1deaa8818cb4c2950a60d0d713865b106d3"
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Get bandwidth prices

POST

https://trx-blockbook.nownodes.io/wallet/getbandwidthprices

Returns current bandwidth prices and market information. Useful for estimating transaction costs for regular transactions.

Body

application/json

No parameters required for this endpoint.

object

Response

200OK

HTTP 200 response for getbandwidthprices. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get bandwidth prices

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/getbandwidthprices' \
  -H 'Content-Type: application/json' \
  -d '"request_example"'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/getbandwidthprices', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify("request_example"),
});

const data = await response.json();

import requests

payload = "request_example"

response = requests.post('https://trx-blockbook.nownodes.io/wallet/getbandwidthprices', json=payload)
data = response.json()

Request Body

"request_example"

{
  "result": true,
  "blockID": "000000000502e9686b96165061a0c1deaa8818cb4c2950a60d0d713865b106d3"
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Get memo fee

POST

https://trx-blockbook.nownodes.io/wallet/getmemofee

Returns the current fee for adding a memo to a transaction. Memos are optional messages that can be included with transactions.

Body

application/json

No parameters required for this endpoint.

object

Response

200OK

HTTP 200 response for getmemofee. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get memo fee

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/getmemofee' \
  -H 'Content-Type: application/json' \
  -d '"request_example"'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/getmemofee', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify("request_example"),
});

const data = await response.json();

import requests

payload = "request_example"

response = requests.post('https://trx-blockbook.nownodes.io/wallet/getmemofee', json=payload)
data = response.json()

Request Body

"request_example"

{
  "result": true,
  "blockID": "000000000502e9686b96165061a0c1deaa8818cb4c2950a60d0d713865b106d3"
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Get burned TRX

POST

https://trx-blockbook.nownodes.io/wallet/getburntrx

Returns the total amount of TRX that has been burned (permanently removed from circulation). TRX can be burned through various network operations and fee mechanisms.

Body

application/json

No parameters required for this endpoint.

object

Response

200OK

HTTP 200 response for getburntrx. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get burned TRX

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/getburntrx' \
  -H 'Content-Type: application/json' \
  -d '"request_example"'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/getburntrx', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify("request_example"),
});

const data = await response.json();

import requests

payload = "request_example"

response = requests.post('https://trx-blockbook.nownodes.io/wallet/getburntrx', json=payload)
data = response.json()

Request Body

"request_example"

{
  "result": true,
  "blockID": "000000000502e9686b96165061a0c1deaa8818cb4c2950a60d0d713865b106d3"
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Smart Contracts

Smart Contracts operations.

Get contract information

POST

https://trx-blockbook.nownodes.io/wallet/getcontract

Returns basic information about a smart contract including its ABI, bytecode, and creation details. This method provides the fundamental contract metadata stored on the blockchain.

Body

application/json

Request value.

valuestringrequired

The contract address in base58 format.

visibleboolean

Whether the address is in base58 format.

Response

200OK

HTTP 200 response for getcontract. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get contract information

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/getcontract' \
  -H 'Content-Type: application/json' \
  -d '{
    "value": "TFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF",
    "visible": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/getcontract', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "value": "TFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF",
      "visible": true
    }),
});

const data = await response.json();

import requests

payload = {
  "value": "TFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF",
  "visible": True
}

response = requests.post('https://trx-blockbook.nownodes.io/wallet/getcontract', json=payload)
data = response.json()

Request Body

{
  "value": "TFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF",
  "visible": true
}

{
  "result": true,
  "blockID": "000000000502e9686b96165061a0c1deaa8818cb4c2950a60d0d713865b106d3"
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Get contract detailed information

POST

https://trx-blockbook.nownodes.io/wallet/getcontractinfo

Returns detailed information about a smart contract including runtime statistics, resource usage, and current state. This provides more comprehensive information than getcontract.

Body

application/json

Request value.

valuestringrequired

The contract address in base58 format.

visibleboolean

Whether the address is in base58 format.

Response

200OK

HTTP 200 response for getcontractinfo. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get contract detailed information

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/getcontractinfo' \
  -H 'Content-Type: application/json' \
  -d '{
    "value": "TFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF",
    "visible": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/getcontractinfo', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "value": "TFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF",
      "visible": true
    }),
});

const data = await response.json();

import requests

payload = {
  "value": "TFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF",
  "visible": True
}

response = requests.post('https://trx-blockbook.nownodes.io/wallet/getcontractinfo', json=payload)
data = response.json()

Request Body

{
  "value": "TFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF",
  "visible": true
}

{
  "result": true,
  "blockID": "000000000502e9686b96165061a0c1deaa8818cb4c2950a60d0d713865b106d3"
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Deploy contract

POST

https://trx-blockbook.nownodes.io/wallet/deploycontract

Deploys a new smart contract to the TRON blockchain. This creates a transaction that must be signed and broadcast to the network. The contract deployment requires sufficient energy and bandwidth resources.

Body

application/json

Request value.

owner_addressstringrequired

The address that will own and deploy the contract.

abistringrequired

The contract's ABI in JSON string format.

bytecodestringrequired

The contract's compiled bytecode in hex format.

namestring

The contract name.

fee_limitinteger<int64>

The maximum fee (in SUN) for contract deployment.

origin_energy_limitinteger

The energy limit for the contract execution.

consume_user_resource_percentinteger

The percentage of resource consumption paid by the user (0-100).

parameterstring

Constructor parameters in hex format (if any).

visibleboolean

Whether addresses are in base58 format.

Response

200OK

HTTP 200 response for deploycontract. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Deploy contract

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/deploycontract' \
  -H 'Content-Type: application/json' \
  -d '{
    "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
    "abi": "{\"entrys\":[{\"type\":\"Constructor\",\"payable\":false},{\"type\":\"Function\",\"name\":\"transfer\",\"constant\":false,\"payable\":false}]}",
    "bytecode": "6080604052348015600f57600080fd5b50603f80601d6000396000f3fe6080604052600080fdfea2646970667358221220...",
    "name": "MyToken",
    "fee_limit": 100000000,
    "origin_energy_limit": 10000000,
    "consume_user_resource_percent": 100,
    "parameter": "",
    "visible": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/deploycontract', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
      "abi": "{\"entrys\":[{\"type\":\"Constructor\",\"payable\":false},{\"type\":\"Function\",\"name\":\"transfer\",\"constant\":false,\"payable\":false}]}",
      "bytecode": "6080604052348015600f57600080fd5b50603f80601d6000396000f3fe6080604052600080fdfea2646970667358221220...",
      "name": "MyToken",
      "fee_limit": 100000000,
      "origin_energy_limit": 10000000,
      "consume_user_resource_percent": 100,
      "parameter": "",
      "visible": true
    }),
});

const data = await response.json();

import requests

payload = {
  "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
  "abi": "{\"entrys\":[{\"type\":\"Constructor\",\"payable\":false},{\"type\":\"Function\",\"name\":\"transfer\",\"constant\":false,\"payable\":false}]}",
  "bytecode": "6080604052348015600f57600080fd5b50603f80601d6000396000f3fe6080604052600080fdfea2646970667358221220...",
  "name": "MyToken",
  "fee_limit": 100000000,
  "origin_energy_limit": 10000000,
  "consume_user_resource_percent": 100,
  "parameter": "",
  "visible": True
}

response = requests.post('https://trx-blockbook.nownodes.io/wallet/deploycontract', json=payload)
data = response.json()

Request Body

{
  "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
  "abi": "{\"entrys\":[{\"type\":\"Constructor\",\"payable\":false},{\"type\":\"Function\",\"name\":\"transfer\",\"constant\":false,\"payable\":false}]}",
  "bytecode": "6080604052348015600f57600080fd5b50603f80601d6000396000f3fe6080604052600080fdfea2646970667358221220...",
  "name": "MyToken",
  "fee_limit": 100000000,
  "origin_energy_limit": 10000000,
  "consume_user_resource_percent": 100,
  "parameter": "",
  "visible": true
}

{
  "txID": "aaeb5bfd0d5f5a4ba8c825bdc8bc6f6ceaec896f11f31c1374d9285dc0c12906",
  "raw_data": {
    "contract": [
      {
        "parameter": {
          "value": {
            "amount": 7,
            "owner_address": "41A614F803B6FD780986A42C78EC9C7F77E6DED13C",
            "to_address": "41ac27ae19688035bf9b3f5f3baa488315f157770a"
          },
          "type_url": "type.googleapis.com/protocol.TransferContract"
        },
        "type": "TransferContract"
      }
    ],
    "ref_block_bytes": "e956",
    "ref_block_hash": "b0413c405002bec9",
    "expiration": 1782900528000,
    "timestamp": 1782900471309
  },
  "raw_data_hex": "0a02e9562208b0413c405002bec94080a79ce9f1335a65080112610a2d747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e5472616e73666572436f6e747261637412300a15413e715d653654406b1707aa6dda01b43f8acadfe6121541ac27ae19688035bf9b3f5f3baa488315f157770a1807"
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Trigger smart contract

POST

https://trx-blockbook.nownodes.io/wallet/triggersmartcontract

Executes a smart contract function that may modify the blockchain state. This creates a transaction that must be signed and broadcast to take effect. Used for state-changing operations like transferring tokens or updating storage.

Body

application/json

Request value.

contract_addressstringrequired

The smart contract address in base58 format.

function_selectorstringrequired

The function signature to call (e.g., "transfer(address,uint256)"). Must match exactly with the contract's ABI.

parameterstring

The encoded function parameters in hex format. Parameters must be ABI-encoded according to the function signature.

fee_limitinteger<int64>

The maximum fee (in SUN) for the contract execution.

call_valueinteger<int64>

The amount of TRX (in SUN) to send with the contract call. Used for payable functions.

owner_addressstringrequired

The address that is triggering the contract call.

visibleboolean

Whether addresses are in base58 format.

permission_idinteger

The permission ID to use for the transaction.

Response

200OK

HTTP 200 response for triggersmartcontract. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Trigger smart contract

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/triggersmartcontract' \
  -H 'Content-Type: application/json' \
  -d '{
    "contract_address": "TFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF",
    "function_selector": "transfer(address,uint256)",
    "parameter": "000000000000000000000000a614f803b6fd780986a42c78ec9c7f77e6ded13c0000000000000000000000000000000000000000000000000000000000000064",
    "fee_limit": 100000000,
    "call_value": 0,
    "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
    "visible": true,
    "permission_id": 0
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/triggersmartcontract', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "contract_address": "TFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF",
      "function_selector": "transfer(address,uint256)",
      "parameter": "000000000000000000000000a614f803b6fd780986a42c78ec9c7f77e6ded13c0000000000000000000000000000000000000000000000000000000000000064",
      "fee_limit": 100000000,
      "call_value": 0,
      "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
      "visible": true,
      "permission_id": 0
    }),
});

const data = await response.json();

import requests

payload = {
  "contract_address": "TFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF",
  "function_selector": "transfer(address,uint256)",
  "parameter": "000000000000000000000000a614f803b6fd780986a42c78ec9c7f77e6ded13c0000000000000000000000000000000000000000000000000000000000000064",
  "fee_limit": 100000000,
  "call_value": 0,
  "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
  "visible": True,
  "permission_id": 0
}

response = requests.post('https://trx-blockbook.nownodes.io/wallet/triggersmartcontract', json=payload)
data = response.json()

Request Body

{
  "contract_address": "TFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF",
  "function_selector": "transfer(address,uint256)",
  "parameter": "000000000000000000000000a614f803b6fd780986a42c78ec9c7f77e6ded13c0000000000000000000000000000000000000000000000000000000000000064",
  "fee_limit": 100000000,
  "call_value": 0,
  "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
  "visible": true,
  "permission_id": 0
}

{
  "result": true
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Trigger constant contract

POST

https://trx-blockbook.nownodes.io/wallet/triggerconstantcontract

Executes a smart contract function in read-only mode without modifying blockchain state. This method does not create a transaction and is free to use. Used for querying contract state, reading values, and view functions.

Body

application/json

Request value.

contract_addressstringrequired

The smart contract address in base58 format.

function_selectorstringrequired

The function signature to call (e.g., "balanceOf(address)").

parameterstring

The encoded function parameters in hex format.

owner_addressstringrequired

The address that is triggering the contract call.

visibleboolean

Whether addresses are in base58 format.

permission_idinteger

The permission ID to use for the call.

Response

200OK

HTTP 200 response for triggerconstantcontract. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Trigger constant contract

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/triggerconstantcontract' \
  -H 'Content-Type: application/json' \
  -d '{
    "contract_address": "TFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF",
    "function_selector": "balanceOf(address)",
    "parameter": "000000000000000000000000a614f803b6fd780986a42c78ec9c7f77e6ded13c",
    "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
    "visible": true,
    "permission_id": 0
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/triggerconstantcontract', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "contract_address": "TFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF",
      "function_selector": "balanceOf(address)",
      "parameter": "000000000000000000000000a614f803b6fd780986a42c78ec9c7f77e6ded13c",
      "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
      "visible": true,
      "permission_id": 0
    }),
});

const data = await response.json();

import requests

payload = {
  "contract_address": "TFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF",
  "function_selector": "balanceOf(address)",
  "parameter": "000000000000000000000000a614f803b6fd780986a42c78ec9c7f77e6ded13c",
  "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
  "visible": True,
  "permission_id": 0
}

response = requests.post('https://trx-blockbook.nownodes.io/wallet/triggerconstantcontract', json=payload)
data = response.json()

Request Body

{
  "contract_address": "TFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF",
  "function_selector": "balanceOf(address)",
  "parameter": "000000000000000000000000a614f803b6fd780986a42c78ec9c7f77e6ded13c",
  "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
  "visible": true,
  "permission_id": 0
}

{
  "result": true
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Update contract setting

POST

https://trx-blockbook.nownodes.io/wallet/updatesetting

Updates the consume_user_resource_percent setting for a smart contract. This determines what percentage of resource consumption is paid by the user vs. the contract owner. Only the contract owner can update this setting.

Body

application/json

Request value.

owner_addressstringrequired

The contract owner address in base58 format.

contract_addressstringrequired

The contract address to update.

consume_user_resource_percentintegerrequired

The new consume user resource percentage (0-100).

visibleboolean

Whether addresses are in base58 format.

Response

200OK

HTTP 200 response for updatesetting. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Update contract setting

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/updatesetting' \
  -H 'Content-Type: application/json' \
  -d '{
    "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
    "contract_address": "TFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF",
    "consume_user_resource_percent": 50,
    "visible": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/updatesetting', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
      "contract_address": "TFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF",
      "consume_user_resource_percent": 50,
      "visible": true
    }),
});

const data = await response.json();

import requests

payload = {
  "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
  "contract_address": "TFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF",
  "consume_user_resource_percent": 50,
  "visible": True
}

response = requests.post('https://trx-blockbook.nownodes.io/wallet/updatesetting', json=payload)
data = response.json()

Request Body

{
  "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
  "contract_address": "TFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF",
  "consume_user_resource_percent": 50,
  "visible": true
}

{
  "txID": "aaeb5bfd0d5f5a4ba8c825bdc8bc6f6ceaec896f11f31c1374d9285dc0c12906",
  "raw_data": {
    "contract": [
      {
        "parameter": {
          "value": {
            "amount": 7,
            "owner_address": "41A614F803B6FD780986A42C78EC9C7F77E6DED13C",
            "to_address": "41ac27ae19688035bf9b3f5f3baa488315f157770a"
          },
          "type_url": "type.googleapis.com/protocol.TransferContract"
        },
        "type": "TransferContract"
      }
    ],
    "ref_block_bytes": "e956",
    "ref_block_hash": "b0413c405002bec9",
    "expiration": 1782900528000,
    "timestamp": 1782900471309
  },
  "raw_data_hex": "0a02e9562208b0413c405002bec94080a79ce9f1335a65080112610a2d747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e5472616e73666572436f6e747261637412300a15413e715d653654406b1707aa6dda01b43f8acadfe6121541ac27ae19688035bf9b3f5f3baa488315f157770a1807"
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Update energy limit

POST

https://trx-blockbook.nownodes.io/wallet/updateenergylimit

Updates the origin_energy_limit for a smart contract. This sets the maximum energy that can be consumed in a single contract call. Only the contract owner can update this setting.

Body

application/json

Request value.

owner_addressstringrequired

The contract owner address in base58 format.

contract_addressstringrequired

The contract address to update.

origin_energy_limitintegerrequired

The new origin energy limit.

visibleboolean

Whether addresses are in base58 format.

Response

200OK

HTTP 200 response for updateenergylimit. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Update energy limit

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/updateenergylimit' \
  -H 'Content-Type: application/json' \
  -d '{
    "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
    "contract_address": "TFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF",
    "origin_energy_limit": 20000000,
    "visible": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/updateenergylimit', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
      "contract_address": "TFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF",
      "origin_energy_limit": 20000000,
      "visible": true
    }),
});

const data = await response.json();

import requests

payload = {
  "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
  "contract_address": "TFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF",
  "origin_energy_limit": 20000000,
  "visible": True
}

response = requests.post('https://trx-blockbook.nownodes.io/wallet/updateenergylimit', json=payload)
data = response.json()

Request Body

{
  "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
  "contract_address": "TFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF",
  "origin_energy_limit": 20000000,
  "visible": true
}

{
  "txID": "aaeb5bfd0d5f5a4ba8c825bdc8bc6f6ceaec896f11f31c1374d9285dc0c12906",
  "raw_data": {
    "contract": [
      {
        "parameter": {
          "value": {
            "amount": 7,
            "owner_address": "41A614F803B6FD780986A42C78EC9C7F77E6DED13C",
            "to_address": "41ac27ae19688035bf9b3f5f3baa488315f157770a"
          },
          "type_url": "type.googleapis.com/protocol.TransferContract"
        },
        "type": "TransferContract"
      }
    ],
    "ref_block_bytes": "e956",
    "ref_block_hash": "b0413c405002bec9",
    "expiration": 1782900528000,
    "timestamp": 1782900471309
  },
  "raw_data_hex": "0a02e9562208b0413c405002bec94080a79ce9f1335a65080112610a2d747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e5472616e73666572436f6e747261637412300a15413e715d653654406b1707aa6dda01b43f8acadfe6121541ac27ae19688035bf9b3f5f3baa488315f157770a1807"
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Clear contract ABI

POST

https://trx-blockbook.nownodes.io/wallet/clearabi

Clears the ABI of a smart contract, removing its interface definition. This operation is irreversible and should be used with caution. Only the contract owner can clear the ABI.

Body

application/json

Request value.

owner_addressstringrequired

The contract owner address in base58 format.

contract_addressstringrequired

The contract address to clear ABI for.

visibleboolean

Whether addresses are in base58 format.

Response

200OK

HTTP 200 response for clearabi. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Clear contract ABI

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/clearabi' \
  -H 'Content-Type: application/json' \
  -d '{
    "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
    "contract_address": "TFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF",
    "visible": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/clearabi', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
      "contract_address": "TFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF",
      "visible": true
    }),
});

const data = await response.json();

import requests

payload = {
  "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
  "contract_address": "TFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF",
  "visible": True
}

response = requests.post('https://trx-blockbook.nownodes.io/wallet/clearabi', json=payload)
data = response.json()

Request Body

{
  "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
  "contract_address": "TFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF",
  "visible": true
}

{
  "result": true,
  "blockID": "000000000502e9686b96165061a0c1deaa8818cb4c2950a60d0d713865b106d3"
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Estimate energy consumption

POST

https://trx-blockbook.nownodes.io/wallet/estimateenergy

Estimates the energy consumption of a smart contract call without executing it. This helps predict the cost of contract interactions before submitting transactions. The estimation is based on the current network state and contract code.

Body

application/json

Request value.

owner_addressstringrequired

The address that would trigger the contract call.

contract_addressstringrequired

The smart contract address.

function_selectorstringrequired

The function signature to estimate.

parameterstringrequired

The encoded function parameters.

visibleboolean

Whether addresses are in base58 format.

Response

200OK

HTTP 200 response for estimateenergy. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Estimate energy consumption

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/estimateenergy' \
  -H 'Content-Type: application/json' \
  -d '{
    "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
    "contract_address": "TFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF",
    "function_selector": "transfer(address,uint256)",
    "parameter": "000000000000000000000000a614f803b6fd780986a42c78ec9c7f77e6ded13c0000000000000000000000000000000000000000000000000000000000000064",
    "visible": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/estimateenergy', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
      "contract_address": "TFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF",
      "function_selector": "transfer(address,uint256)",
      "parameter": "000000000000000000000000a614f803b6fd780986a42c78ec9c7f77e6ded13c0000000000000000000000000000000000000000000000000000000000000064",
      "visible": true
    }),
});

const data = await response.json();

import requests

payload = {
  "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
  "contract_address": "TFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF",
  "function_selector": "transfer(address,uint256)",
  "parameter": "000000000000000000000000a614f803b6fd780986a42c78ec9c7f77e6ded13c0000000000000000000000000000000000000000000000000000000000000064",
  "visible": True
}

response = requests.post('https://trx-blockbook.nownodes.io/wallet/estimateenergy', json=payload)
data = response.json()

Request Body

{
  "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
  "contract_address": "TFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF",
  "function_selector": "transfer(address,uint256)",
  "parameter": "000000000000000000000000a614f803b6fd780986a42c78ec9c7f77e6ded13c0000000000000000000000000000000000000000000000000000000000000064",
  "visible": true
}

{
  "result": true
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

TRC-10 Tokens

TRC-10 Tokens operations.

Get asset issue by account

POST

https://trx-blockbook.nownodes.io/wallet/getassetissuebyaccount

Returns all TRC-10 tokens issued by a specific account. Shows the tokens that an account has created and their details.

Body

application/json

Request value.

addressstringrequired

The account address in base58 format that issued the tokens.

visibleboolean

Whether the address is in base58 format.

Response

200OK

HTTP 200 response for getassetissuebyaccount. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get asset issue by account

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/getassetissuebyaccount' \
  -H 'Content-Type: application/json' \
  -d '{
    "address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
    "visible": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/getassetissuebyaccount', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
      "visible": true
    }),
});

const data = await response.json();

import requests

payload = {
  "address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
  "visible": True
}

response = requests.post('https://trx-blockbook.nownodes.io/wallet/getassetissuebyaccount', json=payload)
data = response.json()

Request Body

{
  "address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
  "visible": true
}

{
  "size": 12
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Get asset issue by name

POST

https://trx-blockbook.nownodes.io/wallet/getassetissuebyname

Returns information about a specific TRC-10 token by its name. Token names are unique across the network.

Body

application/json

Request value.

valuestringrequired

The token name to search for.

visibleboolean

Whether to return addresses in base58 format.

Response

200OK

HTTP 200 response for getassetissuebyname. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get asset issue by name

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/getassetissuebyname' \
  -H 'Content-Type: application/json' \
  -d '{
    "value": "MyToken",
    "visible": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/getassetissuebyname', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "value": "MyToken",
      "visible": true
    }),
});

const data = await response.json();

import requests

payload = {
  "value": "MyToken",
  "visible": True
}

response = requests.post('https://trx-blockbook.nownodes.io/wallet/getassetissuebyname', json=payload)
data = response.json()

Request Body

{
  "value": "MyToken",
  "visible": true
}

{
  "assetIssue": [
    {
      "id": "1004108",
      "name": "TRX",
      "abbr": "trx",
      "total_supply": 100000000
    }
  ]
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Get asset issue list by name

POST

https://trx-blockbook.nownodes.io/wallet/getassetissuelistbyname

Returns information about TRC-10 tokens matching a specific name pattern. Useful for searching tokens by partial name matches.

Body

application/json

Request value.

valuestringrequired

The token name or partial name to search for.

Response

200OK

HTTP 200 response for getassetissuelistbyname. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get asset issue list by name

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/getassetissuelistbyname' \
  -H 'Content-Type: application/json' \
  -d '{
    "value": "MyToken"
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/getassetissuelistbyname', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "value": "MyToken"
    }),
});

const data = await response.json();

import requests

payload = {
  "value": "MyToken"
}

response = requests.post('https://trx-blockbook.nownodes.io/wallet/getassetissuelistbyname', json=payload)
data = response.json()

Request Body

{
  "value": "MyToken"
}

{
  "assetIssue": [
    {
      "id": "1004108",
      "name": "TRX",
      "abbr": "trx",
      "total_supply": 100000000
    }
  ]
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Get asset issue by ID

POST

https://trx-blockbook.nownodes.io/wallet/getassetissuebyid

Returns information about a specific TRC-10 token by its token ID. Token IDs are unique numerical identifiers assigned to each TRC-10 token.

Body

application/json

Request value.

valuestringrequired

The token ID to search for.

visibleboolean

Whether to return addresses in base58 format.

Response

200OK

HTTP 200 response for getassetissuebyid. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get asset issue by ID

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/getassetissuebyid' \
  -H 'Content-Type: application/json' \
  -d '{
    "value": "1000001",
    "visible": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/getassetissuebyid', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "value": "1000001",
      "visible": true
    }),
});

const data = await response.json();

import requests

payload = {
  "value": "1000001",
  "visible": True
}

response = requests.post('https://trx-blockbook.nownodes.io/wallet/getassetissuebyid', json=payload)
data = response.json()

Request Body

{
  "value": "1000001",
  "visible": true
}

{
  "assetIssue": [
    {
      "id": "1004108",
      "name": "TRX",
      "abbr": "trx",
      "total_supply": 100000000
    }
  ]
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Get asset issue list

POST

https://trx-blockbook.nownodes.io/wallet/getassetissuelist

Returns a list of all TRC-10 tokens on the network. This provides a comprehensive view of all issued tokens.

Body

application/json

No parameters required for this endpoint.

object

Response

200OK

HTTP 200 response for getassetissuelist. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get asset issue list

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/getassetissuelist' \
  -H 'Content-Type: application/json' \
  -d '"request_example"'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/getassetissuelist', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify("request_example"),
});

const data = await response.json();

import requests

payload = "request_example"

response = requests.post('https://trx-blockbook.nownodes.io/wallet/getassetissuelist', json=payload)
data = response.json()

Request Body

"request_example"

{
  "assetIssue": [
    {
      "id": "1004108",
      "name": "TRX",
      "abbr": "trx",
      "total_supply": 100000000
    }
  ]
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Get paginated asset issue list

POST

https://trx-blockbook.nownodes.io/wallet/getpaginatedassetissuelist

Returns a paginated list of TRC-10 tokens. Useful for efficiently browsing large numbers of tokens.

Body

application/json

Request value.

offsetintegerrequired

The starting index for pagination (0-based).

limitintegerrequired

The maximum number of tokens to return.

Response

200OK

HTTP 200 response for getpaginatedassetissuelist. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get paginated asset issue list

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/getpaginatedassetissuelist' \
  -H 'Content-Type: application/json' \
  -d '{
    "offset": 0,
    "limit": 20
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/getpaginatedassetissuelist', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "offset": 0,
      "limit": 20
    }),
});

const data = await response.json();

import requests

payload = {
  "offset": 0,
  "limit": 20
}

response = requests.post('https://trx-blockbook.nownodes.io/wallet/getpaginatedassetissuelist', json=payload)
data = response.json()

Request Body

{
  "offset": 0,
  "limit": 20
}

{
  "assetIssue": [
    {
      "id": "1004108",
      "name": "TRX",
      "abbr": "trx",
      "total_supply": 100000000
    }
  ]
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Transfer asset

POST

https://trx-blockbook.nownodes.io/wallet/transferasset

Transfers TRC-10 tokens from one account to another. This creates a transaction that must be signed and broadcast to the network. The sender must have sufficient token balance and bandwidth resources.

Body

application/json

Request value.

to_addressstringrequired

The recipient's address in base58 format.

owner_addressstringrequired

The sender's address in base58 format.

asset_namestringrequired

The token name to transfer.

amountinteger<int64>required

The amount of tokens to transfer.

visibleboolean

Whether addresses are in base58 format.

permission_idinteger

The permission ID to use for the transaction.

Response

200OK

HTTP 200 response for transferasset. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Transfer asset

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/transferasset' \
  -H 'Content-Type: application/json' \
  -d '{
    "to_address": "TFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF",
    "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
    "asset_name": "MyToken",
    "amount": 1000000,
    "visible": true,
    "permission_id": 0
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/transferasset', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "to_address": "TFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF",
      "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
      "asset_name": "MyToken",
      "amount": 1000000,
      "visible": true,
      "permission_id": 0
    }),
});

const data = await response.json();

import requests

payload = {
  "to_address": "TFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF",
  "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
  "asset_name": "MyToken",
  "amount": 1000000,
  "visible": True,
  "permission_id": 0
}

response = requests.post('https://trx-blockbook.nownodes.io/wallet/transferasset', json=payload)
data = response.json()

Request Body

{
  "to_address": "TFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF",
  "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
  "asset_name": "MyToken",
  "amount": 1000000,
  "visible": true,
  "permission_id": 0
}

{
  "assetIssue": [
    {
      "id": "1004108",
      "name": "TRX",
      "abbr": "trx",
      "total_supply": 100000000
    }
  ]
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Participate asset issue

POST

https://trx-blockbook.nownodes.io/wallet/participateassetissue

Participates in a TRC-10 token sale by exchanging TRX for tokens. This allows users to purchase tokens during the token sale period. The token sale must be active and the exchange rate must be favorable.

Body

application/json

Request value.

to_addressstringrequired

The token issuer's address in base58 format.

owner_addressstringrequired

The participant's address in base58 format.

asset_namestringrequired

The token name to purchase.

amountinteger<int64>required

The amount of TRX to spend (in SUN) for token purchase.

visibleboolean

Whether addresses are in base58 format.

Response

200OK

HTTP 200 response for participateassetissue. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Participate asset issue

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/participateassetissue' \
  -H 'Content-Type: application/json' \
  -d '{
    "to_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
    "owner_address": "TFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF",
    "asset_name": "MyToken",
    "amount": 100000000,
    "visible": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/participateassetissue', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "to_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
      "owner_address": "TFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF",
      "asset_name": "MyToken",
      "amount": 100000000,
      "visible": true
    }),
});

const data = await response.json();

import requests

payload = {
  "to_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
  "owner_address": "TFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF",
  "asset_name": "MyToken",
  "amount": 100000000,
  "visible": True
}

response = requests.post('https://trx-blockbook.nownodes.io/wallet/participateassetissue', json=payload)
data = response.json()

Request Body

{
  "to_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
  "owner_address": "TFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF",
  "asset_name": "MyToken",
  "amount": 100000000,
  "visible": true
}

{
  "assetIssue": [
    {
      "id": "1004108",
      "name": "TRX",
      "abbr": "trx",
      "total_supply": 100000000
    }
  ]
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Create asset issue

POST

https://trx-blockbook.nownodes.io/wallet/createassetissue

Creates a new TRC-10 token on the TRON blockchain. This operation requires a significant amount of TRX and creates a new token with specified parameters. Token creation is permanent and cannot be undone.

Body

application/json

Request value.

owner_addressstringrequired

The token issuer's address in base58 format.

namestringrequired

The token name (must be unique across the network).

abbrstringrequired

The token abbreviation.

total_supplyinteger<int64>required

The total token supply.

trx_numintegerrequired

The TRX to token conversion rate numerator.

numintegerrequired

The TRX to token conversion rate denominator.

start_timeinteger<int64>required

Token sale start timestamp in milliseconds.

end_timeinteger<int64>required

Token sale end timestamp in milliseconds.

descriptionstringrequired

Token description.

urlstringrequired

Token website URL.

frozen_supplyobject

Frozen token supply details.

Show child attributes

frozen_amountinteger<int64>

Amount of frozen tokens

frozen_daysinteger

Number of days tokens are frozen

visibleboolean

Whether addresses are in base58 format.

Response

200OK

HTTP 200 response for createassetissue. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Create asset issue

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/createassetissue' \
  -H 'Content-Type: application/json' \
  -d '{
    "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
    "name": "MyToken",
    "abbr": "MTK",
    "total_supply": 1000000000,
    "trx_num": 1,
    "num": 100,
    "start_time": 1573125066000,
    "end_time": 1575720066000,
    "description": "My custom token for ecosystem",
    "url": "https://mytoken.com",
    "frozen_supply": {
      "frozen_amount": 1000000,
      "frozen_days": 1
    },
    "visible": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/createassetissue', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
      "name": "MyToken",
      "abbr": "MTK",
      "total_supply": 1000000000,
      "trx_num": 1,
      "num": 100,
      "start_time": 1573125066000,
      "end_time": 1575720066000,
      "description": "My custom token for ecosystem",
      "url": "https://mytoken.com",
      "frozen_supply": {
        "frozen_amount": 1000000,
        "frozen_days": 1
      },
      "visible": true
    }),
});

const data = await response.json();

import requests

payload = {
  "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
  "name": "MyToken",
  "abbr": "MTK",
  "total_supply": 1000000000,
  "trx_num": 1,
  "num": 100,
  "start_time": 1573125066000,
  "end_time": 1575720066000,
  "description": "My custom token for ecosystem",
  "url": "https://mytoken.com",
  "frozen_supply": {
    "frozen_amount": 1000000,
    "frozen_days": 1
  },
  "visible": True
}

response = requests.post('https://trx-blockbook.nownodes.io/wallet/createassetissue', json=payload)
data = response.json()

Request Body

{
  "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
  "name": "MyToken",
  "abbr": "MTK",
  "total_supply": 1000000000,
  "trx_num": 1,
  "num": 100,
  "start_time": 1573125066000,
  "end_time": 1575720066000,
  "description": "My custom token for ecosystem",
  "url": "https://mytoken.com",
  "frozen_supply": {
    "frozen_amount": 1000000,
    "frozen_days": 1
  },
  "visible": true
}

{
  "assetIssue": [
    {
      "id": "1004108",
      "name": "TRX",
      "abbr": "trx",
      "total_supply": 100000000
    }
  ]
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Unfreeze asset

POST

https://trx-blockbook.nownodes.io/wallet/unfreezeasset

Unfreezes previously frozen TRC-10 tokens. Token issuers can freeze a portion of token supply during creation and unfreeze it later. This makes frozen tokens available for circulation.

Body

application/json

Request value.

owner_addressstringrequired

The token issuer's address in base58 format.

visibleboolean

Whether the address is in base58 format.

Response

200OK

HTTP 200 response for unfreezeasset. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Unfreeze asset

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/unfreezeasset' \
  -H 'Content-Type: application/json' \
  -d '{
    "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
    "visible": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/unfreezeasset', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
      "visible": true
    }),
});

const data = await response.json();

import requests

payload = {
  "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
  "visible": True
}

response = requests.post('https://trx-blockbook.nownodes.io/wallet/unfreezeasset', json=payload)
data = response.json()

Request Body

{
  "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
  "visible": true
}

{
  "assetIssue": [
    {
      "id": "1004108",
      "name": "TRX",
      "abbr": "trx",
      "total_supply": 100000000
    }
  ]
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Update asset

POST

https://trx-blockbook.nownodes.io/wallet/updateasset

Updates the description and URL of an existing TRC-10 token. Only the token issuer can update these details. Token name, supply, and other core parameters cannot be changed.

Body

application/json

Request value.

owner_addressstringrequired

The token issuer's address in base58 format.

descriptionstringrequired

The new token description.

urlstringrequired

The new token website URL.

visibleboolean

Whether the address is in base58 format.

Response

200OK

HTTP 200 response for updateasset. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Update asset

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/updateasset' \
  -H 'Content-Type: application/json' \
  -d '{
    "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
    "description": "Updated token description",
    "url": "https://updated-token.com",
    "visible": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/updateasset', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
      "description": "Updated token description",
      "url": "https://updated-token.com",
      "visible": true
    }),
});

const data = await response.json();

import requests

payload = {
  "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
  "description": "Updated token description",
  "url": "https://updated-token.com",
  "visible": True
}

response = requests.post('https://trx-blockbook.nownodes.io/wallet/updateasset', json=payload)
data = response.json()

Request Body

{
  "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
  "description": "Updated token description",
  "url": "https://updated-token.com",
  "visible": true
}

{
  "assetIssue": [
    {
      "id": "1004108",
      "name": "TRX",
      "abbr": "trx",
      "total_supply": 100000000
    }
  ]
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Vote and Super Representative

Vote and Super Representative operations.

Create witness

POST

https://trx-blockbook.nownodes.io/wallet/createwitness

Registers an account as a witness candidate (Super Representative candidate). This operation requires the account to have sufficient TRX balance and creates a witness node. Witnesses participate in block production and network governance.

Body

application/json

Request value.

owner_addressstringrequired

The account address that will become a witness candidate in base58 format.

urlstringrequired

The witness website or information URL. Maximum 256 bytes.

visibleboolean

Whether the address is in base58 format.

Response

200OK

HTTP 200 response for createwitness. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Create witness

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/createwitness' \
  -H 'Content-Type: application/json' \
  -d '{
    "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
    "url": "https://mywitness.com",
    "visible": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/createwitness', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
      "url": "https://mywitness.com",
      "visible": true
    }),
});

const data = await response.json();

import requests

payload = {
  "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
  "url": "https://mywitness.com",
  "visible": True
}

response = requests.post('https://trx-blockbook.nownodes.io/wallet/createwitness', json=payload)
data = response.json()

Request Body

{
  "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
  "url": "https://mywitness.com",
  "visible": true
}

{
  "witnesses": [
    {
      "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
      "voteCount": 1234567,
      "url": "https://tronscan.org"
    }
  ]
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Update witness

POST

https://trx-blockbook.nownodes.io/wallet/updatewitness

Updates the information of an existing witness (Super Representative). This allows witnesses to change their website URL or other public information. Only the witness owner can update witness information.

Body

application/json

Request value.

owner_addressstringrequired

The witness owner address in base58 format.

update_urlstringrequired

The new witness website or information URL. Maximum 256 bytes.

visibleboolean

Whether the address is in base58 format.

Response

200OK

HTTP 200 response for updatewitness. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Update witness

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/updatewitness' \
  -H 'Content-Type: application/json' \
  -d '{
    "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
    "update_url": "https://updated-witness.com",
    "visible": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/updatewitness', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
      "update_url": "https://updated-witness.com",
      "visible": true
    }),
});

const data = await response.json();

import requests

payload = {
  "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
  "update_url": "https://updated-witness.com",
  "visible": True
}

response = requests.post('https://trx-blockbook.nownodes.io/wallet/updatewitness', json=payload)
data = response.json()

Request Body

{
  "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
  "update_url": "https://updated-witness.com",
  "visible": true
}

{
  "witnesses": [
    {
      "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
      "voteCount": 1234567,
      "url": "https://tronscan.org"
    }
  ]
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

List witnesses

POST

https://trx-blockbook.nownodes.io/wallet/listwitnesses

Returns a list of all witness candidates and Super Representatives on the network. Includes both current Super Representatives and candidate witnesses.

Body

application/json

No parameters required for this endpoint.

object

Response

200OK

HTTP 200 response for listwitnesses. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

List witnesses

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/listwitnesses' \
  -H 'Content-Type: application/json' \
  -d '"request_example"'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/listwitnesses', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify("request_example"),
});

const data = await response.json();

import requests

payload = "request_example"

response = requests.post('https://trx-blockbook.nownodes.io/wallet/listwitnesses', json=payload)
data = response.json()

Request Body

"request_example"

{
  "witnesses": [
    {
      "address": "TQn9Y2khEsLJW1ChVWFMSMeRDow5KcbLSE",
      "voteCount": 1234567,
      "url": "https://tronscan.org"
    }
  ]
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Withdraw balance

POST

https://trx-blockbook.nownodes.io/wallet/withdrawbalance

Allows a Super Representative to withdraw their block production rewards. Rewards are accumulated from block production and voting rewards. There may be a waiting period before rewards can be withdrawn.

Body

application/json

Request value.

owner_addressstringrequired

The Super Representative address in base58 format.

visibleboolean

Whether the address is in base58 format.

Response

200OK

HTTP 200 response for withdrawbalance. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Withdraw balance

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/withdrawbalance' \
  -H 'Content-Type: application/json' \
  -d '{
    "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
    "visible": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/withdrawbalance', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
      "visible": true
    }),
});

const data = await response.json();

import requests

payload = {
  "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
  "visible": True
}

response = requests.post('https://trx-blockbook.nownodes.io/wallet/withdrawbalance', json=payload)
data = response.json()

Request Body

{
  "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
  "visible": true
}

{
  "txID": "aaeb5bfd0d5f5a4ba8c825bdc8bc6f6ceaec896f11f31c1374d9285dc0c12906",
  "raw_data": {
    "contract": [
      {
        "parameter": {
          "value": {
            "amount": 7,
            "owner_address": "41A614F803B6FD780986A42C78EC9C7F77E6DED13C",
            "to_address": "41ac27ae19688035bf9b3f5f3baa488315f157770a"
          },
          "type_url": "type.googleapis.com/protocol.TransferContract"
        },
        "type": "TransferContract"
      }
    ],
    "ref_block_bytes": "e956",
    "ref_block_hash": "b0413c405002bec9",
    "expiration": 1782900528000,
    "timestamp": 1782900471309
  },
  "raw_data_hex": "0a02e9562208b0413c405002bec94080a79ce9f1335a65080112610a2d747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e5472616e73666572436f6e747261637412300a15413e715d653654406b1707aa6dda01b43f8acadfe6121541ac27ae19688035bf9b3f5f3baa488315f157770a1807"
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Vote witness account

POST

https://trx-blockbook.nownodes.io/wallet/votewitnessaccount

Votes for Super Representative candidates using TRX voting power. Each TRX held in account gives 1 vote. Votes can be distributed among multiple candidates. Voting helps determine which witnesses become Super Representatives.

Body

application/json

Request value.

owner_addressstringrequired

The voter's address in base58 format.

votesArray<object>required

Array of vote objects specifying witness addresses and vote counts.

Show child attributes

vote_addressstringrequired

The witness address to vote for in base58 format.

vote_countintegerrequired

The number of votes to cast for this witness. Cannot exceed the voter's available voting power.

visibleboolean

Whether addresses are in base58 format.

support_rewardboolean

Whether to support the reward system (optional).

Response

200OK

HTTP 200 response for votewitnessaccount. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Vote witness account

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/votewitnessaccount' \
  -H 'Content-Type: application/json' \
  -d '{
    "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
    "votes": [
      {
        "vote_address": "TFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF",
        "vote_count": 1000000
      }
    ],
    "visible": true,
    "support_reward": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/votewitnessaccount', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
      "votes": [
        {
          "vote_address": "TFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF",
          "vote_count": 1000000
        }
      ],
      "visible": true,
      "support_reward": true
    }),
});

const data = await response.json();

import requests

payload = {
  "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
  "votes": [
    {
      "vote_address": "TFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF",
      "vote_count": 1000000
    }
  ],
  "visible": True,
  "support_reward": True
}

response = requests.post('https://trx-blockbook.nownodes.io/wallet/votewitnessaccount', json=payload)
data = response.json()

Request Body

{
  "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
  "votes": [
    {
      "vote_address": "TFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFFF",
      "vote_count": 1000000
    }
  ],
  "visible": true,
  "support_reward": true
}

{
  "size": 12
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Get brokerage

POST

https://trx-blockbook.nownodes.io/wallet/getBrokerage

Returns the brokerage (commission rate) for a Super Representative. Brokerage is the percentage of block rewards that the SR shares with voters. Expressed as a value between 0 and 100.

Body

application/json

Request value.

addressstringrequired

The Super Representative address in base58 format.

visibleboolean

Whether the address is in base58 format.

Response

200OK

HTTP 200 response for getBrokerage. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get brokerage

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/getBrokerage' \
  -H 'Content-Type: application/json' \
  -d '{
    "address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
    "visible": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/getBrokerage', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
      "visible": true
    }),
});

const data = await response.json();

import requests

payload = {
  "address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
  "visible": True
}

response = requests.post('https://trx-blockbook.nownodes.io/wallet/getBrokerage', json=payload)
data = response.json()

Request Body

{
  "address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
  "visible": true
}

{
  "result": true,
  "blockID": "000000000502e9686b96165061a0c1deaa8818cb4c2950a60d0d713865b106d3"
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Update brokerage

POST

https://trx-blockbook.nownodes.io/wallet/updateBrokerage

Updates the brokerage (commission rate) for a Super Representative. This determines what percentage of block rewards are shared with voters. Only Super Representatives can update their brokerage rate.

Body

application/json

Request value.

owner_addressstringrequired

The Super Representative address in base58 format.

brokerageintegerrequired

The new brokerage rate as a percentage (0-100).

visibleboolean

Whether the address is in base58 format.

Response

200OK

HTTP 200 response for updateBrokerage. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Update brokerage

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/updateBrokerage' \
  -H 'Content-Type: application/json' \
  -d '{
    "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
    "brokerage": 25,
    "visible": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/updateBrokerage', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
      "brokerage": 25,
      "visible": true
    }),
});

const data = await response.json();

import requests

payload = {
  "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
  "brokerage": 25,
  "visible": True
}

response = requests.post('https://trx-blockbook.nownodes.io/wallet/updateBrokerage', json=payload)
data = response.json()

Request Body

{
  "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
  "brokerage": 25,
  "visible": true
}

{
  "txID": "aaeb5bfd0d5f5a4ba8c825bdc8bc6f6ceaec896f11f31c1374d9285dc0c12906",
  "raw_data": {
    "contract": [
      {
        "parameter": {
          "value": {
            "amount": 7,
            "owner_address": "41A614F803B6FD780986A42C78EC9C7F77E6DED13C",
            "to_address": "41ac27ae19688035bf9b3f5f3baa488315f157770a"
          },
          "type_url": "type.googleapis.com/protocol.TransferContract"
        },
        "type": "TransferContract"
      }
    ],
    "ref_block_bytes": "e956",
    "ref_block_hash": "b0413c405002bec9",
    "expiration": 1782900528000,
    "timestamp": 1782900471309
  },
  "raw_data_hex": "0a02e9562208b0413c405002bec94080a79ce9f1335a65080112610a2d747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e5472616e73666572436f6e747261637412300a15413e715d653654406b1707aa6dda01b43f8acadfe6121541ac27ae19688035bf9b3f5f3baa488315f157770a1807"
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Get reward

POST

https://trx-blockbook.nownodes.io/wallet/getReward

Returns the unwithdrawn voting rewards for an account. Shows the accumulated rewards from voting for Super Representatives. Rewards can be withdrawn using the withdrawbalance method.

Body

application/json

Request value.

addressstringrequired

The account address in base58 format to check rewards for.

visibleboolean

Whether the address is in base58 format.

Response

200OK

HTTP 200 response for getReward. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get reward

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/getReward' \
  -H 'Content-Type: application/json' \
  -d '{
    "address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
    "visible": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/getReward', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
      "visible": true
    }),
});

const data = await response.json();

import requests

payload = {
  "address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
  "visible": True
}

response = requests.post('https://trx-blockbook.nownodes.io/wallet/getReward', json=payload)
data = response.json()

Request Body

{
  "address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
  "visible": true
}

{
  "result": true,
  "blockID": "000000000502e9686b96165061a0c1deaa8818cb4c2950a60d0d713865b106d3"
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Get next maintenance time

POST

https://trx-blockbook.nownodes.io/wallet/getnextmaintenancetime

Returns the timestamp of the next maintenance period. Maintenance periods are when Super Representative elections occur and rewards are distributed. This helps users know when to expect network updates.

Body

application/json

No parameters required for this endpoint.

object

Response

200OK

HTTP 200 response for getnextmaintenancetime. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get next maintenance time

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/getnextmaintenancetime' \
  -H 'Content-Type: application/json' \
  -d '"request_example"'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/getnextmaintenancetime', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify("request_example"),
});

const data = await response.json();

import requests

payload = "request_example"

response = requests.post('https://trx-blockbook.nownodes.io/wallet/getnextmaintenancetime', json=payload)
data = response.json()

Request Body

"request_example"

{
  "result": true,
  "blockID": "000000000502e9686b96165061a0c1deaa8818cb4c2950a60d0d713865b106d3"
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Proposals

Proposals operations.

Create proposal

POST

https://trx-blockbook.nownodes.io/wallet/proposalcreate

Creates a new governance proposal for modifying network parameters. Only Super Representatives (witnesses) can create proposals. Proposals can change various network parameters like block rewards, fees, and resource costs.

Body

application/json

Request value.

owner_addressstringrequired

The Super Representative address creating the proposal in base58 format.

parametersobjectrequired

Key-value pairs of parameters to modify. Keys are parameter IDs, values are the new parameter values.

visibleboolean

Whether the address is in base58 format.

Response

200OK

HTTP 200 response for proposalcreate. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Create proposal

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/proposalcreate' \
  -H 'Content-Type: application/json' \
  -d '{
    "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
    "parameters": {
      "1": 10000000,
      "2": 50000000
    },
    "visible": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/proposalcreate', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
      "parameters": {
        "1": 10000000,
        "2": 50000000
      },
      "visible": true
    }),
});

const data = await response.json();

import requests

payload = {
  "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
  "parameters": {
    "1": 10000000,
    "2": 50000000
  },
  "visible": True
}

response = requests.post('https://trx-blockbook.nownodes.io/wallet/proposalcreate', json=payload)
data = response.json()

Request Body

{
  "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
  "parameters": {
    "1": 10000000,
    "2": 50000000
  },
  "visible": true
}

{
  "txID": "aaeb5bfd0d5f5a4ba8c825bdc8bc6f6ceaec896f11f31c1374d9285dc0c12906",
  "raw_data": {
    "contract": [
      {
        "parameter": {
          "value": {
            "amount": 7,
            "owner_address": "41A614F803B6FD780986A42C78EC9C7F77E6DED13C",
            "to_address": "41ac27ae19688035bf9b3f5f3baa488315f157770a"
          },
          "type_url": "type.googleapis.com/protocol.TransferContract"
        },
        "type": "TransferContract"
      }
    ],
    "ref_block_bytes": "e956",
    "ref_block_hash": "b0413c405002bec9",
    "expiration": 1782900528000,
    "timestamp": 1782900471309
  },
  "raw_data_hex": "0a02e9562208b0413c405002bec94080a79ce9f1335a65080112610a2d747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e5472616e73666572436f6e747261637412300a15413e715d653654406b1707aa6dda01b43f8acadfe6121541ac27ae19688035bf9b3f5f3baa488315f157770a1807"
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Get proposal by ID

POST

https://trx-blockbook.nownodes.io/wallet/getproposalbyid

Returns detailed information about a specific governance proposal by its proposal ID. Shows proposal parameters, voting status, and approval information.

Body

application/json

Request value.

idintegerrequired

The proposal ID to retrieve.

Response

200OK

HTTP 200 response for getproposalbyid. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get proposal by ID

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/getproposalbyid' \
  -H 'Content-Type: application/json' \
  -d '{
    "id": 1
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/getproposalbyid', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "id": 1
    }),
});

const data = await response.json();

import requests

payload = {
  "id": 1
}

response = requests.post('https://trx-blockbook.nownodes.io/wallet/getproposalbyid', json=payload)
data = response.json()

Request Body

{
  "id": 1
}

{
  "txID": "aaeb5bfd0d5f5a4ba8c825bdc8bc6f6ceaec896f11f31c1374d9285dc0c12906",
  "raw_data": {
    "contract": [
      {
        "parameter": {
          "value": {
            "amount": 7,
            "owner_address": "41A614F803B6FD780986A42C78EC9C7F77E6DED13C",
            "to_address": "41ac27ae19688035bf9b3f5f3baa488315f157770a"
          },
          "type_url": "type.googleapis.com/protocol.TransferContract"
        },
        "type": "TransferContract"
      }
    ],
    "ref_block_bytes": "e956",
    "ref_block_hash": "b0413c405002bec9",
    "expiration": 1782900528000,
    "timestamp": 1782900471309
  },
  "raw_data_hex": "0a02e9562208b0413c405002bec94080a79ce9f1335a65080112610a2d747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e5472616e73666572436f6e747261637412300a15413e715d653654406b1707aa6dda01b43f8acadfe6121541ac27ae19688035bf9b3f5f3baa488315f157770a1807"
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

List proposals

POST

https://trx-blockbook.nownodes.io/wallet/listproposals

Returns a list of all governance proposals on the network. Includes both active and historical proposals with their current status.

Body

application/json

No parameters required for this endpoint.

object

Response

200OK

HTTP 200 response for listproposals. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

List proposals

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/listproposals' \
  -H 'Content-Type: application/json' \
  -d '"request_example"'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/listproposals', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify("request_example"),
});

const data = await response.json();

import requests

payload = "request_example"

response = requests.post('https://trx-blockbook.nownodes.io/wallet/listproposals', json=payload)
data = response.json()

Request Body

"request_example"

{
  "txID": "aaeb5bfd0d5f5a4ba8c825bdc8bc6f6ceaec896f11f31c1374d9285dc0c12906",
  "raw_data": {
    "contract": [
      {
        "parameter": {
          "value": {
            "amount": 7,
            "owner_address": "41A614F803B6FD780986A42C78EC9C7F77E6DED13C",
            "to_address": "41ac27ae19688035bf9b3f5f3baa488315f157770a"
          },
          "type_url": "type.googleapis.com/protocol.TransferContract"
        },
        "type": "TransferContract"
      }
    ],
    "ref_block_bytes": "e956",
    "ref_block_hash": "b0413c405002bec9",
    "expiration": 1782900528000,
    "timestamp": 1782900471309
  },
  "raw_data_hex": "0a02e9562208b0413c405002bec94080a79ce9f1335a65080112610a2d747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e5472616e73666572436f6e747261637412300a15413e715d653654406b1707aa6dda01b43f8acadfe6121541ac27ae19688035bf9b3f5f3baa488315f157770a1807"
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Approve proposal

POST

https://trx-blockbook.nownodes.io/wallet/proposalapprove

Approves a governance proposal. Only Super Representatives can approve proposals. Proposals require approval from a sufficient number of SRs to be enacted.

Body

application/json

Request value.

owner_addressstringrequired

The Super Representative address approving the proposal in base58 format.

proposal_idintegerrequired

The proposal ID to approve.

is_add_approvalbooleanrequired

Whether to add approval (true) or remove approval (false). true - approve the proposal false - remove existing approval

visibleboolean

Whether the address is in base58 format.

Response

200OK

HTTP 200 response for proposalapprove. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Approve proposal

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/proposalapprove' \
  -H 'Content-Type: application/json' \
  -d '{
    "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
    "proposal_id": 1,
    "is_add_approval": true,
    "visible": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/proposalapprove', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
      "proposal_id": 1,
      "is_add_approval": true,
      "visible": true
    }),
});

const data = await response.json();

import requests

payload = {
  "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
  "proposal_id": 1,
  "is_add_approval": True,
  "visible": True
}

response = requests.post('https://trx-blockbook.nownodes.io/wallet/proposalapprove', json=payload)
data = response.json()

Request Body

{
  "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
  "proposal_id": 1,
  "is_add_approval": true,
  "visible": true
}

{
  "txID": "aaeb5bfd0d5f5a4ba8c825bdc8bc6f6ceaec896f11f31c1374d9285dc0c12906",
  "raw_data": {
    "contract": [
      {
        "parameter": {
          "value": {
            "amount": 7,
            "owner_address": "41A614F803B6FD780986A42C78EC9C7F77E6DED13C",
            "to_address": "41ac27ae19688035bf9b3f5f3baa488315f157770a"
          },
          "type_url": "type.googleapis.com/protocol.TransferContract"
        },
        "type": "TransferContract"
      }
    ],
    "ref_block_bytes": "e956",
    "ref_block_hash": "b0413c405002bec9",
    "expiration": 1782900528000,
    "timestamp": 1782900471309
  },
  "raw_data_hex": "0a02e9562208b0413c405002bec94080a79ce9f1335a65080112610a2d747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e5472616e73666572436f6e747261637412300a15413e715d653654406b1707aa6dda01b43f8acadfe6121541ac27ae19688035bf9b3f5f3baa488315f157770a1807"
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Delete proposal

POST

https://trx-blockbook.nownodes.io/wallet/proposaldelete

Deletes (cancels) a governance proposal. Only the proposal creator can delete their own proposal. Deleted proposals cannot be approved or enacted.

Body

application/json

Request value.

owner_addressstringrequired

The proposal creator address in base58 format.

proposal_idintegerrequired

The proposal ID to delete.

visibleboolean

Whether the address is in base58 format.

Response

200OK

HTTP 200 response for proposaldelete. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Delete proposal

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/proposaldelete' \
  -H 'Content-Type: application/json' \
  -d '{
    "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
    "proposal_id": 1,
    "visible": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/proposaldelete', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
      "proposal_id": 1,
      "visible": true
    }),
});

const data = await response.json();

import requests

payload = {
  "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
  "proposal_id": 1,
  "visible": True
}

response = requests.post('https://trx-blockbook.nownodes.io/wallet/proposaldelete', json=payload)
data = response.json()

Request Body

{
  "owner_address": "TFF4w6J8XuQABYm8bZvKMVj6t2G7G2Z1iE",
  "proposal_id": 1,
  "visible": true
}

{
  "txID": "aaeb5bfd0d5f5a4ba8c825bdc8bc6f6ceaec896f11f31c1374d9285dc0c12906",
  "raw_data": {
    "contract": [
      {
        "parameter": {
          "value": {
            "amount": 7,
            "owner_address": "41A614F803B6FD780986A42C78EC9C7F77E6DED13C",
            "to_address": "41ac27ae19688035bf9b3f5f3baa488315f157770a"
          },
          "type_url": "type.googleapis.com/protocol.TransferContract"
        },
        "type": "TransferContract"
      }
    ],
    "ref_block_bytes": "e956",
    "ref_block_hash": "b0413c405002bec9",
    "expiration": 1782900528000,
    "timestamp": 1782900471309
  },
  "raw_data_hex": "0a02e9562208b0413c405002bec94080a79ce9f1335a65080112610a2d747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e5472616e73666572436f6e747261637412300a15413e715d653654406b1707aa6dda01b43f8acadfe6121541ac27ae19688035bf9b3f5f3baa488315f157770a1807"
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Get paginated proposal list

POST

https://trx-blockbook.nownodes.io/wallet/getpaginatedproposallist

Returns a paginated list of governance proposals. Useful for efficiently browsing large numbers of proposals with pagination controls.

Body

application/json

Request value.

offsetintegerrequired

The starting index for pagination (0-based).

limitintegerrequired

The maximum number of proposals to return.

Response

200OK

HTTP 200 response for getpaginatedproposallist. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get paginated proposal list

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/getpaginatedproposallist' \
  -H 'Content-Type: application/json' \
  -d '{
    "offset": 0,
    "limit": 20
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/getpaginatedproposallist', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "offset": 0,
      "limit": 20
    }),
});

const data = await response.json();

import requests

payload = {
  "offset": 0,
  "limit": 20
}

response = requests.post('https://trx-blockbook.nownodes.io/wallet/getpaginatedproposallist', json=payload)
data = response.json()

Request Body

{
  "offset": 0,
  "limit": 20
}

{
  "txID": "aaeb5bfd0d5f5a4ba8c825bdc8bc6f6ceaec896f11f31c1374d9285dc0c12906",
  "raw_data": {
    "contract": [
      {
        "parameter": {
          "value": {
            "amount": 7,
            "owner_address": "41A614F803B6FD780986A42C78EC9C7F77E6DED13C",
            "to_address": "41ac27ae19688035bf9b3f5f3baa488315f157770a"
          },
          "type_url": "type.googleapis.com/protocol.TransferContract"
        },
        "type": "TransferContract"
      }
    ],
    "ref_block_bytes": "e956",
    "ref_block_hash": "b0413c405002bec9",
    "expiration": 1782900528000,
    "timestamp": 1782900471309
  },
  "raw_data_hex": "0a02e9562208b0413c405002bec94080a79ce9f1335a65080112610a2d747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e5472616e73666572436f6e747261637412300a15413e715d653654406b1707aa6dda01b43f8acadfe6121541ac27ae19688035bf9b3f5f3baa488315f157770a1807"
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

DEX Exchange

DEX Exchange operations.

Create a token exchange

POST

https://trx-blockbook.nownodes.io/wallet/exchangecreate

Create a new token exchange between TRX and a TRC10 token. This operation requires a certain amount of TRX as a fee.

Body

application/json

Request value.

owner_addressstringrequired

The owner address that creates the exchange, in hex string format

first_token_idstringrequired

The id of the first token, if it's TRX, should be "_"

first_token_balanceintegerrequired

The balance of the first token

second_token_idstringrequired

The id of the second token, can be any TRC10 token id

second_token_balanceintegerrequired

The balance of the second token

visibleboolean

Whether the address is in base58 format

Response

200OK

HTTP 200 response for exchangecreate. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Create a token exchange

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/exchangecreate' \
  -H 'Content-Type: application/json' \
  -d '{
    "owner_address": "41e9d79cc47518930bc322d9bf7cddd260a0260a8d",
    "first_token_id": "_",
    "first_token_balance": 100000000,
    "second_token_id": "1000001",
    "second_token_balance": 500000000000,
    "visible": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/exchangecreate', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "owner_address": "41e9d79cc47518930bc322d9bf7cddd260a0260a8d",
      "first_token_id": "_",
      "first_token_balance": 100000000,
      "second_token_id": "1000001",
      "second_token_balance": 500000000000,
      "visible": true
    }),
});

const data = await response.json();

import requests

payload = {
  "owner_address": "41e9d79cc47518930bc322d9bf7cddd260a0260a8d",
  "first_token_id": "_",
  "first_token_balance": 100000000,
  "second_token_id": "1000001",
  "second_token_balance": 500000000000,
  "visible": True
}

response = requests.post('https://trx-blockbook.nownodes.io/wallet/exchangecreate', json=payload)
data = response.json()

Request Body

{
  "owner_address": "41e9d79cc47518930bc322d9bf7cddd260a0260a8d",
  "first_token_id": "_",
  "first_token_balance": 100000000,
  "second_token_id": "1000001",
  "second_token_balance": 500000000000,
  "visible": true
}

{
  "txID": "aaeb5bfd0d5f5a4ba8c825bdc8bc6f6ceaec896f11f31c1374d9285dc0c12906",
  "raw_data": {
    "contract": [
      {
        "parameter": {
          "value": {
            "amount": 7,
            "owner_address": "41A614F803B6FD780986A42C78EC9C7F77E6DED13C",
            "to_address": "41ac27ae19688035bf9b3f5f3baa488315f157770a"
          },
          "type_url": "type.googleapis.com/protocol.TransferContract"
        },
        "type": "TransferContract"
      }
    ],
    "ref_block_bytes": "e956",
    "ref_block_hash": "b0413c405002bec9",
    "expiration": 1782900528000,
    "timestamp": 1782900471309
  },
  "raw_data_hex": "0a02e9562208b0413c405002bec94080a79ce9f1335a65080112610a2d747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e5472616e73666572436f6e747261637412300a15413e715d653654406b1707aa6dda01b43f8acadfe6121541ac27ae19688035bf9b3f5f3baa488315f157770a1807"
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Add liquidity to an exchange

POST

https://trx-blockbook.nownodes.io/wallet/exchangeinject

Add tokens to a token exchange. Need to specify the token and amount to add.

Body

application/json

Request value.

owner_addressstringrequired

The owner address that adds tokens to the exchange, in hex string format

exchange_idintegerrequired

The id of the exchange

token_idstringrequired

The id of the token, if it's TRX, should be "_"

quantintegerrequired

The amount of tokens to add

visibleboolean

Whether the address is in base58 format

Response

200OK

HTTP 200 response for exchangeinject. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Add liquidity to an exchange

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/exchangeinject' \
  -H 'Content-Type: application/json' \
  -d '{
    "owner_address": "41e9d79cc47518930bc322d9bf7cddd260a0260a8d",
    "exchange_id": 1,
    "token_id": "_",
    "quant": 10000000,
    "visible": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/exchangeinject', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "owner_address": "41e9d79cc47518930bc322d9bf7cddd260a0260a8d",
      "exchange_id": 1,
      "token_id": "_",
      "quant": 10000000,
      "visible": true
    }),
});

const data = await response.json();

import requests

payload = {
  "owner_address": "41e9d79cc47518930bc322d9bf7cddd260a0260a8d",
  "exchange_id": 1,
  "token_id": "_",
  "quant": 10000000,
  "visible": True
}

response = requests.post('https://trx-blockbook.nownodes.io/wallet/exchangeinject', json=payload)
data = response.json()

Request Body

{
  "owner_address": "41e9d79cc47518930bc322d9bf7cddd260a0260a8d",
  "exchange_id": 1,
  "token_id": "_",
  "quant": 10000000,
  "visible": true
}

{
  "txID": "aaeb5bfd0d5f5a4ba8c825bdc8bc6f6ceaec896f11f31c1374d9285dc0c12906",
  "raw_data": {
    "contract": [
      {
        "parameter": {
          "value": {
            "amount": 7,
            "owner_address": "41A614F803B6FD780986A42C78EC9C7F77E6DED13C",
            "to_address": "41ac27ae19688035bf9b3f5f3baa488315f157770a"
          },
          "type_url": "type.googleapis.com/protocol.TransferContract"
        },
        "type": "TransferContract"
      }
    ],
    "ref_block_bytes": "e956",
    "ref_block_hash": "b0413c405002bec9",
    "expiration": 1782900528000,
    "timestamp": 1782900471309
  },
  "raw_data_hex": "0a02e9562208b0413c405002bec94080a79ce9f1335a65080112610a2d747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e5472616e73666572436f6e747261637412300a15413e715d653654406b1707aa6dda01b43f8acadfe6121541ac27ae19688035bf9b3f5f3baa488315f157770a1807"
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Remove liquidity from an exchange

POST

https://trx-blockbook.nownodes.io/wallet/exchangewithdraw

Remove tokens from a token exchange. Need to specify the token and amount to withdraw.

Body

application/json

Request value.

owner_addressstringrequired

The owner address that withdraws tokens from the exchange, in hex string format

exchange_idintegerrequired

The id of the exchange

token_idstringrequired

The id of the token, if it's TRX, should be "_"

quantintegerrequired

The amount of tokens to withdraw

visibleboolean

Whether the address is in base58 format

Response

200OK

HTTP 200 response for exchangewithdraw. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Remove liquidity from an exchange

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/exchangewithdraw' \
  -H 'Content-Type: application/json' \
  -d '{
    "owner_address": "41e9d79cc47518930bc322d9bf7cddd260a0260a8d",
    "exchange_id": 1,
    "token_id": "_",
    "quant": 5000000,
    "visible": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/exchangewithdraw', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "owner_address": "41e9d79cc47518930bc322d9bf7cddd260a0260a8d",
      "exchange_id": 1,
      "token_id": "_",
      "quant": 5000000,
      "visible": true
    }),
});

const data = await response.json();

import requests

payload = {
  "owner_address": "41e9d79cc47518930bc322d9bf7cddd260a0260a8d",
  "exchange_id": 1,
  "token_id": "_",
  "quant": 5000000,
  "visible": True
}

response = requests.post('https://trx-blockbook.nownodes.io/wallet/exchangewithdraw', json=payload)
data = response.json()

Request Body

{
  "owner_address": "41e9d79cc47518930bc322d9bf7cddd260a0260a8d",
  "exchange_id": 1,
  "token_id": "_",
  "quant": 5000000,
  "visible": true
}

{
  "txID": "aaeb5bfd0d5f5a4ba8c825bdc8bc6f6ceaec896f11f31c1374d9285dc0c12906",
  "raw_data": {
    "contract": [
      {
        "parameter": {
          "value": {
            "amount": 7,
            "owner_address": "41A614F803B6FD780986A42C78EC9C7F77E6DED13C",
            "to_address": "41ac27ae19688035bf9b3f5f3baa488315f157770a"
          },
          "type_url": "type.googleapis.com/protocol.TransferContract"
        },
        "type": "TransferContract"
      }
    ],
    "ref_block_bytes": "e956",
    "ref_block_hash": "b0413c405002bec9",
    "expiration": 1782900528000,
    "timestamp": 1782900471309
  },
  "raw_data_hex": "0a02e9562208b0413c405002bec94080a79ce9f1335a65080112610a2d747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e5472616e73666572436f6e747261637412300a15413e715d653654406b1707aa6dda01b43f8acadfe6121541ac27ae19688035bf9b3f5f3baa488315f157770a1807"
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Trade tokens on an exchange

POST

https://trx-blockbook.nownodes.io/wallet/exchangetransaction

Trade tokens on a decentralized exchange. This operation exchanges one token for another.

Body

application/json

Request value.

owner_addressstringrequired

The owner address that trades tokens, in hex string format

exchange_idintegerrequired

The id of the exchange

token_idstringrequired

The id of the token sold, if it's TRX, should be "_"

quantintegerrequired

The amount of tokens to sell

expectedintegerrequired

The expected amount of tokens to buy (minimum acceptable amount)

visibleboolean

Whether the address is in base58 format

Response

200OK

HTTP 200 response for exchangetransaction. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Trade tokens on an exchange

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/exchangetransaction' \
  -H 'Content-Type: application/json' \
  -d '{
    "owner_address": "41e9d79cc47518930bc322d9bf7cddd260a0260a8d",
    "exchange_id": 1,
    "token_id": "_",
    "quant": 1000000,
    "expected": 500000000,
    "visible": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/exchangetransaction', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "owner_address": "41e9d79cc47518930bc322d9bf7cddd260a0260a8d",
      "exchange_id": 1,
      "token_id": "_",
      "quant": 1000000,
      "expected": 500000000,
      "visible": true
    }),
});

const data = await response.json();

import requests

payload = {
  "owner_address": "41e9d79cc47518930bc322d9bf7cddd260a0260a8d",
  "exchange_id": 1,
  "token_id": "_",
  "quant": 1000000,
  "expected": 500000000,
  "visible": True
}

response = requests.post('https://trx-blockbook.nownodes.io/wallet/exchangetransaction', json=payload)
data = response.json()

Request Body

{
  "owner_address": "41e9d79cc47518930bc322d9bf7cddd260a0260a8d",
  "exchange_id": 1,
  "token_id": "_",
  "quant": 1000000,
  "expected": 500000000,
  "visible": true
}

{
  "txID": "aaeb5bfd0d5f5a4ba8c825bdc8bc6f6ceaec896f11f31c1374d9285dc0c12906",
  "raw_data": {
    "contract": [
      {
        "parameter": {
          "value": {
            "amount": 7,
            "owner_address": "41A614F803B6FD780986A42C78EC9C7F77E6DED13C",
            "to_address": "41ac27ae19688035bf9b3f5f3baa488315f157770a"
          },
          "type_url": "type.googleapis.com/protocol.TransferContract"
        },
        "type": "TransferContract"
      }
    ],
    "ref_block_bytes": "e956",
    "ref_block_hash": "b0413c405002bec9",
    "expiration": 1782900528000,
    "timestamp": 1782900471309
  },
  "raw_data_hex": "0a02e9562208b0413c405002bec94080a79ce9f1335a65080112610a2d747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e5472616e73666572436f6e747261637412300a15413e715d653654406b1707aa6dda01b43f8acadfe6121541ac27ae19688035bf9b3f5f3baa488315f157770a1807"
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Get exchange information by ID

POST

https://trx-blockbook.nownodes.io/wallet/getexchangebyid

Query the information of a token exchange by exchange ID.

Body

application/json

Request value.

idintegerrequired

The id of the exchange

visibleboolean

Whether the address is in base58 format

Response

200OK

HTTP 200 response for getexchangebyid. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get exchange information by ID

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/getexchangebyid' \
  -H 'Content-Type: application/json' \
  -d '{
    "id": 1,
    "visible": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/getexchangebyid', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "id": 1,
      "visible": true
    }),
});

const data = await response.json();

import requests

payload = {
  "id": 1,
  "visible": True
}

response = requests.post('https://trx-blockbook.nownodes.io/wallet/getexchangebyid', json=payload)
data = response.json()

Request Body

{
  "id": 1,
  "visible": true
}

{
  "txID": "aaeb5bfd0d5f5a4ba8c825bdc8bc6f6ceaec896f11f31c1374d9285dc0c12906",
  "raw_data": {
    "contract": [
      {
        "parameter": {
          "value": {
            "amount": 7,
            "owner_address": "41A614F803B6FD780986A42C78EC9C7F77E6DED13C",
            "to_address": "41ac27ae19688035bf9b3f5f3baa488315f157770a"
          },
          "type_url": "type.googleapis.com/protocol.TransferContract"
        },
        "type": "TransferContract"
      }
    ],
    "ref_block_bytes": "e956",
    "ref_block_hash": "b0413c405002bec9",
    "expiration": 1782900528000,
    "timestamp": 1782900471309
  },
  "raw_data_hex": "0a02e9562208b0413c405002bec94080a79ce9f1335a65080112610a2d747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e5472616e73666572436f6e747261637412300a15413e715d653654406b1707aa6dda01b43f8acadfe6121541ac27ae19688035bf9b3f5f3baa488315f157770a1807"
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

List all exchanges

POST

https://trx-blockbook.nownodes.io/wallet/listexchanges

List all token exchanges on the blockchain.

Body

application/json

Request value.

visibleboolean

Whether the address is in base58 format

Response

200OK

HTTP 200 response for listexchanges. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

List all exchanges

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/listexchanges' \
  -H 'Content-Type: application/json' \
  -d '{
    "visible": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/listexchanges', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "visible": true
    }),
});

const data = await response.json();

import requests

payload = {
  "visible": True
}

response = requests.post('https://trx-blockbook.nownodes.io/wallet/listexchanges', json=payload)
data = response.json()

Request Body

{
  "visible": true
}

{
  "txID": "aaeb5bfd0d5f5a4ba8c825bdc8bc6f6ceaec896f11f31c1374d9285dc0c12906",
  "raw_data": {
    "contract": [
      {
        "parameter": {
          "value": {
            "amount": 7,
            "owner_address": "41A614F803B6FD780986A42C78EC9C7F77E6DED13C",
            "to_address": "41ac27ae19688035bf9b3f5f3baa488315f157770a"
          },
          "type_url": "type.googleapis.com/protocol.TransferContract"
        },
        "type": "TransferContract"
      }
    ],
    "ref_block_bytes": "e956",
    "ref_block_hash": "b0413c405002bec9",
    "expiration": 1782900528000,
    "timestamp": 1782900471309
  },
  "raw_data_hex": "0a02e9562208b0413c405002bec94080a79ce9f1335a65080112610a2d747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e5472616e73666572436f6e747261637412300a15413e715d653654406b1707aa6dda01b43f8acadfe6121541ac27ae19688035bf9b3f5f3baa488315f157770a1807"
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Get paginated exchange list

POST

https://trx-blockbook.nownodes.io/wallet/getpaginatedexchangelist

Query the list of exchanges in pagination.

Body

application/json

Request value.

offsetintegerrequired

Index of the starting exchange

limitintegerrequired

Number of exchanges to return

visibleboolean

Whether the address is in base58 format

Response

200OK

HTTP 200 response for getpaginatedexchangelist. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get paginated exchange list

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/getpaginatedexchangelist' \
  -H 'Content-Type: application/json' \
  -d '{
    "offset": 0,
    "limit": 10,
    "visible": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/getpaginatedexchangelist', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "offset": 0,
      "limit": 10,
      "visible": true
    }),
});

const data = await response.json();

import requests

payload = {
  "offset": 0,
  "limit": 10,
  "visible": True
}

response = requests.post('https://trx-blockbook.nownodes.io/wallet/getpaginatedexchangelist', json=payload)
data = response.json()

Request Body

{
  "offset": 0,
  "limit": 10,
  "visible": true
}

{
  "txID": "aaeb5bfd0d5f5a4ba8c825bdc8bc6f6ceaec896f11f31c1374d9285dc0c12906",
  "raw_data": {
    "contract": [
      {
        "parameter": {
          "value": {
            "amount": 7,
            "owner_address": "41A614F803B6FD780986A42C78EC9C7F77E6DED13C",
            "to_address": "41ac27ae19688035bf9b3f5f3baa488315f157770a"
          },
          "type_url": "type.googleapis.com/protocol.TransferContract"
        },
        "type": "TransferContract"
      }
    ],
    "ref_block_bytes": "e956",
    "ref_block_hash": "b0413c405002bec9",
    "expiration": 1782900528000,
    "timestamp": 1782900471309
  },
  "raw_data_hex": "0a02e9562208b0413c405002bec94080a79ce9f1335a65080112610a2d747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e5472616e73666572436f6e747261637412300a15413e715d653654406b1707aa6dda01b43f8acadfe6121541ac27ae19688035bf9b3f5f3baa488315f157770a1807"
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Place a market sell order

POST

https://trx-blockbook.nownodes.io/wallet/marketsellasset

Place a sell order on the market.

Body

application/json

Request value.

owner_addressstringrequired

The owner address that places the sell order, in hex string format

sell_token_idstringrequired

The id of the token to sell

sell_token_quantityintegerrequired

The quantity of tokens to sell

buy_token_idstringrequired

The id of the token to buy

buy_token_quantityintegerrequired

The quantity of tokens to buy

visibleboolean

Whether the address is in base58 format

Response

200OK

HTTP 200 response for marketsellasset. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Place a market sell order

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/marketsellasset' \
  -H 'Content-Type: application/json' \
  -d '{
    "owner_address": "41e9d79cc47518930bc322d9bf7cddd260a0260a8d",
    "sell_token_id": "1000001",
    "sell_token_quantity": 100000000,
    "buy_token_id": "_",
    "buy_token_quantity": 1000000,
    "visible": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/marketsellasset', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "owner_address": "41e9d79cc47518930bc322d9bf7cddd260a0260a8d",
      "sell_token_id": "1000001",
      "sell_token_quantity": 100000000,
      "buy_token_id": "_",
      "buy_token_quantity": 1000000,
      "visible": true
    }),
});

const data = await response.json();

import requests

payload = {
  "owner_address": "41e9d79cc47518930bc322d9bf7cddd260a0260a8d",
  "sell_token_id": "1000001",
  "sell_token_quantity": 100000000,
  "buy_token_id": "_",
  "buy_token_quantity": 1000000,
  "visible": True
}

response = requests.post('https://trx-blockbook.nownodes.io/wallet/marketsellasset', json=payload)
data = response.json()

Request Body

{
  "owner_address": "41e9d79cc47518930bc322d9bf7cddd260a0260a8d",
  "sell_token_id": "1000001",
  "sell_token_quantity": 100000000,
  "buy_token_id": "_",
  "buy_token_quantity": 1000000,
  "visible": true
}

{
  "assetIssue": [
    {
      "id": "1004108",
      "name": "TRX",
      "abbr": "trx",
      "total_supply": 100000000
    }
  ]
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Cancel a market order

POST

https://trx-blockbook.nownodes.io/wallet/marketcancelorder

Cancel an existing market order.

Body

application/json

Request value.

owner_addressstringrequired

The owner address that cancels the order, in hex string format

order_idstringrequired

The id of the order to cancel

visibleboolean

Whether the address is in base58 format

Response

200OK

HTTP 200 response for marketcancelorder. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Cancel a market order

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/marketcancelorder' \
  -H 'Content-Type: application/json' \
  -d '{
    "owner_address": "41e9d79cc47518930bc322d9bf7cddd260a0260a8d",
    "order_id": "1234567890abcdef",
    "visible": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/marketcancelorder', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "owner_address": "41e9d79cc47518930bc322d9bf7cddd260a0260a8d",
      "order_id": "1234567890abcdef",
      "visible": true
    }),
});

const data = await response.json();

import requests

payload = {
  "owner_address": "41e9d79cc47518930bc322d9bf7cddd260a0260a8d",
  "order_id": "1234567890abcdef",
  "visible": True
}

response = requests.post('https://trx-blockbook.nownodes.io/wallet/marketcancelorder', json=payload)
data = response.json()

Request Body

{
  "owner_address": "41e9d79cc47518930bc322d9bf7cddd260a0260a8d",
  "order_id": "1234567890abcdef",
  "visible": true
}

{
  "txID": "aaeb5bfd0d5f5a4ba8c825bdc8bc6f6ceaec896f11f31c1374d9285dc0c12906",
  "raw_data": {
    "contract": [
      {
        "parameter": {
          "value": {
            "amount": 7,
            "owner_address": "41A614F803B6FD780986A42C78EC9C7F77E6DED13C",
            "to_address": "41ac27ae19688035bf9b3f5f3baa488315f157770a"
          },
          "type_url": "type.googleapis.com/protocol.TransferContract"
        },
        "type": "TransferContract"
      }
    ],
    "ref_block_bytes": "e956",
    "ref_block_hash": "b0413c405002bec9",
    "expiration": 1782900528000,
    "timestamp": 1782900471309
  },
  "raw_data_hex": "0a02e9562208b0413c405002bec94080a79ce9f1335a65080112610a2d747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e5472616e73666572436f6e747261637412300a15413e715d653654406b1707aa6dda01b43f8acadfe6121541ac27ae19688035bf9b3f5f3baa488315f157770a1807"
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Get market orders by account

POST

https://trx-blockbook.nownodes.io/wallet/getmarketorderbyaccount

Query market orders by account address.

Body

application/json

Request value.

valuestringrequired

The account address in hex string format

visibleboolean

Whether the address is in base58 format

Response

200OK

HTTP 200 response for getmarketorderbyaccount. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get market orders by account

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/getmarketorderbyaccount' \
  -H 'Content-Type: application/json' \
  -d '{
    "value": "41e9d79cc47518930bc322d9bf7cddd260a0260a8d",
    "visible": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/getmarketorderbyaccount', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "value": "41e9d79cc47518930bc322d9bf7cddd260a0260a8d",
      "visible": true
    }),
});

const data = await response.json();

import requests

payload = {
  "value": "41e9d79cc47518930bc322d9bf7cddd260a0260a8d",
  "visible": True
}

response = requests.post('https://trx-blockbook.nownodes.io/wallet/getmarketorderbyaccount', json=payload)
data = response.json()

Request Body

{
  "value": "41e9d79cc47518930bc322d9bf7cddd260a0260a8d",
  "visible": true
}

{
  "size": 12
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Get market pair list

POST

https://trx-blockbook.nownodes.io/wallet/getmarketpairlist

Query the list of all trading pairs on the market.

Body

application/json

Request value.

visibleboolean

Whether the address is in base58 format

Response

200OK

HTTP 200 response for getmarketpairlist. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get market pair list

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/getmarketpairlist' \
  -H 'Content-Type: application/json' \
  -d '{
    "visible": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/getmarketpairlist', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "visible": true
    }),
});

const data = await response.json();

import requests

payload = {
  "visible": True
}

response = requests.post('https://trx-blockbook.nownodes.io/wallet/getmarketpairlist', json=payload)
data = response.json()

Request Body

{
  "visible": true
}

{
  "txID": "aaeb5bfd0d5f5a4ba8c825bdc8bc6f6ceaec896f11f31c1374d9285dc0c12906",
  "raw_data": {
    "contract": [
      {
        "parameter": {
          "value": {
            "amount": 7,
            "owner_address": "41A614F803B6FD780986A42C78EC9C7F77E6DED13C",
            "to_address": "41ac27ae19688035bf9b3f5f3baa488315f157770a"
          },
          "type_url": "type.googleapis.com/protocol.TransferContract"
        },
        "type": "TransferContract"
      }
    ],
    "ref_block_bytes": "e956",
    "ref_block_hash": "b0413c405002bec9",
    "expiration": 1782900528000,
    "timestamp": 1782900471309
  },
  "raw_data_hex": "0a02e9562208b0413c405002bec94080a79ce9f1335a65080112610a2d747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e5472616e73666572436f6e747261637412300a15413e715d653654406b1707aa6dda01b43f8acadfe6121541ac27ae19688035bf9b3f5f3baa488315f157770a1807"
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Get market orders by trading pair

POST

https://trx-blockbook.nownodes.io/wallet/getmarketorderlistbypair

Query market orders by trading pair.

Body

application/json

Request value.

sell_token_idstringrequired

The id of the sell token

buy_token_idstringrequired

The id of the buy token

visibleboolean

Whether the address is in base58 format

Response

200OK

HTTP 200 response for getmarketorderlistbypair. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get market orders by trading pair

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/getmarketorderlistbypair' \
  -H 'Content-Type: application/json' \
  -d '{
    "sell_token_id": "1000001",
    "buy_token_id": "_",
    "visible": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/getmarketorderlistbypair', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "sell_token_id": "1000001",
      "buy_token_id": "_",
      "visible": true
    }),
});

const data = await response.json();

import requests

payload = {
  "sell_token_id": "1000001",
  "buy_token_id": "_",
  "visible": True
}

response = requests.post('https://trx-blockbook.nownodes.io/wallet/getmarketorderlistbypair', json=payload)
data = response.json()

Request Body

{
  "sell_token_id": "1000001",
  "buy_token_id": "_",
  "visible": true
}

{
  "txID": "aaeb5bfd0d5f5a4ba8c825bdc8bc6f6ceaec896f11f31c1374d9285dc0c12906",
  "raw_data": {
    "contract": [
      {
        "parameter": {
          "value": {
            "amount": 7,
            "owner_address": "41A614F803B6FD780986A42C78EC9C7F77E6DED13C",
            "to_address": "41ac27ae19688035bf9b3f5f3baa488315f157770a"
          },
          "type_url": "type.googleapis.com/protocol.TransferContract"
        },
        "type": "TransferContract"
      }
    ],
    "ref_block_bytes": "e956",
    "ref_block_hash": "b0413c405002bec9",
    "expiration": 1782900528000,
    "timestamp": 1782900471309
  },
  "raw_data_hex": "0a02e9562208b0413c405002bec94080a79ce9f1335a65080112610a2d747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e5472616e73666572436f6e747261637412300a15413e715d653654406b1707aa6dda01b43f8acadfe6121541ac27ae19688035bf9b3f5f3baa488315f157770a1807"
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Get market price by trading pair

POST

https://trx-blockbook.nownodes.io/wallet/getmarketpricebypair

Query the market price of a trading pair.

Body

application/json

Request value.

sell_token_idstringrequired

The id of the sell token

buy_token_idstringrequired

The id of the buy token

visibleboolean

Whether the address is in base58 format

Response

200OK

HTTP 200 response for getmarketpricebypair. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get market price by trading pair

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/getmarketpricebypair' \
  -H 'Content-Type: application/json' \
  -d '{
    "sell_token_id": "1000001",
    "buy_token_id": "_",
    "visible": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/getmarketpricebypair', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "sell_token_id": "1000001",
      "buy_token_id": "_",
      "visible": true
    }),
});

const data = await response.json();

import requests

payload = {
  "sell_token_id": "1000001",
  "buy_token_id": "_",
  "visible": True
}

response = requests.post('https://trx-blockbook.nownodes.io/wallet/getmarketpricebypair', json=payload)
data = response.json()

Request Body

{
  "sell_token_id": "1000001",
  "buy_token_id": "_",
  "visible": true
}

{
  "txID": "aaeb5bfd0d5f5a4ba8c825bdc8bc6f6ceaec896f11f31c1374d9285dc0c12906",
  "raw_data": {
    "contract": [
      {
        "parameter": {
          "value": {
            "amount": 7,
            "owner_address": "41A614F803B6FD780986A42C78EC9C7F77E6DED13C",
            "to_address": "41ac27ae19688035bf9b3f5f3baa488315f157770a"
          },
          "type_url": "type.googleapis.com/protocol.TransferContract"
        },
        "type": "TransferContract"
      }
    ],
    "ref_block_bytes": "e956",
    "ref_block_hash": "b0413c405002bec9",
    "expiration": 1782900528000,
    "timestamp": 1782900471309
  },
  "raw_data_hex": "0a02e9562208b0413c405002bec94080a79ce9f1335a65080112610a2d747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e5472616e73666572436f6e747261637412300a15413e715d653654406b1707aa6dda01b43f8acadfe6121541ac27ae19688035bf9b3f5f3baa488315f157770a1807"
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Get market order by ID

POST

https://trx-blockbook.nownodes.io/wallet/getmarketorderbyid

Query a market order by order ID.

Body

application/json

Request value.

valuestringrequired

The order id

visibleboolean

Whether the address is in base58 format

Response

200OK

HTTP 200 response for getmarketorderbyid. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get market order by ID

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/getmarketorderbyid' \
  -H 'Content-Type: application/json' \
  -d '{
    "value": "1234567890abcdef",
    "visible": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/getmarketorderbyid', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "value": "1234567890abcdef",
      "visible": true
    }),
});

const data = await response.json();

import requests

payload = {
  "value": "1234567890abcdef",
  "visible": True
}

response = requests.post('https://trx-blockbook.nownodes.io/wallet/getmarketorderbyid', json=payload)
data = response.json()

Request Body

{
  "value": "1234567890abcdef",
  "visible": true
}

{
  "txID": "aaeb5bfd0d5f5a4ba8c825bdc8bc6f6ceaec896f11f31c1374d9285dc0c12906",
  "raw_data": {
    "contract": [
      {
        "parameter": {
          "value": {
            "amount": 7,
            "owner_address": "41A614F803B6FD780986A42C78EC9C7F77E6DED13C",
            "to_address": "41ac27ae19688035bf9b3f5f3baa488315f157770a"
          },
          "type_url": "type.googleapis.com/protocol.TransferContract"
        },
        "type": "TransferContract"
      }
    ],
    "ref_block_bytes": "e956",
    "ref_block_hash": "b0413c405002bec9",
    "expiration": 1782900528000,
    "timestamp": 1782900471309
  },
  "raw_data_hex": "0a02e9562208b0413c405002bec94080a79ce9f1335a65080112610a2d747970652e676f6f676c65617069732e636f6d2f70726f746f636f6c2e5472616e73666572436f6e747261637412300a15413e715d653654406b1707aa6dda01b43f8acadfe6121541ac27ae19688035bf9b3f5f3baa488315f157770a1807"
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Pending Pool

Pending Pool operations.

Get transaction from pending pool by ID

POST

https://trx-blockbook.nownodes.io/wallet/gettransactionfrompending

Query a transaction from the pending pool by its transaction ID. The pending pool contains transactions that have been broadcast but not yet included in a block.

Body

application/json

Request value.

valuestringrequired

The transaction ID in hex string format

visibleboolean

Whether the address is in base58 format

Response

200OK

HTTP 200 response for gettransactionfrompending. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

404Not Found

Transaction not found in pending pool

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get transaction from pending pool by ID

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/gettransactionfrompending' \
  -H 'Content-Type: application/json' \
  -d '{
    "value": "abc123def456abc123def456abc123def456abc123def456abc123def456abc123",
    "visible": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/gettransactionfrompending', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "value": "abc123def456abc123def456abc123def456abc123def456abc123def456abc123",
      "visible": true
    }),
});

const data = await response.json();

import requests

payload = {
  "value": "abc123def456abc123def456abc123def456abc123def456abc123def456abc123",
  "visible": True
}

response = requests.post('https://trx-blockbook.nownodes.io/wallet/gettransactionfrompending', json=payload)
data = response.json()

Request Body

{
  "value": "abc123def456abc123def456abc123def456abc123def456abc123def456abc123",
  "visible": true
}

{
  "result": true,
  "blockID": "000000000502e9686b96165061a0c1deaa8818cb4c2950a60d0d713865b106d3"
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

{
  "Error": "Transaction not found in pending pool"
}

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Get all transactions from pending pool

POST

https://trx-blockbook.nownodes.io/wallet/gettransactionlistfrompending

Query all transactions from the pending pool. Returns a list of all transactions that are currently waiting to be included in a block.

Body

application/json

Request value.

visibleboolean

Whether the address is in base58 format

Response

200OK

HTTP 200 response for gettransactionlistfrompending. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get all transactions from pending pool

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/gettransactionlistfrompending' \
  -H 'Content-Type: application/json' \
  -d '{
    "visible": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/gettransactionlistfrompending', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "visible": true
    }),
});

const data = await response.json();

import requests

payload = {
  "visible": True
}

response = requests.post('https://trx-blockbook.nownodes.io/wallet/gettransactionlistfrompending', json=payload)
data = response.json()

Request Body

{
  "visible": true
}

{
  "result": true,
  "blockID": "000000000502e9686b96165061a0c1deaa8818cb4c2950a60d0d713865b106d3"
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Get pending pool size

POST

https://trx-blockbook.nownodes.io/wallet/getpendingsize

Query the current size of the pending pool. Returns the number of transactions currently waiting to be processed.

Body

application/json

Request value.

visibleboolean

Whether the address is in base58 format

Response

200OK

HTTP 200 response for getpendingsize. The body contains either a successful result or a node-level error.

400Bad Request

Bad Request. The request is malformed or contains invalid parameters.

401Unauthorized

Unauthorized: API key is present but rejected by the NOWNodes gateway.

405Method Not Allowed

Method Not Allowed. Returned by the NOWNodes gateway for malformed or unsupported gateway-level requests.

422Unprocessable Entity

Missing API key. The NOWNodes gateway returns plain text for this error.

500Internal Server Error

Internal Server Error. The gateway or node failed while processing the request.

Authorization

api-keyAuthapiKey in header

NOWNodes API key passed in the api-key header.

Get pending pool size

curl -X POST 'https://trx-blockbook.nownodes.io/wallet/getpendingsize' \
  -H 'Content-Type: application/json' \
  -d '{
    "visible": true
  }'

const response = await fetch('https://trx-blockbook.nownodes.io/wallet/getpendingsize', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "visible": true
    }),
});

const data = await response.json();

import requests

payload = {
  "visible": True
}

response = requests.post('https://trx-blockbook.nownodes.io/wallet/getpendingsize', json=payload)
data = response.json()

Request Body

{
  "visible": true
}

{
  "size": 12
}

{
  "Error": "class org.tron.core.exception.ContractValidateException: Invalid parameter",
  "code": "CONTRACT_VALIDATE_ERROR"
}

{
  "code": 400,
  "message": "Bad Request"
}

Unknown API_key

Method Not Allowed

Missing API_key

{
  "code": 500,
  "message": "Internal Server Error"
}

Documentation

Authentication

MAINNET / Blockbook

BlockBook

Response

Authorization

Parameters

Response

Authorization

Parameters

Response

Authorization

Parameters

Response

Authorization

Parameters

Response

Authorization

Parameters

Response

Authorization

Parameters

Response

Authorization

Parameters

Response

Authorization

Parameters

Response

Authorization

Parameters

Response

Authorization

Body

Response

Authorization

BlockBook (legacy unversioned)

Response

Authorization

Parameters

Response

Authorization

Parameters

Response

Authorization

Parameters

Response

Authorization

Parameters

Response

Authorization

Parameters

Response

Authorization

Parameters

Response

Authorization

Parameters

Response

Authorization

Parameters

Response

Authorization

Parameters

Response

Authorization

Parameters

Response

Authorization

Body

Response

Authorization

MAINNET / EVM

eth_accounts

Body

Response

Authorization

eth_blockNumber

Body

Response