Developer Documentation

Base Endpoint

https://api.envionai.com/v1/

---

1. Net Worth Mapping API

Returns the total combined net worth of holders for a given token.

Request Example

GET /v1/networth?contract=0xTOKEN_ADDRESS

Example JSON Response

{
  "token": "XYZ",
  "contract": "0xTOKEN_ADDRESS",
  "total_holder_net_worth_usd": 12450000.52,
  "mapped_wallets": 3841,
  "excluded_entities": ["CEX Wallets", "Smart Contracts", "Bridges"],
  "last_updated_utc": "2025-11-25T13:54:11Z"
}

---

2. Holder Analysis API

Returns supply distribution across holder tiers + AI interpreted risk grading.

Request Example

GET /v1/holders?contract=0xTOKEN_ADDRESS

Example JSON Response

{
  "token": "XYZ",
  "network": "Ethereum",
  "supply_distribution": {
    "1_percent_holders": 32.4,
    "point5_percent_holders": 8.1,
    "point1_percent_holders": 12.7
  },
  "top_holder_strength_score": 71,
  "ai_risk_rating": "Medium Risk",
  "ai_notes": "Supply centralization detected. Whale activity influences price movement.",
  "scan_time_utc": "2025-11-25T14:02:44Z",
  "market_cap_at_scan": "$6.3M"
}

---

Quick Integration Example (Node.js)

import fetch from "node-fetch";

async function fetchHolderAnalysis(contract) {
  const response = await fetch(`https://api.envionai.com/v1/holders?contract=${contract}`);
  const data = await response.json();
  console.log("Holder Scan Result:", data);
}

fetchHolderAnalysis("0xTOKEN_ADDRESS");

---

Quick Integration Example (Python)

import requests

contract = "0xTOKEN_ADDRESS"
url = f"https://api.envionai.com/v1/networth?contract={contract}"

response = requests.get(url)
data = response.json()

print("Total Holder Net Worth:", data["total_holder_net_worth_usd"])

---