Granite Upgrade Activates in11d:16h:53m:32s
Interchain Messaging

List ICM messages

Lists ICM messages. Ordered by timestamp in descending order.

GET
/v1/icm/messages
x-glacier-api-key<token>

Api keys provide higher access to rate limits. To obtain an api key, sign up for an account at https://build.avax.network/console/utilities/data-api-keys.

In: header

Query Parameters

pageToken?string

A page token, received from a previous list call. Provide this to retrieve the subsequent page.

pageSize?integer

The maximum number of items to return. The minimum page size is 1. The maximum pageSize is 100.

Default10
Range1 <= value <= 100
sourceBlockchainId?string

The base58 encoded blockchain ID or evm chain ID of the source chain that the ICM message was sent from.

destinationBlockchainId?string

The base58 encoded blockchain ID or evm chain ID of the destination chain that the ICM message was sent to.

blockchainId?string

The base58 encoded blockchain ID of either source or destination chain that one ICM message interacts with.

to?string

The address of the recipient of the ICM message.

from?string

The address of the sender of the ICM message.

network?string

Either mainnet or testnet/fuji.

Value in"mainnet" | "fuji" | "testnet"

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://data-api.avax.network/v1/icm/messages?pageSize=10&sourceBlockchainId=2D8RG4UpSXbPbvPCAWppNJyqTG2i2CAXSkTgmTBBvs7GKNZjsY&destinationBlockchainId=yH8D7ThNJkxmtkuv2jgBa4P1Rn3Qpr4pPr7QYNfcdoS6k6HWp&to=0x664A4Be5Af2cFc824F9C0914CbAc4703396Da2DC&from=0x321eDA69247566D662178feE695C7026c604Cd94&network=mainnet"
{
  "nextPageToken": "string",
  "messages": [
    {
      "messageId": "string",
      "icmContractAddress": "string",
      "sourceBlockchainId": "string",
      "destinationBlockchainId": "string",
      "sourceEvmChainId": "string",
      "destinationEvmChainId": "string",
      "messageNonce": "string",
      "from": "string",
      "to": "string",
      "data": "string",
      "messageExecuted": true,
      "receipts": [
        {
          "receivedMessageNonce": "string",
          "relayerRewardAddress": "string"
        }
      ],
      "receiptDelivered": true,
      "rewardDetails": {
        "address": "0x71C7656EC7ab88b098defB751B7401B5f6d8976F",
        "name": "Wrapped AVAX",
        "symbol": "WAVAX",
        "decimals": 18,
        "logoUri": "https://images.ctfassets.net/gcj8jwzm6086/5VHupNKwnDYJvqMENeV7iJ/fdd6326b7a82c8388e4ee9d4be7062d4/avalanche-avax-logo.svg",
        "ercType": "ERC-20",
        "price": {
          "currencyCode": "usd",
          "value": "42.42"
        },
        "value": "string"
      },
      "sourceTransaction": {
        "txHash": "string",
        "timestamp": 0,
        "gasSpent": "string"
      },
      "status": "pending"
    }
  ]
}
{
  "message": "string",
  "statusCode": 400,
  "error": "Bad Request"
}
{
  "message": "string",
  "statusCode": 401,
  "error": "Unauthorized"
}
{
  "message": "string",
  "statusCode": 403,
  "error": "Forbidden"
}
{
  "message": "string",
  "statusCode": 404,
  "error": "Not Found"
}
{
  "message": "string",
  "statusCode": 429,
  "error": "Too Many Requests"
}
{
  "message": "string",
  "statusCode": 500,
  "error": "Internal Server Error"
}
{
  "message": "string",
  "statusCode": 502,
  "error": "Bad Gateway"
}
{
  "message": "string",
  "statusCode": 503,
  "error": "Service Unavailable"
}

Is this guide helpful?