Vai al contenuto principale
QuantanSite

Riferimento API

Documentazione API

Un'API JSON in sola lettura sugli stessi dati di mercato che questo sito mostra. Le risposte riuscite usano l'involucro { data, meta }; gli errori usano { error: { code, message } }.

URL di base
http://localhost:3000
Metodi
Solo GET
Formato
JSON, UTF-8
Limite di richieste
60 richieste ogni 60 secondi, per indirizzo IP e per endpoint

These are API examples. This site is served as static files.

Demo
Le risposte provengono da un set di dati demo deterministico con emittenti fittizi, a meno che il server imposti MARKET_DATA_PROVIDER=fmp insieme a FMP_API_KEY. Il campo meta.provider di ogni risposta indica quale origine ha risposto.

Elenca le quotazioni

GET/api/quotes

Restituisce una pagina di strumenti come array piatto, con total, page e pageSize in meta. Ogni filtro dello screener qui sotto funziona anche qui; i valori che non possono essere interpretati vengono ignorati.

Parametri

ParametroInTipoObbligatorioDescrizione
sectorquerystringFacoltativoNome esatto del settore: Technology, Healthcare, Financials, Consumer Discretionary, Consumer Staples, Industrials, Energy, Materials, Utilities, Real Estate.
sortquerystringFacoltativoCampo di ordinamento: marketCap (predefinito), price, changePercent, volume o symbol.
orderquerystringFacoltativoOrdine di ordinamento: desc (predefinito) o asc.
pagequerynumberFacoltativoNumero di pagina, a partire da 1.
pageSizequerynumberFacoltativoRighe per pagina: 20 per impostazione predefinita, al massimo 100.

Richiesta

curl -s "http://localhost:3000/api/quotes?pageSize=3"

Esempio di risposta

200application/json

{
  "data": [
    {
      "symbol": "NWRB",
      "name": "Northwind Robotics",
      "exchange": "NASDAQ",
      "sector": "Technology",
      "industry": "Industrial Automation",
      "price": 733.8,
      "change": -16.52,
      "changePercent": -2.2,
      "previousClose": 750.32,
      "open": 750.03,
      "dayHigh": 751.29,
      "dayLow": 731.5,
      "volume": 3471317,
      "avgVolume": 2962633,
      "marketCap": 982258754565,
      "peRatio": 60.35,
      "eps": 12.16,
      "dividendYield": null,
      "week52High": 963.99,
      "week52Low": 583.89,
      "afterHoursPrice": 731,
      "afterHoursChangePercent": -0.38,
      "updatedAt": "2026-11-12T21:00:00.000Z"
    }
  ],
  "meta": {
    "provider": "demo",
    "generatedAt": "2026-11-12T21:00:04.512Z",
    "disclaimer": "Demo dataset: fictional issuers and simulated prices. Not investment advice.",
    "total": 20,
    "page": 1,
    "pageSize": 3
  }
}

L'esempio è ridotto a una riga.

Ottieni una quotazione

GET/api/quotes/{symbol}

Restituisce la quotazione completa di uno strumento o di un indice. Un simbolo sconosciuto restituisce 404 not_found.

Parametri

ParametroInTipoObbligatorioDescrizione
symbolpathstringObbligatorioSimbolo dello strumento o dell'indice, per esempio NWRB. La corrispondenza ignora maiuscole e minuscole.

Richiesta

curl -s "http://localhost:3000/api/quotes/NWRB"

Esempio di risposta

200application/json

{
  "data": {
    "symbol": "NWRB",
    "name": "Northwind Robotics",
    "exchange": "NASDAQ",
    "sector": "Technology",
    "industry": "Industrial Automation",
    "price": 733.8,
    "change": -16.52,
    "changePercent": -2.2,
    "previousClose": 750.32,
    "open": 750.03,
    "dayHigh": 751.29,
    "dayLow": 731.5,
    "volume": 3471317,
    "avgVolume": 2962633,
    "marketCap": 982258754565,
    "peRatio": 60.35,
    "eps": 12.16,
    "dividendYield": null,
    "week52High": 963.99,
    "week52Low": 583.89,
    "afterHoursPrice": 731,
    "afterHoursChangePercent": -0.38,
    "updatedAt": "2026-11-12T21:00:00.000Z"
  },
  "meta": {
    "provider": "demo",
    "generatedAt": "2026-11-12T21:00:04.512Z",
    "disclaimer": "Demo dataset: fictional issuers and simulated prices. Not investment advice."
  }
}

Ottieni le candele

GET/api/candles/{symbol}

Restituisce candele OHLCV, dalla più vecchia alla più recente. L'intervallo 1D usa intervalli da 30-minute; ogni altro intervallo usa candele giornaliere. Un intervallo sconosciuto restituisce 400 bad_request.

Parametri

ParametroInTipoObbligatorioDescrizione
symbolpathstringObbligatorioSimbolo dello strumento o dell'indice, per esempio NWRB. La corrispondenza ignora maiuscole e minuscole.
rangequerystringFacoltativoUno tra 1D, 5D, 1M, 6M, 1Y, 5Y. Predefinito: 1M.

Richiesta

curl -s "http://localhost:3000/api/candles/NWRB?range=1M"

Esempio di risposta

200application/json

{
  "data": [
    {
      "time": "2026-11-11",
      "open": 757.4,
      "high": 761.18,
      "low": 743.92,
      "close": 750.32,
      "volume": 3531710
    },
    {
      "time": "2026-11-12",
      "open": 750.03,
      "high": 751.29,
      "low": 731.5,
      "close": 733.8,
      "volume": 3471317
    }
  ],
  "meta": {
    "provider": "demo",
    "generatedAt": "2026-11-12T21:00:04.512Z",
    "disclaimer": "Demo dataset: fictional issuers and simulated prices. Not investment advice.",
    "symbol": "NWRB",
    "range": "1M"
  }
}

L'esempio è ridotto a due candele; 1M ne restituisce 22.

Filtra gli strumenti

GET/api/screener

Filtra, ordina e pagina gli strumenti con gli stessi parametri della pagina screener. Il risultato contiene rows insieme a total, page e pageSize; i valori che non possono essere interpretati vengono ignorati.

Parametri

ParametroInTipoObbligatorioDescrizione
sectorquerystringFacoltativoNome esatto del settore: Technology, Healthcare, Financials, Consumer Discretionary, Consumer Staples, Industrials, Energy, Materials, Utilities, Real Estate.
minMarketCap, maxMarketCapquerynumberFacoltativoLimiti di capitalizzazione di mercato in USD.
minPrice, maxPricequerynumberFacoltativoLimiti di prezzo in USD.
minChangePercent, maxChangePercentquerynumberFacoltativoLimiti di variazione giornaliera in punti percentuali: -3 significa -3%.
minVolumequerynumberFacoltativoVolume giornaliero minimo in azioni.
profitableOnlyquerystringFacoltativoImposta 1 per mantenere solo gli strumenti con EPS superiore a 0.
sortquerystringFacoltativoCampo di ordinamento: marketCap (predefinito), price, changePercent, volume o symbol.
orderquerystringFacoltativoOrdine di ordinamento: desc (predefinito) o asc.
pagequerynumberFacoltativoNumero di pagina, a partire da 1.
pageSizequerynumberFacoltativoRighe per pagina: 20 per impostazione predefinita, al massimo 100.

Richiesta

curl -s "http://localhost:3000/api/screener?profitableOnly=1&pageSize=5"

Esempio di risposta

200application/json

{
  "data": {
    "rows": [
      {
        "symbol": "NWRB",
        "name": "Northwind Robotics",
        "exchange": "NASDAQ",
        "sector": "Technology",
        "industry": "Industrial Automation",
        "price": 733.8,
        "change": -16.52,
        "changePercent": -2.2,
        "previousClose": 750.32,
        "open": 750.03,
        "dayHigh": 751.29,
        "dayLow": 731.5,
        "volume": 3471317,
        "avgVolume": 2962633,
        "marketCap": 982258754565,
        "peRatio": 60.35,
        "eps": 12.16,
        "dividendYield": null,
        "week52High": 963.99,
        "week52Low": 583.89,
        "afterHoursPrice": 731,
        "afterHoursChangePercent": -0.38,
        "updatedAt": "2026-11-12T21:00:00.000Z"
      }
    ],
    "total": 17,
    "page": 1,
    "pageSize": 5
  },
  "meta": {
    "provider": "demo",
    "generatedAt": "2026-11-12T21:00:04.512Z",
    "disclaimer": "Demo dataset: fictional issuers and simulated prices. Not investment advice.",
    "total": 17,
    "page": 1,
    "pageSize": 5
  }
}

L'esempio è ridotto a una riga.

Autenticazione

La modalità demo non richiede alcuna chiave. Quando il server imposta la variabile d'ambiente API_KEY, ogni richiesta deve inviare lo stesso valore nell'intestazione X-API-Key; qualsiasi altro valore riceve 401 unauthorized.

curl -s "http://localhost:3000/api/quotes/NWRB" \
  -H "X-API-Key: your-key-here"
Nota
La chiave viene letta solo sul server. I pulsanti Invia richiesta di questa pagina chiamano l'API dal browser senza chiave, quindi restituiscono 401 finché l'autenticazione con chiave è attiva.

Codici di errore

Le richieste fallite restituiscono uno stato HTTP corrispondente e un oggetto di errore. Ramifica su code; il message è scritto per le persone e può cambiare.

{
  "error": {
    "code": "not_found",
    "message": "A human-readable explanation."
  }
}
Stato HTTPCodiceQuando si verifica
400bad_requestUn valore di parametro non è consentito, per esempio un intervallo di candele sconosciuto.
401unauthorizedAPI_KEY è configurata e la richiesta non ha un'intestazione X-API-Key corrispondente.
404not_foundIl simbolo non esiste nel set di dati.
405method_not_allowedL'API è in sola lettura: /api/quotes risponde a POST con questo codice.
429rate_limitedPiù di 60 richieste in 60 secondi da un indirizzo IP verso un endpoint. La risposta include Retry-After in secondi.

Vedi gli stessi dati nel prodotto

La panoramica del mercato, le pagine delle quotazioni e lo screener leggono lo stesso fornitore di questi endpoint.