Home / API
API
Gli stessi dati delle pagine, leggibili da un programma. Le risposte sono in JSON, gli indirizzi e i nomi dei campi in inglese.
L'accesso è oggi libero: nessuna chiave, nessun account, nessuna quota. Le autorità pubblicano questi dati, questo sito li raccoglie e li ripubblica nella stessa forma per tutti. Il file completo risponde in una sola richiesta a ciò che richiederebbe migliaia di pagine, il che alleggerisce tanto il server quanto chi lo interroga.
| Indirizzo | Risposta |
|---|---|
/api/positions.jsonl.gz /api/positions.jsonl.gz | Tutte le posizioni aperte, una per riga, in un file compresso ricostruito dopo ogni raccolta. |
/api/company/<slug> /api/company/reyuu-japan-inc | Una società: chi la vende allo scoperto oggi, e tutte le sue comunicazioni dall'origine. |
/api/fund/<slug> /api/fund/citadel-advisors-llc | Un fondo: tutte le sue posizioni aperte, su tutti i registri. |
/api/moves /api/moves | Movimenti degli ultimi trenta giorni, qualificati: opening, increase, reduction, below_threshold. |
/api/isins /api/isins | Una riga per società dichiarata: il suo codice ISIN e l'indirizzo della sua pagina. |
/api/openapi.json /api/openapi.json | Il contratto come documento OpenAPI, per generare un client invece di leggere questa pagina. |
/action/<slug>/positions.csv /action/reyuu-japan-inc/positions.csv | Una società o un fondo: tutto il suo storico dichiarato, in foglio di calcolo. Colonne nella lingua del dominio, separatore e codifica leggibili da Excel. |
/action/<slug>/movements.xml /action/reyuu-japan-inc/movements.xml | Una società o un fondo: i suoi movimenti, in flusso RSS. |
/mcp https://www.quivad.it/mcp | Il server MCP: un assistente si collega e legge i registri da sé. Solo POST. |
Qualsiasi assistente che parla il Model Context Protocol può leggere questi registri da sé: aggiungigli https://www.quivad.it/mcp. Cinque strumenti, che trovano una società o un fondo, leggono l'uno o l'altro, classificano un mercato ed elencano ciò che si è mosso, e che rispondono in inglese come il resto dell'API, senza chiave e sotto lo stesso limite di frequenza. La revisione corrente del protocollo e le tre precedenti sono servite a questo solo indirizzo; accetta solo POST, quindi, se lo apri in un browser, risponde 405 e spiega perché.
Una risposta lunga è suddivisa in pagine da limit (1.000 righe per impostazione predefinita, 12.000 al massimo) e offset. Il blocco page della risposta porta il totale e gli indirizzi della pagina successiva e della precedente: nulla è tolto, tutto è raggiungibile, e un valore non valido viene sostituito da quello predefinito, senza errore.
Oltre 120 richieste al minuto, un indirizzo riceve una risposta 429 e il tempo di attesa. Una risposta servita dalla cache non conta: il limite blocca lo scraping massivo, mai l'uso normale.
Nessuna versione negli indirizzi, perché nulla si romperà: un campo può apparire, nessuno scompare o cambia significato, e un indirizzo non si sposta.
Gli errori
Un errore è in JSON come ogni risposta, mai una pagina: type, title, status e detail, nella forma che la RFC 9457 dà a ogni API HTTP. Il campo type rimanda a uno dei codici di questa sezione.
company-not-found- Nessuna società risponde a questo indirizzo. L'elenco è su /api/isins.
fund-not-found- Nessun fondo risponde a questo indirizzo.
no-such-endpoint- Nessun indirizzo dell'API risponde qui.
method-not-allowed- Questi indirizzi sono di sola lettura: GET, HEAD e OPTIONS.
rate-limit-exceeded- Troppe richieste nel minuto. retry-after dice quanto aspettare.
not-ready- Il file del giorno è ancora in preparazione; la risposta indica il tempo di attesa.
I dati vengono dalle pubblicazioni ufficiali delle autorità e restano soggetti alle condizioni che ciascuna fissa. La licenza nota di ogni registro è indicata nella pagina delle fonti. Vedi lo stato delle fonti