Tutta la documentazione Documentazione di Nebula Tutti gli endpoint Documentazione interattiva Markdown JSON OpenAPI
  1. API REST
  2. Lookup

Ricerca

GET /search
Ricerca

Una sola ricerca su asset, persone, account e argomenti. Il campo kind di ogni risultato indica di che tipo si tratta: gli asset riportano asset_id e asset_class, i soggetti riportano subject_id. Invia kind per cercare solo da un lato.

Pagamento con wallet disponibile su https://nebula-api.hiddensystems.ai/api/v1/x402/search. Non sono richiesti un account Nebula o una chiave API; controlla l'offerta di pagamento prima di firmare. Guida al pagamento x402.

Parametri

query string QUERY obbligatorio

Testo da cercare: un ticker, il nome di una società o di una coin, una persona, un account o un argomento.

Example:NVIDIA

kind string QUERY

Limita i risultati agli asset (azioni, materie prime, indici e crypto) o ai soggetti (persone, account e argomenti). Ometti il parametro per cercare in entrambi.

Valori consentiti
assetsubject

Example:asset

limit integer QUERY

Numero massimo di risultati restituiti.

Default:10

Esempio cURL

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

Risposte

200 OK
400 Richiesta non valida
401 Non autorizzato
402 Crediti esauriti; la risposta include i tempi di rinnovo e il saldo dei crediti acquistati
403 Vietato
404 Non trovato
405 Metodo non consentito; l'header Allow elenca il metodo supportato
429 Troppe richieste
500 Errore interno del server
503 Servizio non disponibile

Tipo di media application/json

query
string obbligatorio

La stringa di testo libero che è stata risolta, restituita così com'è.

results
array<object> obbligatorio

Risultati classificati, dal migliore al peggiore.
results[].asset_class
string opzionale

La classe dell'asset: equity (azioni ed ETF), commodity, index o crypto. Va inviata con asset_id in ogni richiesta con ambito asset.

results[].asset_id
string opzionale

Identificatore pubblico canonico dell'asset: il ticker o simbolo di mercato per azioni, commodity e indici, e lo slug CoinGecko (o, in mancanza, un id numerico) per le crypto.

results[].kind
string obbligatorio

Che cosa rappresenta il risultato: asset (da interrogare con asset_id e asset_class) o subject (da interrogare con subject_id).

Valori consentiti
assetsubject
results[].matched_alias
string opzionale

Il nome o l'alias che ha corrisposto alla query, così puoi mostrare perché una ricerca ha dato quel risultato.

results[].name
string obbligatorio

Nome leggibile.

results[].subject_id
string opzionale

Identificatore canonico per una persona, un account o un argomento non riconducibile a un asset.

results[].symbol
string opzionale

Ticker o simbolo di mercato visualizzato.

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