HelixTrace Documentation

Complete guide to the HelixTrace origin forensics engine

Quick Start

Get started in minutes

API Reference

Complete API docs

Data Models

Understand the data

Security

Best practices

Getting Started

Welcome to the HelixTrace documentation. This guide will help you integrate the HelixTrace origin forensics engine into your applications and workflows.

Installation

NPM Package

npm install @helixtrace/sdk

Initialize

import { HelixTrace } from '@helixtrace/sdk'

const helixtrace = new HelixTrace({
  apiKey: 'your-api-key',
  network: 'mainnet-beta'
})

Core Features

1. Token Origin Tracking

Trace any token back to its origin, including all intermediate transactions and wallet interactions.

const origin = await helixtrace.traceToken({
  tokenAddress: 'token_mint_address',
  depth: 10
})

console.log(origin.sourceWallet)
console.log(origin.creationDate)
console.log(origin.transactionPath)

2. Wallet Analysis

Analyze wallet behavior patterns, transaction history, and risk scoring.

const analysis = await helixtrace.analyzeWallet({
  walletAddress: 'wallet_address',
  includeRiskScore: true
})

console.log(analysis.riskLevel)
console.log(analysis.transactionCount)
console.log(analysis.suspiciousActivity)

3. Real-time Monitoring

Set up webhooks to receive real-time alerts on specific token or wallet activities.

helixtrace.monitor({
  type: 'token',
  address: 'token_mint_address',
  webhook: 'https://your-domain.com/webhook',
  events: ['transfer', 'mint', 'burn']
})

API Reference

POST /api/v1/trace

Trace the origin of a token

Parameters:

  • tokenAddress (required) - SPL token mint address
  • depth (optional) - Transaction depth to trace (default: 10)

GET /api/v1/wallet/:address

Get comprehensive wallet analysis

Parameters:

  • address (required) - Solana wallet address
  • includeRiskScore (optional) - Include risk assessment

POST /api/v1/monitor

Set up real-time monitoring

Parameters:

  • type (required) - Monitor type: 'token' or 'wallet'
  • address (required) - Address to monitor
  • webhook (required) - Webhook URL for alerts
  • events (optional) - Array of events to track

Rate Limits

  • Free Tier: 100 requests/day
  • Basic Tier: 1,000 requests/day
  • Pro Tier: 10,000 requests/day
  • Enterprise: Custom limits

Support

Need help? Our team is here to assist you:

  • Discord: discord.gg/helixtrace
  • Email: support@helixtrace.io
  • Twitter: @helixtrace

SDK Examples

Complete Example

import { HelixTrace } from '@helixtrace/sdk'

async function analyzeToken() {
  const helixtrace = new HelixTrace({
    apiKey: process.env.HELIXTRACE_API_KEY,
    network: 'mainnet-beta'
  })

  try {
    // Trace token origin
    const origin = await helixtrace.traceToken({
      tokenAddress: 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v',
      depth: 15
    })

    // Analyze source wallet
    const wallet = await helixtrace.analyzeWallet({
      walletAddress: origin.sourceWallet,
      includeRiskScore: true
    })

    // Set up monitoring
    await helixtrace.monitor({
      type: 'token',
      address: 'EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v',
      webhook: 'https://myapp.com/helixtrace-webhook',
      events: ['transfer', 'large_transaction']
    })

    console.log('Analysis complete:', {
      origin,
      wallet,
      riskLevel: wallet.riskLevel
    })
  } catch (error) {
    console.error('Analysis failed:', error)
  }
}

analyzeToken()