Przejdź do treści

Żądaj danych lub analizy

Powiedz nam, czego potrzebowałeś, a czego nie znalazłeś. Wnioski są czytane w cotygodniowym przeglądzie, łączone z podobnymi, a najczęściej żądane dane, na które pozwalają źródła publiczne, są tworzone jako pierwsze.

Kiedy poprosić

Wyślij prośbę, gdy brakuje potrzebnego Ci zbioru danych, pola, spółki lub analizy albo gdy odpowiedź wygląda na błędną. Ludzie korzystają z formularza; agenci używają API lub serwera MCP. Oba trafiają do tej samej kolejki, z tymi samymi limitami.

Każdy pusty, nieobjęty i nieznany stan firmy w terminalu kończy się linkiem Request it, który wypełnia formularz za Ciebie. Paleta poleceń również zawiera listę Request data lub analysis.

Rodzaje

ŻyczliweUżyj go do
datasetBrakuje nam całego zbioru danych
fieldJedna pozycja lub atrybut
analysisObliczenia, które trzeba było wykonać ręcznie
coverageFirmy, giełdy czy kraju, którego nie obsługujemy
bugBłędna lub zepsuta odpowiedź
otherCoś jeszcze

Użyj formularza

Formularz Request data lub analysis pyta o rodzaj, czego potrzebujesz, dlaczego (opcjonalnie) oraz firmę (opcjonalnie). Nie podawaj danych osobowych w tekście.

Dostajesz identyfikator żądania od razu. Zachowaj je, żeby później sprawdzić status.

Wyślij jedną z API

POST /v1/request-data przyjmuje kind i want, a opcjonalnie why, company i endpoint_or_tool. Nie potrzebuje klucza i nigdy nie jest ładowany.

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

Odpowiedź to 201 z identyfikatorem żądania, elementem popytu, do którego dołączył, jego statusem i ilością osób do tej pory zapytano:

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

Do 10 żądań na adres na UTC dzień, łącznie 500. Po obu limitach odpowiedź to 429 z Retry-After (patrz rate_limited). GET /v1/request-data opisuje treść ciała.

Wyślij od agenta

Agent wysyła żądanie za pomocą POST wywołania powyżej. Na serwerze MCP narzędzie request_status wyszukuje jedno z nich według jego identyfikatora. Nieodpowiedzi od API niosą pewne rozwiązanie request_data, więc agent nigdy nie utknie.

https://mcp.financial.md/mcp

Podążaj za jego statusem

Podobne prośby łączą się w jedną pozycję popytu, identyfikowaną według rodzaju, spółki i pozycji; ponowne zgłoszenie dodaje głos. Wyszukaj ją na stronie statusu lub przez GET /v1/request-data/{id}:

curl "https://api.financial.md/v1/request-data/0b8f6a52-6f0e-4a8e-9a43-3c0f6b2d1e11"
StatusZnaczenie
newOtrzymano, jeszcze nierecenzowane
triagedPrzejrzane i połączone z podobnymi prośbami
plannedZamierzamy ją zbudować
donezbudowany; served_by nazywa trasę lub narzędzie, które go obsługuje
wontfixNie zbudujemy go; notatka publiczna wyjaśnia dlaczego

Zamówione i wysłane

Strona Requested and send zawiera przedmioty, które osoba z naszej strony przejrzała i zatytułowała, wraz z ich liczbą i wynikami. Element nigdy nie jest automatycznie wyświetlany. Pokazuje jedynie zbiory: brak przesłania, brak przesłanego tekstu. Te same dane to JSON feed:

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

Dziennik zmian zawiera link do tablicy, a przy każdej wdrożonej pozycji wskazano, co ją obsługuje.

Co możemy zbudować

Budujemy na podstawie otwartych źródeł publicznych oraz naszej własnej analizy pochodnej:

  • SEC EDGAR zgłoszeń i zbiorów danych (wyciągi, własność, zdarzenia, fundusze)
  • FRED i inne publiczne statystyki
  • Obliczenia na podstawie danych, które już udostępniamy (stosunki, przesyłki, porównania)

Dane wymagające licencji lub których warunki zabraniają ponownego użycia, takie jak szacunki konsensusowe, oceny analityków czy strumienie wymiany w czasie rzeczywistym, są oznaczane wontfix notatką wskazującą na GET /v1/coverage. Późniejsze wnioski o nie nadal liczą się jako głosy, więc wiemy, czego się oczekuje.

Prywatność

Wniosek nie wymaga podania danych osobowych. Adres, z którego wysyłasz, jest przechowywany tylko jako solony skrót, aby zastosować limity.

Formularz obecnie nie prosi o adres e-mail: podążaj za żądaniem według jego identyfikatora. Jeśli odpowiedź zostanie dostarczona później, jest opcjonalna, wysyłana tylko po zaznaczeniu pola, oddzielona od żądania, używana tylko do informowania o wysłaniu lub zamknięciu zgłoszenia, usuwana po zamknięciu lub po 365 dniach i nigdy nie udostępniana. Zobacz Prywatność.