Skip to main content

​
Overview

Webacy Webhooks provide a push-model delivery of risk analysis data. Instead of polling our API, receive real-time notifications when events occur.
Webhooks are currently in beta with limited access. Contact us at [email protected] to request early access.

​
Why Use Webhooks?

Pull Model (API)Push Model (Webhooks)
You poll for updatesWe notify you instantly
Higher latencySub-second delivery
More API callsEfficient, event-driven
Good for on-demand queriesIdeal for monitoring & alerts

​
Event Types

​
TOKEN_LAUNCH_ANALYSIS

Triggered immediately when a new token is created. Receive risk analysis within milliseconds of minting. Use Cases:
  • Early token screening for trading bots
  • New token alerts for monitoring dashboards
  • Automated listing decisions for DEX aggregators
{
  "event": "TOKEN_LAUNCH_ANALYSIS",
  "timestamp": "2024-01-15T10:30:00.000Z",
  "data": {
    "tokenAddress": "So11111111111111111111111111111111111111112",
    "chain": "sol",
    "launchTimestamp": "2024-01-15T10:29:58.000Z",
    "riskScore": 45.5,
    "issues": [
      {
        "tag": "mintable",
        "severity": "medium",
        "description": "Token supply can still be increased"
      },
      {
        "tag": "minted-less-than-10-minutes",
        "severity": "low",
        "description": "Token was minted within the last 10 minutes"
      }
    ],
    "metadata": {
      "name": "Example Token",
      "symbol": "EXT",
      "decimals": 9,
      "totalSupply": "1000000000000000"
    }
  }
}

​
TOKEN_TRANSACTION

Fires instantly for each buy/sell transaction on monitored tokens. Use Cases:
  • Real-time trading alerts
  • Instant bundler/sniper activity detection
  • Live portfolio tracking
  • Automated trading signals
{
  "event": "TOKEN_TRANSACTION",
  "timestamp": "2024-01-15T10:35:22.000Z",
  "data": {
    "tokenAddress": "So11111111111111111111111111111111111111112",
    "chain": "sol",
    "transactionSignature": "5K8vJkLm9nPqRsTuVwXyZ123AbCdEfGhIjKlMnOpQr",
    "type": "BUY",
    "trader": "Abc123DefGhi456JklMno789PqrStu012VwxYz345",
    "amount": "1500000000",
    "priceUsd": "0.00125",
    "totalValueUsd": "1875.00",
    "traderAnalysis": {
      "isSniper": true,
      "isBundler": false,
      "sniperConfidence": 85,
      "previousRugpulls": 0
    },
    "poolAddress": "PoolABC123DefGhi456JklMno789PqrStu012Vwx"
  }
}

​
HOLDER_ANALYSIS_UPDATE

Delivers updates at 15 scheduled checkpoints after token launch, tracking how the holder distribution evolves. Checkpoints: Analysis is delivered at key intervals post-launch to track:
  • How bundler/sniper activity evolves
  • Holder concentration changes
  • Whale accumulation patterns
  • Distribution normalization
Use Cases:
  • Track manipulation patterns over time
  • Monitor holder distribution health
  • Identify late-stage accumulation
  • Research token lifecycle patterns
{
  "event": "HOLDER_ANALYSIS_UPDATE",
  "timestamp": "2024-01-15T11:00:00.000Z",
  "data": {
    "tokenAddress": "So11111111111111111111111111111111111111112",
    "chain": "sol",
    "checkpoint": 3,
    "checkpointLabel": "30_minutes",
    "timeSinceLaunch": 1800,
    "analysis": {
      "totalHolders": 156,
      "top10HoldersPercentage": 68.5,
      "sniperPercentageHolding": 42.3,
      "bundlerPercentageHolding": 15.8,
      "devHoldingPercentage": 5.2,
      "uniqueWallets": 142
    },
    "changes": {
      "holdersDelta": 48,
      "top10Delta": -12.5,
      "sniperDelta": -8.2
    },
    "previousCheckpoint": {
      "checkpoint": 2,
      "checkpointLabel": "15_minutes"
    }
  }
}

​
Current Limitations

As a beta feature, webhooks have the following limitations:
LimitationDetails
AccessLimited beta access - requires approval
ChainsSolana only (additional chains coming soon)
Rate LimitsCustom limits based on your plan

​
Getting Early Access

To request webhook access:
  1. Email us at [email protected]
  2. Include your use case and expected volume
  3. Our team will reach out to discuss setup
We’ll provide:
  • Webhook endpoint configuration
  • Authentication details
  • Detailed payload documentation
  • Integration support

​
Coming Soon

  • Support for additional blockchains (EVM chains, TON, etc.)
  • Custom event filtering
  • Webhook management dashboard
  • Retry and delivery guarantees
Interested in helping shape the webhooks feature? We welcome feedback from beta users. Contact us to share your requirements.