Ga naar inhoud

Vraag gegevens of analyse op

Vertel ons wat je nodig had en niet hebt gevonden. Verzoeken worden in een wekelijkse review gelezen, samengevoegd met soortgelijke, en de meest gevraagde data die publieke bronnen toestaan, worden eerst opgebouwd.

Wanneer te verzoeken

Stuur een verzoek wanneer een dataset, veld, bedrijf of analyse die je nodig hebt ontbreekt, of wanneer een antwoord verkeerd lijkt. Mensen gebruiken het -formulier; agenten gebruiken de API of de MCP server. Beide bereiken dezelfde wachtrij, met dezelfde limieten.

Elke lege, niet bedekte en onbekende bedrijfsstatus in de terminal eindigt met een Link 'Request it' die het formulier voor je invult. Het commandopalet vermeldt ook 'Request data of analysis'.

Soorten

VriendelijkGebruik het voor
datasetEen hele dataset die we missen
fieldEén regelitem of attribuut
analysisEen berekening die je met de hand moest doen
coverageEen bedrijf, beurs of land dat wij niet dekken
bugEen verkeerd of gebroken antwoord
otherNog iets anders

Gebruik het formulier

Het formulier Gegevens of analyse aanvragen vraagt naar het soort, wat je nodig hebt, waarom (optioneel) en een bedrijf (optioneel). Neem geen persoonsgegevens op in de tekst.

Je krijgt meteen een aanvraag-ID. Bewaar het om later de status op te zoeken.

Stuur er een van de API

POST /v1/request-data neemt kind en want, en optioneel why, company en endpoint_or_tool. Het heeft geen sleutel nodig en wordt nooit opgerekend.

curl -X POST "https://api.financial.md/v1/request-data" -H "content-type: application/json" \
  -d '{"kind":"dataset","want":"Segment operating margin by quarter","why":"Comparing business lines","company":"ticker:AAPL"}'

Het antwoord is 201 met de verzoek-id, het vraagitem dat het heeft toegevoegd, de status en hoeveel er tot nu toe zijn gevraagd:

{
  "data": {
    "request_id": "0b8f6a52-6f0e-4a8e-9a43-3c0f6b2d1e11",
    "item_id": "7c2e0d4b-31a9-4f57-9a3e-5d0b8c1f2a64",
    "status": "new",
    "requests": 3,
    "requesters": 2,
    "status_url": "https://api.financial.md/v1/request-data/0b8f6a52-6f0e-4a8e-9a43-3c0f6b2d1e11",
    "served_by": null
  },
  "meta": { ... }
}

Tot 10 verzoeken per adres per UTC dag, in totaal 500. Voorbij beide limieten is het antwoord 429 met Retry-After (zie rate_limited). GET /v1/request-data beschrijft het lichaam.

Stuur er een van een agent

Een agent stuurt een verzoek met de bovenstaande POST oproep. Op de MCP server zoekt de request_status tool een op via zijn id. Onbeantwoorde antwoorden van de API bevatten een soort oplossing request_data, dus een agent zit nooit vast.

https://mcp.financial.md/mcp

Volg de status ervan

Vergelijkbare verzoeken worden samengevoegd tot één verzoekitem, gecodeerd op soort, bedrijf en concept; een herhaalde aanvraag voegt een stem toe. Zoek er een op op de statuspagina of met GET /v1/request-data/{id}:

curl "https://api.financial.md/v1/request-data/0b8f6a52-6f0e-4a8e-9a43-3c0f6b2d1e11"
StatusBetekenis
newOntvangen, nog niet beoordeeld
triagedBeoordeeld en samengevoegd met soortgelijke verzoeken
plannedWe zijn van plan het te bouwen
doneGebouwd; served_by noemt de route of het gereedschap dat het bedient
wontfixWe zullen het niet bouwen; de openbare notitie zegt waarom

Aangevraagd en verzonden

De pagina Aangevraagd en verzonden vermeldt de items die iemand aan onze kant heeft beoordeeld en getiteld, met hun aantallen en uitkomst. Een item wordt nooit automatisch vermeld. Het toont alleen aggregaties: geen indiener, geen ingediende tekst. Dezelfde data is een JSON feed:

curl "https://api.financial.md/v1/requested"

De changelog links naar het bord, en elk verzonden item noemt wat het bedient.

Wat we kunnen bouwen

We bouwen voort uit open publieke bronnen en onze eigen afgeleide analyse:

  • SEC EDGAR aangiften en datasets (afschriften, eigendom, gebeurtenissen, fondsen)
  • FRED en andere openbare statistieken
  • Berekeningen over de data die we al bedienen (verhoudingen, schermen, vergelijkingen)

Data die een licentie vereist of waarvan de voorwaarden hergebruik verbieden, zoals consensusschattingen, analistenbeoordelingen of realtime uitwisselingsfeeds, worden wontfix gemarkeerd met een notitie die wijst naar GET /v1/coverage. Latere verzoeken tellen nog steeds als stemmen, dus we weten wat gewenst wordt.

Privacy

Een verzoek vraagt om geen persoonlijke gegevens. Het adres waar je vanaf stuurt wordt alleen bewaard als een gezouten digest om de limieten toe te passen.

Het formulier vraagt momenteel niet om een e-mailadres: volg een verzoek op het id. Als er later een antwoordmail wordt aangeboden, is deze optioneel, alleen verzonden wanneer je het vakje aanvinkt, apart van het verzoek, alleen gebruikt om je te informeren wanneer het verzoek wordt verzonden of gesloten, verwijderd wanneer het verzoek wordt gesloten of na 365 dagen, en nooit gedeeld. Zie Privacy.