Cambrian Token Details API
GET /api/v1/solana/token-details
Solana Token Details
Retrieve comprehensive information about a specific Solana token including price, trading volumes, holder counts, and supply metrics. This endpoint provides real-time token data across multiple time frames.
Business Value
- Market Analysis: Access current price and trading volume data for investment decisions and market research
- Trading Intelligence: Get 1h, 24h, and 7-day trading statistics for algorithmic trading strategies
- Portfolio Tracking: Monitor token metrics including holder count and fully diluted valuation for portfolio management
- Risk Assessment: Analyze buy/sell ratios and volume patterns to assess token liquidity and market sentiment
- Token Research: Access fundamental token data including symbol, name, decimals, and supply information
Endpoint Details
URL:
https://opabinia.cambrian.network/api/v1/solana/token-details
Method: GET
Authentication: Required via X-API-Key header
Query Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| token_address | String | Yes | - | The Solana token program address (base58 string) |
Response Field Descriptions
| Response Field | Type | Description |
|---|---|---|
| tokenAddress | String | The Solana token mint address |
| symbol | String | Token symbol (e.g., SOL) |
| name | String | Full token name |
| decimals | UInt8 | Number of decimal places for token precision |
| lastTradeUnixTime | UInt32 | Unix timestamp of the most recent trade |
| lastTradeHumanTime | String | Human-readable timestamp of the most recent trade |
| priceUSD | Float64 | Current token price in USD |
| trade1hCount | UInt64 | Number of trades in the last hour |
| trade24hCount | UInt64 | Number of trades in the last 24 hours |
| trade7dCount | UInt64 | Number of trades in the last 7 days |
| volume1h | Float64 | Trading volume in the last hour (in token units) |
| volume24h | Float64 | Trading volume in the last 24 hours (in token units) |
| volume7d | Float64 | Trading volume in the last 7 days (in token units) |
| volume1hUSD | Float64 | Trading volume in the last hour in USD |
| volume24hUSD | Float64 | Trading volume in the last 24 hours in USD |
| volume7dUSD | Float64 | Trading volume in the last 7 days in USD |
| buy24hCount | UInt64 | Number of buy transactions in the last 24 hours |
| sell24hCount | UInt64 | Number of sell transactions in the last 24 hours |
| buyVolume24h | Float64 | Buy volume in the last 24 hours (in token units) |
| sellVolume24h | Float64 | Sell volume in the last 24 hours (in token units) |
| buyVolume24hUSD | Float64 | Buy volume in the last 24 hours in USD |
| sellVolume24hUSD | Float64 | Sell volume in the last 24 hours in USD |
| holderCount | Nullable(UInt64) | Total number of token holders (may be null) |
| totalSupply | Nullable(Float64) | Total token supply (may be null) |
| fdvUSD | Nullable(Float64) | Fully diluted valuation in USD (may be null) |
Examples
1. Get Wrapped SOL Token Details
Retrieve comprehensive trading and market data for Wrapped SOL, the most liquid token on Solana.
curl -X GET "https://opabinia.cambrian.network/api/v1/solana/token-details?token_address=So11111111111111111111111111111111111111112" \
-H "X-API-Key: YOUR_API_KEY" \
-H "Content-Type: application/json"
Response:
{
"columns": [
{
"name": "tokenAddress",
"type": "String"
},
{
"name": "symbol",
"type": "String"
},
{
"name": "name",
"type": "String"
},
{
"name": "decimals",
"type": "UInt8"
},
{
"name": "lastTradeUnixTime",
"type": "UInt32"
},
{
"name": "lastTradeHumanTime",
"type": "String"
},
{
"name": "priceUSD",
"type": "Float64"
},
{
"name": "trade1hCount",
"type": "UInt64"
},
{
"name": "trade24hCount",
"type": "UInt64"
},
{
"name": "trade7dCount",
"type": "UInt64"
},
{
"name": "volume1h",
"type": "Float64"
},
{
"name": "volume24h",
"type": "Float64"
},
{
"name": "volume7d",
"type": "Float64"
},
{
"name": "volume1hUSD",
"type": "Float64"
},
{
"name": "volume24hUSD",
"type": "Float64"
},
{
"name": "volume7dUSD",
"type": "Float64"
},
{
"name": "buy24hCount",
"type": "UInt64"
},
{
"name": "sell24hCount",
"type": "UInt64"
},
{
"name": "buyVolume24h",
"type": "Float64"
},
{
"name": "sellVolume24h",
"type": "Float64"
},
{
"name": "buyVolume24hUSD",
"type": "Float64"
},
{
"name": "sellVolume24hUSD",
"type": "Float64"
},
{
"name": "holderCount",
"type": "Nullable(UInt64)"
},
{
"name": "totalSupply",
"type": "Nullable(Float64)"
},
{
"name": "fdvUSD",
"type": "Nullable(Float64)"
}
],
"data": [
[
"So11111111111111111111111111111111111111112",
"SOL",
"Wrapped SOL",
9,
1769609747,
"2026-01-28 14:15:47",
126.99117955165421,
724768,
17561170,
112483856,
2560284.9693677383,
65542758.580979966,
384543179.47802883,
325133608.24837995,
8323352223.267952,
48833591950.45835,
7635426,
9925744,
32785754.07305617,
32757004.50792383,
4163501582.2278543,
4159850641.0401015,
4576630,
13169745.274044368,
1672441486.745718
]
],
"rows": 1
}
Returns detailed trading metrics for Wrapped SOL showing high trading activity with over 17M trades in 24 hours and $8.3B in daily volume, demonstrating the token's strong liquidity and market presence.
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/token-details"
);
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/token-details")
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/ohlcv/token- Retrieve Open, High, Low, Close, and Volume data for any SPL token/api/v1/solana/price-current- Get current price data for Solana tokens/api/v1/solana/ohlcv/base-quote- Retrieve granular OHLCV data with separate base and quote token volumes for detailed trading analysis/api/v1/solana/orca/pool-multi- Get comprehensive overview metrics for multiple pools/pairs simultaneously/api/v1/solana/orca/pools/fee-metrics- Retrieve core metrics like fees, volume, and TVL for Orca Whirlpools