Real-time matters on Solana. Wallets, portfolio trackers, SocialFi apps, and onchain agents all need to know and listen to new transactions and react instantly. Zerion API now supports transaction webhooks for Solana, giving you push-style updates without polling. It follows the same schema as for EVM, letting you use the same tool for both Ethereum and Solana ecosystems.
Below you’ll find a production-ready walkthrough: how webhooks work, how to create subscriptions to Solana addresses, and how to manage subscriptions over time.
Create real-time transaction webhooks for Solana wallets via Zerion API. Delivery is push (no polling), using a unified schema across EVM + Solana. Use https://api.zerion.io/v1/tx-subscriptions/ with addresses, callback_url, and chain_ids: ["solana"]. You can start with a dev key and webhook.site.
Why Solana webhooks?
Polling Solana for new activity across many addresses can be wasteful and brittle.
Zerion’s webhook system listens to onchain activity, normalizes it into a merged EVM/Solana schema, and pushes a signed notification to your endpoint as soon as the transaction is seen and classified. That’s the same infrastructure that powers Zerion’s own app notifications. It’s now available for your app via Zerion's Solana API.
How it works
Here's a quick overview of how Zerion's Solana webhooks work.
- Zerion indexers. Observes Solana blocks/transactions, applies spam filtering and normalization to a unified transaction model for Solana and EVM.
- Webhook dispatch. When a subscribed address transacts, Zerion sends a signed POST to your
callback_url. Delivery order is not guaranteed, and after 3 failed attempts, dispatch stops for that event. - Your server. Verifies signature headers, processes the JSON payload, and triggers app logic (notify user, refresh positions, update feed, run an agent, etc.).
- Enrichment. If you need price/value immediately, fetch the transaction by hash with Zerion API’s transactions endpoint.
Create a Solana subscription
You can mirror the example from our earlier guide to Ethereum transaction notifications. Just pass Solana addresses and chain_ids: ["solana"]. Here’s a minimal curl:
curl --request POST \
--url https://api.zerion.io/v1/tx-subscriptions/ \
--header 'accept: application/json' \
--header 'authorization: Basic emtfZGV2X2Q2YmEzYzM3NTNiYjQ2NWM4YjNjZTEzMTU2OTVlYjMwOg==' \
--header 'content-type: application/json' \
--data '
{
"addresses": [
"8BH9pjtgyZDC4iAQH5ZiYDZ1MDWC98xki2V8NzqqKW3K"
],
"callback_url": "https://webhook.site/a1197f43-1522-4689-bbbb-5e7dcc3b346e"
}
'
Use webhook.site for quick testing. Custom callback hosts must be approved. With a dev key, you get 1 subscription, 5 wallets max, 1-week validity. For production, request host whitelisting and long-lived subs—just get your free dev keys first and ask by email.
The same endpoint can be used for watching Solana and EVM addresses. Solana simply uses chain_ids: ["solana"]. But you don’t need to specify it because for a Solana address, you would only get Solana transactions.
Here is an example of a POST response in webhook.site:
{
"data": {
"attributes": {
"address": "8BH9pjtgyZDC4iAQH5ZiYDZ1MDWC98xki2V8NzqqKW3K",
"callback_url": "https://webhook.site/a1197f43-1522-4689-bbbb-5e7dcc3b346e",
"timestamp": "2025-10-16T10:56:50.047643374Z"
},
"id": "bf300927-3f57-4d00-a01a-f7b75bd9b8de",
"relationships": {
"subscription": {
"id": "61f13641-443e-4068-932b-c28edeaefd85",
"type": "tx-subscriptions"
}
},
"type": "callback"
},
"included": [
{
"attributes": {
"acts": [
{
"application_metadata": {
"contract_address": "JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4",
"icon": {
"url": "https://protocol-icons.s3.amazonaws.com/icons/jupiter.jpg"
},
"name": "Jupiter"
},
"id": "0",
"type": "trade"
}
],
"application_metadata": {
"contract_address": "JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4",
"icon": {
"url": "https://protocol-icons.s3.amazonaws.com/icons/jupiter.jpg"
},
"name": "Jupiter"
},
"approvals": [],
"fee": {
"fungible_info": {
"flags": {
"verified": true
},
"icon": {
"url": "https://cdn.zerion.io/11111111111111111111111111111111.png"
},
"implementations": [
{
"address": "11111111111111111111111111111111",
"chain_id": "solana",
"decimals": 9
}
],
"name": "Solana",
"symbol": "SOL"
},
"price": 196.45239612519998,
"quantity": {
"decimals": 9,
"float": 0.000005,
"int": "5000",
"numeric": "0.000005000"
},
"value": 0.000982261980626
},
"flags": {
"is_trash": false
},
"hash": "i5hptq3Dx8mbuAY5SuF5mUz7mTrAQYmwrJSrdUC4L1MJEkxsXDgSVt9to6HU8EcNygoLnhD7ut11r3mAQafP6Gx",
"mined_at": "2025-10-16T10:56:48Z",
"mined_at_block": 0,
"nonce": 0,
"operation_type": "trade",
"sent_from": "8BH9pjtgyZDC4iAQH5ZiYDZ1MDWC98xki2V8NzqqKW3K",
"sent_to": "",
"status": "confirmed",
"transfers": [
{
"act_id": "0",
"direction": "in",
"fungible_info": {
"flags": {
"verified": true
},
"icon": {
"url": "https://cdn.zerion.io/0xdac17f958d2ee523a2206206994597c13d831ec7.png"
},
"implementations": [
{
"address": "0xbb06dca3ae6887fabf931640f67cab3e3a16f4dc",
"chain_id": "metis-andromeda",
"decimals": 6
},
{
"address": "0xf55bec9cafdbe8730f096aa55dad6d22d44099df",
"chain_id": "scroll",
"decimals": 6
},
{
"address": "0x6386da73545ae4e2b2e0393688fa8b65bb9a7169",
"chain_id": "zero",
"decimals": 6
},
{
"address": "0x55d398326f99059ff775485246999027b3197955",
"chain_id": "binance-smart-chain",
"decimals": 18
},
{
"address": "0x816e810f9f787d669fb71932deabf6c83781cd48",
"chain_id": "gravity-alpha",
"decimals": 6
},
{
"address": "0xfde4c96c8593536e31f229ea8f37b2ada2699bb2",
"chain_id": "base",
"decimals": 6
},
{
"address": "0x588ce4f028d8e7b53b687865d6a67b3a54c75518",
"chain_id": "unichain",
"decimals": 6
},
{
"address": "0x1e4a5963abfd975d8c9021ce480b42188849d41d",
"chain_id": "polygon-zkevm",
"decimals": 6
},
{
"address": "0xf0f161fda2712db8b566946122a5af183995e2ed",
"chain_id": "mode",
"decimals": 6
},
{
"address": "0x6047828dc181963ba44974801ff68e538da5eaf9",
"chain_id": "sonic",
"decimals": 6
},
{
"address": "0x1e4a5963abfd975d8c9021ce480b42188849d41d",
"chain_id": "okbchain",
"decimals": 6
},
{
"address": "0x48065fbbe25f71c9282ddf5e1cd6d6a887483d5e",
"chain_id": "celo",
"decimals": 6
},
{
"address": "0x94b008aa00579c1307b0ef2c499ad98a8ce58e58",
"chain_id": "optimism",
"decimals": 6
},
{
"address": "0x493257fd37edb34451f62edf8d2a0c418852ba4c",
"chain_id": "zksync-era",
"decimals": 6
},
{
"address": "0x4ecaba5870353805a9f068101a40e0f32ed605c6",
"chain_id": "xdai",
"decimals": 6
},
{
"address": "0x4988a896b1227218e4a686fde5eabdcabd91571f",
"chain_id": "aurora",
"decimals": 6
},
{
"address": "0x0709f39376deee2a2dfc94a58edeb2eb9df012bd",
"chain_id": "abstract",
"decimals": 6
},
{
"address": "Es9vMFrzaCERmJfrF4H2FYD4KCoNkY11McCe8BenwNYB",
"chain_id": "solana",
"decimals": 6
},
{
"address": "0x9702230a8ea53601f5cd2dc00fdbc13d4df4a8c7",
"chain_id": "avalanche",
"decimals": 6
},
{
"address": "0xdac17f958d2ee523a2206206994597c13d831ec7",
"chain_id": "ethereum",
"decimals": 6
},
{
"address": "0xf417f5a458ec102b90352f697d6e2ac3a3d2851f",
"chain_id": "manta-pacific",
"decimals": 6
}
],
"name": "Tether USD",
"symbol": "USDT"
},
"price": 1.0005395552,
"quantity": {
"decimals": 6,
"float": 0.980106,
"int": "980106",
"numeric": "0.980106"
},
"recipient": "8BH9pjtgyZDC4iAQH5ZiYDZ1MDWC98xki2V8NzqqKW3K",
"sender": "JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4",
"value": 0.9806348212888513
},
{
"act_id": "0",
"direction": "out",
"fungible_info": {
"flags": {
"verified": true
},
"icon": {
"url": "https://cdn.zerion.io/11111111111111111111111111111111.png"
},
"implementations": [
{
"address": "11111111111111111111111111111111",
"chain_id": "solana",
"decimals": 9
}
],
"name": "Solana",
"symbol": "SOL"
},
"price": 196.45239612519998,
"quantity": {
"decimals": 9,
"float": 0.005,
"int": "5000000",
"numeric": "0.005000000"
},
"recipient": "JUP6LkbZbjS1jKKwapdHNy74zcZ3tLUZoi5QNyVTaV4",
"sender": "8BH9pjtgyZDC4iAQH5ZiYDZ1MDWC98xki2V8NzqqKW3K",
"value": 0.9822619806259999
}
]
},
"id": "13de850a-bfa4-54c7-a7bb-fd6371d98894",
"relationships": {
"chain": {
"id": "solana",
"type": "chains"
},
"dapp": {
"id": "jupiter",
"type": "dapps"
}
},
"type": "transactions"
}
]
}
Manage subscriptions over time
As your product evolves, you can modify subscriptions without recreating them:
- List all subscriptions or fetch by ID to introspect settings,
- Enable or disable a subscription (pause without deleting),
- Update the callback URL safely,
- Replace or patch wallets within a subscription to track new addresses (e.g., users who opt into notifications),
- Change chains via
chain_ids—you can expand to specific chains in addition to Solana. Zerion API covers mainnet Ethereum, Base, BSC, and all the main EVM chains.
Production notes and best practices
Here are a few things to keep in mind for your implementation of Solana webhooks:
- Ordering: Don’t assume webhook order equals onchain order.
- Retries: Zerion retries up to 3 times per event; after that, it stops. Monitor logs and build a reconciliation job that backfills missed events by time window if needed.
- Spam & UX: Use webhook events to instantly refresh balances/positions in your UI and surface only meaningful transfers (the unified schema + Zerion’s spam filtering helps).
- Scope: Keep
chain_idsto["solana"]for fastest Solana-first launches. Extend to EVM later with the same payload model.
Common Solana use cases
Solana webhooks are useful in many cases.
- Wallet & super-app notifications: Create pushes for confirmed and failed transactions, fees, or DEX trades.
- Social/copy trading feeds: Follow specific wallets and publish activity streams in near-real time.
- Agentic workflows: Trigger actions when your agent’s Solana address receives funds or completes an instruction.
- Compliance/monitoring: Pipe transactions into your alerting stack instantly.
Get started
You’ve now learned how Solana webhooks work in Zerion API. It’s time to put into action.
Request your free dev keys—and get $2,500 in free credits while Zerion’s Solana API is in early access.
If you need help or want us to review your setup, reply in the #devs-lounge on Discord or ping the API team via the docs.