Cambrian Tokens Trending API

By Cambrian Network solana

GET /api/v1/solana/trending-tokens

Trending Tokens

Retrieves a list of trending Solana tokens, ordered by price change in 24hs, trade volume in 24hs or current price. This endpoint allows you to track token performance and identify tokens with significant price movements or trading activity.

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://opabinia.cambrian.network/api/v1/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. Options: price_change_percentage, volume_usd_24h, current_price_usd
limit integer No 10 Limit the number of results (1-1000)
offset integer No 0 Offset the results, allows you to skip a number of rows (0-100000)

Response Field Descriptions

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

Examples

1. Get Top 5 Trending Tokens by Price Change

This example demonstrates how to retrieve the top 5 tokens with the highest 24-hour price percentage changes.

curl -X GET "https://opabinia.cambrian.network/api/v1/solana/trending-tokens?order_by=price_change_percentage&limit=5" \
  -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": [
    [
      "6VKDRsckuBSk3rFnsvoHV9hrPKnzNHRSCfrS91Cupump",
      "Ditto",
      0.00005313623154318319,
      0.000014776157632777156,
      259.60790933438574,
      72446.12936012667
    ],
    [
      "AWc8uws9nh7pYjFQ8FzxavmP8WTUPwmQZAvK2yAPBAGS",
      "ZHC",
      0.0028328309623358587,
      0.0010027201852745697,
      182.5146041674786,
      873324.2777910972
    ],
    [
      "81N3XkeSL28tfyKUEEVSTiyT3xyT1WKc4QrZEgNMpump",
      "GooGooGaga",
      0.0001302789756645811,
      0.00005090819792348477,
      155.909619626275,
      44547.12389077158
    ],
    [
      "aXKEWTAJb58e58tybyXZF3dqTunWLPEaK4Ccn3Be1iN",
      "cd",
      0.00009629904274771568,
      0.00004089656262920902,
      135.46977192390557,
      1627667.6195803545
    ],
    [
      "CPLTbYbtDMKZtHBaPqdDmHjxNwESCEB14gm6VuoDpump",
      "DTV",
      0.0025435318605601877,
      0.001225105981183932,
      107.6172918609164,
      205113.99916285655
    ]
  ],
  "rows": 5
}

Returns the top 5 tokens with the highest 24-hour price percentage changes, with Ditto showing an impressive 259.6% increase.

2. Get Top Tokens by Trading Volume

This example shows how to retrieve tokens ordered by their 24-hour trading volume to identify the most actively traded tokens.

curl -X GET "https://opabinia.cambrian.network/api/v1/solana/trending-tokens?order_by=volume_usd_24h&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": [
    [
      "AWc8uws9nh7pYjFQ8FzxavmP8WTUPwmQZAvK2yAPBAGS",
      "ZHC",
      0.0028328309623358587,
      0.0010027201852745697,
      182.5146041674786,
      873324.2777910972
    ],
    [
      "aXKEWTAJb58e58tybyXZF3dqTunWLPEaK4Ccn3Be1iN",
      "cd",
      0.00009629904274771568,
      0.00004089656262920902,
      135.46977192390557,
      1627667.6195803545
    ],
    [
      "CPLTbYbtDMKZtHBaPqdDmHjxNwESCEB14gm6VuoDpump",
      "DTV",
      0.0025435318605601877,
      0.001225105981183932,
      107.6172918609164,
      205113.99916285655
    ],
    [
      "6VKDRsckuBSk3rFnsvoHV9hrPKnzNHRSCfrS91Cupump",
      "Ditto",
      0.00005313623154318319,
      0.000014776157632777156,
      259.60790933438574,
      72446.12936012667
    ],
    [
      "81N3XkeSL28tfyKUEEVSTiyT3xyT1WKc4QrZEgNMpump",
      "GooGooGaga",
      0.0001302789756645811,
      0.00005090819792348477,
      155.909619626275,
      44547.12389077158
    ]
  ],
  "rows": 5
  // ... additional rows omitted for brevity
}

Returns tokens ordered by their 24-hour trading volume, helping identify the most liquid and actively traded tokens in the market.

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/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://deep42.cambrian.network/api/v1/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–5 automatically.

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

Related Endpoints

  • /api/v1/solana/tokens - Get comprehensive token information and metrics
  • /api/v1/solana/token-details - Get detailed information for specific tokens
  • /api/v1/solana/tokens/holders - Get token holder distribution data
  • /api/v1/solana/ohlcv/token - Get OHLCV price data for tokens
  • /api/v1/solana/orca/pools - Get Orca DEX pool information for token trading