Token search | Nebula Docs

Parameters

q string QUERY required

Search query. For tokens this matches symbol, name, or contract address; for accounts it matches display name or handle.

Example:string

limit integer QUERY

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

Example:50

cURL Example

curl --get \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/tokens/search' \
  --data-urlencode 'q=string' \
  --header 'X-API-Key: YOUR_API_KEY'

Responses

200 OK

400 Bad Request ErrorResponse

Media type application/json

query

string optional

Normalized query string that was searched.

tokens

array<object> optional

Matching tokens ordered by relevance.

tokens[].coingecko_id

string optional

CoinGecko asset identifier when available; null otherwise.

tokens[].followers

integer (int64) optional

Project follower count when available; null otherwise.

tokens[].handle

string optional

Primary social handle for the token's project; null when unknown.

tokens[].image_url

string optional

Token logo URL.

tokens[].market_cap_usd

number (double) optional

Latest known market capitalization in USD; null when unavailable.

tokens[].name

string optional

Human-readable token name.

tokens[].price_change_24h_pct

number (double) optional

24h price change percentage; null when unavailable.

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.

total

integer optional

Number of tokens returned in this response.

{
  "query": "string",
  "tokens": [
    {
      "coingecko_id": "string",
      "followers": 0,
      "handle": "string",
      "image_url": "string",
      "market_cap_usd": 0,
      "name": "string",
      "price_change_24h_pct": 0,
      "price_usd": 0,
      "symbol": "string",
      "token_id": 0
    }
  ],
  "total": 0
}