Cambrian Tokens Trending API

By Cambrian Network solana

GET /api/v1/solana/trending-tokens

Tokens Trending

Overview

Retrieves a list of trending Solana tokens, ordered by price change in 24h, trade volume in 24h, or current price. This endpoint helps identify tokens experiencing significant market activity across major Solana DEXs.

Business Value

  • Market Analysis: Track trending tokens to identify emerging market opportunities and price momentum patterns
  • Investment Research: Analyze token performance metrics including 24-hour price changes and trading volumes to inform investment decisions
  • Risk Management: Monitor token volatility and trading activity to assess market risk and liquidity conditions
  • Portfolio Optimization: Identify high-performing tokens based on price appreciation and volume metrics for portfolio diversification
  • Trading Strategy: Use trending data to develop momentum-based trading strategies and identify entry/exit points

Endpoint Details

URL:

https://api.cambrian.org/solana/trending-tokens

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

Query Parameters

Parameter Type Required Default Description
order_by string Yes - Column to sort the results by. Enum: price_change_percentage, volume_usd_24h, current_price_usd
limit integer No 10 Limit the number of results. Minimum 1, maximum 1000
offset integer No 0 Offset the results, skipping a number of rows before returning results. Minimum 0, maximum 100000

Response Field Descriptions

Response Field Type Description
tokenAddress String The token's program/mint address on Solana
symbol String The token's ticker symbol
currentPriceUSD Float64 Current price of the token in USD
price24hAgo Float64 Token price in USD 24 hours ago
priceChangePercentage Float64 Percentage change in price over the last 24 hours
volume24hUSD Float64 Total trade volume in USD over the last 24 hours

Examples

1. Trending Tokens by Price Change

Retrieve the top trending Solana tokens sorted by 24-hour price change percentage.

curl -X GET "https://api.cambrian.org/solana/trending-tokens?order_by=price_change_percentage&limit=10" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json"

Response:

[
  {
    "columns": [
      {
        "name": "tokenAddress",
        "type": "String"
      },
      {
        "name": "symbol",
        "type": "String"
      },
      {
        "name": "currentPriceUSD",
        "type": "Float64"
      },
      {
        "name": "price24hAgo",
        "type": "Float64"
      },
      {
        "name": "priceChangePercentage",
        "type": "Float64"
      },
      {
        "name": "volume24hUSD",
        "type": "Float64"
      }
    ],
    "data": [
      [
        "7LA4wwjoXU4hAdwX1eT5ouuSsMrHq9wHQBfAyPfJK1eQ",
        "CLANKER",
        0.00030977020995104327,
        6.350242501898885e-05,
        387.8084732329734,
        222831.61405092085
      ],
      [
        "pumpvQHCc1kxMZ2iHZwYKYkdHHemnZQjKbnQemQUmcB",
        "PUMP",
        2.8815529240891106e-05,
        6.488801682055631e-06,
        344.08090511655826,
        45209.74804679812
      ],
      [
        "7ssJZGFT3twGqeYA1kvpoMWwZYvMZvrMEbjRaWgg46BL",
        "BUTTHOLE",
        0.00406459742682072,
        0.0011439312392943436,
        255.31833445933745,
        3094384.6383995335
      ],
      [
        "PerPsCe2SJ7Q25CN4R5TTX4fmBdmknE2hQmqCt96fHL",
        "PERPSPAD",
        0.0008224269868897212,
        0.0003096333739143196,
        165.61315936094786,
        40270.75731695424
      ],
      [
        "2Q3RhyE3u9qWf4ZNMebsWBkUJjCuQiYT62b15zu2LtCD",
        "CLAWD",
        0.00010926558382160787,
        4.7795907537797596e-05,
        128.6086601351785,
        528293.917378107
      ],
      [
        "8G4XEHtNpoDmtf9emkGFEkwHwPeCXkS5V4MpfrBJpump",
        "Queefcoin",
        7.247218167775941e-06,
        3.1773600870118674e-06,
        128.0892932910085,
        20404.61168746477
      ],
      [
        "Ga5ErptAQ5oHwB7G195UEq9FeJ5UNDoV9SCRCpebFeG7",
        "REDACTED",
        0.00020724716811236447,
        9.515913646529828e-05,
        117.79008911870632,
        70774.37743015483
      ],
      [
        "2u3ufZ5defxwPXMixvvQpSs68PDNzHTdE52t9Crspump",
        "BLOXWAP",
        0.00037071967568893204,
        0.00017726804186187184,
        109.12944702000979,
        118048.5331991455
      ],
      [
        "CTgiaZUK12kCcB8sosn4Nt2NZtzLgtPqDwyQyr2syATC",
        "BITCOIN",
        0.022990489205846888,
        0.011009650156737855,
        108.82125116188924,
        31538.14602054251
      ],
      [
        "3H7kMWRa7WfrpBGcyMpiAxkjBCc7k1pDShjQLDHJpump",
        "SD",
        4.944444029294309e-05,
        2.387929761887958e-05,
        107.05986031118042,
        37863.43883718179
      ]
    ],
    "rows": 10
  }
]

This example limits the result set to 10 items, showing the top 10 Solana tokens ranked by 24-hour price change percentage, with CLANKER leading at a 387.8% increase.

x402 Payment Option

This endpoint supports pay-per-use access via the x402 payment protocol (v2), letting you 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/trending-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://x402.cambrian.org/solana/trending-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 through 5 automatically.

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