Demander des données ou une analyse

Quand faire une demande

Envoyez une demande lorsqu'un jeu de données, un champ, une entreprise ou une analyse dont vous avez besoin manque, ou lorsqu'une réponse semble erronée. Les utilisateurs passent par le formulaire ; les agents utilisent l'API ou le serveur MCP. Les deux alimentent la même file d'attente, avec les mêmes limites.

Dans le terminal, chaque état vide, non couvert ou d'entreprise inconnue se termine par un lien « Faire une demande » qui préremplit le formulaire pour vous. La palette de commandes propose aussi « Demander des données ou une analyse ».

Types

Utiliser le formulaire

Le formulaire Demander des données ou une analyse vous demande le type, ce dont vous avez besoin, la raison (facultative) et une entreprise (facultative). N'incluez pas de données personnelles dans le texte.

Vous recevez immédiatement un identifiant de demande. Conservez-le pour consulter le statut plus tard.

Envoyer une demande via l'API

POST /v1/request-data accepte kind et want, ainsi que, facultativement, why, company et endpoint_or_tool. Aucune clé n'est nécessaire et cet appel n'est jamais facturé.

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 réponse est 201 et contient l'identifiant de la demande, l'élément auquel elle a été rattachée, son statut et le nombre de demandes reçues jusqu'à présent :

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

Jusqu'à 10 demandes par adresse et par jour UTC, 500 au total. Au-delà de l'une ou l'autre limite, la réponse est 429 avec Retry-After (voir rate_limited). GET /v1/request-data décrit le corps de la requête.

Envoyer une demande depuis un agent

Le serveur MCP dispose de deux outils à cet effet : request_data envoie une demande avec les mêmes champs, et request_status consulte une demande à partir de son identifiant. Les réponses de l'API qui ne satisfont pas le besoin incluent une solution de type request_data, afin qu'un agent ne soit jamais bloqué.

https://mcp.financial.md/mcp

Suivre son statut

Les demandes similaires sont regroupées dans un même élément, identifié par le type, l'entreprise et le concept ; une demande répétée ajoute un vote. Consultez une demande sur la page de statut ou avec GET /v1/request-data/{id} :

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

Demandes et réalisations

La page Demandes et réalisations répertorie les éléments qu'une personne de notre équipe a examinés et auxquels elle a donné un titre, avec leur nombre de demandes et leur issue. Aucun élément n'est répertorié automatiquement. Elle n'affiche que des données agrégées : ni l'auteur de la demande, ni le texte soumis. Les mêmes données sont disponibles sous forme de flux JSON :

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

Le journal des modifications renvoie au tableau, et chaque élément réalisé indique ce qui permet d'y répondre.

Ce que nous pouvons réaliser

Nous nous appuyons sur des sources publiques gratuites et sur nos propres analyses dérivées :

• Dépôts auprès de la SEC (documents déposés) sur EDGAR et jeux de données (états financiers, actionnariat, événements, fonds)
• FRED et autres statistiques publiques
• Calculs sur les données que nous fournissons déjà (ratios, filtrages, comparaisons)

Les données qui nécessitent une licence ou dont les conditions interdisent la réutilisation, comme les estimations du consensus, les recommandations d'analystes ou les flux boursiers en temps réel, sont marquées wontfix avec une note renvoyant à GET /v1/coverage. Les demandes ultérieures pour ces données comptent toujours comme des votes, afin que nous sachions ce qui est souhaité.

Confidentialité

Une demande ne requiert aucune donnée personnelle. L'adresse depuis laquelle vous l'envoyez n'est conservée que sous forme d'empreinte salée, pour appliquer les limites.

Le formulaire ne demande actuellement aucune adresse e-mail : suivez une demande grâce à son identifiant. Si une réponse par e-mail est proposée ultérieurement, elle sera facultative, envoyée uniquement si vous cochez la case ; l'adresse sera conservée séparément de la demande, utilisée uniquement pour vous avertir de sa réalisation ou de sa clôture, supprimée à la clôture de la demande ou après 365 jours, et jamais partagée. Voir Confidentialité.