Trigger Onchain

Triggers when a Solana transaction matching your criteria is detected. Powered by Helius webhooks. Monitors wallet addresses for swaps, token transfers, token launches, liquidity pool creation, NFT activity, SOL staking, program events, account balance changes, and protocol activity.

At a Glance

FieldValue
Trigger IDsolana-transaction
CategoryOnchain
Tagsblockchain, solana, trigger, helius, swap, transfer, defi

Trigger Configuration

FieldTypeRequiredDescription
chainIdintegerYesSolana network to monitor
watchAddressstringYesSolana address to monitor for transactions
eventCategorystringYesType of Solana activity to watch for
directionstringNoTransfer direction filter (token-transfer only)
balanceDirectionstringNoNet balance delta direction to filter on (account-change only): increase fires when the watched balance goes up, decrease when it goes down, any matches either.
tokenMintstringNoToken mint address to filter by (optional)
minAmountstringNoMinimum amount to trigger (optional)
dexstringNoDEX filter (swap and pool-created only)
platformstringNoPlatform filter (token-mint only)
programIdstringNoProgram address to monitor (program-event only)
balanceTypestringNoType of balance to monitor (account-change only)
programstringNoProtocol to monitor (program-activity only). These are Helius Source names, not raw program addresses.
descriptionPatternstringNoOptional text to match in the transaction description (program-activity only)

Trigger Result

FieldTypeRequiredDescription
triggeredAtstringYesUTC timestamp when the event was detected
eventTypestringYesHelius transaction type (SWAP, TRANSFER, TOKEN_MINT, etc.)
signaturestringYesSolana transaction signature
fromstringNoSender address
tostringNoReceiver address
amountstringNoTransaction amount
tokenstringNoToken mint address
dexstringNoDEX name (for swaps)
rawobjectNoFull Helius enhanced transaction payload
nativeBalanceChangeintegerNoSOL balance change in lamports (signed, for account-change)
tokenBalanceChangesarrayNoToken balance changes for the watched address (for account-change)
descriptionstringNoHelius human-readable transaction description

Workflow Root Example

json
{ "nodes": { "root": { "type": "solana-transaction", "payload": { "chainId": 7565164, "watchAddress": "0x0000000000000000000000000000000000000000", "eventCategory": "token-transfer" }, "children": [ "log_event" ] }, "log_event": { "type": "log", "payload": { "message": "Triggered at {{$trigger.triggeredAt}}" }, "children": [] } }}

Downstream nodes can use {{$trigger.triggeredAt}} and any result fields listed above. Event triggers usually expose the raw source payload under a field such as event, body, trade, or raw.