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. It surfaces tokens with significant market activity so you can identify movers across the Solana ecosystem in a single request.

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. This parameter is required. Allowed values: price_change_percentage, volume_usd_24h, current_price_usd.
limit integer No 10 Limit the number of results. Minimum: 1. Maximum: 300.
offset integer No 0 Offset the results, allows you to skip a number of rows before starting to return rows. Minimum: 0. Maximum: 100000000.

Response Field Descriptions

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

Examples

1. Top Trending Tokens by Price Change

This example retrieves the top trending Solana tokens ordered by 24-hour price change percentage, which is useful for identifying tokens with the strongest recent momentum.

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": [
      [
        "ELR9i6Z7uhtZMWqkySYNnDhviSuSMA7nnyZ1BocKkEK",
        "ANT",
        1.548118698819226e-05,
        4.047036235829018e-06,
        282.53146465887784,
        46324137.01996983
      ],
      [
        "CM65K38bqGePYkNQBjGRRDYMhyxgh9xTQg2HPQTFpump",
        "Pois",
        0.00018347099635002224,
        9.65406559224956e-05,
        90.04531779576442,
        116889.55517390904
      ],
      [
        "GM8EysYT8NRSsoULdeYShbRsUdhoUoiB9EN4eW3YETCH",
        "ETCHY",
        0.0007514273826470393,
        0.00045079629904423664,
        66.68889789915994,
        10990.826776123902
      ],
      [
        "8ryRQD6jWfxnSdvvVbQ8Tzwo1NgGP7w1X1nQPpb4pump",
        "meowl",
        0.00042763351439243703,
        0.0002855861972853385,
        49.73885939073393,
        81037.60597163718
      ],
      [
        "4kjruqGHDsSqkMdFfCjV7Vb62HPFhtXyWc2t6JpQzDnz",
        "GTA6",
        0.01751212966374121,
        0.012233242922554555,
        43.15198165037593,
        11065697.282869294
      ],
      [
        "AHKcbfroL4aYLcmK6iPwYJieGYUZZmeB917FZYjbg6Xb",
        "$CHIMP",
        5.582804482022403e-05,
        4.67183977316513e-05,
        19.499057182778824,
        27636.805597271454
      ],
      [
        "3K296KEmjJQAPfbnYtkESJ2XT5Hqv38LuYX2jfecP7wk",
        "WASTED",
        0.0004716398796319813,
        0.00040784981232344284,
        15.640577825729174,
        438063.65801138873
      ],
      [
        "CWZ6BsdnjkDVTGkmL6bGbJXXig6ceef12KvyGQW14cMt",
        "ANTFUN",
        0.01169093773335816,
        0.010341052877209517,
        13.053650070039136,
        688406.404435534
      ],
      [
        "FgLfLhT3QoPWynZ53L3KUUsPhspWbdPUfMtmPfezXci6",
        "xZEC",
        0.31413455104261834,
        0.2812684055351783,
        11.684975937807373,
        16875.880633719757
      ],
      [
        "739dnZEG4yaBWFsY8L8ZwrfhGG6dhtCSercW8Umspump",
        "CLAW",
        0.005875175049194414,
        0.005276407222595062,
        11.348021510456205,
        24108.39004879085
      ]
    ],
    "rows": 10
  }
]

The response is limited to 10 results. It shows the top 10 Solana tokens ranked by 24-hour price change percentage, led by "ANT" with a 282.5% gain and over $46M in 24-hour volume.

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://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