Solana Webhooks: 실시간 블록체인 이벤트 알림

Solana 웹훅이란?

Solana 웹훅은 온체인 이벤트가 발생할 때 애플리케이션에 실시간으로 전송되는 HTTP 알림입니다. 지속적으로 블록체인을 폴링하는 대신, Helius는 지갑이 자금을 이체하거나 NFT가 판매되거나 감시 중인 거래 유형이 발생할 때마다 구문 분석된 거래 데이터를 직접 엔드포인트로 푸시합니다. 웹훅을 사용하여 트레이딩 봇, 분석 대시보드, 컴플라이언스 파이프라인 및 이벤트 기반 자동화를 구현하세요. 사용자 친화적인 인터페이스, 프로그래매틱 API 및 SDK 액세스를 제공하여 웹훅을 쉽게 생성하고 관리할 수 있습니다. 자주 묻는 질문은 웹훅 FAQ를 참조하세요. 실시간 파싱 트랜잭션이 필요한 새 빌드에는 Parsed Streams를 고려하세요. 이는 Enhanced Transaction Webhooks의 후속 기능으로, IDL 카탈로그를 통해 모든 명령어를 디코딩하고 프로그램, 계정, 명령어 이름을 기준으로 서버 측에서 필터링합니다. 모든 요금제에서 이벤트당 동일하게 1크레딧이 청구됩니다.

서버가 성공 응답을 반환하지 않으면 Helius가 웹훅 전송을 재시도할 수 있으며, 중복 이벤트가 수신될 수 있습니다. 재시도 및 중복 처리에 대한 자세한 내용은 Webhooks FAQ를 참조하세요.

요금

Helius가 이벤트를 처리하여 엔드포인트로 전송할 때 웹훅 이벤트당 1크레딧이 청구됩니다. 엔드포인트가 웹훅을 성공적으로 처리하는지와 관계없이 요금이 청구됩니다. API를 통해 웹훅을 수정, 추가 또는 삭제하면 요청당 100크레딧이 부과됩니다.

웹훅 유형

현재 다양한 요구 사항에 맞춘 여러 유형의 웹훅을 제공합니다.

Enhanced Transaction Webhooks

모니터링하는 주소와 관련된 특정 트랜잭션 유형(예: NFT 판매)에 대해 사람이 읽을 수 있는 파싱된 데이터를 제공합니다. 필터링된 실행 가능한 인사이트가 필요한 경우에 적합합니다.

Raw Transaction Webhooks

이 옵션은 모니터링하는 주소가 관련된 모든 트랜잭션의 원시 트랜잭션 데이터를 전송합니다. 트랜잭션 유형별 필터링은 지원하지 않습니다.

Raw Transaction Webhooks는 이벤트 유형을 파싱하지 않으므로 지연 시간이 더 짧습니다.

Discord Webhooks

특정 트랜잭션 유형의 업데이트를 서식이 지정된 메시지로 지정된 Discord 채널에 직접 스트리밍합니다. 이 옵션을 사용하려면 Discord Webhook URL을 제출해야 합니다.

이벤트 페이로드 예시

Enhanced

[
  {
    "accountData": [
      {
        "account": "CKs1E69a2e9TmH4mKKLrXFF8kD3ZnwKjoEuXa6sz9WqX",
        "nativeBalanceChange": -72938049280,
        "tokenBalanceChanges": []
      },
      {
        "account": "NTYeYJ1wr4bpM5xo6zx5En44SvJFAd35zTxxNoERYqd",
        "nativeBalanceChange": 0,
        "tokenBalanceChanges": []
      },
      {
        "account": "AAaTGaA3uVqikfVEwoSG7EwkCb4bBDsMEyueiVUS5CaU",
        "nativeBalanceChange": 0,
        "tokenBalanceChanges": []
      },
      {
        "account": "autMW8SgBkVYeBgqYiTuJZnkvDZMVU2MHJh9Jh7CSQ2",
        "nativeBalanceChange": 0,
        "tokenBalanceChanges": []
      },
      {
        "account": "D8TxfGwdu9MiNMoJmUoC9wQfNfNT7Lnm6DzifQHRTy6B",
        "nativeBalanceChange": 0,
        "tokenBalanceChanges": []
      },
      {
        "account": "5DxD5ViWjvRZEkxQEaJHZw2sBsso6xoXx3wGFNKgXUzE",
        "nativeBalanceChange": 71860273440,
        "tokenBalanceChanges": []
      },
      {
        "account": "25DTUAd1roBFoUQaxJQByL6Qy2cKQCBp4bK9sgfy9UiM",
        "nativeBalanceChange": -2039280,
        "tokenBalanceChanges": [
          {
            "mint": "FdsNQE5EeCe57tbEYCRV1JwW5dzNCof7MUTaGWhmzYqu",
            "rawTokenAmount": {
              "decimals": 0,
              "tokenAmount": "-1"
            },
            "tokenAccount": "25DTUAd1roBFoUQaxJQByL6Qy2cKQCBp4bK9sgfy9UiM",
            "userAccount": "1BWutmTvYPwDtmw9abTkS4Ssr8no61spGAvW1X6NDix"
          }
        ]
      },
      {
        "account": "DTYuh7gAGGZg2okM7hdFfU1yMY9LUemCiPyD5Z5GCs6Z",
        "nativeBalanceChange": 2039280,
        "tokenBalanceChanges": [
          {
            "mint": "FdsNQE5EeCe57tbEYCRV1JwW5dzNCof7MUTaGWhmzYqu",
            "rawTokenAmount": {
              "decimals": 0,
              "tokenAmount": "1"
            },
            "tokenAccount": "DTYuh7gAGGZg2okM7hdFfU1yMY9LUemCiPyD5Z5GCs6Z",
            "userAccount": "CKs1E69a2e9TmH4mKKLrXFF8kD3ZnwKjoEuXa6sz9WqX"
          }
        ]
      },
      {
        "account": "rFqFJ9g7TGBD8Ed7TPDnvGKZ5pWLPDyxLcvcH2eRCtt",
        "nativeBalanceChange": 1080000000,
        "tokenBalanceChanges": []
      },
      {
        "account": "CgXS5xC3qAGSg9txD9bS7BUgugZwshivGXpCJcGmdwrd",
        "nativeBalanceChange": -2234160,
        "tokenBalanceChanges": []
      },
      {
        "account": "M2mx93ekt1fmXSVkTrUL9xVFHkmME8HTUi5Cyc5aF7K",
        "nativeBalanceChange": 0,
        "tokenBalanceChanges": []
      },
      {
        "account": "E8cU1WiRWjanGxmn96ewBgk9vPTcL6AEZ1t6F6fkgUWe",
        "nativeBalanceChange": 0,
        "tokenBalanceChanges": []
      },
      {
        "account": "11111111111111111111111111111111",
        "nativeBalanceChange": 0,
        "tokenBalanceChanges": []
      },
      {
        "account": "FdsNQE5EeCe57tbEYCRV1JwW5dzNCof7MUTaGWhmzYqu",
        "nativeBalanceChange": 0,
        "tokenBalanceChanges": []
      },
      {
        "account": "AYZsWahcrSnkwqbA1ji7wEzgAnGjLNJhVUMDPfACECZf",
        "nativeBalanceChange": 0,
        "tokenBalanceChanges": []
      },
      {
        "account": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
        "nativeBalanceChange": 0,
        "tokenBalanceChanges": []
      },
      {
        "account": "SysvarRent111111111111111111111111111111111",
        "nativeBalanceChange": 0,
        "tokenBalanceChanges": []
      },
      {
        "account": "ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL",
        "nativeBalanceChange": 0,
        "tokenBalanceChanges": []
      },
      {
        "account": "1BWutmTvYPwDtmw9abTkS4Ssr8no61spGAvW1X6NDix",
        "nativeBalanceChange": 0,
        "tokenBalanceChanges": []
      }
    ],
    "description": "5DxD5ViWjvRZEkxQEaJHZw2sBsso6xoXx3wGFNKgXUzE sold Fox #7637 to CKs1E69a2e9TmH4mKKLrXFF8kD3ZnwKjoEuXa6sz9WqX for 72 SOL on MAGIC_EDEN.",
    "events": {
      "nft": {
        "amount": 72000000000,
        "buyer": "CKs1E69a2e9TmH4mKKLrXFF8kD3ZnwKjoEuXa6sz9WqX",
        "description": "5DxD5ViWjvRZEkxQEaJHZw2sBsso6xoXx3wGFNKgXUzE sold Fox #7637 to CKs1E69a2e9TmH4mKKLrXFF8kD3ZnwKjoEuXa6sz9WqX for 72 SOL on MAGIC_EDEN.",
        "fee": 10000,
        "feePayer": "CKs1E69a2e9TmH4mKKLrXFF8kD3ZnwKjoEuXa6sz9WqX",
        "nfts": [
          {
            "mint": "FdsNQE5EeCe57tbEYCRV1JwW5dzNCof7MUTaGWhmzYqu",
            "tokenStandard": "NonFungible"
          }
        ],
        "saleType": "INSTANT_SALE",
        "seller": "5DxD5ViWjvRZEkxQEaJHZw2sBsso6xoXx3wGFNKgXUzE",
        "signature": "5nNtjezQMYBHvgSQmoRmJPiXGsPAWmJPoGSa64xanqrauogiVzFyGQhKeFataHGXq51jR2hjbzNTkPUpP787HAmL",
        "slot": 171942732,
        "source": "MAGIC_EDEN",
        "staker": "",
        "timestamp": 1673445241,
        "type": "NFT_SALE"
      }
    },
    "fee": 10000,
    "feePayer": "CKs1E69a2e9TmH4mKKLrXFF8kD3ZnwKjoEuXa6sz9WqX",
    "nativeTransfers": [
      {
        "amount": 72936000000,
        "fromUserAccount": "CKs1E69a2e9TmH4mKKLrXFF8kD3ZnwKjoEuXa6sz9WqX",
        "toUserAccount": "AAaTGaA3uVqikfVEwoSG7EwkCb4bBDsMEyueiVUS5CaU"
      },
      {
        "amount": 2011440,
        "fromUserAccount": "CKs1E69a2e9TmH4mKKLrXFF8kD3ZnwKjoEuXa6sz9WqX",
        "toUserAccount": "D8TxfGwdu9MiNMoJmUoC9wQfNfNT7Lnm6DzifQHRTy6B"
      },
      {
        "amount": 71856000000,
        "fromUserAccount": "AAaTGaA3uVqikfVEwoSG7EwkCb4bBDsMEyueiVUS5CaU",
        "toUserAccount": "5DxD5ViWjvRZEkxQEaJHZw2sBsso6xoXx3wGFNKgXUzE"
      },
      {
        "amount": 1080000000,
        "fromUserAccount": "AAaTGaA3uVqikfVEwoSG7EwkCb4bBDsMEyueiVUS5CaU",
        "toUserAccount": "rFqFJ9g7TGBD8Ed7TPDnvGKZ5pWLPDyxLcvcH2eRCtt"
      },
      {
        "amount": 2039280,
        "fromUserAccount": "CKs1E69a2e9TmH4mKKLrXFF8kD3ZnwKjoEuXa6sz9WqX",
        "toUserAccount": "DTYuh7gAGGZg2okM7hdFfU1yMY9LUemCiPyD5Z5GCs6Z"
      }
    ],
    "signature": "5nNtjezQMYBHvgSQmoRmJPiXGsPAWmJPoGSa64xanqrauogiVzFyGQhKeFataHGXq51jR2hjbzNTkPUpP787HAmL",
    "slot": 171942732,
    "source": "MAGIC_EDEN",
    "timestamp": 1673445241,
    "tokenTransfers": [
      {
        "fromTokenAccount": "25DTUAd1roBFoUQaxJQByL6Qy2cKQCBp4bK9sgfy9UiM",
        "fromUserAccount": "1BWutmTvYPwDtmw9abTkS4Ssr8no61spGAvW1X6NDix",
        "mint": "FdsNQE5EeCe57tbEYCRV1JwW5dzNCof7MUTaGWhmzYqu",
        "toTokenAccount": "DTYuh7gAGGZg2okM7hdFfU1yMY9LUemCiPyD5Z5GCs6Z",
        "toUserAccount": "CKs1E69a2e9TmH4mKKLrXFF8kD3ZnwKjoEuXa6sz9WqX",
        "tokenAmount": 1,
        "tokenStandard": "NonFungible"
      }
    ],
    "type": "NFT_SALE"
  }
]

Raw

[
  {
    "blockTime": 1673445241,
    "indexWithinBlock": 2557,
    "meta": {
      "err": null,
      "fee": 10000,
      "innerInstructions": [
        {
          "index": 0,
          "instructions": [
            {
              "accounts": [
                0,
                2
              ],
              "data": "3Bxs3zs3x6pg4XWo",
              "programIdIndex": 12
            }
          ]
        },
        {
          "index": 1,
          "instructions": [
            {
              "accounts": [
                0,
                4
              ],
              "data": "11112nba6qLH4BKL4MW8GP9ayKApZeYn3LQKJdPdeSXbRW1n6UPeJ8y77ps6sAVwAjdxzh",
              "programIdIndex": 12
            }
          ]
        },
        {
          "index": 2,
          "instructions": [
            {
              "accounts": [
                2,
                5
              ],
              "data": "3Bxs3zx147oWJQej",
              "programIdIndex": 12
            },
            {
              "accounts": [
                2,
                8
              ],
              "data": "3Bxs3zwT1TGLhiT9",
              "programIdIndex": 12
            },
            {
              "accounts": [
                0,
                7,
                0,
                13,
                12,
                15
              ],
              "data": "1",
              "programIdIndex": 17
            },
            {
              "accounts": [
                13
              ],
              "data": "84eT",
              "programIdIndex": 15
            },
            {
              "accounts": [
                0,
                7
              ],
              "data": "11119os1e9qSs2u7TsThXqkBSRVFxhmYaFKFZ1waB2X7armDmvK3p5GmLdUxYdg3h7QSrL",
              "programIdIndex": 12
            },
            {
              "accounts": [
                7
              ],
              "data": "P",
              "programIdIndex": 15
            },
            {
              "accounts": [
                7,
                13
              ],
              "data": "6YTZgAHgNKVRJ2mAHQUYC1DgXF6dPCgbSWA5P4gZoSfGV",
              "programIdIndex": 15
            },
            {
              "accounts": [
                6,
                7,
                18
              ],
              "data": "3DdGGhkhJbjm",
              "programIdIndex": 15
            },
            {
              "accounts": [
                6,
                5,
                18
              ],
              "data": "A",
              "programIdIndex": 15
            }
          ]
        }
      ],
      "loadedAddresses": {
        "readonly": [],
        "writable": []
      },
      "logMessages": [
        "Program M2mx93ekt1fmXSVkTrUL9xVFHkmME8HTUi5Cyc5aF7K invoke [1]",
        "Program log: Instruction: Deposit",
        "Program 11111111111111111111111111111111 invoke [2]",
        "Program 11111111111111111111111111111111 success",
        "Program M2mx93ekt1fmXSVkTrUL9xVFHkmME8HTUi5Cyc5aF7K consumed 10148 of 600000 compute units",
        "Program M2mx93ekt1fmXSVkTrUL9xVFHkmME8HTUi5Cyc5aF7K success",
        "Program M2mx93ekt1fmXSVkTrUL9xVFHkmME8HTUi5Cyc5aF7K invoke [1]",
        "Program log: Instruction: Buy",
        "Program 11111111111111111111111111111111 invoke [2]",
        "Program 11111111111111111111111111111111 success",
        "Program log: {\"price\":72000000000,\"buyer_expiry\":0}",
        "Program M2mx93ekt1fmXSVkTrUL9xVFHkmME8HTUi5Cyc5aF7K consumed 30501 of 589852 compute units",
        "Program M2mx93ekt1fmXSVkTrUL9xVFHkmME8HTUi5Cyc5aF7K success",
        "Program M2mx93ekt1fmXSVkTrUL9xVFHkmME8HTUi5Cyc5aF7K invoke [1]",
        "Program log: Instruction: ExecuteSaleV2",
        "Program 11111111111111111111111111111111 invoke [2]",
        "Program 11111111111111111111111111111111 success",
        "Program 11111111111111111111111111111111 invoke [2]",
        "Program 11111111111111111111111111111111 success",
        "Program ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL invoke [2]",
        "Program log: Create",
        "Program TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA invoke [3]",
        "Program log: Instruction: GetAccountDataSize",
        "Program TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA consumed 1622 of 497733 compute units",
        "Program return: TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA pQAAAAAAAAA=",
        "Program TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA success",
        "Program 11111111111111111111111111111111 invoke [3]",
        "Program 11111111111111111111111111111111 success",
        "Program log: Initialize the associated token account",
        "Program TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA invoke [3]",
        "Program log: Instruction: InitializeImmutableOwner",
        "Program log: Please upgrade to SPL Token 2022 for immutable owner support",
        "Program TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA consumed 1405 of 491243 compute units",
        "Program TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA success",
        "Program TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA invoke [3]",
        "Program log: Instruction: InitializeAccount3",
        "Program TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA consumed 4241 of 487361 compute units",
        "Program TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA success",
        "Program ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL consumed 21793 of 504630 compute units",
        "Program ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL success",
        "Program TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA invoke [2]",
        "Program log: Instruction: Transfer",
        "Program TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA consumed 4645 of 475696 compute units",
        "Program TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA success",
        "Program TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA invoke [2]",
        "Program log: Instruction: CloseAccount",
        "Program TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA consumed 3033 of 456654 compute units",
        "Program TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA success",
        "Program log: {\"price\":72000000000,\"seller_expiry\":-1,\"buyer_expiry\":0}",
        "Program M2mx93ekt1fmXSVkTrUL9xVFHkmME8HTUi5Cyc5aF7K consumed 109266 of 559351 compute units",
        "Program M2mx93ekt1fmXSVkTrUL9xVFHkmME8HTUi5Cyc5aF7K success"
      ],
      "postBalances": [
        371980779080,
        0,
        0,
        100129388687,
        0,
        81872924494,
        0,
        2039280,
        993583055919,
        0,
        1141440,
        3654000,
        1,
        1461600,
        5616720,
        934087680,
        1009200,
        731913600,
        457953014766
      ],
      "postTokenBalances": [
        {
          "accountIndex": 7,
          "mint": "FdsNQE5EeCe57tbEYCRV1JwW5dzNCof7MUTaGWhmzYqu",
          "owner": "CKs1E69a2e9TmH4mKKLrXFF8kD3ZnwKjoEuXa6sz9WqX",
          "programId": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
          "uiTokenAmount": {
            "amount": "1",
            "decimals": 0,
            "uiAmount": 1,
            "uiAmountString": "1"
          }
        }
      ],
      "preBalances": [
        444918828360,
        0,
        0,
        100129388687,
        0,
        10012651054,
        2039280,
        0,
        992503055919,
        2234160,
        1141440,
        3654000,
        1,
        1461600,
        5616720,
        934087680,
        1009200,
        731913600,
        457953014766
      ],
      "preTokenBalances": [
        {
          "accountIndex": 6,
          "mint": "FdsNQE5EeCe57tbEYCRV1JwW5dzNCof7MUTaGWhmzYqu",
          "owner": "1BWutmTvYPwDtmw9abTkS4Ssr8no61spGAvW1X6NDix",
          "programId": "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
          "uiTokenAmount": {
            "amount": "1",
            "decimals": 0,
            "uiAmount": 1,
            "uiAmountString": "1"
          }
        }
      ],
      "rewards": []
    },
    "slot": 171942732,
    "transaction": {
      "message": {
        "accountKeys": [
          "CKs1E69a2e9TmH4mKKLrXFF8kD3ZnwKjoEuXa6sz9WqX",
          "NTYeYJ1wr4bpM5xo6zx5En44SvJFAd35zTxxNoERYqd",
          "AAaTGaA3uVqikfVEwoSG7EwkCb4bBDsMEyueiVUS5CaU",
          "autMW8SgBkVYeBgqYiTuJZnkvDZMVU2MHJh9Jh7CSQ2",
          "D8TxfGwdu9MiNMoJmUoC9wQfNfNT7Lnm6DzifQHRTy6B",
          "5DxD5ViWjvRZEkxQEaJHZw2sBsso6xoXx3wGFNKgXUzE",
          "25DTUAd1roBFoUQaxJQByL6Qy2cKQCBp4bK9sgfy9UiM",
          "DTYuh7gAGGZg2okM7hdFfU1yMY9LUemCiPyD5Z5GCs6Z",
          "rFqFJ9g7TGBD8Ed7TPDnvGKZ5pWLPDyxLcvcH2eRCtt",
          "CgXS5xC3qAGSg9txD9bS7BUgugZwshivGXpCJcGmdwrd",
          "M2mx93ekt1fmXSVkTrUL9xVFHkmME8HTUi5Cyc5aF7K",
          "E8cU1WiRWjanGxmn96ewBgk9vPTcL6AEZ1t6F6fkgUWe",
          "11111111111111111111111111111111",
          "FdsNQE5EeCe57tbEYCRV1JwW5dzNCof7MUTaGWhmzYqu",
          "AYZsWahcrSnkwqbA1ji7wEzgAnGjLNJhVUMDPfACECZf",
          "TokenkegQfeZyiNwAJbNbGKPFXCWuBvf9Ss623VQ5DA",
          "SysvarRent111111111111111111111111111111111",
          "ATokenGPvbdGVxr1b2hvZbsiqW5xWH25efTNsLJA8knL",
          "1BWutmTvYPwDtmw9abTkS4Ssr8no61spGAvW1X6NDix"
        ],
        "addressTableLookups": null,
        "header": {
          "numReadonlySignedAccounts": 1,
          "numReadonlyUnsignedAccounts": 9,
          "numRequiredSignatures": 2
        },
        "instructions": [
          {
            "accounts": [
              0,
              1,
              2,
              3,
              11,
              12
            ],
            "data": "3GyWrkssW12wSfxjTynBnbif",
            "programIdIndex": 10
          },
          {
            "accounts": [
              0,
              1,
              13,
              14,
              2,
              3,
              11,
              4,
              3,
              15,
              12,
              16
            ],
            "data": "3Jmjmsq2jyrch5iz612vBLZCRB498owPe7qezQVetRZhiMu",
            "programIdIndex": 10
          },
          {
            "accounts": [
              0,
              5,
              1,
              6,
              13,
              14,
              2,
              7,
              3,
              11,
              8,
              4,
              3,
              9,
              3,
              15,
              12,
              17,
              18,
              16
            ],
            "data": "B2rqPwAgvj3t35y6HpdumfhdhsZMLNFLmXMC9Uz2HX4nNAwirTk3o98vTazFB1y",
            "programIdIndex": 10
          }
        ],
        "recentBlockhash": "3NRncb7FJuDruQjMDxnHvJBQkvkHa7KSUBqBsxG21roZ"
      },
      "signatures": [
        "5nNtjezQMYBHvgSQmoRmJPiXGsPAWmJPoGSa64xanqrauogiVzFyGQhKeFataHGXq51jR2hjbzNTkPUpP787HAmL",
        "4dWBkbLHGvU2jw9Sjj6YETtKfaVKAAN1M8aWzXRNC4aHBckUzM73n3FddNbWTtfUvkU2vFRQ7bKHMwKZQ5dGy1iH"
      ]
    }
  }
]

시작하기

Webhooks Quickstart

Dashboard, REST API 또는 공식 TypeScript / Rust SDK를 통해 첫 번째 웹훅을 생성하세요.

실패한 웹훅 자동 비활성화

Helius는 웹훅 엔드포인트의 상태를 모니터링하며, 전송 수신에 지속적으로 실패하는 웹훅을 자동으로 비활성화합니다. 이를 통해 연결할 수 없거나 손상된 엔드포인트에 불필요하게 전송을 시도하는 것을 방지합니다.

작동 방식

유료 요금제(Dev 이상): 7일 동안 실패율이 95% 이상인 웹훅은 자동으로 비활성화됩니다.
무료 요금제: 동일한 실패율 기준을 적용하여 24시간 단위로 웹훅을 평가합니다.

시스템은 4시간마다 웹훅 상태를 확인합니다. 웹훅이 비활성화되면 몇 초 이내에 전송이 중지됩니다.

이메일 알림

Dev 요금제 이상 사용자는 웹훅이 자동으로 비활성화되면 이메일 알림을 받습니다.

비활성화된 웹훅 다시 활성화하기

Fix your endpoint

전송 실패를 일으키는 문제(예: 서버 중단, 잘못된 URL, 엔드포인트 오류)를 해결하세요.

Helius Dashboard로 이동하세요.

Re-enable the webhook

비활성화된 웹훅을 찾아 다시 켜세요.

Toggle Webhook API endpoint를 통해 프로그래밍 방식으로 웹훅을 다시 활성화할 수도 있습니다.

다시 활성화된 웹훅에는 24시간의 유예 기간이 적용되며, 이 기간에는 다시 자동으로 비활성화되지 않습니다. 따라서 엔드포인트가 정상인지 확인할 시간이 주어집니다.

사용 예시

봇

NFT가 마켓플레이스 X에 등록되면 “NFT 구매” 작업을 트리거합니다.
마진 포지션이 불안정해지면 “청산” 작업을 트리거합니다.

모니터링 및 알림

프로그램에서 특정 로그가 생성되면 PagerDuty 통합을 트리거합니다.
토큰 계정 잔액이 X% 넘게 변경되면 Dialect를 사용하여 경고 작업을 전달합니다.

이벤트 기반 인덱싱

지정된 프로그램에서 트랜잭션이 발생하면 데이터베이스 또는 백엔드로 직접 전송합니다.

알림 및 활동 추적

지갑 X에서 지갑 Y로 전송되면 Slack 알림 또는 이메일을 보냅니다.

분석 및 로그

이벤트 X가 발생하면 ETL 파이프라인으로 보내거나 Helius에 직접 저장하여 시간 경과에 따른 추세를 확인합니다.

워크플로 자동화

이벤트 X가 발생하면 원하는 작업 세트를 트리거합니다.

시작하기

데이터 스트리밍 및 이벤트 수신

데이터 API 및 RPC

트레이딩

트랜잭션 전송

서비스형 지갑

개인정보 보호

리소스

Solana Webhooks: 실시간 블록체인 이벤트 알림

Solana 웹훅이란?

요금

웹훅 유형

Enhanced Transaction Webhooks

Raw Transaction Webhooks

Discord Webhooks

이벤트 페이로드 예시

시작하기

Webhooks Quickstart

실패한 웹훅 자동 비활성화

작동 방식

이메일 알림

비활성화된 웹훅 다시 활성화하기

사용 예시

봇

모니터링 및 알림

이벤트 기반 인덱싱

알림 및 활동 추적

분석 및 로그

워크플로 자동화

​Solana 웹훅이란?

​요금

​웹훅 유형

​Enhanced Transaction Webhooks

​Raw Transaction Webhooks

​Discord Webhooks

​이벤트 페이로드 예시

​시작하기

Webhooks Quickstart

​실패한 웹훅 자동 비활성화

​작동 방식

​이메일 알림

​비활성화된 웹훅 다시 활성화하기

​사용 예시

​봇

​모니터링 및 알림

​이벤트 기반 인덱싱

​알림 및 활동 추적

​분석 및 로그

​워크플로 자동화

Solana 웹훅이란?

요금

웹훅 유형

Enhanced Transaction Webhooks

Raw Transaction Webhooks

Discord Webhooks

이벤트 페이로드 예시

시작하기

실패한 웹훅 자동 비활성화

작동 방식

이메일 알림

비활성화된 웹훅 다시 활성화하기

사용 예시

봇

모니터링 및 알림

이벤트 기반 인덱싱

알림 및 활동 추적

분석 및 로그

워크플로 자동화