Home / API
API
Dezelfde cijfers als de pagina's, leesbaar voor een programma. De antwoorden zijn JSON, de adressen en veldnamen Engels.
De toegang is vandaag vrij: geen sleutel, geen account, geen quotum. De toezichthouders publiceren deze gegevens, deze site brengt ze samen en publiceert ze in dezelfde vorm voor iedereen. Het volledige bestand beantwoordt in één verzoek wat anders duizenden pagina's zou vergen, wat zowel de server als de vrager spaart.
| Adres | Antwoord |
|---|---|
/api/positions.jsonl.gz /api/positions.jsonl.gz | Alle open posities, één per regel, gecomprimeerd. Herbouwd na elke inzameling. |
/api/company/<slug> /api/company/reyuu-japan-inc | Eén onderneming: wie ze vandaag short verkoopt, en al haar meldingen sinds het begin. |
/api/fund/<slug> /api/fund/citadel-advisors-llc | Eén fonds: al zijn open posities, over alle registers heen. |
/api/moves /api/moves | Bewegingen van de laatste dertig dagen, benoemd: opening, increase, reduction, below_threshold. |
/api/isins /api/isins | Eén regel per aangemelde onderneming: haar ISIN en het adres van haar pagina. |
/api/openapi.json /api/openapi.json | Het contract als OpenAPI-document, om een client te genereren in plaats van deze pagina te lezen. |
/action/<slug>/positions.csv /action/reyuu-japan-inc/positions.csv | Een onderneming of een fonds: haar volledige meldingsgeschiedenis, als spreadsheet. Kolommen in de taal van het domein, scheidingsteken en codering die Excel leest. |
/action/<slug>/movements.xml /action/reyuu-japan-inc/movements.xml | Een onderneming of een fonds: haar bewegingen, als RSS-feed. |
/mcp https://www.quivad.be/mcp | De MCP-server: een assistent maakt er verbinding mee en leest de registers zelf. Alleen POST. |
Elke assistent die het Model Context Protocol spreekt kan deze registers zelf lezen: voeg er https://www.quivad.be/mcp aan toe. Vijf gereedschappen, die een onderneming of een fonds vinden, een van beide lezen, een markt rangschikken en opsommen wat er bewoog, en die net als de rest van dit oppervlak in het Engels antwoorden, zonder sleutel en onder dezelfde snelheidsgrens. De huidige revisie van het protocol en de drie ervoor worden op dat ene adres bediend; het aanvaardt alleen POST, dus het openen in een browser antwoordt 405 en zegt dat.
Een lang antwoord wordt geknipt door limit (standaard 1.000 regels, hoogstens 12.000) en offset. Het page-blok van het antwoord draagt het totaal en de adressen van de volgende en de vorige pagina: niets valt weg, alles is bereikbaar, en een onleesbare waarde valt terug op de standaard in plaats van te weigeren.
Boven 120 verzoeken per minuut krijgt een adres een 429 en de wachttijd. Een antwoord uit de cache telt niet mee: de grens stopt een leegtrekken, nooit een gebruik.
Geen versie in de adressen, omdat niets zal breken: een veld kan verschijnen, geen enkel verdwijnt of verandert van betekenis, en een adres verhuist niet.
Weigeringen
Een weigering is JSON zoals een antwoord, nooit een pagina: type, title, status en detail, in de vorm die RFC 9457 aan elke HTTP-API geeft. Het veld type verwijst naar een van de codes in deze sectie.
company-not-found- Geen onderneming antwoordt op dit adres. De lijst leeft op /api/isins.
fund-not-found- Geen fonds antwoordt op dit adres.
no-such-endpoint- Geen API-adres antwoordt hier.
method-not-allowed- Deze adressen zijn alleen-lezen: GET, HEAD en OPTIONS.
rate-limit-exceeded- Te veel verzoeken binnen de minuut. retry-after zegt hoe lang te wachten.
not-ready- Het dagbestand wordt nog gebouwd, met de wachttijd.
De gegevens komen uit de officiële publicaties van de toezichthouders en blijven onderworpen aan de voorwaarden die elk van hen stelt. De bekende licentie van elk register staat op de bronnenpagina. Bekijk de staat van de bronnen