Webhooks

Knot integrates with Helius to receive enhanced transaction notifications for your agent’s wallet. Webhooks let you react to incoming transfers, trade confirmations, and other on-chain events in real time.

Helius integration

Knot uses Helius to process and enrich transaction data before delivering webhook events. The webhook endpoint receives parsed, human-readable transaction data rather than raw Solana transaction bytes.

Webhook configuration is managed server-side. Contact support to enable webhooks for your agent.

Webhook endpoint

Knot exposes an endpoint that Helius posts events to:

POST /webhooks/helius

This endpoint is called by Helius, not by your application. You do not call this endpoint directly.

Payload format

Helius delivers enhanced transaction data in its standard webhook format:

{
  "type": "TRANSFER",
  "source": "HELIUS",
  "signature": "5UfgJ3vN...",
  "timestamp": 1679012345,
  "nativeTransfers": [
    {
      "fromUserAccount": "SourceAddress...",
      "toUserAccount": "DestAddress...",
      "amount": 1000000000
    }
  ],
  "tokenTransfers": [
    {
      "fromUserAccount": "SourceAddress...",
      "toUserAccount": "DestAddress...",
      "mint": "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
      "tokenAmount": 100.0
    }
  ]
}

Payload fields

string

The event type. See event types below.

string

Always "HELIUS" for Helius-delivered webhooks.

string

The Solana transaction signature. Use this to look up the transaction on-chain.

number

Unix timestamp of when the transaction was confirmed.

array

List of native SOL transfers in this transaction, with sender, recipient, and lamport amount.

array

List of SPL token transfers in this transaction, with sender, recipient, token mint address, and amount.

Event types

Type	Description
`TRANSFER`	Native SOL or SPL token transfer
`SWAP`	Token swap via a DEX
`NFT_SALE`	NFT purchase or sale
`NFT_MINT`	NFT minting event

Use cases

Balance updates

Refresh your internal balance cache when transactions are confirmed on-chain.

Notifications

Trigger alerts or agent actions when the wallet receives incoming funds.

Incoming transfers

Track deposits and incoming payments from external sources.

Transaction confirmations

Confirm that outgoing transactions have settled and been finalized.

Setup overview

Contact support

Reach out to the Knot team to enable Helius webhooks for your agent.

Provide your wallet address

Supply your agent’s wallet address so Knot can configure the Helius subscription for your account.

Receive events

Knot begins receiving Helius events for your wallet. Balance state and audit logs are updated in real time.

React to events

Poll for updated balances or use audit logs to detect incoming transfers and take action.

Native SOL amounts in webhook payloads are denominated in lamports. Divide by 1,000,000,000 to convert to SOL.

Getting Started

Core Features

Security & Policies

Advanced

Helius integration

Webhook endpoint

Payload format

Payload fields

Event types

Use cases

Balance updates

Notifications

Incoming transfers

Transaction confirmations

Setup overview

​Helius integration

​Webhook endpoint

​Payload format

​Payload fields

​Event types

​Use cases

Balance updates

Notifications

Incoming transfers

Transaction confirmations

​Setup overview

Helius integration

Webhook endpoint

Payload format

Payload fields

Event types

Use cases

Setup overview