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

Text to asset ID

GET /assets
ListAssets

Look up equities (stocks and ETFs), commodities, indices, and crypto by name or ticker, and get the asset_id and asset_class every asset endpoint takes. Send query to search, asset_id for an exact match, or neither to browse the most active assets.

Parameter rules:

  • asset_id must be sent with asset_class.
  • asset_id cannot be combined with query.

Wallet payment available at https://nebula-api.hiddensystems.ai/api/v1/x402/assets. No Nebula account or API key required; check the payment offer before signing. x402 payment guide.

Parameters

asset_id string QUERY

Asset ID from /assets or /search, such as NVDA, GLD, SPX, or bitcoin. Send it with the asset_class returned alongside it.

Example:NVDA

asset_class string QUERY

Restricts results to one class: equity (stocks and ETFs), commodity, index, or crypto. Required when asset_id is sent.

Allowed values
equitycommodityindexcrypto

Example:equity

query string QUERY

Case-insensitive search across public identifiers and names.

Example:NVIDIA

limit integer QUERY

Maximum results returned.

Default:50

offset integer QUERY

Number of results skipped.

Default:0

cURL Example

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

Responses

200 OK
400 Bad Request
401 Unauthorized
402 Credits used up; response includes renewal timing and purchased credit balance
403 Forbidden
404 Not Found
405 Method not allowed; the Allow header lists the supported method
429 Too Many Requests
500 Internal Server Error
503 Service Unavailable

Media type application/json

assets
array<object> required

Assets matching the supplied discovery filters.
assets[].asset_class
string required

The asset's class: equity (stocks and ETFs), commodity, index, or crypto. Send it with asset_id on every asset-scoped request.

Allowed values
equitycommodityindexcrypto
assets[].asset_id
string required

Canonical public asset identifier: the ticker or market symbol for stocks, commodities, and indices, and the CoinGecko slug (or, without one, a numeric id) for crypto.

assets[].handle
string optional

Primary social handle when available.

assets[].market_cap_usd
number (double) optional

Latest market capitalisation in US dollars. Reported for crypto; absent for stocks, commodities, and indices.

assets[].name
string required

Human-readable name.

assets[].price_change_24h_pct
number (double) optional

Raw market-price change over 24 hours, in percentage points.

assets[].price_usd
number (double) optional

Latest or observed market price in US dollars.

assets[].symbol
string required

Display ticker or market symbol.

has_more
boolean required

True when another page is available after the returned records.

limit
integer required

Maximum records requested.

offset
integer required

Number of matching records skipped.

{
  "assets": [
    {
      "asset_class": "equity",
      "asset_id": "NVDA",
      "name": "NVIDIA Corporation",
      "price_change_24h_pct": 2.37,
      "price_usd": 182.41,
      "symbol": "NVDA"
    },
    {
      "asset_class": "commodity",
      "asset_id": "GLD",
      "name": "SPDR Gold Shares",
      "symbol": "GLD"
    },
    {
      "asset_class": "index",
      "asset_id": "SPX",
      "name": "S&P 500",
      "symbol": "SPX"
    }
  ],
  "has_more": false,
  "limit": 50,
  "offset": 0
}