Solicitar dados ou análise

Conte o que você precisava e não encontrou. As solicitações são lidas em uma revisão semanal e agrupadas com outras semelhantes. Os dados mais solicitados que as fontes públicas permitem fornecer são desenvolvidos primeiro.

Quando solicitar

Envie uma solicitação quando faltar um conjunto de dados, campo, empresa ou análise de que você precisa, ou quando uma resposta parecer errada. As pessoas usam o formulário; os agentes usam a API ou o servidor MCP. Ambos chegam à mesma fila, com os mesmos limites.

Todo estado vazio, sem cobertura ou de empresa desconhecida no terminal termina com um link Solicitar que preenche o formulário para você. A paleta de comandos também lista Solicitar dados ou análise.

Tipos

Tipo	Use para
`dataset`	Um conjunto de dados completo que não temos
`field`	Uma rubrica ou atributo
`analysis`	Um cálculo que você precisou fazer manualmente
`coverage`	Uma empresa, bolsa ou país que não cobrimos
`bug`	Uma resposta incorreta ou com falha
`other`	Qualquer outra coisa

Use o formulário

O formulário Solicitar dados ou análise pede o tipo, o que você precisa, o motivo (opcional) e uma empresa (opcional). Não inclua dados pessoais no texto.

Você recebe um identificador da solicitação imediatamente. Guarde-o para consultar o status depois.

Envie uma solicitação pela API

POST /v1/request-data aceita kind e want e, opcionalmente, why, company e endpoint_or_tool. Não exige chave e nunca é cobrado.

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

A resposta é 201, com o identificador da solicitação, o item de demanda ao qual ela foi incorporada, seu status e quantas pessoas já solicitaram:

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

Até 10 solicitações por endereço por dia UTC, 500 no total. Ao ultrapassar qualquer um dos limites, a resposta é 429 com Retry-After (consulte rate_limited). GET /v1/request-data descreve o corpo da requisição.

Envie uma solicitação por um agente

O servidor MCP tem duas ferramentas para isso: request_data envia uma solicitação com os mesmos campos, e request_status consulta uma solicitação pelo identificador. Respostas da API que não atendem à consulta incluem uma alternativa do tipo request_data, para que um agente nunca fique sem saída.

https://mcp.financial.md/mcp

Acompanhe o status

Solicitações semelhantes são agrupadas em um único item de demanda, identificado por tipo, empresa e conceito; uma solicitação repetida acrescenta um voto. Consulte uma solicitação na página de status ou com GET /v1/request-data/{id}:

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

Status	Significado
`new`	Recebido, ainda não analisado
`triaged`	Analisado e agrupado com solicitações semelhantes
`planned`	Pretendemos desenvolver
`done`	Desenvolvido; `served_by` indica a rota ou ferramenta que o disponibiliza
`wontfix`	Não vamos desenvolver; a nota pública explica o motivo

Solicitado e entregue

A página Solicitado e entregue lista os itens que uma pessoa da nossa equipe analisou e aos quais atribuiu um título, com suas contagens e resultados. Um item nunca é listado automaticamente. Ela mostra apenas dados agregados: sem identificação de quem enviou e sem o texto enviado. Os mesmos dados estão disponíveis em um feed JSON:

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

O registro de alterações contém um link para o painel, e cada item entregue indica o que o disponibiliza.

O que podemos desenvolver

Desenvolvemos a partir de fontes públicas gratuitas e de nossas próprias análises derivadas:

Documentos arquivados na SEC e conjuntos de dados do EDGAR (demonstrações financeiras, participações acionárias, eventos, fundos)
FRED e outras estatísticas públicas
Cálculos sobre os dados que já disponibilizamos (indicadores, filtros, comparações)

Dados que exigem licença ou cujos termos proíbem a reutilização, como estimativas de consenso, recomendações de analistas ou feeds de bolsas em tempo real, são marcados como wontfix com uma nota que aponta para GET /v1/coverage. Solicitações posteriores desses dados continuam contando como votos, para sabermos o que é desejado.

Privacidade

Uma solicitação não pede dados pessoais. O endereço de origem do envio é mantido apenas como um resumo criptográfico com salt, para aplicar os limites.

No momento, o formulário não pede um endereço de e-mail: acompanhe uma solicitação pelo seu id. Se futuramente houver a opção de informar um e-mail para resposta, ele será opcional, enviado apenas quando você marcar a caixa, mantido separado da solicitação, usado apenas para avisar quando a solicitação for entregue ou encerrada, excluído quando a solicitação for encerrada ou após 365 dias e nunca compartilhado. Veja Privacidade.