Cambrian Token Details Multi API

By Cambrian Network solana

GET /api/v1/solana/token-details-multi

Token Details Multi

Retrieve comprehensive details for multiple Solana tokens simultaneously. Returns the same data structure as the single token_details endpoint but for multiple tokens in a single API call with a maximum of 50 tokens per request.

Business Value

  • Batch Processing: Query up to 50 tokens in a single API call, dramatically reducing latency and API calls compared to individual requests
  • Portfolio Analysis: Efficiently gather comprehensive metrics for entire token portfolios or watchlists in one operation
  • Trading Intelligence: Access real-time price data, volume metrics, holder counts, and trading statistics for multiple tokens simultaneously
  • Cost Optimization: Minimize API usage costs by batching multiple token queries into single requests
  • Performance Enhancement: Reduce network overhead and improve application responsiveness with bulk data retrieval

Endpoint Details

URL: 

https://opabinia.cambrian.network/api/v1/solana/token-details-multi

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

Query Parameters

Parameter Type Required Default Description
token_addresses String Yes - Comma-separated Solana token mint addresses (max 50, base58). Example: So11111111111111111111111111111111111111112,DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263

Response Field Descriptions

Response Field Type Description
tokenAddress String The token mint address
symbol String Token symbol (e.g., "USDC")
name String Full token name (e.g., "USD Coin")
decimals UInt8 Number of decimal places for the token
priceUSD Float64 Current token price in USD
lastTradeUnixTime UInt32 Unix timestamp of the most recent trade
lastTradeHumanTime String Human-readable timestamp of the most recent trade
trade1hCount UInt64 Number of trades in the last 1 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 1 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 1 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 UInt64 Total number of unique token holders

Examples

1. Single Token Query

Query comprehensive details for USDC token.

curl -X GET "https://opabinia.cambrian.network/api/v1/solana/token-details-multi?token_addresses=EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v" \
  -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": "priceUSD",
        "type": "Float64"
      },
      {
        "name": "lastTradeUnixTime",
        "type": "UInt32"
      },
      {
        "name": "lastTradeHumanTime",
        "type": "String"
      },
      {
        "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": "UInt64"
      }
    ],
    "data": [
      [
        "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
        "USDC",
        "USD Coin",
        6,
        1.0,
        1769609874,
        "2026-01-28 14:17:54",
        60991,
        929475,
        5513852,
        27545937.767328,
        416115947.9326,
        2573929498.162569,
        27545937.767328,
        416115947.9326,
        2573929498.162569,
        466656,
        462819,
        205474330.700439,
        210641617.232161,
        205474330.700439,
        210641617.232161,
        3835713
      ]
    ],
    "rows": 1
  }
]

This response shows comprehensive metrics for USDC including its stable $1.00 price, high trading activity with over 929K trades in 24 hours, and substantial holder base of 3.8M addresses.

2. Multiple Token Query

Query details for multiple tokens to compare metrics across different tokens.

curl -X GET "https://opabinia.cambrian.network/api/v1/solana/token-details-multi?token_addresses=So11111111111111111111111111111111111111112,EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v" \
  -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": "priceUSD",
        "type": "Float64"
      },
      {
        "name": "lastTradeUnixTime",
        "type": "UInt32"
      },
      {
        "name": "lastTradeHumanTime",
        "type": "String"
      },
      {
        "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": "UInt64"
      }
    ],
    "data": [
      [
        "So11111111111111111111111111111111111111112",
        "SOL",
        "Wrapped SOL",
        9,
        250.45,
        1769609874,
        "2026-01-28 14:17:54",
        85432,
        1247832,
        7832156,
        154328.267890,
        2785321.456123,
        18432187.891234,
        38684521.789456,
        697543821.234567,
        4618734256.789123,
        624218,
        623614,
        1392871.234567,
        1392450.221556,
        348771234.567891,
        348772587.666676,
        8934521
      ],
      [
        "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v",
        "USDC",
        "USD Coin",
        6,
        1.0,
        1769609874,
        "2026-01-28 14:17:54",
        60991,
        929475,
        5513852,
        27545937.767328,
        416115947.9326,
        2573929498.162569,
        27545937.767328,
        416115947.9326,
        2573929498.162569,
        466656,
        462819,
        205474330.700439,
        210641617.232161,
        205474330.700439,
        210641617.232161,
        3835713
      ]
    ],
    "rows": 2
  }
]

This example demonstrates querying both SOL and USDC simultaneously, allowing for direct comparison of trading metrics, volume, and holder statistics between different tokens in a single API call.

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-multi"
);
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-multi")
        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/token-details - Retrieve comprehensive details about a single Solana token
  • /api/v1/solana/tokens - Returns a paginated list of known tokens for the Solana chain
  • /api/v1/solana/tokens/security - Provides comprehensive security analysis for a token on Solana
  • /api/v1/solana/token-pool-search - Find pools containing a specific token and retrieve comprehensive trading statistics
  • /api/v1/solana/token-transactions - Retrieve a paginated list of trades/transactions for a specified Solana token address across all DEXes