Token Security Metrics

Overview

Provides security analysis for a token on Solana, covering ownership concentration, holder distribution, and transaction metrics. The endpoint combines holder concentration ratios, balance distribution statistics, transaction activity, and price volatility into a single composite security score.

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://api.cambrian.org/solana/tokens/security

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

Query Parameters

Response Field Descriptions

Examples

1. Analyze Security Metrics for Wrapped SOL

Retrieve comprehensive security metrics for Wrapped SOL, including holder concentration and transaction activity.

curl -X GET "https://api.cambrian.org/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",
        13348181.108462175,
        6973676,
        0.16189652639737476,
        0.2142132379822427,
        0.25792370503464934,
        0.31370070811266915,
        1e-09,
        0.00014928899999999999,
        0.11172613570000002,
        48290409,
        199543,
        0.46580054851057484,
        "2026-08-05T14:56:38+00:00",
        0.02912814651254293,
        1.163993860005979,
        11.673931646565606,
        83.50960990149156
      ]
    ],
    "rows": 1
  }
]

Result collections are limited to 10 items. The response shows Wrapped SOL with a holder count of ~6.97M, top-5 holder concentration of ~16.2%, and a composite security score of ~83.5, figures consistent with relatively decentralized ownership and healthy transaction activity.

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://x402.cambrian.org/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://x402.cambrian.org/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 through 5 automatically.

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