Skip to main content
Use the Webacy SDK to integrate blockchain security and risk analysis capabilities into your applications. You get type-safe access to all Webacy API endpoints with built-in error handling, retry logic, and multi-chain support.

​
Why Use the SDK?

Type Safety

Full TypeScript support with complete type definitions for all requests and responses

Multi-Chain

Built-in support for 12 blockchains with type-safe Chain enum

Error Handling

Structured error classes with recovery suggestions

Retry Logic

Automatic retries with exponential backoff for transient failures

​
Packages

The SDK is organized as a monorepo with focused packages:
PackageDescription
@webacy-xyz/sdkUnified SDK that re-exports all packages
@webacy-xyz/sdk-coreCore utilities: HTTP client, errors, Chain enum
@webacy-xyz/sdk-threatThreat analysis: addresses, contracts, sanctions, URLs
@webacy-xyz/sdk-tradingTrading analysis: holder analysis, sniper detection
For most use cases, install @webacy-xyz/sdk which includes everything you need.

​
Quick Example

import { ThreatClient, Chain } from '@webacy-xyz/sdk';

const client = new ThreatClient({
  apiKey: process.env.WEBACY_API_KEY,
  defaultChain: Chain.ETH,
});

// Analyze an address for security risks
const result = await client.addresses.analyze(
  '0x742d35Cc6634C0532925a3b844Bc454e4438f44e'
);

console.log(result.overallRisk); // 0-100 risk score
console.log(result.issues);      // Array of risk factors

​
Supported Chains

The SDK supports all 12 blockchains available in the Webacy API: 
import { Chain } from '@webacy-xyz/sdk';

Chain.ETH      // Ethereum
Chain.SOL      // Solana
Chain.BASE     // Base
Chain.BSC      // BNB Smart Chain
Chain.POL      // Polygon
Chain.ARB      // Arbitrum
Chain.OPT      // Optimism
Chain.TON      // TON
Chain.SUI      // Sui
Chain.STELLAR  // Stellar
Chain.BTC      // Bitcoin
Chain.SEI      // Sei

​
Next Steps

Installation

Install the SDK in your project

ThreatClient

Analyze addresses, contracts, and URLs

TradingClient

Holder analysis and sniper detection

Error Handling

Handle errors gracefully