Solana Token List

This endpoint returns a paginated list of known tokens for the Solana blockchain. It provides comprehensive token information including program IDs, symbols, names, and decimal configurations for all tracked Solana SPL tokens.

Business Value

• Token Discovery: Access a comprehensive database of Solana tokens for portfolio tracking, DeFi applications, and market analysis
• Integration Support: Standardized token metadata enables seamless integration with wallets, DEXs, and trading platforms
• Data Reliability: Curated token list ensures accurate symbol and decimal information for financial calculations
• Scalable Access: Pagination support allows efficient handling of large token datasets without performance impact
• Real-time Updates: Access to the latest token additions and metadata changes in the Solana ecosystem

Endpoint Details

URL:

https://opabinia.cambrian.network/api/v1/solana/tokens

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

Query Parameters

Parameter	Type	Required	Default	Description
limit	integer	No	100	Limit the number of results (1-1000)
offset	integer	No	0	Offset the results, allows skipping rows (0-100000)

Response Field Descriptions

Response Field	Type	Description
programId	String	The unique program/mint address of the token on Solana
symbol	String	The ticker symbol of the token (e.g., SOL, USDC)
name	String	The full name of the token
decimals	UInt8	The number of decimal places for the token

Examples

1. Basic Token List Retrieval

Retrieve the first 10 tokens from the Solana token database.

curl -X GET "https://opabinia.cambrian.network/api/v1/solana/tokens?limit=10" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"

Response:

{
  "columns": [
    {
      "name": "programId",
      "type": "String"
    },
    {
      "name": "symbol",
      "type": "String"
    },
    {
      "name": "name",
      "type": "String"
    },
    {
      "name": "decimals",
      "type": "UInt8"
    }
  ],
  "data": [
    [
      "3rYnoXJPtPh9g35unyzfF7fzCqx7svEMf2ALoGAo8WQU",
      "Pacino",
      "Pacino",
      6
    ],
    [
      "DaawVoBYG9JS5gePZanPrczi9Q78HRogKTk6jFnQbonk",
      "DEWIE",
      "Dewie the Turtle",
      6
    ],
    [
      "CQBFaPH5Ci48VED2UkuAFY1yDWc4ms69ta5qECjrLKer",
      "403",
      "Meme Not Authorized",
      6
    ],
    [
      "D1tjYcdndYE9iindaZ6ufGbEiq3sqQDeMZszip121EtG",
      "TPTT",
      "Trust Plan Trust Trump",
      6
    ],
    [
      "JAKxFTgiaRzJtkMy6LvJrW6nKvQYJhrk4czYPoAmmoon",
      "CTURL",
      "CTurtL",
      6
    ]
  ],
  "rows": 5
  // ... additional rows omitted for brevity
}

The response returns a columnar format with token metadata including program addresses, symbols, full names, and decimal configurations for the requested tokens.

2. Paginated Token Retrieval

Retrieve tokens 50-100 from the token list using offset pagination.

curl -X GET "https://opabinia.cambrian.network/api/v1/solana/tokens?limit=50&offset=50" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"

Response:

{
  "columns": [
    {
      "name": "programId",
      "type": "String"
    },
    {
      "name": "symbol",
      "type": "String"
    },
    {
      "name": "name",
      "type": "String"
    },
    {
      "name": "decimals",
      "type": "UInt8"
    }
  ],
  "data": [
    [
      "3rYnoXJPtPh9g35unyzfF7fzCqx7svEMf2ALoGAo8WQU",
      "Pacino",
      "Pacino",
      6
    ],
    [
      "DaawVoBYG9JS5gePZanPrczi9Q78HRogKTk6jFnQbonk",
      "DEWIE",
      "Dewie the Turtle",
      6
    ],
    [
      "CQBFaPH5Ci48VED2UkuAFY1yDWc4ms69ta5qECjrLKer",
      "403",
      "Meme Not Authorized",
      6
    ],
    [
      "D1tjYcdndYE9iindaZ6ufGbEiq3sqQDeMZszip121EtG",
      "TPTT",
      "Trust Plan Trust Trump",
      6
    ],
    [
      "JAKxFTgiaRzJtkMy6LvJrW6nKvQYJhrk4czYPoAmmoon",
      "CTURL",
      "CTurtL",
      6
    ]
  ],
  "rows": 5
  // ... additional rows omitted for brevity
}

This allows efficient pagination through large token datasets by skipping the first 50 tokens and retrieving the next 50.

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"
);
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")
        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/tokens/holders - Get current holders for a specific token
• /api/v1/solana/tokens/holders-over-time - Track token holder counts over time
• /api/v1/solana/tokens/holder-distribution-over-time - Analyze holder distribution changes
• /api/v1/solana/tokens/security - Get security analysis for a token
• /api/v1/solana/trending-tokens - Get currently trending Solana tokens