All docs Nebula docs All endpoints Interactive docs Markdown OpenAPI JSON
  1. REST API
  2. Utility

Trending token list

GET /tokens/trending
GetTokensTrending

Trending token snapshot sorted by mindshare_change DESC. Returns the same response shape as /tokens, with optional trend metrics (mindshare_24h, mindshare_change, mindshare_change_pct). Use limit (max 50).

Parameters

limit integer QUERY

Maximum number of trending tokens to return (default 10, max 50).

Example:50

cURL Example

curl --request GET \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/tokens/trending' \
  --header 'X-API-Key: YOUR_API_KEY'

Responses

200 OK
400 Bad Request ErrorResponse

Media type application/json

limit
integer optional

Applied response size limit.

offset
integer optional

Applied page offset (always 0 for non-paginated token snapshots).

tokens
array<object> optional

Paged token rows. One entry per indexed token.
tokens[].address
string optional

Canonical contract address when available; null for native assets or unknown contracts.

tokens[].coingecko_id
string optional

CoinGecko asset identifier when available; null otherwise.

tokens[].market_cap_usd
number (double) optional

Latest known market capitalization in USD; null when unavailable.

tokens[].mindshare_24h
number (double) optional

Percent change in mindshare over the latest comparison window when available.

tokens[].mindshare_change
number (double) optional

Percent change in mindshare over the latest comparison window when available.

tokens[].mindshare_change_pct
number (double) optional

Percent change in mindshare over the latest comparison window when available.

tokens[].name
string optional

Human-readable token name.

tokens[].price_usd
number (double) optional

Latest known USD price; null when unavailable.

tokens[].symbol
string optional

Primary trading symbol.

tokens[].token_id
integer (int64) optional

Internal Nebula token identifier.

tokens[].volume_usd
number (double) optional

Latest known 24h volume in USD; null when unavailable.

total
integer optional

Total number of tokens in this response set.

{
  "limit": 0,
  "offset": 0,
  "tokens": [
    {
      "address": "string",
      "coingecko_id": "string",
      "market_cap_usd": 0,
      "mindshare_24h": 0,
      "mindshare_change": 0,
      "mindshare_change_pct": 0,
      "name": "string",
      "price_usd": 0,
      "symbol": "string",
      "token_id": 0,
      "volume_usd": 0
    }
  ],
  "total": 0
}