Solicitar datos o análisis

Dinos qué necesitabas y no encontraste. Las solicitudes se leen en una revisión semanal, se agrupan con otras similares y se desarrollan primero los datos más solicitados que permiten las fuentes públicas.

Cuándo enviar una solicitud

Envía una solicitud cuando falte un conjunto de datos, un campo, una empresa o un análisis que necesites, o cuando una respuesta parezca incorrecta. Las personas usan el formulario; los agentes usan la API o el servidor MCP. Ambos llegan a la misma cola, con los mismos límites.

Todos los estados de datos vacíos, sin cobertura o de empresa desconocida en el terminal terminan con un enlace Solicitar que rellena el formulario por ti. La paleta de comandos también incluye Solicitar datos o análisis.

Tipos

Tipo	Úsalo para
`dataset`	Un conjunto de datos completo que nos falta
`field`	Una partida o un atributo
`analysis`	Un cálculo que tuviste que hacer a mano
`coverage`	Una empresa, bolsa o país que no cubrimos
`bug`	Una respuesta incorrecta o que no funciona
`other`	Cualquier otra cosa

Usar el formulario

El formulario Solicitar datos o análisis pide el tipo, lo que necesitas, el motivo (opcional) y una empresa (opcional). No incluyas datos personales en el texto.

Recibes un identificador de solicitud al instante. Guárdalo para consultar el estado más adelante.

Enviar una solicitud desde la API

POST /v1/request-data acepta kind y want, y opcionalmente why, company y endpoint_or_tool. No necesita clave y nunca se cobra.

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 respuesta es 201 e incluye el identificador de solicitud, el elemento de demanda al que se ha añadido, su estado y cuántas personas lo han solicitado hasta ahora:

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

Hasta 10 solicitudes por dirección y día UTC, 500 en total. Si se supera cualquiera de los límites, la respuesta es 429 con Retry-After (consulta rate_limited). GET /v1/request-data describe el cuerpo.

Enviar una solicitud desde un agente

El servidor MCP tiene dos herramientas para esto: request_data envía una solicitud con los mismos campos y request_status consulta una por su identificador. Las respuestas de la API que no satisfacen lo solicitado incluyen una solución de tipo request_data, de modo que un agente nunca se queda bloqueado.

https://mcp.financial.md/mcp

Seguir su estado

Las solicitudes similares se agrupan en un único elemento de demanda, identificado por tipo, empresa y concepto; una solicitud repetida añade un voto. Consulta uno en la página de estado o con GET /v1/request-data/{id}:

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

Estado	Significado
`new`	Recibido, aún no revisado
`triaged`	Revisado y agrupado con solicitudes similares
`planned`	Tenemos previsto desarrollarlo
`done`	Desarrollado; `served_by` indica la ruta o herramienta que lo proporciona
`wontfix`	No lo desarrollaremos; la nota pública explica el motivo

Solicitado y entregado

La página Solicitado y entregado enumera los elementos que una persona de nuestro equipo ha revisado y titulado, con sus recuentos y resultados. Ningún elemento se publica automáticamente. Solo muestra datos agregados: ni quién lo envió ni el texto enviado. Los mismos datos están disponibles en un feed JSON:

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

El registro de cambios enlaza al tablero, y cada elemento entregado indica qué lo proporciona.

Qué podemos desarrollar

Desarrollamos a partir de fuentes públicas gratuitas y de nuestros propios análisis derivados:

Presentaciones ante la SEC (documentos presentados) y conjuntos de datos de SEC EDGAR (estados financieros, participaciones accionariales, eventos, fondos)
FRED y otras estadísticas públicas
Cálculos sobre los datos que ya proporcionamos (ratios, filtros, comparaciones)

Los datos que requieren una licencia o cuyas condiciones prohíben su reutilización, como las estimaciones de consenso, las recomendaciones de analistas o los flujos de datos bursátiles en tiempo real, se marcan como wontfix con una nota que remite a GET /v1/coverage. Las solicitudes posteriores de esos datos siguen contando como votos, para que sepamos qué se desea.

Privacidad

Una solicitud no requiere datos personales. La dirección desde la que la envías se conserva únicamente como un resumen criptográfico con sal, para aplicar los límites.

El formulario no pide una dirección de correo electrónico por ahora: sigue una solicitud mediante su id. Si más adelante se ofrece una respuesta por correo electrónico, será opcional, se enviará solo cuando marques la casilla, la dirección se conservará separada de la solicitud, se usará solo para avisarte cuando se implemente o cierre la solicitud, se eliminará cuando se cierre la solicitud o después de 365 días, y nunca se compartirá. Consulta Privacidad.