Toda la documentación Documentación de Nebula Todos los endpoints Documentación interactiva Markdown JSON de OpenAPI

API REST
Búsqueda

Buscar

GET /search

Buscar

Una sola búsqueda en activos, personas, cuentas y temas. El kind de cada resultado indica qué es: los activos llevan asset_id y asset_class, los sujetos llevan subject_id. Envía kind para buscar solo en un lado.

Pago con wallet disponible en https://nebula-api.hiddensystems.ai/api/v1/x402/search. 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

query string QUERY obligatorio

Texto que se va a buscar: un ticker, el nombre de una empresa o moneda, una persona, una cuenta o un tema.

Example:NVIDIA

kind string QUERY

Restringe los resultados a activos (acciones, materias primas, índices y cripto) o a sujetos (personas, cuentas y temas). Omítelo para buscar en ambos.

Valores permitidos

assetsubject

Example:asset

limit integer QUERY

Número máximo de resultados devueltos.

Default:10

Ejemplo de cURL

curl --get \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/search' \
  --data-urlencode 'query=NVIDIA' \
  --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

query

string obligatorio

La cadena de texto libre que se resolvió, devuelta tal cual.

results

array<object> obligatorio

Resultados clasificados, del mejor al primero.

results[].asset_class

string opcional

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

results[].asset_id

string opcional

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.

results[].kind

string obligatorio

Qué es el resultado: asset (consúltalo con asset_id y asset_class) o subject (consúltalo con subject_id).

Valores permitidos

assetsubject

results[].matched_alias

string opcional

El nombre o alias que coincidió con la consulta, para que puedas mostrar por qué una búsqueda dio el resultado que dio.

results[].name

string obligatorio

Nombre legible para personas.

results[].subject_id

string opcional

Identificador canónico de una persona, cuenta o tema que no es un activo.

results[].symbol

string opcional

Ticker o símbolo de mercado para mostrar.

{
  "query": "nvidia",
  "results": [
    {
      "asset_class": "equity",
      "asset_id": "NVDA",
      "kind": "asset",
      "name": "NVIDIA Corporation",
      "symbol": "NVDA"
    },
    {
      "kind": "subject",
      "matched_alias": "NVIDIA AI",
      "name": "NVIDIA AI",
      "subject_id": "handle:nvidiaai"
    }
  ]
}