Toda la documentación Documentación de Nebula Todos los endpoints Documentación interactiva Markdown JSON de OpenAPI
  1. API REST
  2. Búsqueda

Texto a ID de activo

GET /assets
ListAssets

Busca acciones (stocks y ETFs), materias primas, índices y cripto por nombre o ticker, y obtén los asset_id y asset_class que acepta cada endpoint de activos. Envía query para buscar, asset_id para una coincidencia exacta, o ninguno de los dos para explorar los activos más activos.

Reglas de los parámetros:

  • asset_id debe enviarse junto con asset_class.
  • asset_id no se puede combinar con query.

Pago con wallet disponible en https://nebula-api.hiddensystems.ai/api/v1/x402/assets. No se requiere cuenta de Nebula ni clave de API; consulta la oferta de pago antes de firmar. Guía de pago x402.

Parámetros

asset_id string QUERY

ID del activo de /assets o /search, como NVDA, GLD, SPX o bitcoin. Envíalo junto con el asset_class que se devolvió con él.

Example:NVDA

asset_class string QUERY

Restringe los resultados a una clase: equity (stocks y ETFs), commodity, index o crypto. Obligatorio cuando se envía asset_id.

Valores permitidos
equitycommodityindexcrypto

Example:equity

query string QUERY

Búsqueda sin distinción de mayúsculas y minúsculas en identificadores públicos y nombres.

Example:NVIDIA

limit integer QUERY

Número máximo de resultados devueltos.

Default:50

offset integer QUERY

Número de resultados omitidos.

Default:0

Ejemplo de cURL

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

Respuestas

200 OK
400 Solicitud incorrecta
401 No autorizado
402 Créditos agotados; la respuesta incluye el momento de renovación y el saldo de créditos comprados
403 Prohibido
404 No encontrado
405 Método no permitido; el encabezado Allow enumera el método admitido
429 Demasiadas solicitudes
500 Error interno del servidor
503 Servicio no disponible

Tipo de medio application/json

assets
array<object> obligatorio

Activos que coinciden con los filtros de descubrimiento proporcionados.
assets[].asset_class
string obligatorio

Clase del activo: equity (acciones y ETF), commodity, index o crypto. Envíala junto con asset_id en cada solicitud con alcance de asset.

Valores permitidos
equitycommodityindexcrypto
assets[].asset_id
string obligatorio

Identificador público canónico del activo: el ticker o símbolo de mercado para acciones, commodities e índices, y el slug de CoinGecko (o, si no lo hay, un id numérico) para crypto.

assets[].handle
string opcional

Identificador social principal cuando esté disponible.

assets[].market_cap_usd
number (double) opcional

Última capitalización de mercado en dólares estadounidenses. Se informa para cripto; no está disponible para acciones, materias primas e índices.

assets[].name
string obligatorio

Nombre legible para personas.

assets[].price_change_24h_pct
number (double) opcional

Cambio bruto del precio de mercado en 24 horas, en puntos porcentuales.

assets[].price_usd
number (double) opcional

Último precio de mercado observado, en dólares estadounidenses.

assets[].symbol
string obligatorio

Ticker o símbolo de mercado para mostrar.

has_more
boolean obligatorio

True cuando hay otra página disponible después de los registros devueltos.

limit
integer obligatorio

Número máximo de registros solicitados.

offset
integer obligatorio

Número de registros coincidentes omitidos.

{
  "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
}