API Documentation | BitBoss Institutional

API Overview

The BitBoss Analyzer API provides deterministic safety scores (0–100) for smart contracts and wallet addresses. Our engine performs deep forensics on-chain state, governance privileges, and code structural safety.

Base URL: https://api.bitboss.io/v1

Authentication

All requests must include your institutional API Key in the X-API-KEY header.

                    X-API-KEY: your_api_key_here 

                    Content-Type: application/json

Analyze Asset

Retrieves a comprehensive safety assessment for a specific on-chain address.

POST /analyze

Parameter	Type	Description
`address`	String	The smart contract or wallet address (0x...)
`chain`	String	Network ID (ethereum, base, arbitrum)

Example Javascript Integration

                    const response = await fetch('https://api.bitboss.io/v1/analyze', { 

                      method: 'POST', 

                      headers: { 'X-API-KEY': 'YOUR_KEY' }, 

                      body: JSON.stringify({ address: '0x...', chain: 'ethereum' }) 

                    }); 

                    const data = await response.json(); 

                    console.log(`Safety Score: ${data.score}`);

Example Java Pseudocode

                    RiskResponse res = bitbossClient.analyze(targetAddress, "ethereum"); 

                    if (res.getScore() < 50) { 

                          throw new RiskThresholdException("Asset safety score too low"); 

                        }

Deterministic Scoring

Our scores are not opaque prophecies. They are verifiable weighted calculations based on five deterministic pillars:

🛡️ **Governance (40%)**: Timelocks, Multi-sigs, and Owner Privileges.
⚖️ **Code Safety (25%)**: Structural integrity and compiler maturity.
📊 **Tokenomics (20%)**: Holder concentration and liquidity depth.
🌐 **Network Risk (10%)**: L2 bridge status and canonical verification.
🔍 **Transparency (5%)**: Metadata completeness and age.