Cambrian Tokens Trending API
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
- Send a normal request to the endpoint (no API key needed)
- Server returns
402 Payment Requiredwith payment details - The x402 SDK automatically signs a payment authorization with your wallet
- The SDK resubmits the request with the signed payment
- 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