Skip to main content
Webhooks are a great way to receive real-time updates from the Codex API directly to your application. Webhooks are sent via HTTP, and a 2xx response is expected with 3 seconds, otherwise we will retry sending the message later. If you are successfully receiving the message but not responding within 3 seconds, this can result in repeated messages. We will also retry sending messages up to 2 times before giving up. Periods between retries will gradually increase. If your service is down for too long though you may miss some messages.
Webhook usage breakdown:
  • Processed means an event matched at a basic level (e.g. maker, pair, token address)
  • Triggered means all conditions passed and we will try to publish
  • Success means we attempted to publish and it worked as expected
  • Failed means we attempted to publish and it failed (Usually a bad URL)

​
Message Payloads

​
type
WebhookPublisherMessageType
​
deduplicationId
String
​
webhookId
String
​
groupId
String
​
hash
String
SHA256 hash of the securityToken and deduplicationId. See Hash Verification for details on how to verify this hash.
​
data
WebhookPublisherDataModels

​
WebhookPublisherMessageType

WebhookPublisherMessageType
enum {
  TOKEN_PRICE_EVENT,
  TOKEN_PRICE_EVENT_BATCH,
  PRICE_EVENT, # Deprecated - use TOKEN_PRICE_EVENT
  PRICE_EVENT_BATCH, # Deprecated - use TOKEN_PRICE_EVENT_BATCH
  TOKEN_PAIR_EVENT,
  TOKEN_PAIR_EVENT_BATCH
  NFT_EVENT,
  NFT_EVENT_BATCH,
  MARKET_CAP_EVENT,
  MARKET_CAP_EVENT_BATCH,
  TOKEN_TRANSFER_EVENT,
  TOKEN_TRANSFER_EVENT_BATCH
}

​
WebhookPublisherDataModels

​
PRICE_EVENT
Price
The Price response type.Deprecated: Use TOKEN_PRICE_EVENT instead.
​
PRICE_EVENT_BATCH
Price
An array of Prices.Deprecated: Use TOKEN_PRICE_EVENT_BATCH instead.
​
TOKEN_PRICE_EVENT
TokenPriceEvent
A TokenPriceEvent with price data and token metadata
​
TOKEN_PRICE_EVENT_BATCH
TokenPriceEvent
An array of TokenPriceEvents
​
TOKEN_PAIR_EVENT
WebhookTokenPairEvent
A WebhookTokenPairEvent
​
TOKEN_PAIR_EVENT_BATCH
WebhookTokenPairEvent
An array of WebhookTokenPairEvents
​
NFT_EVENT
NftEvent
An NftEvent
​
NFT_EVENT_BATCH
NftEvent
An array of NftEvents
​
MARKET_CAP_EVENT
MarketCapEvent
A MarketCapEvent
​
MARKET_CAP_EVENT_BATCH
MarketCapEventBatch
An array of MarketCapEvents
​
TOKEN_TRANSFER_EVENT
TokenTransferEvent
A TokenTransferEvent for token transfers between wallets
​
TOKEN_TRANSFER_EVENT_BATCH
TokenTransferEvent
An array of TokenTransferEvents

​
PriceEvent

Deprecated: PRICE_EVENT is deprecated. Use TOKEN_PRICE_EVENT instead.

{
   "type":"PRICE_EVENT",
   "deduplicationId":"43b7b2a6-10b4-4a96-86ff-3c8f12854187-0xf4d2888d29d722226fafa5d9b24f9164c092421e:1-0000000016636917#00000008#00000042",
   "webhookId":"43b7b2a6-10b4-4a96-86ff-3c8f12854187",
   "groupId":"43b7b2a6-10b4-4a96-86ff-3c8f12854187",
   "hash":"1b7753a1220e3a73cb9ad80fe2995417391bbbdf5afdc2c20e8d09e1525b5a77",
   "data":{
      "id":"0xf4d2888d29d722226fafa5d9b24f9164c092421e:1",
      "priceUsd":"0.2947524293192561",
      "weightedMeanPriceUSD":"0.29591661415754684237638544437518137913573321397384173430977975687571741224486479663626573953609440257289752764081859",
      "address":"0xf4d2888d29d722226fafa5d9b24f9164c092421e",
      "networkId":1,
      "timestamp":1676497655,
      "blockNumber":16636917,
      "absoluteDeviation":0.0011641848382907423,
      "deviationsFromMean":3.1257552985434662,
      "derivedSwapPrice":"0.2943200371838018",
      "targetTokenAddress":"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
      "pairMetadata": {
        "liquidityUsd":"67747",
        "pairId":"0x2aeee741fa1e21120a21e57db9ee545428e683c9:1",
        "volume24Usd":"162206"
      }
   }
}

## BATCH VERSION
{
  "type":"PRICE_EVENT_BATCH",
   "deduplicationId":"43b7b2a6-10b4-4a96-86ff-3c8f12854187-0xf4d2888d29d722226fafa5d9b24f9164c092421e:1-0000000016636917#00000008#00000042",
   "webhookId":"43b7b2a6-10b4-4a96-86ff-3c8f12854187",
   "groupId":"43b7b2a6-10b4-4a96-86ff-3c8f12854187",
   "hash":"1b7753a1220e3a73cb9ad80fe2995417391bbbdf5afdc2c20e8d09e1525b5a77",
   "data":[
     {
        "id":"0xf4d2888d29d722226fafa5d9b24f9164c092421e:1",
        "priceUsd":"0.2947524293192561",
        "weightedMeanPriceUSD":"0.29591661415754684237638544437518137913573321397384173430977975687571741224486479663626573953609440257289752764081859",
        "address":"0xf4d2888d29d722226fafa5d9b24f9164c092421e",
        "networkId":1,
        "timestamp":1676497655,
        "blockNumber":16636917,
        "absoluteDeviation":0.0011641848382907423,
        "deviationsFromMean":3.1257552985434662,
        "derivedSwapPrice":"0.2943200371838018",
        "targetTokenAddress":"0xa0b86991c6218b36c1d19d4a2e9eb0ce3606eb48",
        "pairMetadata": {
          "liquidityUsd":"67747",
          "pairId":"0x2aeee741fa1e21120a21e57db9ee545428e683c9:1",
          "volume24Usd":"162206"
        }
   	 },
      {
        "id":"0xf4d2888d29d722226fafa5d9b24f9164c092421e:1",
        "priceUsd":"0.2947524293192561",
        "weightedMeanPriceUSD":"0.29591661415754684237638544437518137913573321397384173430977975687571741224486479663626573953609440257289752764081859",
        "address":"0xf4d2888d29d722226fafa5d9b24f9164c092423fdaf",
        "networkId":1,
        "timestamp":1676497688,
        "blockNumber":16636917,
        "absoluteDeviation":0.0011641848382907423,
        "deviationsFromMean":3.1257552985434662,
        "derivedSwapPrice":"22.09",
        "targetTokenAddress":"0xa0fwsj894vh487hv85e7hv58hw8437hfw48f43oiunvj",
        "pairMetadata": {
          "liquidityUsd":"67747",
          "pairId":"0x2aeee741fa1e21120a21e57db9ee545428e683c9:1",
          "volume24Usd":"162206"
        }
   	 }
   ]
}
Check out our webhook price event input conditions here. Note: This webhook type is deprecated. Please use TOKEN_PRICE_EVENT for new implementations.

​
TokenPriceEvent

The TOKEN_PRICE_EVENT webhook delivers token price updates with comprehensive token metadata including name, symbol, and supply information. 

{
   "type":"TOKEN_PRICE_EVENT",
   "deduplicationId":"5e0fe797-c795-451f-af87-0257847b8c3b-0x0b3e328455c4059eeb9e3f84b5543f74e24e7e1b:8453-0000000030917440#00000117#00000353",
   "webhookId":"5e0fe797-c795-451f-af87-0257847b8c3b",
   "groupId":"5e0fe797-c795-451f-af87-0257847b8c3b",
   "hash":"c296a760c563c9a4115146af75945d1b35d0741835309fa44d393ef3c2b044dd",
   "webhook":{
      "id":"5e0fe797-c795-451f-af87-0257847b8c3b",
      "name":"token-price-webhook"
   },
   "data":{
      "id": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2:1",
      "priceUsd": "3.0898058248076381750556910457327e+3",
      "address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
      "networkId": 1,
      "timestamp": 1765585223,
      "blockNumber": 24000071
   }
}

## BATCH VERSION
{
  "type":"TOKEN_PRICE_EVENT_BATCH",
   "deduplicationId":"5e0fe797-c795-451f-af87-0257847b8c3b-batch-0000000030917440",
   "webhookId":"5e0fe797-c795-451f-af87-0257847b8c3b",
   "groupId":"5e0fe797-c795-451f-af87-0257847b8c3b",
   "hash":"c296a760c563c9a4115146af75945d1b35d0741835309fa44d393ef3c2b044dd",
   "data":[
      {
         "id": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2:1",
         "priceUsd": "3.0898058248076381750556910457327e+3",
         "address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
         "networkId": 1,
         "timestamp": 1765585223,
         "blockNumber": 24000071
      },
      {
         "id": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2:1",
         "priceUsd": "3.0998058248076381750556910457327e+3",
         "address": "0xc02aaa39b223fe8d0a0e5c4f27ead9083c756cc2",
         "networkId": 1,
         "timestamp": 17655852423,
         "blockNumber": 24000072
      }
   ]
}
Check out our webhook token price event input conditions here.

​
WebhookTokenPairEvent

​
pair
Pair
​
event
Event
Example
{
  "deduplicationId": "aa4cd403-b54e-4e2d-825c-f70a69f6fd9f-DbyEjKTHE76qgb8niQ4zDCoaU4CK7Si9PJkD6Ckjtugo:1399811149-0000000256717997#00000000#00000002#00000009",
  "groupId": "bc9345e6-b0da-4935-9b31-47b34cc5f628",
  "hash": "e39fa0bfcef1bfcd12d6707c29ac752899228d026338e594e04a398255962022",
  "type": "TOKEN_PAIR_EVENT",
  "webhook": {
    "bucketId": "bc9345e6-b0da-4935-9b31-47b34cc5f628",
    "bucketSortkey": "GSE6vfr6vws493G22jfwCU6Zawh3dfvSYXYQqKhFsBwe",
    "id": "aa4cd403-b54e-4e2d-825c-f70a69f6fd9f",
    "name": "traderpow:GSE6vfr6vws493G22jfwCU6Zawh3dfvSYXYQqKhFsBwe:TOKEN_PAIR_EVENT",
  },
  "webhookId": "aa4cd403-b54e-4e2d-825c-f70a69f6fd9f",
  "data": {
    "event": {
      "address": "DbyEjKTHE76qgb8niQ4zDCoaU4CK7Si9PJkD6Ckjtugo",
      "baseTokenPrice": "18651403264.31996",
      "blockHash": "DGXgkMSxovvjdA5iKgrsFL7duNyXRPsW86Ztvg2Mc1hL",
      "blockNumber": 256717997,
      "data": {
        "amount0": "7020307392",
        "amount1": "-2899270904078",
        "liquidity": "51478999661589",
        "liquidity0": "1140722809229",
        "liquidity1": "457845387792910",
        "protocol": "Orca",
        "sqrtPriceX64": "376244087403309877755",
        "tick": "60310",
        "type": "Swap",
      },
      "eventDisplayType": "Buy",
      "eventType": "Swap",
      "eventType2": "Token1Buy",
      "id": "DbyEjKTHE76qgb8niQ4zDCoaU4CK7Si9PJkD6Ckjtugo:1399811149",
      "labels": {},
      "liquidityToken": "So11111111111111111111111111111111111111112",
      "logIndex": 2,
      "maker": "GSE6vfr6vws493G22jfwCU6Zawh3dfvSYXYQqKhFsBwe",
      "makerHashKey": "GSE6vfr6vws493G22jfwCU6Zawh3dfvSYXYQqKhFsBwe:DbyEjKTHE76qgb8niQ4zDCoaU4CK7Si9PJkD6Ckjtugo:1399811149",
      "networkId": 1399811149,
      "quoteToken": "token1",
      "sortKey": "0000000256717997#00000000#00000002#00000009",
      "supplementalIndex": 9,
      "timestamp": 1711526246,
      "token0PoolValueUsd": "186.5140326431996",
      "token0SwapValueUsd": "186.51403264319955960744460600963952776157867455426636901017",
      "token0ValueBase": "1",
      "token0ValueUsd": "186.5140326431996",
      "token1PoolValueUsd": "0.4483442346979745",
      "token1SwapValueUsd": "0.45162590368325119780671230665069180443756818839541768",
      "token1ValueBase": "0.0024038096669951625071971972244735217782",
      "token1ValueUsd": "0.4483442346979745",
      "transactionHash": "2dd5jDHbVYZpXgYbEQzpv47Z7jwimmHeDxKytiM9FB4GzBA5QeYh5xHTzkQvCScQksvTrHqgq9k7q84MBcGbaFfJ",
      "transactionIndex": 0,
      "ttl": 1716710246,
    },
    "pair": {
      "address": "DbyEjKTHE76qgb8niQ4zDCoaU4CK7Si9PJkD6Ckjtugo",
      "exchangeHash": "whirLbMiicVdio4qvUfM5KAg6Ct8VwpYzGff3uctyCc",
      "fee": undefined,
      "id": "DbyEjKTHE76qgb8niQ4zDCoaU4CK7Si9PJkD6Ckjtugo:1399811149",
      "networkId": 1399811149,
      "tickSpacing": undefined,
      "token0": "So11111111111111111111111111111111111111112",
      "token1": "FU1q8vJpZNUrmqsciSjp8bAKKidGsLmouB8CBdf8TKQv",
    },
  },
}

## BATCH VERSION
{
  "deduplicationId": "aa4cd403-b54e-4e2d-825c-f70a69f6fd9f-DbyEjKTHE76qgb8niQ4zDCoaU4CK7Si9PJkD6Ckjtugo:1399811149-0000000256717997#00000000#00000002#00000009",
  "groupId": "bc9345e6-b0da-4935-9b31-47b34cc5f628",
  "hash": "e39fa0bfcef1bfcd12d6707c29ac752899228d026338e594e04a398255962022",
  "type": "TOKEN_PAIR_EVENT_BATCH",
  "webhook": {
    "bucketId": "bc9345e6-b0da-4935-9b31-47b34cc5f628",
    "bucketSortkey": "GSE6vfr6vws493G22jfwCU6Zawh3dfvSYXYQqKhFsBwe",
    "id": "aa4cd403-b54e-4e2d-825c-f70a69f6fd9f",
    "name": "traderpow:GSE6vfr6vws493G22jfwCU6Zawh3dfvSYXYQqKhFsBwe:TOKEN_PAIR_EVENT",
  },
  "webhookId": "aa4cd403-b54e-4e2d-825c-f70a69f6fd9f",
  "data": [
    {
      "event": {
        "address": "DbyEjKTHE76qgb8niQ4zDCoaU4CK7Si9PJkD6Ckjtugo",
        "baseTokenPrice": "18651403264.31996",
        "blockHash": "DGXgkMSxovvjdA5iKgrsFL7duNyXRPsW86Ztvg2Mc1hL",
        "blockNumber": 256717997,
        "data": {
          "amount0": "7020307392",
          "amount1": "-2899270904078",
          "liquidity": "51478999661589",
          "liquidity0": "1140722809229",
          "liquidity1": "457845387792910",
          "protocol": "Orca",
          "sqrtPriceX64": "376244087403309877755",
          "tick": "60310",
          "type": "Swap",
        },
        "eventDisplayType": "Buy",
        "eventType": "Swap",
        "eventType2": "Token1Buy",
        "id": "DbyEjKTHE76qgb8niQ4zDCoaU4CK7Si9PJkD6Ckjtugo:1399811149",
        "labels": {},
        "liquidityToken": "So11111111111111111111111111111111111111112",
        "logIndex": 2,
        "maker": "GSE6vfr6vws493G22jfwCU6Zawh3dfvSYXYQqKhFsBwe",
        "makerHashKey": "GSE6vfr6vws493G22jfwCU6Zawh3dfvSYXYQqKhFsBwe:DbyEjKTHE76qgb8niQ4zDCoaU4CK7Si9PJkD6Ckjtugo:1399811149",
        "networkId": 1399811149,
        "quoteToken": "token1",
        "sortKey": "0000000256717997#00000000#00000002#00000009",
        "supplementalIndex": 9,
        "timestamp": 1711526246,
        "token0PoolValueUsd": "186.5140326431996",
        "token0SwapValueUsd": "186.51403264319955960744460600963952776157867455426636901017",
        "token0ValueBase": "1",
        "token0ValueUsd": "186.5140326431996",
        "token1PoolValueUsd": "0.4483442346979745",
        "token1SwapValueUsd": "0.45162590368325119780671230665069180443756818839541768",
        "token1ValueBase": "0.0024038096669951625071971972244735217782",
        "token1ValueUsd": "0.4483442346979745",
        "transactionHash": "2dd5jDHbVYZpXgYbEQzpv47Z7jwimmHeDxKytiM9FB4GzBA5QeYh5xHTzkQvCScQksvTrHqgq9k7q84MBcGbaFfJ",
        "transactionIndex": 0,
        "ttl": 1716710246,
      },
      "pair": {
        "address": "DbyEjKTHE76qgb8niQ4zDCoaU4CK7Si9PJkD6Ckjtugo",
        "exchangeHash": "whirLbMiicVdio4qvUfM5KAg6Ct8VwpYzGff3uctyCc",
        "fee": undefined,
        "id": "DbyEjKTHE76qgb8niQ4zDCoaU4CK7Si9PJkD6Ckjtugo:1399811149",
        "networkId": 1399811149,
        "tickSpacing": undefined,
        "token0": "So11111111111111111111111111111111111111112",
        "token1": "FU1q8vJpZNUrmqsciSjp8bAKKidGsLmouB8CBdf8TKQv",
      },
    },
    {
      "event": {
        "address": "HKeUEKvx7fjKbLyGSZN5UND6RCJnyj5ApPGQPowUPdbB",
        "baseTokenPrice": "18651403264.31996",
        "blockHash": "DGXgkMSxovvjdA5iKgrsFL7duNyXRPsW86Ztvg2Mc1hL",
        "blockNumber": 256717997,
        "data": {
          "amount0": "26155218627555",
          "amount1": "-35101536960",
          "protocol": "RaydiumV4",
          "reserve0": "1058148164348477",
          "reserve1": "1458745388741",
          "type": "Swap",
        },
        "eventDisplayType": "Sell",
        "eventType": "Swap",
        "eventType2": "Token1Buy",
        "id": "HKeUEKvx7fjKbLyGSZN5UND6RCJnyj5ApPGQPowUPdbB:1399811149",
        "labels": {},
        "liquidityToken": "So11111111111111111111111111111111111111112",
        "logIndex": 2,
        "maker": "GSE6vfr6vws493G22jfwCU6Zawh3dfvSYXYQqKhFsBwe",
        "makerHashKey": "GSE6vfr6vws493G22jfwCU6Zawh3dfvSYXYQqKhFsBwe:HKeUEKvx7fjKbLyGSZN5UND6RCJnyj5ApPGQPowUPdbB:1399811149",
        "networkId": 1399811149,
        "quoteToken": "token0",
        "sortKey": "0000000256717997#00000012#00000002#00000001",
        "supplementalIndex": 1,
        "timestamp": 1711526246,
        "token0PoolValueUsd": "0.2571251306959254",
        "token0SwapValueUsd": "0.25031062839163607245575397421766145134310347613998208",
        "token0ValueBase": "0.0013785833004201055103623962393194678448",
        "token0ValueUsd": "0.2571251306959254",
        "token1PoolValueUsd": "186.5140326431996",
        "token1SwapValueUsd": "186.5140326431995460110225891373618074187028512286137509928",
        "token1ValueBase": "1",
        "token1ValueUsd": "186.5140326431996",
        "transactionHash": "2dd5jDHbVYZpXgYbEQzpv47Z7jwimmHeDxKytiM9FB4GzBA5QeYh5xHTzkQvCScQksvTrHqgq9k7q84MBcGbaFfJ",
        "transactionIndex": 12,
        "ttl": 1716710246,
      },
      "pair": {
        "address": "HKeUEKvx7fjKbLyGSZN5UND6RCJnyj5ApPGQPowUPdbB",
        "exchangeHash": "675kPX9MHTjS2zt1qfr1NYHuzeLXfQM9H24wFSUt1Mp8",
        "fee": undefined,
        "id": "HKeUEKvx7fjKbLyGSZN5UND6RCJnyj5ApPGQPowUPdbB:1399811149",
        "networkId": 1399811149,
        "tickSpacing": undefined,
        "token0": "GumHxsx6Kan7R1BNAEEtRMhZJVULeeZGwMGPcjT162Sp",
        "token1": "So11111111111111111111111111111111111111112",
      },
    },
  ],
}

​
NftEvent

{
  "deduplicationId": "182f0dba-19a2-402d-a5fa-8cf7ac29562c-0x91d60c55e3a8e150aa5b62e705dfca1a0aefb45c:987:1-987#12345",
  "groupId": "182f0dba-19a2-402d-a5fa-8cf7ac29562c",
  "hash": "9b25ed220bbf7b142256d5e21095fe254bce96c9cbabbb4937640c5ddb073e19",
  "type": "NFT_EVENT",
  "webhook": {
    "bucketId": "alm",
    "bucketSortkey": "zpp",
    "id": "182f0dba-19a2-402d-a5fa-8cf7ac29562c",
    "name": "Global",
  },
  "webhookId": "182f0dba-19a2-402d-a5fa-8cf7ac29562c",
  "data": {
    "baseTokenAddress": "0x0c574e080ece5eefcec7888cd2bd3b491e2fd6dd",
    "baseTokenPrice": "123400000000",
    "blockHash": "0xM123k12m3k12m3",
    "blockNumber": "12345",
    "contractAddress": "0x91d60c55e3a8e150aa5b62e705dfca1a0aefb45c",
    "data": {
      "buyHash": "",
      "maker": "0x59748c740ab9aa73cb5708cec0e05ac001aa11d7",
      "metadata": "0x00000000000000000000000000000000000",
      "price": "100000000",
      "sellHash": "",
      "taker": "0x7aa6221ff4fbaf6fea223ca834af1e6cc5ea9406",
      "type": "OrdersMatched",
    },
    "eventType": "OrdersMatched",
    "exchangeAddress": "0xe55b5ceba4dc0d4e26261f3dcd468faaf7d0cdb8",
    "id": "0x91d60c55e3a8e150aa5b62e705dfca1a0aefb45c:987:1",
    "individualBaseTokenPrice": "123400000000",
    "individualNetworkBaseTokenPrice": "129999999999",
    "individualPrice": "129999999999",
    "individualPriceNetworkBaseToken": "129999999999",
    "individualPriceUsd": "123400000000",
    "individualTokenPrice": "129999999999",
    "logIndex": 12345,
    "maker": "0x59748c740ab9aa73cb5708cec0e05ac001aa11d7",
    "networkBaseTokenPrice": "12312",
    "networkId": 1,
    "numberOfTokens": 1,
    "orderDirection": "BUY",
    "paymentTokenAddress": "0x0c574e080ece5eefcec7888cd2bd3b491e2fd6dd",
    "sortKey": "987#12345",
    "taker": "0x7aa6221ff4fbaf6fea223ca834af1e6cc5ea9406",
    "timestamp": 1726522569,
    "tokenId": "987",
    "tokenPrice": "129999999999",
    "totalPrice": "129999999999",
    "totalPriceNetworkBaseToken": "12312",
    "totalPriceUsd": "123400000000",
    "tradeOffer": [
      {
        "address": "0x0c574e080ece5eefcec7888cd2bd3b491e2fd6dd",
        "amount": "129999999999",
        "baseTokenPrice": "123400000000",
        "individualBaseTokenPrice": "123400000000",
        "individualNetworkBaseTokenPrice": "129999999999",
        "individualTokenPrice": "129999999999",
        "isPrice": true,
        "networkBaseTokenPrice": "12312",
        "recipient": "0x59748c740ab9aa73cb5708cec0e05ac001aa11d7",
        "tokenId": "987",
        "tokenPrice": "129999999999",
        "type": "TOKEN",
      },
    ],
    "tradeReceived": [
      {
        "address": "0x91d60c55e3a8e150aa5b62e705dfca1a0aefb45c",
        "amount": 1,
        "recipient": "0x7aa6221ff4fbaf6fea223ca834af1e6cc5ea9406",
        "tokenId": "987",
        "type": "NFT",
      },
    ],
    "transactionHash": "0xKM2km4k32m4k32m4k23",
    "transactionIndex": 1234,
  },
}

## BATCH VERSION
{
  "deduplicationId": "182f0dba-19a2-402d-a5fa-8cf7ac29562c-0x91d60c55e3a8e150aa5b62e705dfca1a0aefb45c:987:1-987#12345",
  "groupId": "182f0dba-19a2-402d-a5fa-8cf7ac29562c",
  "hash": "9b25ed220bbf7b142256d5e21095fe254bce96c9cbabbb4937640c5ddb073e19",
  "type": "NFT_EVENT_BATCH",
  "webhook": {
    "bucketId": "ava",
    "bucketSortkey": "lom",
    "id": "182f0dba-19a2-402d-a5fa-8cf7ac29562c",
    "name": "Global",
  },
  "webhookId": "182f0dba-19a2-402d-a5fa-8cf7ac29562c",
  "data": [
    {
      "baseTokenAddress": "0x0c574e080ece5eefcec7888cd2bd3b491e2fd6dd",
      "baseTokenPrice": "123400000000",
      "blockHash": "0xM123k12m3k12m3",
      "blockNumber": "12345",
      "contractAddress": "0x91d60c55e3a8e150aa5b62e705dfca1a0aefb45c",
      "data": {
        "buyHash": "",
        "maker": "0x59748c740ab9aa73cb5708cec0e05ac001aa11d7",
        "metadata": "0x00000000000000000000000000000000000",
        "price": "100000000",
        "sellHash": "",
        "taker": "0x7aa6221ff4fbaf6fea223ca834af1e6cc5ea9406",
        "type": "OrdersMatched",
      },
      "eventType": "OrdersMatched",
      "exchangeAddress": "0xe55b5ceba4dc0d4e26261f3dcd468faaf7d0cdb8",
      "id": "0x91d60c55e3a8e150aa5b62e705dfca1a0aefb45c:987:1",
      "individualBaseTokenPrice": "123400000000",
      "individualNetworkBaseTokenPrice": "129999999999",
      "individualPrice": "129999999999",
      "individualPriceNetworkBaseToken": "129999999999",
      "individualPriceUsd": "123400000000",
      "individualTokenPrice": "129999999999",
      "logIndex": 12345,
      "maker": "0x59748c740ab9aa73cb5708cec0e05ac001aa11d7",
      "networkBaseTokenPrice": "12312",
      "networkId": 1,
      "numberOfTokens": 1,
      "orderDirection": "BUY",
      "paymentTokenAddress": "0x0c574e080ece5eefcec7888cd2bd3b491e2fd6dd",
      "sortKey": "987#12345",
      "taker": "0x7aa6221ff4fbaf6fea223ca834af1e6cc5ea9406",
      "timestamp": 1726522569,
      "tokenId": "987",
      "tokenPrice": "129999999999",
      "totalPrice": "129999999999",
      "totalPriceNetworkBaseToken": "12312",
      "totalPriceUsd": "123400000000",
      "tradeOffer": [
        {
          "address": "0x0c574e080ece5eefcec7888cd2bd3b491e2fd6dd",
          "amount": "129999999999",
          "baseTokenPrice": "123400000000",
          "individualBaseTokenPrice": "123400000000",
          "individualNetworkBaseTokenPrice": "129999999999",
          "individualTokenPrice": "129999999999",
          "isPrice": true,
          "networkBaseTokenPrice": "12312",
          "recipient": "0x59748c740ab9aa73cb5708cec0e05ac001aa11d7",
          "tokenId": "987",
          "tokenPrice": "129999999999",
          "type": "TOKEN",
        },
      ],
      "tradeReceived": [
        {
          "address": "0x91d60c55e3a8e150aa5b62e705dfca1a0aefb45c",
          "amount": 1,
          "recipient": "0x7aa6221ff4fbaf6fea223ca834af1e6cc5ea9406",
          "tokenId": "987",
          "type": "NFT",
        },
      ],
      "transactionHash": "0xKM2km4k32m4k32m4k23",
      "transactionIndex": 1234,
    },
    {
      "baseTokenAddress": "0xcdfdc65ff2fdbca50e3f1e5e8e6b1e871ca50de9",
      "baseTokenPrice": "123400000000",
      "blockHash": "0xM123k12m3k12m3",
      "blockNumber": "12345",
      "contractAddress": "0xcd984d5890c4ce3bcd4acd1b5dca4cb4929cbddc",
      "data": {
        "buyHash": "",
        "maker": "0x6f7fddbbf7ceceb48fbaefa2ac2a6b77d3eacc49",
        "metadata": "0x00000000000000000000000000000000000",
        "price": "100000000",
        "sellHash": "",
        "taker": "0xa5a53cbbfece874a7b9d1d29552bfdaaf0cdc099",
        "type": "OrdersMatched",
      },
      "eventType": "OrdersMatched",
      "exchangeAddress": "0xac08fbacc4b1ae98dce55ccfafe01c048ef1dd42",
      "id": "0xcd984d5890c4ce3bcd4acd1b5dca4cb4929cbddc:987:1",
      "individualBaseTokenPrice": "123400000000",
      "individualNetworkBaseTokenPrice": "129999999999",
      "individualPrice": "129999999999",
      "individualPriceNetworkBaseToken": "129999999999",
      "individualPriceUsd": "123400000000",
      "individualTokenPrice": "129999999999",
      "logIndex": 12345,
      "maker": "0x6f7fddbbf7ceceb48fbaefa2ac2a6b77d3eacc49",
      "networkBaseTokenPrice": "12312",
      "networkId": 1,
      "numberOfTokens": 1,
      "orderDirection": "BUY",
      "paymentTokenAddress": "0xcdfdc65ff2fdbca50e3f1e5e8e6b1e871ca50de9",
      "sortKey": "987#12345",
      "taker": "0xa5a53cbbfece874a7b9d1d29552bfdaaf0cdc099",
      "timestamp": 1726522569,
      "tokenId": "987",
      "tokenPrice": "129999999999",
      "totalPrice": "129999999999",
      "totalPriceNetworkBaseToken": "12312",
      "totalPriceUsd": "123400000000",
      "tradeOffer": [
        {
          "address": "0xcdfdc65ff2fdbca50e3f1e5e8e6b1e871ca50de9",
          "amount": "129999999999",
          "baseTokenPrice": "123400000000",
          "individualBaseTokenPrice": "123400000000",
          "individualNetworkBaseTokenPrice": "129999999999",
          "individualTokenPrice": "129999999999",
          "isPrice": true,
          "networkBaseTokenPrice": "12312",
          "recipient": "0x6f7fddbbf7ceceb48fbaefa2ac2a6b77d3eacc49",
          "tokenId": "987",
          "tokenPrice": "129999999999",
          "type": "TOKEN",
        },
      ],
      "tradeReceived": [
        {
          "address": "0xcd984d5890c4ce3bcd4acd1b5dca4cb4929cbddc",
          "amount": 1,
          "recipient": "0xa5a53cbbfece874a7b9d1d29552bfdaaf0cdc099",
          "tokenId": "987",
          "type": "NFT",
        },
      ],
      "transactionHash": "0xKM2km4k32m4k32m4k23",
      "transactionIndex": 1234,
    },
  ],
}

​
MarketCapEvent


{
   "type":"MARKET_CAP_EVENT",
   "deduplicationId":"5e0fe797-c795-451f-af87-0257847b8c3b-0x0b3e328455c4059eeb9e3f84b5543f74e24e7e1b:8453-0000000030917440#00000117#00000353-0x0b3e328455c4059eeb9e3f84b5543f74e24e7e1b:8453",
   "webhookId":"5e0fe797-c795-451f-af87-0257847b8c3b",
   "groupId":"test-group",
   "hash":"c296a760c563c9a4115146af75945d1b35d0741835309fa44d393ef3c2b044dd",
   "webhook":{
      "id":"5e0fe797-c795-451f-af87-0257847b8c3b",
      "name":"mcap-virt"
   },
   "data":{
      "priceModel":{
         "id":"0x0b3e328455c4059eeb9e3f84b5543f74e24e7e1b:8453",
         "priceUsd":"2.014904011469267",
         "address":"0x0b3e328455c4059eeb9e3f84b5543f74e24e7e1b",
         "networkId":8453,
         "timestamp":1748624227,
         "blockNumber":30917440,
         "absoluteDeviation":0,
         "derivedSwapPrice":"2.008965143151456",
         "targetTokenAddress":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
         "pairMetadata": {
            "liquidityUsd":"67747",
            "pairId":"0x2aeee741fa1e21120a21e57db9ee545428e683c9:1",
            "volume24Usd":"162206"
          }
      },
      "tokenModel":{
         "id":"0x0b3e328455c4059eeb9e3f84b5543f74e24e7e1b:8453",
         "address":"0x0b3e328455c4059eeb9e3f84b5543f74e24e7e1b",
         "name":"Virtual Protocol",
         "symbol":"VIRTUAL",
         "decimals":18,
         "shiftedTotalSupply":"495620931.12225886540849246",
         "shiftedCirculatingSupply":"495620930.505466750752879695"
      },
      "fdvMarketCapUsd":"998628602.29",
      "circulatingMarketCapUsd":"998628601.04"
   }
}
  


## BATCH VERSION
{
  "type":"PRICE_EVENT_BATCH",
   "deduplicationId":"43b7b2a6-10b4-4a96-86ff-3c8f12854187-0xf4d2888d29d722226fafa5d9b24f9164c092421e:1-0000000016636917#00000008#00000042",
   "webhookId":"43b7b2a6-10b4-4a96-86ff-3c8f12854187",
   "groupId":"43b7b2a6-10b4-4a96-86ff-3c8f12854187",
   "hash":"1b7753a1220e3a73cb9ad80fe2995417391bbbdf5afdc2c20e8d09e1525b5a77",
   "data":[
     {
        "priceModel":{
            "id":"0x0b3e328455c4059eeb9e3f84b5543f74e24e7e1b:8453",
            "priceUsd":"2.014904011469267",
            "address":"0x0b3e328455c4059eeb9e3f84b5543f74e24e7e1b",
            "networkId":8453,
            "timestamp":1748624227,
            "blockNumber":30917440,
            "absoluteDeviation":0,
            "derivedSwapPrice":"2.008965143151456",
            "targetTokenAddress":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
            "pairMetadata": {
              "liquidityUsd":"67747",
              "pairId":"0x2aeee741fa1e21120a21e57db9ee545428e683c9:1",
              "volume24Usd":"162206"
            }
        },
        "tokenModel":{
            "id":"0x0b3e328455c4059eeb9e3f84b5543f74e24e7e1b:8453",
            "address":"0x0b3e328455c4059eeb9e3f84b5543f74e24e7e1b",
            "name":"Virtual Protocol",
            "symbol":"VIRTUAL",
            "decimals":18,
            "shiftedTotalSupply":"495620931.12225886540849246",
            "shiftedCirculatingSupply":"495620930.505466750752879695"
        },
        "fdvMarketCapUsd":"998628602.29",
        "circulatingMarketCapUsd":"998628601.04"
      },
      {
        "priceModel":{
          "id":"0x0b3e328455c4059eeb9e3f84b5543f74e24e7e1b:8453",
          "priceUsd":"2.014904011469267",
          "address":"0x0b3e328455c4059eeb9e3f84b5543f74e24e7e1b",
          "networkId":8453,
          "timestamp":1748624227,
          "blockNumber":30917440,
          "absoluteDeviation":0,
          "derivedSwapPrice":"2.008965143151456",
          "targetTokenAddress":"0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
          "pairMetadata": {
              "liquidityUsd":"67747",
              "pairId":"0x2aeee741fa1e21120a21e57db9ee545428e683c9:1",
              "volume24Usd":"162206"
            }
        },
        "tokenModel":{
          "id":"0x0b3e328455c4059eeb9e3f84b5543f74e24e7e1b:8453",
          "address":"0x0b3e328455c4059eeb9e3f84b5543f74e24e7e1b",
          "name":"Virtual Protocol",
          "symbol":"VIRTUAL",
          "decimals":18,
          "shiftedTotalSupply":"495620931.12225886540849246",
          "shiftedCirculatingSupply":"495620930.505466750752879695"
        },
        "fdvMarketCapUsd":"998628602.29",
        "circulatingMarketCapUsd":"998628601.04"
      }
   ]
}

​
TokenTransferEvent

The TOKEN_TRANSFER_EVENT webhook delivers token transfer events when tokens are transferred between wallets. The direction field specifies which transfers to monitor using a oneOf condition:
  • TO - Fires when the monitored wallet receives tokens (is the recipient)
  • FROM - Fires when the monitored wallet sends tokens (is the sender)
  • Include both TO and FROM to monitor all transfers involving the wallet

{
  "type": "TOKEN_TRANSFER_EVENT",
  "deduplicationId": "6af3a260-7e2c-4615-babe-c239786ec9fd-0x84df029b0fc5d81ec8d65fa49568bc509e8ce0caa3de05c8de51acea8aafdb6b-740",
  "webhookId": "6af3a260-7e2c-4615-babe-c239786ec9fd",
  "groupId": "762acfb9-872d-4fa7-96a0-e45236759c55",
  "hash": "360adec82a811049a7374b087c40789e716c2329cb5dfc9b6dffc182fb77cd2b",
  "webhook": {
    "id": "6af3a260-7e2c-4615-babe-c239786ec9fd",
    "name": "Track transfers to wallet"
  },
  "data": {
    "tokenAddress": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
    "networkId": 8453,
    "fromAddress": "0x4767bf3619bb493d129c864a023512fa1dce9da4",
    "toAddress": "0x1abde2088657de84ad6239f3d445dd07d6fa1033",
    "amount": "20000",
    "shiftedAmount": "0.02",
    "direction": "TO",
    "timestamp": 1767657659,
    "blockNumber": 40434156,
    "transactionHash": "0x84df029b0fc5d81ec8d65fa49568bc509e8ce0caa3de05c8de51acea8aafdb6b",
    "transactionIndex": 171,
    "logIndex": 740
  }
}

## BATCH VERSION
{
  "type": "TOKEN_TRANSFER_EVENT_BATCH",
  "deduplicationId": "6af3a260-7e2c-4615-babe-c239786ec9fd-batch-40434156",
  "webhookId": "6af3a260-7e2c-4615-babe-c239786ec9fd",
  "groupId": "762acfb9-872d-4fa7-96a0-e45236759c55",
  "hash": "360adec82a811049a7374b087c40789e716c2329cb5dfc9b6dffc182fb77cd2b",
  "webhook": {
    "id": "6af3a260-7e2c-4615-babe-c239786ec9fd",
    "name": "Track all transfers"
  },
  "data": [
    {
      "tokenAddress": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
      "networkId": 8453,
      "fromAddress": "0x4767bf3619bb493d129c864a023512fa1dce9da4",
      "toAddress": "0x1abde2088657de84ad6239f3d445dd07d6fa1033",
      "amount": "20000",
      "shiftedAmount": "0.02",
      "direction": "TO",
      "timestamp": 1767657659,
      "blockNumber": 40434156,
      "transactionHash": "0x84df029b0fc5d81ec8d65fa49568bc509e8ce0caa3de05c8de51acea8aafdb6b",
      "transactionIndex": 171,
      "logIndex": 740
    },
    {
      "tokenAddress": "0x833589fcd6edb6e08f4c7c32d4f71b54bda02913",
      "networkId": 8453,
      "fromAddress": "0x1abde2088657de84ad6239f3d445dd07d6fa1033",
      "toAddress": "0x9876543210fedcba9876543210fedcba98765432",
      "amount": "50000",
      "shiftedAmount": "0.05",
      "direction": "FROM",
      "timestamp": 1767657700,
      "blockNumber": 40434160,
      "transactionHash": "0x1234567890abcdef1234567890abcdef1234567890abcdef1234567890abcdef",
      "transactionIndex": 85,
      "logIndex": 312
    }
  ]
}

​
Hash Verification

The hash field is a SHA256 hash of your webhook’s securityToken and the message’s deduplicationId. Verify it matches: 
const crypto = require('crypto');

const calculatedHash = crypto
  .createHash('sha256')
  .update(securityToken)
  .update(deduplicationId)
  .digest('hex');