Richiedi dati o analisi

Dicci di cosa avevi bisogno e cosa non hai trovato. Le richieste vengono lette durante una revisione settimanale e unite a quelle simili; vengono resi disponibili prima i dati più richiesti che le fonti pubbliche consentono di ottenere.

Quando inviare una richiesta

Invia una richiesta quando manca un insieme di dati, un campo, una società o un'analisi di cui hai bisogno, oppure quando una risposta sembra errata. Le persone usano il modulo; gli agenti usano l'API o il server MCP. Entrambi confluiscono nella stessa coda, con gli stessi limiti.

Nel terminale, ogni stato vuoto, non coperto o relativo a una società sconosciuta termina con un link Richiedi che compila il modulo per te. Anche la tavolozza dei comandi include Richiedi dati o analisi.

Tipi

Tipo	Da usare per
`dataset`	Un intero insieme di dati che ci manca
`field`	Una singola voce o un attributo
`analysis`	Un calcolo che hai dovuto eseguire a mano
`coverage`	Una società, una borsa o un paese che non copriamo
`bug`	Una risposta errata o non funzionante
`other`	Qualsiasi altra cosa

Usa il modulo

Il modulo Richiedi dati o analisi chiede il tipo, ciò di cui hai bisogno, il motivo (facoltativo) e una società (facoltativa). Non includere dati personali nel testo.

Ricevi subito un identificativo della richiesta. Conservalo per consultarne lo stato in seguito.

Invia una richiesta tramite l'API

POST /v1/request-data accetta kind e want e, facoltativamente, why, company e endpoint_or_tool. Non richiede una chiave e non comporta mai addebiti.

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

La risposta è 201 con l'identificativo della richiesta, la voce di domanda a cui è stata associata, il suo stato e quante persone l'hanno richiesta finora:

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

Fino a 10 richieste per indirizzo per giorno UTC, 500 in totale. Superato uno dei due limiti, la risposta è 429 con Retry-After (vedi rate_limited). GET /v1/request-data descrive il corpo della richiesta.

Invia una richiesta tramite un agente

Il server MCP dispone di due strumenti per questo: request_data invia una richiesta con gli stessi campi e request_status ne consulta una tramite il suo identificativo. Le risposte dell'API che non soddisfano la richiesta includono un rimedio di tipo request_data, così un agente non resta mai bloccato.

https://mcp.financial.md/mcp

Segui lo stato della richiesta

Le richieste simili vengono unite in un'unica voce di domanda, identificata da tipo, società e concetto; una richiesta ripetuta aggiunge un voto. Consultane una nella pagina dello stato o con GET /v1/request-data/{id}:

curl "https://api.financial.md/v1/request-data/0b8f6a52-6f0e-4a8e-9a43-3c0f6b2d1e11"

Stato	Significato
`new`	Ricevuta, non ancora esaminata
`triaged`	Esaminata e accorpata a richieste simili
`planned`	Intendiamo realizzarla
`done`	Realizzata; `served_by` indica la route o lo strumento che la fornisce
`wontfix`	Non la realizzeremo; la nota pubblica ne spiega il motivo

Richieste e rilasci

La pagina Richieste e rilasci elenca le voci che una persona del nostro team ha esaminato e a cui ha assegnato un titolo, con i relativi conteggi ed esiti. Nessuna voce viene mai elencata automaticamente. Mostra solo dati aggregati: né l'autore né il testo inviato. Gli stessi dati sono disponibili come feed JSON:

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

Il registro delle modifiche rimanda alla bacheca e ogni voce rilasciata indica cosa la fornisce.

Cosa possiamo realizzare

Realizziamo funzionalità a partire da fonti pubbliche gratuite e dalle nostre analisi derivate:

Documenti depositati presso la SEC e set di dati di SEC EDGAR (prospetti finanziari, assetti proprietari, eventi, fondi)
FRED e altre statistiche pubbliche
Calcoli sui dati che già forniamo (indici, filtri di selezione, confronti)

I dati che richiedono una licenza o le cui condizioni vietano il riutilizzo, come le stime di consenso, i giudizi degli analisti o i flussi di dati di borsa in tempo reale, vengono contrassegnati come wontfix con una nota che rimanda a GET /v1/coverage. Le richieste successive per gli stessi dati continuano a contare come voti, così sappiamo cosa viene richiesto.

Privacy

Una richiesta non richiede dati personali. L'indirizzo da cui invii viene conservato solo come digest con salt, per applicare i limiti.

Al momento il modulo non richiede un indirizzo email: segui una richiesta tramite il suo id. Se in futuro verrà offerta un'email di risposta, sarà facoltativa, inviata solo se selezioni la casella, conservata separatamente dalla richiesta, usata solo per informarti quando la richiesta viene realizzata o chiusa, eliminata alla chiusura della richiesta o dopo 365 giorni e mai condivisa. Consulta la Privacy.