Hoppa till innehållet

Begär data eller analys

Berätta vad du behövde och inte hittade. Förfrågningar läses i en veckovis granskning, slås ihop med liknande data, och den mest efterfrågade data som offentliga källor tillåter byggs först.

När man ska begära

Skicka en förfrågan när en datamängd, ett fält, ett företag eller en analys du behöver saknas, eller när ett svar verkar fel. Folk använder formuläret; agenter använder API eller MCP -servern. Båda når samma kö, med samma gränser.

Varje tom, otäckt och okänd företagsstatus i terminalen slutar med en länk Be om det som fyller i formuläret åt dig. Kommandopaletten listar också Begär data eller analys.

Typer

SnälltAnvänd den till
datasetEn hel datamängd saknar vi
fieldEn radpost eller attribut
analysisEn beräkning du var tvungen att göra för hand
coverageEtt företag, en börs eller ett land som vi inte täcker
bugEtt fel eller trasigt svar
otherNågot annat

Använd formuläret

Formuläret Be om data eller analys frågar efter typ, vad du behöver, varför (valfritt) och ett företag (valfritt). Inkludera inte personuppgifter i texten.

Du får ett begäran-ID direkt. Behåll det för att kolla statusen senare.

Skicka en från API

POST /v1/request-data tar kind och want, och valfritt why, company och endpoint_or_tool. Den behöver ingen nyckel och debiteras aldrig.

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

Svaret är 201 med request-id, efterfrågeposten den gick med i, dess status och hur många som hittills frågats:

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

Upp till 10 förfrågningar per adress per UTC dag, totalt 500. Efter någon av gränserna är svaret 429 med Retry-After (se rate_limited). GET /v1/request-data beskriver kroppen.

Skicka en från en agent

En agent skickar en förfrågan med det POST samtalet ovan. På MCP -servern söker request_status -verktyget upp en via dess id. Ouppfyllda svar från API innehåller en slags lösning request_data, så en agent fastnar aldrig.

https://mcp.financial.md/mcp

Följ dess status

Liknande förfrågningar slås ihop till en efterfrågepunkt, kodad efter typ, företag och koncept; en upprepad förfrågan lägger till en röst. Slå upp en på statussida eller med GET /v1/request-data/{id}:

curl "https://api.financial.md/v1/request-data/0b8f6a52-6f0e-4a8e-9a43-3c0f6b2d1e11"
StatusBetydelse
newMottaget, inte recenserat än
triagedGranskade och sammanslagna med liknande önskemål
plannedVi tänker bygga den
doneByggt; served_by namnger rutten eller verktyget som betjänar den
wontfixVi kommer inte att bygga den; den offentliga notisen anger varför

Begärt och skickat

Sidan begärda och skickade listar de objekt som en person på vår sida har granskat och gett titlar, med deras antal och resultat. En vara listas aldrig automatiskt. Den visar endast aggregerade: ingen inskickad text, ingen inskickad text. Samma data är ett JSON flöde:

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

Den ändringsloggen länkar till tavlan, och varje skickat objekt namnger vad som används för det.

Vad vi kan bygga

Vi bygger på öppna offentliga källor och vår egen härledda analys:

  • SEC EDGAR inlämningar och datamängder (kontoutdrag, ägande, händelser, medel)
  • FRED och annan offentlig statistik
  • Beräkningar över den data vi redan tillhandahåller (förhållanden, skärmar, jämförelser)

Data som kräver licens eller vars villkor förbjuder återanvändning, såsom konsensusuppskattningar, analytikerbetyg eller realtidsutbytesflöden, markeras wontfix med en notering som pekar på GET /v1/coverage. Senare förfrågningar om det räknas fortfarande som röster, så vi vet vad som önskas.

Integritet

En begäran begär inga personuppgifter. Adressen du skickar från sparas endast som en saltad digest för att tillämpa begränsningarna.

Formuläret ber inte om en e-postadress för närvarande: följ en förfrågan med dess id. Om ett svarsmail erbjuds senare är det valfritt, skickat endast när du kryssar i rutan, hålls åtskilt från förfrågan, används endast för att meddela när förfrågan skickas eller stängs, raderas när förfrågan stängs eller efter 365 dagar, och delas aldrig. Se Integritet.