Cambrian Token Security Metrics API

By Cambrian Network solana

GET /api/v1/solana/tokens/security

Token Security Analysis

Provides comprehensive security analysis for a token on Solana, including ownership concentration, holder distribution, and transaction metrics. This endpoint analyzes various security indicators to help assess the risk profile and legitimacy of any Solana token.

Business Value

  • Risk Assessment: Evaluate token security risks before investing or integrating with DeFi protocols
  • Due Diligence: Comprehensive metrics for institutional analysis and compliance requirements
  • Market Intelligence: Understand holder concentration patterns and transaction activity levels
  • Investment Protection: Identify potential red flags like excessive whale concentration or unusual trading patterns
  • Portfolio Management: Monitor security metrics for existing token holdings

Endpoint Details

URL:

https://opabinia.cambrian.network/api/v1/solana/tokens/security

Method: GET
Authentication: Required via X-API-Key header

Query Parameters

Parameter Type Required Default Description
token_address String Yes - The token address to analyze

Response Field Descriptions

Response Field Type Description
address String The token address being analyzed
chain String The blockchain network (solana)
symbol String Token symbol
name String Token name
totalSupply Float64 Total token supply
holderCount UInt64 Total number of token holders
top5HolderConcentration Float64 Percentage of total supply held by top 5 holders
top10HolderConcentration Float64 Percentage of total supply held by top 10 holders
top20HolderConcentration Float64 Percentage of total supply held by top 20 holders
top50HolderConcentration Float64 Percentage of total supply held by top 50 holders
bottom10pctBalance Float64 Average balance of bottom 10% of holders
medianBalance Float64 Median balance across all holders
top10pctBalance Float64 Average balance of top 10% of holders
transaction1dCount UInt64 Number of transactions in the last 24 hours
activeAccounts1dCount UInt64 Number of active accounts in the last 24 hours
txUniquenessRatio Float64 Ratio of unique transactions to total transactions
latestTransaction DateTime Timestamp of the most recent transaction
priceVolatility30d Float64 Price volatility over the last 30 days
priceMaxMinRatio30d Float64 Ratio of maximum to minimum price over 30 days
priceRange30d Float64 Price range (max - min) over the last 30 days
securityScore Float64 Overall security score from 0-100

Examples

1. Wrapped SOL Security Analysis

Analyze the security metrics for Wrapped SOL (WSOL), one of the most established tokens on Solana.

curl -X GET "https://opabinia.cambrian.network/api/v1/solana/tokens/security?token_address=So11111111111111111111111111111111111111112" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"

Response:

[
  {
    "columns": [
      {
        "name": "address",
        "type": "String"
      },
      {
        "name": "chain",
        "type": "String"
      },
      {
        "name": "symbol",
        "type": "String"
      },
      {
        "name": "name",
        "type": "String"
      },
      {
        "name": "totalSupply",
        "type": "Float64"
      },
      {
        "name": "holderCount",
        "type": "UInt64"
      },
      {
        "name": "top5HolderConcentration",
        "type": "Float64"
      },
      {
        "name": "top10HolderConcentration",
        "type": "Float64"
      },
      {
        "name": "top20HolderConcentration",
        "type": "Float64"
      },
      {
        "name": "top50HolderConcentration",
        "type": "Float64"
      },
      {
        "name": "bottom10pctBalance",
        "type": "Float64"
      },
      {
        "name": "medianBalance",
        "type": "Float64"
      },
      {
        "name": "top10pctBalance",
        "type": "Float64"
      },
      {
        "name": "transaction1dCount",
        "type": "UInt64"
      },
      {
        "name": "activeAccounts1dCount",
        "type": "UInt64"
      },
      {
        "name": "txUniquenessRatio",
        "type": "Float64"
      },
      {
        "name": "latestTransaction",
        "type": "DateTime('UTC')"
      },
      {
        "name": "priceVolatility30d",
        "type": "Float64"
      },
      {
        "name": "priceMaxMinRatio30d",
        "type": "Float64"
      },
      {
        "name": "priceRange30d",
        "type": "Float64"
      },
      {
        "name": "securityScore",
        "type": "Float64"
      }
    ],
    "data": [
      [
        "So11111111111111111111111111111111111111112",
        "solana",
        "SOL",
        "Wrapped SOL",
        13169745.274044368,
        4577253,
        0.20673651046716712,
        0.24244014124692528,
        0.2894327047837308,
        0.35218503112177485,
        2E-9,
        0.0006327605,
        0.22798681700000006,
        22691795,
        119064,
        0.6849797911535865,
        "2026-01-15T16:33:44+00:00",
        0.049005545861426476,
        1.2299914862817527,
        27.12428926260411,
        80.73994363936819
      ]
    ],
    "rows": 1
  }
]

The analysis shows Wrapped SOL has a strong security profile with over 4.5 million holders, reasonable concentration levels (top 5 holders control ~20.7% of supply), high transaction activity (22M+ transactions in 24h), and a security score of 80.7 out of 100.

x402 Payment Option

This endpoint supports pay-per-use access via the x402 payment protocol (v2) — pay $0.05 USDC per request using blockchain micropayments. No API key required.

Quick Start (TypeScript)

npm install @x402/fetch @x402/evm viem
import { x402Client } from "@x402/core/client";
import { ExactEvmScheme } from "@x402/evm/exact/client";
import { wrapFetchWithPayment } from "@x402/fetch";
import { privateKeyToAccount } from "viem/accounts";

const signer = privateKeyToAccount(process.env.EVM_PRIVATE_KEY as `0x${string}`);
const client = new x402Client();
client.register("eip155:*", new ExactEvmScheme(signer));

const fetchWithPayment = wrapFetchWithPayment(fetch, client);
const response = await fetchWithPayment(
  "https://deep42.cambrian.network/api/v1/solana/tokens/security"
);
const data = await response.json();

Quick Start (Python)

pip install "x402[httpx]"
import asyncio, os
from eth_account import Account
from x402 import x402Client
from x402.http.clients import x402HttpxClient
from x402.mechanisms.evm import EthAccountSigner
from x402.mechanisms.evm.exact.register import register_exact_evm_client

async def main():
    client = x402Client()
    account = Account.from_key(os.getenv("EVM_PRIVATE_KEY"))
    register_exact_evm_client(client, EthAccountSigner(account))

    async with x402HttpxClient(client) as http:
        response = await http.get("https://deep42.cambrian.network/api/v1/solana/tokens/security")
        print(response.json())

asyncio.run(main())

Payment Flow

  1. Send a normal request to the endpoint (no API key needed)
  2. Server returns 402 Payment Required with payment details
  3. The x402 SDK automatically signs a payment authorization with your wallet
  4. The SDK resubmits the request with the signed payment
  5. Server verifies payment and returns the API response

The x402 SDK handles steps 2–5 automatically.

Network: Base (chain ID 8453) | Currency: USDC | Price: $0.05 per request


Related Endpoints

  • /api/v1/solana/tokens/holders - Returns current holders of a specific token sorted by balance
  • /api/v1/solana/tokens/holder-distribution-over-time - Track token holder distribution changes over time by USD value tiers
  • /api/v1/solana/tokens/holders-over-time - Monitor changes in token holders across block intervals
  • /api/v1/solana/price-current - Get current USD price for any Solana token
  • /api/v1/solana/token-details - Comprehensive token information including price history and trade statistics