Python.
TypeScript.
Both typed.

Requires Python 3.9 or later. Built on httpx for async support.

Installation

pip install veris-sdk

Initialize the client

from veris import Veris

client = Veris(api_key="vrs_sk_live_...")

# Screen an address
result = client.screen(
    address="0x7Ff9...D4eA",
    chain="ethereum",
    include_risk=True
)
print(result.status)       # "match"
print(result.risk_score)   # 0.94

Async support

from veris import AsyncVeris

client = AsyncVeris(api_key="vrs_sk_live_...")

async def check_risk():
    risk = await client.risk(
        address="0x7Ff9...D4eA",
        chain="ethereum"
    )
    print(risk.score)          # 0.82
    print(risk.detectors)      # [Detector(...), ...]
    print(risk.shap_values)    # {"mixer_exposure": 0.21, ...}

Works in Node.js 18+ and modern browsers. Ships with full type definitions.

Installation

npm install @veris/sdk

Initialize the client

import { Veris } from "@veris/sdk";

const client = new Veris({ apiKey: "vrs_sk_live_..." });

// Screen an address
const result = await client.screen({
    address: "0x7Ff9...D4eA",
    chain: "ethereum",
    includeRisk: true,
});
console.log(result.status);      // "match"
console.log(result.riskScore);   // 0.94

Async / await

// All methods return promises
const [risk, alerts] = await Promise.all([
    client.risk("0x7Ff9...D4eA", { chain: "ethereum" }),
    client.alerts({ status: "open", limit: 10 }),
]);
console.log(risk.score);         // 0.82
console.log(alerts.total);       // 142

Configuration

Both SDKs read configuration from environment variables. You can also pass values directly to the constructor. Constructor values take precedence over environment variables.

Error handling

Both SDKs raise typed exceptions. Catch specific error classes to handle different failure modes.

from veris import Veris, VerisError, VerisRateLimitError, VerisAuthError

client = Veris(api_key="vrs_sk_live_...")