xCallscan APIs

This documentation describes how to use the xcallscan REST APIs

Supported Networks

BASE_URL

• Mainnet: https://xcallscan.xyz (opens in a new tab)
• Testnet: https://testnet.xcallscan.xyz (opens in a new tab)

/api/messages

Listing all messages

GET base_url/api/messages

Params:

• limit: the maximum number of items
• skip: starting point within the collection of resource results
• src_network: (optional) source network
• dest_network: (optional) dest network
• src_address: (optional) sender address
• dest_address: (optional) recipient address
• from_timestamp: (optional) from block timestamp
• to_timestamp: (optional) to block timestamp
• status: (optional) message status, one of values pending, delivered, executed, rollbacked

/api/messages/:id

Get message by id

GET base_url/api/messages/:id

Params: :id: message id

/api/search

Search messages by transaction hash or serial number

GET base_url/api/search

Params:

• value: transaction hash OR serial number

/api/statistics/total_messages

Get total number of messages

GET base_url/api/statistics/total_messages

Params:

• src_network: (optional) source network, eg: icon, bsc...
• dest_network: (optional) destination network, eg: icon, bsc...
• from_timestamp: (optional) from block timestamp
• to_timestamp: (optional) to block timestamp
• status: (optional) message status, one of values pending, delivered, executed, rollbacked

Example:

• Get total number of cross-chain messages originating from the ICON Network: https://xcallscan.xyz/api/statistics/total_messages?src_network=icon