forwarding

List forwarding events

Changed on

Returns a paginated list of forwarding events. Forwarding events represent cross-domain token transfers where tokens are forwarded from a Celestia address to a destination address on another domain. Results can be filtered by transaction hash, address, or block height.

get/forwarding

Request

  • Base URL
    api-mainnet.celenium.io (relative, and the document was published on a file host, not at the API’s origin)
  • Auth
    API key in header apikey

Query parameters

limitinteger

Count of requested entities

offsetinteger

Offset for pagination

sort'asc' | 'desc'

Sort order. Default: desc

tx_hashstring

Filter by transaction hash (hex)

addressstring

Filter by Celestia address

heightinteger

Filter by block height

frominteger

Filter by start time (Unix timestamp)

tointeger

Filter by end time (Unix timestamp)

Response

OK

amountstring string
denomstring hex
dest_addressstring hex
dest_domaininteger
heightinteger
idinteger
message_idstring hex
timestring date-time
token_idstring hex
tx_hashstring hex

Example response

[
  {
    "amount": "1000000",
    "chain": {
      "block_explorers": [
        {
          "api_url": "https://api.scan.url.io",
          "family": "etherscan",
          "name": "Block explorer",
          "url": "https://scan.url.io"
        }
      ],
      "name": "name",
      "native_token": {
        "decimals": 18,
        "name": "Ether",
        "symbol": "ETH"
      }
    },
    "denom": "hyperlane/0x726f757465725f61707000000000000000000000000000020000000000000024",
    "dest_address": "0x000000000000000000000000d5e85e86fc692cedad6d6992f1f0ccf273e39913",
    "dest_domain": 11155111,
    "forward_address": {
      "celestials": {
        "image_url": "https://ipfs.io/ipfs/QmUi269vE25fagqhyMCCTNSoiW6x4LHCwwQb3keSrEXAmC",
        "name": "name",
        "primary": true,
        "status": "VERIFIED"
      },
      "hash": "celestia1jc92qdnty48pafummfr8ava2tjtuhfdw774w60"
    },
    "height": 100,
    "id": 321,
    "inputs": [
      {
        "chain": {
          "block_explorers": [
            {
              "api_url": "https://api.scan.url.io",
              "family": "etherscan",
              "name": "Block explorer",
              "url": "https://scan.url.io"
            }
          ],
          "name": "name",
          "native_token": {
            "decimals": 18,
            "name": "Ether",
            "symbol": "ETH"
          }
        },
        "chain_id": "osmosis-1",
        "channel_id": "channel-2",
        "denom": "utia",
        "from": "0x000000000000000000000000123456789abcdef123456789abcdef12345609",
        "height": 100,
        "received": "123445",
        "time": "2023-07-04T03:10:57+00:00",
        "tx_hash": "652452A670018D629CC116E510BA88C1CABE061336661B1F3D206D248BD558AF",
        "type": "ibc"
      }
    ],
    "message_id": "₀xac8852bd411c₀c88cdadfe9b2386b2bcd7₀2f35479c25a4b2d2cc3fb49d₀95d4",
    "time": "2023-07-04T03:10:57+00:00",
    "token_id": "12652452A670018D629CC116E510BA88C1CABE061336661B1F3D206D248BD558AF345",
    "tx_hash": "652452A670018D629CC116E510BA88C1CABE061336661B1F3D206D248BD558AF"
  }
]

Changes