Zum Inhalt springen

Daten oder Analyse anfordern

Teilen Sie uns mit, was Sie benötigt und nicht gefunden haben. Anfragen werden wöchentlich geprüft und mit ähnlichen Anfragen zusammengeführt. Die am häufigsten angeforderten Daten, die sich aus öffentlichen Quellen bereitstellen lassen, werden zuerst umgesetzt.

Wann Sie eine Anfrage stellen sollten

Senden Sie eine Anfrage, wenn ein benötigter Datensatz, ein Feld, ein Unternehmen oder eine Analyse fehlt oder wenn eine Antwort falsch erscheint. Menschen verwenden das Formular; Agenten verwenden die API oder den MCP-Server. Beide gelangen in dieselbe Warteschlange und unterliegen denselben Limits.

Jede Anzeige im Terminal für leere Ergebnisse, nicht abgedeckte oder unbekannte Unternehmen endet mit einem Link „Anfordern“, der das Formular für Sie ausfüllt. Die Befehlspalette enthält ebenfalls „Daten oder Analyse anfordern“.

Arten

ArtVerwendungszweck
datasetEin vollständiger Datensatz, der uns fehlt
fieldEin einzelner Posten oder ein Attribut
analysisEine Berechnung, die Sie von Hand durchführen mussten
coverageEin Unternehmen, eine Börse oder ein Land, das wir nicht abdecken
bugEine falsche oder fehlerhafte Antwort
otherAlles andere

Das Formular verwenden

Das Formular Daten oder Analyse anfordern fragt nach der Art, Ihrem Bedarf, dem Grund (optional) und einem Unternehmen (optional). Geben Sie im Text keine personenbezogenen Daten an.

Sie erhalten sofort eine Anfrage-ID. Bewahren Sie sie auf, um später den Status abzufragen.

Eine Anfrage über die API senden

POST /v1/request-data nimmt kind und want sowie optional why, company und endpoint_or_tool entgegen. Dafür ist kein Schlüssel erforderlich, und es fallen niemals Gebühren an.

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"}'

Die Antwort ist 201 mit der Anfrage-ID, dem Bedarfseintrag, dem die Anfrage zugeordnet wurde, seinem Status und der Anzahl der bisherigen Anfragen:

{
  "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": { ... }
}

Bis zu 10 Anfragen pro Adresse und UTC-Tag, insgesamt 500. Wird eines der beiden Limits überschritten, lautet die Antwort 429 mit Retry-After (siehe rate_limited). GET /v1/request-data beschreibt den Anfragetext.

Eine Anfrage über einen Agenten senden

Der MCP-Server bietet dafür zwei Tools: request_data sendet eine Anfrage mit denselben Feldern, und request_status ruft eine Anfrage anhand ihrer ID ab. API-Antworten, die den Bedarf nicht erfüllen, enthalten eine Abhilfemöglichkeit der Art request_data, sodass ein Agent nie ohne nächsten Schritt bleibt.

https://mcp.financial.md/mcp

Den Status verfolgen

Ähnliche Anfragen werden zu einem Bedarfseintrag zusammengeführt, dessen Schlüssel aus Art, Unternehmen und Konzept besteht; eine wiederholte Anfrage fügt eine Stimme hinzu. Rufen Sie einen Eintrag auf der Statusseite oder mit GET /v1/request-data/{id} ab:

curl "https://api.financial.md/v1/request-data/0b8f6a52-6f0e-4a8e-9a43-3c0f6b2d1e11"
StatusBedeutung
newEingegangen, noch nicht geprüft
triagedGeprüft und mit ähnlichen Anfragen zusammengeführt
plannedWir beabsichtigen, dies umzusetzen
doneUmgesetzt; served_by nennt die Route oder das Tool, das die Funktion bereitstellt
wontfixWir werden dies nicht umsetzen; der öffentliche Hinweis erklärt den Grund

Angefragt und bereitgestellt

Die Seite Angefragt und bereitgestellt listet die Einträge auf, die eine Person auf unserer Seite geprüft und mit einem Titel versehen hat, einschließlich der jeweiligen Anzahl und des Ergebnisses. Ein Eintrag wird niemals automatisch aufgelistet. Angezeigt werden nur aggregierte Angaben: weder der Absender noch der eingereichte Text. Dieselben Daten sind als JSON-Feed verfügbar:

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

Das Änderungsprotokoll verlinkt auf die Übersicht, und jeder bereitgestellte Eintrag nennt, wodurch er bereitgestellt wird.

Was wir umsetzen können

Wir entwickeln auf Grundlage kostenloser öffentlicher Quellen und unserer eigenen daraus abgeleiteten Analysen:

  • Einreichungen bei der SEC (eingereichte Dokumente) und Datensätze aus SEC EDGAR (Finanzberichte, Beteiligungsverhältnisse, Ereignisse, Fonds)
  • FRED und andere öffentliche Statistiken
  • Berechnungen auf Basis der bereits von uns bereitgestellten Daten (Kennzahlen, Screening, Vergleiche)

Daten, die eine Lizenz erfordern oder deren Nutzungsbedingungen eine Weiterverwendung untersagen, etwa Konsensschätzungen, Analystenbewertungen oder Echtzeit-Börsendatenfeeds, werden mit wontfix und einem Hinweis auf GET /v1/coverage gekennzeichnet. Spätere Anfragen dazu zählen weiterhin als Stimmen, damit wir wissen, was gewünscht wird.

Datenschutz

Bei einer Anfrage werden keine personenbezogenen Daten abgefragt. Die Adresse, von der aus Sie senden, wird nur als Hashwert mit Salt gespeichert, um die Limits durchzusetzen.

Das Formular fragt derzeit nicht nach einer E-Mail-Adresse: Verfolgen Sie eine Anfrage anhand ihrer ID. Falls später eine Antwort per E-Mail angeboten wird, ist diese optional und wird nur versendet, wenn Sie das Kästchen aktivieren. Die E-Mail-Adresse wird getrennt von der Anfrage gespeichert, nur verwendet, um Sie über die Umsetzung oder den Abschluss der Anfrage zu informieren, beim Abschluss der Anfrage oder nach 365 Tagen gelöscht und niemals weitergegeben. Siehe Datenschutz.