ICON ICX JSON-RPC API

v1.0.0

Base URL

https://icx.nownodes.io

Swagger definition for ICON (ICX) node JSON-RPC method icx_call

Authentication

api-keyAuthapiKey

API Key: api-key in header

Mainnet

icx_call

Call SCORE method

POST

https://icx.nownodes.io/api/v3

Executes a read-only call to a SCORE method without creating a transaction.

Body

application/json

JSON-RPC request object

jsonrpcstringrequired

JSON-RPC protocol version.

idintegerrequired

Unique identifier for the JSON-RPC request.

methodstringrequired

JSON-RPC method name.

paramsobjectrequired

Parameters for SCORE call.

Show child attributes

fromstring

Address of the caller.

tostring

SCORE address to call.

dataTypestring

Type of data payload.

dataobject

Call data for SCORE method.

Show child attributes

methodstring

Name of the SCORE method to call.

paramsobject

Parameters passed to the SCORE method.

Show child attributes

_ownerstring

Address whose balance is requested.

Response

200OK

Successful response containing the result of the SCORE method call.

Authorization

api-keyAuthapiKey in header

Call SCORE method

curl -X POST 'https://icx.nownodes.io/api/v3' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "icx_call",
    "params": {
      "from": "hxbe258ceb872e08851f1f59694dac2558708ece11",
      "to": "cx2609b924e33ef00b648a409245c7ea394c467824",
      "dataType": "call",
      "data": {
        "method": "balanceOf",
        "params": {
          "_owner": "hxbe258ceb872e08851f1f59694dac2558708ece11"
        }
      }
    }
  }'

const response = await fetch('https://icx.nownodes.io/api/v3', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "id": 1,
      "method": "icx_call",
      "params": {
        "from": "hxbe258ceb872e08851f1f59694dac2558708ece11",
        "to": "cx2609b924e33ef00b648a409245c7ea394c467824",
        "dataType": "call",
        "data": {
          "method": "balanceOf",
          "params": {
            "_owner": "hxbe258ceb872e08851f1f59694dac2558708ece11"
          }
        }
      }
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": 1,
  "method": "icx_call",
  "params": {
    "from": "hxbe258ceb872e08851f1f59694dac2558708ece11",
    "to": "cx2609b924e33ef00b648a409245c7ea394c467824",
    "dataType": "call",
    "data": {
      "method": "balanceOf",
      "params": {
        "_owner": "hxbe258ceb872e08851f1f59694dac2558708ece11"
      }
    }
  }
}

response = requests.post('https://icx.nownodes.io/api/v3', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "icx_call",
  "params": {
    "from": "hxbe258ceb872e08851f1f59694dac2558708ece11",
    "to": "cx2609b924e33ef00b648a409245c7ea394c467824",
    "dataType": "call",
    "data": {
      "method": "balanceOf",
      "params": {
        "_owner": "hxbe258ceb872e08851f1f59694dac2558708ece11"
      }
    }
  }
}

200

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

icx_getBalance

Get ICX balance

POST

https://icx.nownodes.io/api/v3

Returns the ICX balance of a given address.

Body

application/json

JSON-RPC request object

idintegerrequired

Unique identifier for the JSON-RPC request.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

paramsobjectrequired

Parameters for balance query.

Show child attributes

addressstring

ICON address whose balance is requested.

Response

200OK

Successful response containing the ICX balance.

Authorization

api-keyAuthapiKey in header

Get ICX balance

curl -X POST 'https://icx.nownodes.io/api/v3' \
  -H 'Content-Type: application/json' \
  -d '{
    "id": 1,
    "jsonrpc": "2.0",
    "method": "icx_getBalance",
    "params": {
      "address": "hx5a05b58a25a1e5ea0f1d5715e1f655dffc1fb30a"
    }
  }'

const response = await fetch('https://icx.nownodes.io/api/v3', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "id": 1,
      "jsonrpc": "2.0",
      "method": "icx_getBalance",
      "params": {
        "address": "hx5a05b58a25a1e5ea0f1d5715e1f655dffc1fb30a"
      }
    }),
});

const data = await response.json();

import requests

payload = {
  "id": 1,
  "jsonrpc": "2.0",
  "method": "icx_getBalance",
  "params": {
    "address": "hx5a05b58a25a1e5ea0f1d5715e1f655dffc1fb30a"
  }
}

response = requests.post('https://icx.nownodes.io/api/v3', json=payload)
data = response.json()

Request Body

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "icx_getBalance",
  "params": {
    "address": "hx5a05b58a25a1e5ea0f1d5715e1f655dffc1fb30a"
  }
}

200

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

icx_getBlockByHash

Get block by hash

POST

https://icx.nownodes.io/api/v3

Returns a block from the ICON blockchain by its hash.

Body

application/json

JSON-RPC request object

idintegerrequired

Unique identifier for the JSON-RPC request.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

paramsobjectrequired

Parameters for block query.

Show child attributes

hashstring

Block hash in hexadecimal format.

Response

200OK

Successful response containing the requested block.

Authorization

api-keyAuthapiKey in header

Get block by hash

curl -X POST 'https://icx.nownodes.io/api/v3' \
  -H 'Content-Type: application/json' \
  -d '{
    "id": 1,
    "jsonrpc": "2.0",
    "method": "icx_getBlockByHash",
    "params": {
      "hash": "0x5faccd9589eaa7c2aa4d89afce1a97357b833509e614e8123bb60b6fe8d09eab"
    }
  }'

const response = await fetch('https://icx.nownodes.io/api/v3', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "id": 1,
      "jsonrpc": "2.0",
      "method": "icx_getBlockByHash",
      "params": {
        "hash": "0x5faccd9589eaa7c2aa4d89afce1a97357b833509e614e8123bb60b6fe8d09eab"
      }
    }),
});

const data = await response.json();

import requests

payload = {
  "id": 1,
  "jsonrpc": "2.0",
  "method": "icx_getBlockByHash",
  "params": {
    "hash": "0x5faccd9589eaa7c2aa4d89afce1a97357b833509e614e8123bb60b6fe8d09eab"
  }
}

response = requests.post('https://icx.nownodes.io/api/v3', json=payload)
data = response.json()

Request Body

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "icx_getBlockByHash",
  "params": {
    "hash": "0x5faccd9589eaa7c2aa4d89afce1a97357b833509e614e8123bb60b6fe8d09eab"
  }
}

200

{
  "jsonrpc": "2.0",
  "result": {
    "block_hash": "5faccd9589eaa7c2aa4d89afce1a97357b833509e614e8123bb60b6fe8d09eab",
    "confirmed_transaction_list": [
      {
        "data": {
          "result": {
            "coveredByFee": "0x0",
            "coveredByOverIssuedICX": "0x0",
            "issue": "0x1fecf5d301c8682c"
          }
        },
        "dataType": "base",
        "timestamp": "0x6462674d48bd4",
        "txHash": "0xeea6ca0f1835978fe1fbe8fd2b95052815edd4ad218aa08295bf4ce9a079bb10",
        "version": "0x3"
      }
    ],
    "height": 106574961,
    "merkle_tree_root_hash": "90f006355a9c94eab66ec43eab209ee1fc33b3e8dfaa7e598ce9702a4afd5a1e",
    "peer_id": "hx9f3a8fe47f4676004b802d62397838b2d5c966dd",
    "prev_block_hash": "5be5536d4cd791a66c5605851f4319788a45a8e621c8cce7840730bd6e3316a7",
    "signature": "",
    "time_stamp": 1765980843051988,
    "version": "2.0"
  },
  "id": 1
}

icx_getBlockByHeight

Get block by height

POST

https://icx.nownodes.io/api/v3

Returns a block from the ICON blockchain by its height.

Body

application/json

JSON-RPC request object

idstringrequired

Unique identifier for the JSON-RPC request.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

paramsobjectrequired

Parameters for block query.

Show child attributes

heightstring

Block height in hexadecimal format.

Response

200OK

Successful response containing the requested block.

Authorization

api-keyAuthapiKey in header

Get block by height

curl -X POST 'https://icx.nownodes.io/api/v3' \
  -H 'Content-Type: application/json' \
  -d '{
    "id": "1",
    "jsonrpc": "2.0",
    "method": "icx_getBlockByHeight",
    "params": {
      "height": "0x100"
    }
  }'

const response = await fetch('https://icx.nownodes.io/api/v3', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "id": "1",
      "jsonrpc": "2.0",
      "method": "icx_getBlockByHeight",
      "params": {
        "height": "0x100"
      }
    }),
});

const data = await response.json();

import requests

payload = {
  "id": "1",
  "jsonrpc": "2.0",
  "method": "icx_getBlockByHeight",
  "params": {
    "height": "0x100"
  }
}

response = requests.post('https://icx.nownodes.io/api/v3', json=payload)
data = response.json()

Request Body

{
  "id": "1",
  "jsonrpc": "2.0",
  "method": "icx_getBlockByHeight",
  "params": {
    "height": "0x100"
  }
}

200

{
  "jsonrpc": "2.0",
  "result": {
    "block_hash": "c35d1a1495c19e685111c212cd6cd9290af994f43da04649800e7906f32e0e60",
    "confirmed_transaction_list": [
      {
        "fee": "0x2386f26fc10000",
        "from": "hx2fa0f222a40692fa54ebadb7cfc703f0618f2f1a",
        "method": "icx_sendTransaction",
        "signature": "e2/4ozKQu9Oo3dCMxwvYcUWgcz/LLS2SmVCb/natz5onVvGjFjSBfVIv71AZkMNH8KPWXZz/eK8osW4tnHqmlwE=",
        "timestamp": "1521668857318000",
        "to": "hxd602531cbc85676a5f4cecfdac8ec28c85985112",
        "tx_hash": "18e03233a183eae2ae9830a4994955673fa7567e8bcfd4f538f5e4451f065a70",
        "value": "0x9b41fbf9e0aec00000"
      }
    ],
    "height": 256,
    "merkle_tree_root_hash": "18e03233a183eae2ae9830a4994955673fa7567e8bcfd4f538f5e4451f065a70",
    "peer_id": "hx547c6d5f7e80cd97b95cfefbaad919549a80831c",
    "prev_block_hash": "c23487aaaf7b8cf97f8b1613c978d7d9ac8e968c4c2b922de988e7e65e9cf410",
    "signature": "",
    "time_stamp": 1521668862828233,
    "version": "0.1a"
  },
  "id": "1"
}

icx_getLastBlock

Get last block

POST

https://icx.nownodes.io/api/v3

Returns the most recent block from the ICON blockchain.

Body

application/json

JSON-RPC request object

idintegerrequired

Unique identifier for the JSON-RPC request.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

Response

200OK

Successful response containing the last block.

Authorization

api-keyAuthapiKey in header

Get last block

curl -X POST 'https://icx.nownodes.io/api/v3' \
  -H 'Content-Type: application/json' \
  -d '{
    "id": 1,
    "jsonrpc": "2.0",
    "method": "icx_getLastBlock"
  }'

const response = await fetch('https://icx.nownodes.io/api/v3', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "id": 1,
      "jsonrpc": "2.0",
      "method": "icx_getLastBlock"
    }),
});

const data = await response.json();

import requests

payload = {
  "id": 1,
  "jsonrpc": "2.0",
  "method": "icx_getLastBlock"
}

response = requests.post('https://icx.nownodes.io/api/v3', json=payload)
data = response.json()

Request Body

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "icx_getLastBlock"
}

200

{
  "jsonrpc": "2.0",
  "result": {
    "block_hash": "0d5151b292a6ea8a7601a5f2c57fbf26e87867a82e142f1e1f11261e55cc1441",
    "confirmed_transaction_list": [
      {
        "data": {
          "result": {
            "coveredByFee": "0x0",
            "coveredByOverIssuedICX": "0x0",
            "issue": "0x1fecf5d301c8682c"
          }
        },
        "dataType": "base",
        "timestamp": "0x6462621353625",
        "txHash": "0xc3867ed0ea8166cdb685bf14ff84bd6445e83fb92dda036a0d768417ccca1ced",
        "version": "0x3"
      }
    ],
    "height": 106574261,
    "merkle_tree_root_hash": "16c2d25d31ced78864f8ff293c19b82b514869df2c03dc393a7eba2df1fb48fa",
    "peer_id": "hx9f3a8fe47f4676004b802d62397838b2d5c966dd",
    "prev_block_hash": "578a8586b63aa2223df0a9fd71c9432310c46ba21f4283439d3da8656caf0b22",
    "signature": "",
    "time_stamp": 1765979440100901,
    "version": "2.0"
  },
  "id": 1
}

icx_getNetworkInfo

Get network information

POST

https://icx.nownodes.io/api/v3

Returns general information about the ICON network, including network ID, channel, block height, and step price.

Body

application/json

JSON-RPC request object

jsonrpcstringrequired

JSON-RPC protocol version.

idintegerrequired

Unique identifier for the JSON-RPC request.

methodstringrequired

JSON-RPC method name.

Response

200OK

Successful response containing network information.

Authorization

api-keyAuthapiKey in header

Get network information

curl -X POST 'https://icx.nownodes.io/api/v3' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "icx_getNetworkInfo"
  }'

const response = await fetch('https://icx.nownodes.io/api/v3', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "id": 1,
      "method": "icx_getNetworkInfo"
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": 1,
  "method": "icx_getNetworkInfo"
}

response = requests.post('https://icx.nownodes.io/api/v3', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "icx_getNetworkInfo"
}

200

{
  "jsonrpc": "2.0",
  "result": {
    "platform": "icon",
    "nid": "0x1",
    "channel": "icon_dex",
    "earliest": "0x0",
    "latest": "0x65a3b7f",
    "stepPrice": "0x2e90edd00"
  },
  "id": 1
}

icx_getScoreApi

Get SCORE API

POST

https://icx.nownodes.io/api/v3

Returns the API of a SCORE (contract) at the specified address, including methods and eventlogs.

Body

application/json

JSON-RPC request object

jsonrpcstringrequired

JSON-RPC protocol version.

idintegerrequired

Unique identifier for the JSON-RPC request.

methodstringrequired

JSON-RPC method name.

paramsobjectrequired

Parameters for SCORE API query.

Show child attributes

addressstring

SCORE (contract) address.

Response

200OK

Successful response containing the SCORE API.

Authorization

api-keyAuthapiKey in header

Get SCORE API

curl -X POST 'https://icx.nownodes.io/api/v3' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "icx_getScoreApi",
    "params": {
      "address": "cx2609b924e33ef00b648a409245c7ea394c467824"
    }
  }'

const response = await fetch('https://icx.nownodes.io/api/v3', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "id": 1,
      "method": "icx_getScoreApi",
      "params": {
        "address": "cx2609b924e33ef00b648a409245c7ea394c467824"
      }
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": 1,
  "method": "icx_getScoreApi",
  "params": {
    "address": "cx2609b924e33ef00b648a409245c7ea394c467824"
  }
}

response = requests.post('https://icx.nownodes.io/api/v3', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "icx_getScoreApi",
  "params": {
    "address": "cx2609b924e33ef00b648a409245c7ea394c467824"
  }
}

200

{
  "jsonrpc": "2.0",
  "result": [
    {
      "name": "Transfer",
      "type": "eventlog",
      "inputs": [
        {
          "name": "_from",
          "type": "Address",
          "indexed": "0x1"
        },
        {
          "name": "_to",
          "type": "Address",
          "indexed": "0x1"
        },
        {
          "name": "_value",
          "type": "int",
          "indexed": "0x1"
        },
        {
          "name": "_data",
          "type": "bytes"
        }
      ]
    },
    {
      "name": "HubTransfer",
      "type": "eventlog",
      "inputs": [
        {
          "name": "_from",
          "type": "str",
          "indexed": "0x1"
        },
        {
          "name": "_to",
          "type": "str",
          "indexed": "0x1"
        },
        {
          "name": "_value",
          "type": "int",
          "indexed": "0x1"
        },
        {
          "name": "_data",
          "type": "bytes"
        }
      ]
    }
  ],
  "id": 1
}

icx_getScoreStatus

Get SCORE status

POST

https://icx.nownodes.io/api/v3

Returns the current status of a SCORE (smart contract) including type, status, code hash, and owner.

Body

application/json

JSON-RPC request object

jsonrpcstringrequired

JSON-RPC protocol version.

idintegerrequired

Unique identifier for the JSON-RPC request.

methodstringrequired

JSON-RPC method name.

paramsobjectrequired

Parameters for querying SCORE status.

Show child attributes

addressstring

SCORE address.

Response

200OK

Successful response containing SCORE status.

Authorization

api-keyAuthapiKey in header

Get SCORE status

curl -X POST 'https://icx.nownodes.io/api/v3' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "icx_getScoreStatus",
    "params": {
      "address": "cx2609b924e33ef00b648a409245c7ea394c467824"
    }
  }'

const response = await fetch('https://icx.nownodes.io/api/v3', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "id": 1,
      "method": "icx_getScoreStatus",
      "params": {
        "address": "cx2609b924e33ef00b648a409245c7ea394c467824"
      }
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": 1,
  "method": "icx_getScoreStatus",
  "params": {
    "address": "cx2609b924e33ef00b648a409245c7ea394c467824"
  }
}

response = requests.post('https://icx.nownodes.io/api/v3', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "icx_getScoreStatus",
  "params": {
    "address": "cx2609b924e33ef00b648a409245c7ea394c467824"
  }
}

200

{
  "jsonrpc": "2.0",
  "result": {
    "owner": "hx33908de1715f15511d4d7503f0fed22e8e60fdc2",
    "current": {
      "status": "active",
      "type": "java",
      "codeHash": "0xb3bb1d5cf1b7ff1d3d3efbfc763667cbfdbcd38a87b656523b326990f017fe53",
      "deployTxHash": "0x9f3fe8f586df68428340e38edfc1237e6adb66dab32c3b889d643b46aff9c2c7",
      "auditTxHash": "0x9f3fe8f586df68428340e38edfc1237e6adb66dab32c3b889d643b46aff9c2c7"
    }
  },
  "id": 1
}

icx_getTotalSupply

Get total ICX supply

POST

https://icx.nownodes.io/api/v3

Returns the total supply of ICX tokens in the ICON blockchain.

Body

application/json

JSON-RPC request object

idintegerrequired

Unique identifier for the JSON-RPC request.

jsonrpcstringrequired

JSON-RPC protocol version.

methodstringrequired

JSON-RPC method name.

Response

200OK

Successful response containing the total ICX supply.

Authorization

api-keyAuthapiKey in header

Get total ICX supply

curl -X POST 'https://icx.nownodes.io/api/v3' \
  -H 'Content-Type: application/json' \
  -d '{
    "id": 1,
    "jsonrpc": "2.0",
    "method": "icx_getTotalSupply"
  }'

const response = await fetch('https://icx.nownodes.io/api/v3', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "id": 1,
      "jsonrpc": "2.0",
      "method": "icx_getTotalSupply"
    }),
});

const data = await response.json();

import requests

payload = {
  "id": 1,
  "jsonrpc": "2.0",
  "method": "icx_getTotalSupply"
}

response = requests.post('https://icx.nownodes.io/api/v3', json=payload)
data = response.json()

Request Body

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "icx_getTotalSupply"
}

200

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

icx_getTransactionByHash

Get transaction by hash

POST

https://icx.nownodes.io/api/v3

Returns the detailed transaction data for a given transaction hash.

Body

application/json

JSON-RPC request object

jsonrpcstringrequired

JSON-RPC protocol version.

idintegerrequired

Unique identifier for the JSON-RPC request.

methodstringrequired

JSON-RPC method name.

paramsobjectrequired

Parameters for querying the transaction by hash.

Show child attributes

txHashstring

Transaction hash to query.

Response

200OK

Successful response containing the transaction data.

Authorization

api-keyAuthapiKey in header

Get transaction by hash

curl -X POST 'https://icx.nownodes.io/api/v3' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "icx_getTransactionByHash",
    "params": {
      "txHash": "0xeea6ca0f1835978fe1fbe8fd2b95052815edd4ad218aa08295bf4ce9a079bb10"
    }
  }'

const response = await fetch('https://icx.nownodes.io/api/v3', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "id": 1,
      "method": "icx_getTransactionByHash",
      "params": {
        "txHash": "0xeea6ca0f1835978fe1fbe8fd2b95052815edd4ad218aa08295bf4ce9a079bb10"
      }
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": 1,
  "method": "icx_getTransactionByHash",
  "params": {
    "txHash": "0xeea6ca0f1835978fe1fbe8fd2b95052815edd4ad218aa08295bf4ce9a079bb10"
  }
}

response = requests.post('https://icx.nownodes.io/api/v3', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "icx_getTransactionByHash",
  "params": {
    "txHash": "0xeea6ca0f1835978fe1fbe8fd2b95052815edd4ad218aa08295bf4ce9a079bb10"
  }
}

200

{
  "jsonrpc": "2.0",
  "result": {
    "txHash": "0xeea6ca0f1835978fe1fbe8fd2b95052815edd4ad218aa08295bf4ce9a079bb10",
    "blockHash": "0x5faccd9589eaa7c2aa4d89afce1a97357b833509e614e8123bb60b6fe8d09eab",
    "blockHeight": "0x65a3471",
    "dataType": "base",
    "data": {
      "result": {
        "coveredByFee": "0x0",
        "coveredByOverIssuedICX": "0x0",
        "issue": "0x1fecf5d301c8682c"
      }
    },
    "timestamp": "0x6462674d48bd4",
    "version": "0x3",
    "txIndex": "0x0"
  },
  "id": 1
}

icx_getTransactionResult

Get transaction result

POST

https://icx.nownodes.io/api/v3

Returns the result of a transaction by its hash, including status, logs, and used steps.

Body

application/json

JSON-RPC request object

jsonrpcstringrequired

JSON-RPC protocol version.

idintegerrequired

Unique identifier for the JSON-RPC request.

methodstringrequired

JSON-RPC method name.

paramsobjectrequired

Parameters for transaction result query.

Show child attributes

txHashstring

Transaction hash to query.

Response

200OK

Successful response containing the transaction result.

Authorization

api-keyAuthapiKey in header

Get transaction result

curl -X POST 'https://icx.nownodes.io/api/v3' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "icx_getTransactionResult",
    "params": {
      "txHash": "0xeea6ca0f1835978fe1fbe8fd2b95052815edd4ad218aa08295bf4ce9a079bb10"
    }
  }'

const response = await fetch('https://icx.nownodes.io/api/v3', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "id": 1,
      "method": "icx_getTransactionResult",
      "params": {
        "txHash": "0xeea6ca0f1835978fe1fbe8fd2b95052815edd4ad218aa08295bf4ce9a079bb10"
      }
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": 1,
  "method": "icx_getTransactionResult",
  "params": {
    "txHash": "0xeea6ca0f1835978fe1fbe8fd2b95052815edd4ad218aa08295bf4ce9a079bb10"
  }
}

response = requests.post('https://icx.nownodes.io/api/v3', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "icx_getTransactionResult",
  "params": {
    "txHash": "0xeea6ca0f1835978fe1fbe8fd2b95052815edd4ad218aa08295bf4ce9a079bb10"
  }
}

200

{
  "jsonrpc": "2.0",
  "result": {
    "txHash": "0xeea6ca0f1835978fe1fbe8fd2b95052815edd4ad218aa08295bf4ce9a079bb10",
    "blockHash": "0x5faccd9589eaa7c2aa4d89afce1a97357b833509e614e8123bb60b6fe8d09eab",
    "blockHeight": "0x65a3471",
    "cumulativeStepUsed": "0x0",
    "stepUsed": "0x0",
    "stepPrice": "0x0",
    "status": "0x1",
    "to": "hx1000000000000000000000000000000000000000",
    "txIndex": "0x0",
    "logsBloom": "0x00000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000008000000010000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000008000000000000000000000000000000000000080000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000004000000000000000000000000000000000000000",
    "eventLogs": [
      {
        "scoreAddress": "cx0000000000000000000000000000000000000000",
        "indexed": [
          "ICXIssued(int,int,int,int)"
        ],
        "data": [
          "0x0",
          "0x0",
          "0x1fecf5d301c8682c",
          "0x0"
        ]
      }
    ]
  },
  "id": 1
}

icx_sendTransaction

Send transaction

POST

https://icx.nownodes.io/api/v3

Submits a transaction to the ICON blockchain.

Body

application/json

JSON-RPC request object

jsonrpcstringrequired

JSON-RPC protocol version.

idintegerrequired

Unique identifier for the JSON-RPC request.

methodstringrequired

JSON-RPC method name.

paramsobjectrequired

Transaction parameters.

Show child attributes

versionstring

Transaction version.

fromstring

Sender address.

tostring

Recipient address.

valuestring

Amount of ICX to send in loop (hexadecimal).

stepLimitstring

Maximum step allowed for the transaction.

timestampstring

Timestamp of the transaction in hexadecimal format.

nidstring

Network ID.

noncestring

Nonce for transaction uniqueness.

signaturestring

Transaction signature.

Response

200OK

Successful response containing the transaction hash.

Authorization

api-keyAuthapiKey in header

Send transaction

curl -X POST 'https://icx.nownodes.io/api/v3' \
  -H 'Content-Type: application/json' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "icx_sendTransaction",
    "params": {
      "version": "0x3",
      "from": "hx49b1556654e51f52d59a8222b4737ee7dccc6d1b",
      "to": "hx0341962988c44dd8a47e419f8eab6bf4383aa23a",
      "value": "0x8ac7230489e80000",
      "stepLimit": "0x186a0",
      "timestamp": "0x578177c2fe6e8",
      "nid": "0x1",
      "nonce": "0x1",
      "signature": "VAliDsiGnATurE1234567890abcdef..."
    }
  }'

const response = await fetch('https://icx.nownodes.io/api/v3', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
      "jsonrpc": "2.0",
      "id": 1,
      "method": "icx_sendTransaction",
      "params": {
        "version": "0x3",
        "from": "hx49b1556654e51f52d59a8222b4737ee7dccc6d1b",
        "to": "hx0341962988c44dd8a47e419f8eab6bf4383aa23a",
        "value": "0x8ac7230489e80000",
        "stepLimit": "0x186a0",
        "timestamp": "0x578177c2fe6e8",
        "nid": "0x1",
        "nonce": "0x1",
        "signature": "VAliDsiGnATurE1234567890abcdef..."
      }
    }),
});

const data = await response.json();

import requests

payload = {
  "jsonrpc": "2.0",
  "id": 1,
  "method": "icx_sendTransaction",
  "params": {
    "version": "0x3",
    "from": "hx49b1556654e51f52d59a8222b4737ee7dccc6d1b",
    "to": "hx0341962988c44dd8a47e419f8eab6bf4383aa23a",
    "value": "0x8ac7230489e80000",
    "stepLimit": "0x186a0",
    "timestamp": "0x578177c2fe6e8",
    "nid": "0x1",
    "nonce": "0x1",
    "signature": "VAliDsiGnATurE1234567890abcdef..."
  }
}

response = requests.post('https://icx.nownodes.io/api/v3', json=payload)
data = response.json()

Request Body

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "icx_sendTransaction",
  "params": {
    "version": "0x3",
    "from": "hx49b1556654e51f52d59a8222b4737ee7dccc6d1b",
    "to": "hx0341962988c44dd8a47e419f8eab6bf4383aa23a",
    "value": "0x8ac7230489e80000",
    "stepLimit": "0x186a0",
    "timestamp": "0x578177c2fe6e8",
    "nid": "0x1",
    "nonce": "0x1",
    "signature": "VAliDsiGnATurE1234567890abcdef..."
  }
}

200

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

Documentation

Authentication

Mainnet

icx_call

Body

Response

Authorization

icx_getBalance

Body

Response

Authorization

icx_getBlockByHash

Body

Response

Authorization

icx_getBlockByHeight

Body

Response

Authorization

icx_getLastBlock

Body

Response

Authorization

icx_getNetworkInfo

Body

Response

Authorization

icx_getScoreApi

Body

Response

Authorization

icx_getScoreStatus

Body

Response

Authorization

icx_getTotalSupply

Body

Response

Authorization

icx_getTransactionByHash

Body

Response

Authorization

icx_getTransactionResult

Body

Response

Authorization

icx_sendTransaction

Body

Response

Authorization