HOLDR LABS

Documentation

Technical documentation for Holdr Labs holder analysis platform

Getting Started

Holdr Labs provides local-first diagnostics for Solana holder behavior patterns. Our Chrome extension analyzes on-chain data to identify conviction signals, drift patterns, and behavioral anomalies in real-time.

PREREQUISITES

  • Chrome browser (version 96 or later)
  • Internet connection for RPC queries
  • Basic understanding of Solana token addresses

Installation

Chrome Extension

  1. 01.Visit the Chrome Web Store
  2. 02.Click "Add to Chrome" to install the extension
  3. 03.Pin the extension to your toolbar for easy access
  4. 04.Click the Holdr Labs icon to open the analysis interface
Installation Verification
1. Open Chrome Extensions (chrome://extensions/)
2. Verify "Holdr Labs - Holder Analysis" is enabled
3. Check that version number matches latest release

Core Features

Holder Age Analysis

Calculate the age of each token holder based on their first transaction timestamp. Identify veteran holders vs. recent entrants to assess conviction levels.

AGE = current_time - first_tx_timestamp

Activity Monitoring

Track transaction frequency and volume changes over time. Detect unusual activity spikes that may signal market events.

ACTIVITY_SCORE = tx_count / time_window

Conviction Curves

Visualize holder accumulation and distribution patterns. Generate predictive signals based on behavioral trends.

CONVICTION = hold_duration × balance_stability

Drift Detection

Identify behavioral anomalies and pattern shifts that deviate from historical norms. Early warning system for market changes.

DRIFT = |current_pattern - baseline_pattern|

Usage Guide

ANALYZING A TOKEN

  1. 01.

    Open the Extension

    Click the Holdr Labs icon in your Chrome toolbar

  2. 02.

    Enter Token Address

    Paste the Solana token address you want to analyze

  3. 03.

    Run Diagnostics

    Click "Start Analyzing" to begin holder behavior analysis

  4. 04.

    Review Results

    Examine the waveform, metrics, and behavioral signals

Interpreting Results

Signal Strength: Higher values indicate stronger behavioral patterns

Conviction Spike: Orange peaks show moments of high conviction or activity

Baseline: The black waveform represents normal holder behavior

Drift Pattern: Deviation from baseline indicates behavioral shifts

API Reference

COMING SOON: DEVELOPER API

Programmatic access to Holdr Labs behavioral analytics is currently in development. Phase 2 will include REST API endpoints for integrating holder diagnostics into your applications.

// Planned Endpoint: Holder Analysis
POST /api/v1/analyze
Content-Type: application/json

{
  "token_address": "string",
  "analysis_type": "full" | "quick",
  "time_range": "24h" | "7d" | "30d"
}
// Response Schema
{
  "holder_age": { "avg": number, "median": number },
  "activity_score": number,
  "conviction_curve": number[],
  "drift_pattern": number,
  "signals": string[]
}

Troubleshooting

Extension not loading

Check that the extension is enabled in chrome://extensions/ and try reloading the page.

Solution: Disable and re-enable the extension, then restart Chrome

RPC connection errors

Network timeouts or RPC failures may occur during high load periods on Solana.

Solution: Wait a few moments and retry, or check Solana network status

Invalid token address

Ensure you're using a valid Solana token mint address (base58 encoded, 32-44 characters).

Solution: Verify the token address on Solscan or Solana Explorer

Slow analysis performance

Large holder counts (10,000+ addresses) may require additional processing time.

Solution: Use "Quick Analysis" mode for faster results with reduced detail

Need Help?

For additional support, feature requests, or bug reports, reach out to the Holdr Labs team.