Cambrian Token Security Metrics API
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
- Send a normal request to the endpoint (no API key needed)
- Server returns
402 Payment Requiredwith payment details - The x402 SDK automatically signs a payment authorization with your wallet
- The SDK resubmits the request with the signed payment
- 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