> ## Documentation Index > Fetch the complete documentation index at: https://docs.dfns.co/llms.txt > Use this file to discover all available pages before exploring further. # Get Address Watch Blockchain Events > Retrieves a list of decoded blockchain events indexed for the specified address watch. Blockchain events are not value transfers: asset and token transfers are listed by [Get Address Watch History](https://docs.dfns.co/api-reference/address-watches/get-address-watch-history) instead. Events from the same transaction share the same `txHash` across both lists. Items are sorted by descending block number; within one block the item order is not the on-chain order. `index` is the block scoped log index as a decimal string: sort by `blockNumber` and the numeric value of `index` to recover the on-chain order. Webhook delivery is at-least-once and unordered; use `id` to deduplicate. #### Authentication ✅ Organization User (`CustomerEmployee`)\ ✅ Delegated User (`EndUser`)\ ✅ Service Account #### Required Permissions `AddressWatches:Read`: Always required. ## OpenAPI ````yaml /openapi.yaml get /address-watches/{addressWatchId}/blockchain-events openapi: 3.1.0 info: version: 1.952.0 title: Dfns servers: - url: https://api.dfns.io description: Default - Europe - url: https://api.uae.dfns.io description: UAE - url: https://api.dfns.ninja description: Staging security: [] paths: /address-watches/{addressWatchId}/blockchain-events: get: tags: - Address Watches summary: Get Address Watch Blockchain Events description: >- Retrieves a list of decoded blockchain events indexed for the specified address watch. Blockchain events are not value transfers: asset and token transfers are listed by [Get Address Watch History](https://docs.dfns.co/api-reference/address-watches/get-address-watch-history) instead. Events from the same transaction share the same `txHash` across both lists. Items are sorted by descending block number; within one block the item order is not the on-chain order. `index` is the block scoped log index as a decimal string: sort by `blockNumber` and the numeric value of `index` to recover the on-chain order. Webhook delivery is at-least-once and unordered; use `id` to deduplicate. parameters: - schema: type: string minLength: 1 maxLength: 64 pattern: ^aw-[a-z0-9]{5}-[a-z0-9]{5}-[a-z0-9]{14,16}$ description: Address watch you want to get the blockchain events from. required: true description: Address watch you want to get the blockchain events from. name: addressWatchId in: path - schema: type: integer minimum: 1 maximum: 500 default: 50 description: Maximum number of items to return. required: false description: Maximum number of items to return. name: limit in: query - schema: type: string minLength: 1 description: >- Opaque token used to retrieve the next page. Returned as `nextPageToken` from the previous request. required: false description: >- Opaque token used to retrieve the next page. Returned as `nextPageToken` from the previous request. name: paginationToken in: query - schema: type: string minLength: 1 required: false name: name in: query - schema: type: string minLength: 1 required: false name: contract in: query - schema: type: string minLength: 1 required: false name: txHash in: query responses: '200': description: Success content: application/json: schema: type: object properties: items: type: array items: $ref: '#/components/schemas/AddressWatchBlockchainEvent' description: Current page items. nextPageToken: type: string description: >- token to use as `paginationToken` to request the next page. addressWatchId: type: string minLength: 1 maxLength: 64 pattern: ^aw-[a-z0-9]{5}-[a-z0-9]{5}-[a-z0-9]{14,16}$ description: Address watch id. example: aw-0pbh4-7sdh4-2occ0e4r1g7obe8c network: $ref: '#/components/schemas/Network' required: - items - addressWatchId - network security: - authenticationToken: [] components: schemas: AddressWatchBlockchainEvent: type: object properties: id: type: string description: Deterministic event id, safe to deduplicate on. addressWatchId: type: string network: $ref: '#/components/schemas/Network' name: type: string description: Decoded event name. blockNumber: type: number txHash: type: string index: type: string description: Block scoped log index of the event, as a decimal string. timestamp: type: string status: type: string enum: - Included - Confirmed description: >- Webhooks are emitted only once Confirmed; the list can contain Included events on networks with unfinalized indexing. data: type: object additionalProperties: {} description: Decoded event fields, the emitting contract included. required: - id - addressWatchId - network - name - blockNumber - txHash - index - timestamp - status - data example: id: ce-2c5o1-eaqqp-xxxxxxxxxxxxxxxx addressWatchId: aw-1f04s-lqc9q-xxxxxxxxxxxxxxxx network: Ethereum name: OrderSettled blockNumber: 19036906 txHash: '0x8e88793607610a83798eb5ec6dde861f3e459c7e4a22e78b0d2e675b86d0d1e7' index: '134' timestamp: '2026-01-18T23:03:59.000Z' status: Confirmed data: contract: '0x11a4a5aa04d840f0c692ba297dd60c2871ad0b56' orderId: '0x0102030405060708090a0b0c0d0e0f10' amount: '1000' currency: EUR Network: type: string description: Network the address is watched on. title: Network enum: - Algorand - AlgorandTestnet - Aptos - AptosTestnet - ArbitrumOne - ArbitrumSepolia - ArcTestnet - AvalancheC - AvalancheCFuji - BabylonGenesis - BabylonTestnet5 - Base - BaseSepolia - Berachain - BerachainBepolia - Bitcoin - BitcoinSignet - BitcoinTestnet4 - BitcoinCash - Bob - BobSepolia - Bsc - BscTestnet - Canton - CantonTestnet - Cardano - CardanoPreprod - Concordium - ConcordiumTestnet - Celo - CeloAlfajores - Codex - CodexSepolia - CosmosHub4 - CosmosIcsTestnet - Dogecoin - DogecoinTestnet - Ethereum - EthereumClassic - EthereumClassicMordor - EthereumSepolia - EthereumHoodi - FlareC - FlareCCoston2 - FlowEvm - FlowEvmTestnet - Hedera - HederaTestnet - Ink - InkSepolia - InternetComputer - Ion - IonTestnet - Iota - IotaTestnet - Kusama - KusamaAssetHub - Litecoin - LitecoinTestnet - Movement - MovementTestnet - Near - NearTestnet - Optimism - OptimismSepolia - Origyn - Plasma - PlasmaTestnet - Plume - PlumeSepolia - Paseo - PaseoAssetHub - Polkadot - PolkadotAssetHub - Polygon - PolygonAmoy - Polymesh - PolymeshTestnet - Race - RaceSepolia - Rayls - RaylsTestnet - Robinhood - RobinhoodSepolia - SeiAtlantic2 - SeiPacific1 - Solana - SolanaDevnet - Sonic - SonicTestnet - Starknet - StarknetSepolia - Stellar - StellarTestnet - Sui - SuiTestnet - Tezos - TezosGhostnet - TezosShadownet - Tempo - TempoModerato - Tsc - TscTestnet1 - Ton - TonTestnet - Tron - TronNile - Westend - WestendAssetHub - Xdc - XdcApothem - XLayer - XLayerSepolia - XrpLedger - XrpLedgerTestnet securitySchemes: authenticationToken: type: http scheme: bearer bearerFormat: JWT description: >- **Bearer Token:** Used to authenticate API requests. More details how to generate the token: [Authentication flows](https://docs.dfns.co/api-reference/auth/login-flows) ````