Streams API
What is the Streams API?
With Streams API you can listen for real time events on chain, you can listen for when a new event is emitted in your contract or for when a walltet address does an NFT transfer or a transaction. You can also get notifications for native and internal transactions. You will receive webhook requests for those events specific to your stream configuration.
Working With Webhooks
Webhooks allow you to receive real-time notifications for events that are happening in relation to your application. When a supported event occurs, a real-time notification is posted, including a data payload, via HTTP POST method to a custom URL you provide.
Streams API features
- Get blockchain events streamed to your backend directly in real-time
- Listen to wallets or contract events, or both with multiple streams
- Track one address or millions with just one stream, it is up to you
- Fully customize your streams using filters, you want to only want to listen to transactions over 1000 USDT, no problem
- Listen for events from all contract addresses
- Add your custom ABI and choose which events you want to listen too
- and much more...
Popular use cases
- Realtime Wallet notifications (monitor when an address sends, receives, stakes, swaps, or burns assets)
- Monitor assets (get notifications when an asset is being sent, received, staked, swapped, or burned)
- In game specific events, for example when a battle starts in your web3 game
- Token sales (get notifications for when someone participates in your token sale)
- Any other smart contract event fires on-chain based on your filters
Listen to all addresses use cases
- Listen to all NFT contract transfers tutorial
- Listen to all events from new contracts specific to a contract factory tutorial
- Listen to all NFT contracts transfers where sender is a specific address tutorial
- Listen to all ERC20 contract transfers where sender is a specific address and number of coins transferred is over 1000 tutorial
Run Smart Contract Functions
- Run smart contract functions against Events Read more here!
Get Native Balances
- Get Native Balances for addresses! Read more here!
High reliability
- Moralis guarantees 100% delivery of Webhooks
- If your service is down Moralis will retry to send the webhook in intervals
- If your service fails to receive the webhooks you can manually replay
Supported chains
| Chain | Chain Id (HEX) | Internal Transaction Supported | Note | Blocks until confirmed |
|---|---|---|---|---|
| ETH | 0x1 | ✅ YES | 12 | |
| GOERLI | 0x5 | ✅ YES | 12 | |
| SEPOLIA | 0xaa36a7 | ✅ YES | 18 | |
| BNB | 0x38 | ✅ YES | 18 | |
| BNB TEST | 0x61 | ✅ YES | 18 | |
| POLYGON | 0x89 | ✅ YES | 100 | |
| MUMBAI | 0x13881 | ✅ YES | 100 | |
| FANTOM TEST | 0xfa2 | ✅ YES | 100 | |
| FANTOM | 0xfa | ✅ YES | 100 | |
| AVAX | 0xa86a | ✅ YES | 100 | |
| AVAX TEST (deprecated) | 0xa869 | ✅ YES | 100 | |
| CRONOS | 0x19 | ❌ Very soon | Planned support within a couple of days | 100 |
| CRONOS TEST (deprecated) | 0x152 | ❌ NO | 100 | |
| RONIN | 0x7e4 | ✅ YES | 🔥 NEW | 100 |
| ARBITRUM | 0xa4b1 | ✅ YES | 🔥 NEW | 100 |
| ARBITRUM TEST | 0x66eed | ✅ YES | 🔥 NEW | 100 |
| OPTIMISM | 0xa | 🔥 NEW | 100 | |
| PALM | 0x2a15c308d | 🔥 |
Until a block is confirmed, it is possible that a re-organization of the chain may occur, invalidating some information. If a re-organization does occur before a block is confirmed, the information associated with the block is deleted and the updated block is inserted in its place.
To get started, check the following tutorials:
- Your First Stream using NodeJS SDK
- Your First Stream using WebUI
- You can also use the Swagger Interface directly.