Token Details Multi

Overview

Get detailed data for multiple Solana tokens in a single request. The response uses the same structure as the single-token token-details endpoint, including price, trading activity, volume, and holder metrics, batched for up to 50 tokens per call.

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://api.cambrian.org/solana/token-details-multi

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

Query Parameters

Response Field Descriptions

Examples

1. Fetch details for multiple well-known tokens

Get details for SOL (wrapped native token) and Bonk in a single request by passing their comma-separated mint addresses.

curl -X GET "https://api.cambrian.org/solana/token-details-multi?token_addresses=So11111111111111111111111111111111111111112%2CDezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263" \
  -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,
        74.00676590925579,
        1785945415,
        "2026-08-05 15:56:55",
        1093034,
        23826521,
        147985950,
        4429122.400240805,
        93032561.4433486,
        510949224.80290234,
        327785024.6580624,
        6885038996.676356,
        37813699671.504105,
        9559168,
        14267353,
        46330616.84688268,
        46701944.59646592,
        3428779115.418669,
        3456259881.257687,
        9792518
      ],
      [
        "DezXAZ8z7PnrnRJjz3wXBoRgixCa6xjnB7YaB1pPB263",
        "Bonk",
        "Bonk",
        5,
        2.7855047656462087e-06,
        1785945412,
        "2026-08-05 15:56:52",
        359,
        7870,
        63074,
        1468809952.5160499,
        45186071309.198135,
        283381622871.66986,
        4091.3771225620385,
        125866.01697260083,
        789360.8610055931,
        3687,
        4183,
        22313864735.79276,
        22872206573.40538,
        62155.37656153561,
        63710.64041106523,
        430549
      ]
    ],
    "rows": 2
  }
]

Note: Result collections are limited to 10 items.

The response returns one row per requested token address in the columnar columns/data format. SOL is priced at ~$74.01 with ~9.8M holders, and Bonk trades at a fraction of a cent with ~430K holders; both rows include the full 1h/24h/7d trade count and volume breakdowns.

x402 Payment Option

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

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