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

Da testo ad asset ID

GET /assets
ListAssets

Cerca azioni (titoli ed ETF), materie prime, indici e criptovalute per nome o ticker e ottieni asset_id e asset_class accettati da ogni endpoint degli asset. Invia query per cercare, asset_id per una corrispondenza esatta, oppure nessuno dei due per sfogliare gli asset più attivi.

Regole dei parametri:

  • asset_id deve essere inviato insieme a asset_class.
  • asset_id non può essere combinato con query.

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

Parametri

asset_id string QUERY

Asset ID da /assets o /search, ad esempio NVDA, GLD, SPX o bitcoin. Va inviato con l'asset_class restituito insieme ad esso.

Example:NVDA

asset_class string QUERY

Limita i risultati a una classe: equity (titoli ed ETF), commodity, index o crypto. Obbligatorio quando viene inviato asset_id.

Valori consentiti
equitycommodityindexcrypto

Example:equity

query string QUERY

Ricerca senza distinzione tra maiuscole e minuscole su identificatori pubblici e nomi.

Example:NVIDIA

limit integer QUERY

Numero massimo di risultati restituiti.

Default:50

offset integer QUERY

Numero di risultati saltati.

Default:0

Esempio cURL

curl --request GET \
  --url 'https://nebula-api.hiddensystems.ai/api/v1/public/assets' \
  --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

assets
array<object> obbligatorio

Asset che corrispondono ai filtri di discovery forniti.
assets[].asset_class
string obbligatorio

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

Valori consentiti
equitycommodityindexcrypto
assets[].asset_id
string obbligatorio

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.

assets[].handle
string opzionale

Handle social principale, quando disponibile.

assets[].market_cap_usd
number (double) opzionale

Capitalizzazione di mercato più recente in dollari statunitensi. Segnalata per le criptovalute; assente per azioni, materie prime e indici.

assets[].name
string obbligatorio

Nome leggibile.

assets[].price_change_24h_pct
number (double) opzionale

Variazione grezza del prezzo di mercato su 24 ore, in punti percentuali.

assets[].price_usd
number (double) opzionale

Prezzo di mercato più recente o osservato in dollari statunitensi.

assets[].symbol
string obbligatorio

Ticker o simbolo di mercato visualizzato.

has_more
boolean obbligatorio

True quando è disponibile un'altra pagina dopo i record restituiti.

limit
integer obbligatorio

Numero massimo di record richiesti.

offset
integer obbligatorio

Numero di record corrispondenti saltati.

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