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.
MARKET_DATA_PROVIDER=fmp insieme a FMP_API_KEY. Il campo meta.provider di ogni risposta indica quale origine ha risposto.Elenca le quotazioni
/api/quotesRestituisce 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
| Parametro | In | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|---|
| sector | query | string | Facoltativo | Nome esatto del settore: Technology, Healthcare, Financials, Consumer Discretionary, Consumer Staples, Industrials, Energy, Materials, Utilities, Real Estate. |
| sort | query | string | Facoltativo | Campo di ordinamento: marketCap (predefinito), price, changePercent, volume o symbol. |
| order | query | string | Facoltativo | Ordine di ordinamento: desc (predefinito) o asc. |
| page | query | number | Facoltativo | Numero di pagina, a partire da 1. |
| pageSize | query | number | Facoltativo | Righe 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
/api/quotes/{symbol}Restituisce la quotazione completa di uno strumento o di un indice. Un simbolo sconosciuto restituisce 404 not_found.
Parametri
| Parametro | In | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|---|
| symbol | path | string | Obbligatorio | Simbolo 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
/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
| Parametro | In | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|---|
| symbol | path | string | Obbligatorio | Simbolo dello strumento o dell'indice, per esempio NWRB. La corrispondenza ignora maiuscole e minuscole. |
| range | query | string | Facoltativo | Uno 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
/api/screenerFiltra, 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
| Parametro | In | Tipo | Obbligatorio | Descrizione |
|---|---|---|---|---|
| sector | query | string | Facoltativo | Nome esatto del settore: Technology, Healthcare, Financials, Consumer Discretionary, Consumer Staples, Industrials, Energy, Materials, Utilities, Real Estate. |
| minMarketCap, maxMarketCap | query | number | Facoltativo | Limiti di capitalizzazione di mercato in USD. |
| minPrice, maxPrice | query | number | Facoltativo | Limiti di prezzo in USD. |
| minChangePercent, maxChangePercent | query | number | Facoltativo | Limiti di variazione giornaliera in punti percentuali: -3 significa -3%. |
| minVolume | query | number | Facoltativo | Volume giornaliero minimo in azioni. |
| profitableOnly | query | string | Facoltativo | Imposta 1 per mantenere solo gli strumenti con EPS superiore a 0. |
| sort | query | string | Facoltativo | Campo di ordinamento: marketCap (predefinito), price, changePercent, volume o symbol. |
| order | query | string | Facoltativo | Ordine di ordinamento: desc (predefinito) o asc. |
| page | query | number | Facoltativo | Numero di pagina, a partire da 1. |
| pageSize | query | number | Facoltativo | Righe 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"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 HTTP | Codice | Quando si verifica |
|---|---|---|
| 400 | bad_request | Un valore di parametro non è consentito, per esempio un intervallo di candele sconosciuto. |
| 401 | unauthorized | API_KEY è configurata e la richiesta non ha un'intestazione X-API-Key corrispondente. |
| 404 | not_found | Il simbolo non esiste nel set di dati. |
| 405 | method_not_allowed | L'API è in sola lettura: /api/quotes risponde a POST con questo codice. |
| 429 | rate_limited | Più 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.