Geth/Parity Proxy (WIP)

eth_blockNumber (WIP)

Returns the number of most recent block

https://api.xdcscan.io/api
   ?module=proxy
   &action=eth_blockNumber
   &apikey=YourApiKeyToken

Try this endpoint in your browser 🔗

Request

No parameters required.

Response

eth_getBlockTransactionCountByNumber (WIP)

Returns the number of transactions in a block.

https://api.xdcscan.io/api
   ?module=proxy
   &action=eth_getBlockTransactionCountByNumber
   &tag=0x10FB78
   &apikey=YourApiKeyToken

Try this endpoint in your browser 🔗

Request

Query Parameters

Parameter	Description
tag	the block number, in hex eg. 0x10FB78

Response

eth_getTransactionByHash (WIP)

Returns the information about a transaction requested by transaction hash.

https://api.xdcscan.io/api
   ?module=proxy
   &action=eth_getTransactionByHash
   &txhash=0xbc78ab8a9e9a0bca7d0321a27b2c03addeae08ba81ea98b03cd3dd237eabed44
   &apikey=YourApiKeyToken

Try this endpoint in your browser 🔗

Request

Query Parameters

Parameter	Description
txhash	the string representing the hash of the transaction

Response

eth_getTransactionByBlockNumberAndIndex (WIP)

Returns information about a transaction by block number and transaction index position.

https://api.xdcscan.io/api
   ?module=proxy
   &action=eth_getTransactionByBlockNumberAndIndex
   &tag=0xC6331D
   &index=0x11A
   &apikey=YourApiKeyToken

Try this endpoint in your browser 🔗

Request

Query Parameters

Parameter	Description
tag	the block number, in hex eg. 0x10FB78
index	the position of the uncle's index in the block, in hex eg. 0x0

Response

eth_getTransactionCount (WIP)

Returns the number of transactions performed by an address.

https://api.xdcscan.io/api
   ?module=proxy
   &action=eth_getTransactionCount
   &address=0x4bd5900Cb274ef15b153066D736bf3e83A9ba44e
   &tag=latest
   &apikey=YourApiKeyToken

Try this endpoint in your browser 🔗

Request

Query Parameters

Parameter	Description
address	the string representing the address to get transaction count
tag	the string pre-defined block parameter, either earliest, pending or latest

Response

eth_sendRawTransaction (WIP)

Submits a pre-signed transaction for broadcast to the XDC network.

https://api.xdcscan.io/api
   ?module=proxy
   &action=eth_sendRawTransaction
   &hex=0xf904808000831cfde080
   &apikey=YourApiKeyToken

Try this endpoint in your browser 🔗

Request

Parameter	Description
hex	the string representing the signed raw transaction data to broadcast.

Response

Sample Response

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

💡 Tip: Send a POST request if your hex string is particularly long.

⛏️ Note: The result represents the transaction hash of the submitted raw transaction.

Use eth_getTransactionReceipt (WIP) to retrieve full details.

eth_getTransactionReceipt (WIP)

Returns the receipt of a transaction by transaction hash.

https://api.xdcscan.io/api
   ?module=proxy
   &action=eth_getTransactionReceipt
   &txhash=0xadb8aec59e80db99811ac4a0235efa3e45da32928bcff557998552250fa672eb
   &apikey=YourApiKeyToken

Try this endpoint in your browser 🔗

Query Parameters

Parameter	Description
txhash	the string representing the hash of the transaction

Sample Response

{
   "jsonrpc":"2.0",
   "id":1,
   "result":{
      "blockHash":"0x07c17710dbb7514e92341c9f83b4aab700c5dba7c4fb98caadd7926a32e47799",
      "blockNumber":"0xcf2427",
      "contractAddress":null,
      "cumulativeGasUsed":"0xeb67d5",
      "effectiveGasPrice":"0x1a96b24c26",
      "from":"0x292f04a44506c2fd49bac032e1ca148c35a478c8",
      "gasUsed":"0xb41d",
      "logs":[
         {
            "address":"0xdac17f958d2ee523a2206206994597c13d831ec7",
            "topics":[
               "0xddf252ad1be2c89b69c2b068fc378daa952ba7f163c4a11628f55a4df523b3ef",
               "0x000000000000000000000000292f04a44506c2fd49bac032e1ca148c35a478c8",
               "0x000000000000000000000000ab6960a6511ff18ed8b8c012cb91c7f637947fc0"
            ],
            "data":"0x00000000000000000000000000000000000000000000000000000000013f81a6",
            "blockNumber":"0xcf2427",
            "transactionHash":"0xadb8aec59e80db99811ac4a0235efa3e45da32928bcff557998552250fa672eb",
            "transactionIndex":"0x122",
            "blockHash":"0x07c17710dbb7514e92341c9f83b4aab700c5dba7c4fb98caadd7926a32e47799",
            "logIndex":"0xdb",
            "removed":false
         }
      ],
      "logsBloom":"0x00000000000000000000000000000000000000000000000000000000000004000000000004000000000000000000010000000000000000000000000000000000000000000000000000000008000000000000000000000000800000000000000000000000000000000000000000000000000000000000000000000010000000001100000000000000000000000000000000000000000000000000000200100000000000000000000000000080000000000000000000000000000000000000000000000002000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000000",
      "status":"0x1",
      "to":"0xdac17f958d2ee523a2206206994597c13d831ec7",
      "transactionHash":"0xadb8aec59e80db99811ac4a0235efa3e45da32928bcff557998552250fa672eb",
      "transactionIndex":"0x122",
      "type":"0x2"
   }
}

eth_call (WIP)

Executes a new message call immediately without creating a transaction on the block chain.

https://api.xdcscan.io/api
   ?module=proxy
   &action=eth_call
   &to=0xAEEF46DB4855E25702F8237E8f403FddcaF931C0
   &data=0x70a08231000000000000000000000000e16359506c028e51f16be38986ec5746251e9724
   &tag=latest
   &apikey=YourApiKeyToken

Try this endpoint in your browser 🔗

Request

Query Parameters

Parameter	Description
to	the string representing the address to interact with
data	the hash of the method signature and encoded parameters
tag	the string pre-defined block parameter, either earliest, pending or latest

⛽ Note: The gas parameter is capped at 2x the current block gas limit.

Response

eth_getCode (WIP)

Returns code at a given address.

https://api.xdcscan.io/api
   ?module=proxy
   &action=eth_getCode
   &address=0xf75e354c5edc8efed9b59ee9f67a80845ade7d0c
   &tag=latest
   &apikey=YourApiKeyToken

Try this endpoint in your browser 🔗

Request

Query Parameters

Parameter	Description
address	the string representing the address to get code
tag	the string pre-defined block parameter, either earliest, pending or latest

Response

eth_getStorageAt (WIP)

Returns the value from a storage position at a given address.

This endpoint is still experimental and may have potential issues

https://api.xdcscan.io/api
   ?module=proxy
   &action=eth_getStorageAt
   &address=0x6e03d9cce9d60f3e9f2597e13cd4c54c55330cfd
   &position=0x0
   &tag=latest
   &apikey=YourApiKeyToken

Try this endpoint in your browser

Request

Query Parameters

Parameter	Description
address	the string representing the address to get code
position	the hex code of the position in storage, eg 0x0
tag	the string pre-defined block parameter, either earliest, pending or latest

Response

eth_gasPrice (WIP)

Returns the current price per gas in wei.

https://api.xdcscan.io/api
   ?module=proxy
   &action=eth_gasPrice
   &apikey=YourApiKeyToken

Try this endpoint in your browser 🔗

Request

No parameters required.

Response

eth_estimateGas (WIP)

Makes a call or transaction, which won't be added to the blockchain and returns the used gas.

https://api.xdcscan.io/api
   ?module=proxy
   &action=eth_estimateGas
   &data=0x4e71d92d
   &to=0xf0160428a8552ac9bb7e050d90eeade4ddd52843
   &value=0xff22
   &gasPrice=0x51da038cc
   &gas=0x5f5e0ff
   &apikey=YourApiKeyToken

Try this endpoint in your browser 🔗

Request

Query Parameters

Parameter	Description
data	the hash of the method signature and encoded parameters
to	the string representing the address to interact with
value	the value sent in this transaction, in hex eg. 0xff22
gas	the amount of gas provided for the transaction, in hex eg. 0x5f5e0ff
gasPrice	the gas price paid for each unit of gas, in wei post EIP-1559, the gasPrice has to be higher than the block's baseFeePerGas

⛽ Note: The gas parameter is capped at 2x the current block gas limit.

Response