SURCHI SDK: Build Blockchain Analytics Into Your App

The SURCHI SDK gives you programmatic access to the full SURCHI analytics platform directly from your application code. Whether you’re building a trading dashboard, a wallet tracker, or an automated risk monitor, the SDK handles authentication, serialization, pagination, and error handling so you can focus on your product logic rather than raw HTTP calls.

Available SDKs

Language	Package	Install
JavaScript / TypeScript	`@surchi/sdk`	`npm install @surchi/sdk`
Python	`surchi-sdk`	`pip install surchi-sdk`

Quick Install

npm install @surchi/sdk

yarn add @surchi/sdk

pnpm add @surchi/sdk

pip install surchi-sdk

Initialization

Both clients read your API key from an environment variable. Never hardcode your key directly in source code.

JavaScript / TypeScript
Python

import { Surchi } from '@surchi/sdk';

const surchi = new Surchi({
  apiKey: process.env.SURCHI_API_KEY
});

import os
from surchi import Surchi

client = Surchi(api_key=os.environ['SURCHI_API_KEY'])

The JavaScript SDK ships with full TypeScript type definitions bundled in the package — no need to install a separate @types/surchi package. You get complete autocompletion and type safety out of the box.

Available Modules

Every client instance exposes four top-level modules. Click through to the relevant SDK guide for complete method signatures and examples.

Tokens

Query token metadata, real-time prices, market cap, risk scores, and holder distributions across all supported networks.

Wallets

Analyze wallet behavior, calculate realized and unrealized PnL, inspect portfolio holdings, and track trading history.

Contracts

Run AI-powered smart contract audits that detect honeypots, rug-pull vectors, ownership risks, and hidden mint authorities.

Liquidity

Discover optimal swap routes, compare DEX prices, and calculate expected output amounts with configurable slippage tolerance.

Error Handling

The SDK surfaces distinct error classes so you can handle rate limits, missing resources, and general API errors separately.

JavaScript / TypeScript
Python

import { SurchiError, RateLimitError, NotFoundError } from '@surchi/sdk';

try {
  const token = await surchi.tokens.get(address, { network: 'solana' });
} catch (err) {
  if (err instanceof RateLimitError) {
    console.log(`Rate limited. Retry after ${err.retryAfter}s`);
  } else if (err instanceof NotFoundError) {
    console.log('Token not found on this network');
  } else if (err instanceof SurchiError) {
    console.log(`API error: ${err.message} (${err.code})`);
  }
}

from surchi.exceptions import SurchiError, RateLimitError, NotFoundError

try:
    token = client.tokens.get(address, network=network)
except RateLimitError as e:
    print(f"Rate limited. Retry after {e.retry_after}s")
except NotFoundError:
    print("Token not found on this network")
except SurchiError as e:
    print(f"API error: {e.message} ({e.code})")

API Reference

SDK

Webhooks

SURCHI SDK: Build Blockchain Analytics Into Your App

Available SDKs

Quick Install

Initialization

Available Modules

Tokens

Wallets

Contracts

Liquidity

Error Handling

​Available SDKs

​Quick Install

​Initialization

​Available Modules

Tokens

Wallets

Contracts

Liquidity

​Error Handling

Available SDKs

Quick Install

Initialization

Available Modules

Error Handling