Перейти к содержанию

Запрос данных или анализ

Расскажите, что вам было нужно, а что нет. Запросы читаются в еженедельном обзоре, объединяются с похожими, и сначала формируются наиболее запрашиваемые данные, которые публичные источники допускают.

Когда задавать запрос

Отправьте запрос, если нужный вам набор данных, поле, компания или анализ отсутствуют либо если ответ выглядит неверным. Люди используют форму; агенты используют API или MCP server. И то и другое попадает в одну и ту же очередь с одинаковыми ограничениями.

Каждое пустое, не покрытое и неизвестное состояние компании в терминале заканчивается ссылкой Запросить, которая заполняет форму за вас. В палитре команд также отображаются данные Запрос или анализ.

Виды

KindИспользуйте его для
datasetЦелый набор данных, которого нам не хватает
fieldОдин строчный элемент или атрибут
analysisВычисление, которое нужно было делать вручную
coverageКомпания, биржа или страна, которые мы не обслуживаем
bugНеправильный или сломанный ответ
otherВсё остальное

Используйте форму

Форма Запрос данных или анализа спрашивает, какой тип, что вам нужно, почему (необязательно) и компанию (по желанию). Не включайте личные данные в текст.

Вы сразу получаете идентификатор запроса. Оставьте его, чтобы потом проверить статус.

Отправьте один из API

POST /v1/request-data принимает kind и want, а также по желанию why, company и endpoint_or_tool. Он не требует ключа и никогда не заряжается.

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

Ответ — 201 с идентификатором запроса, элементом спроса, к которому он присоединился, его статусом и тем, сколько заданных на данный момент:

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

До 10 запросов на адрес в UTC день, всего 500. После любого из ограничений ответ — 429 с Retry-After (см. rate_limited). GET /v1/request-data описывает основное тело.

Отправьте сообщение от агента

Агент отправляет запрос с помощью POST вызова выше. На сервере MCP инструмент request_status ищет его по идентификатору. Невыполненные ответы из API содержат своего рода решение request_data, поэтому агент никогда не застревает.

https://mcp.financial.md/mcp

Следите за его статусом

Похожие запросы объединяются в один элемент спроса с ключом по kind, company и concept; повторный запрос добавляет голос. Посмотреть его можно на странице статуса или через GET /v1/request-data/{id}:

curl "https://api.financial.md/v1/request-data/0b8f6a52-6f0e-4a8e-9a43-3c0f6b2d1e11"
СтатусЗначение
newПолучено, пока не рассмотрено
triagedРассмотрено и объединено с похожими запросами
plannedМы намерены её построить
doneПостроен; served_by называет маршрут или инструмент, который его обслуживает
wontfixМы не будем её строить; публичная заметка объясняет почему

Запрос и отправка

На странице Запрос и отправка перечислены товары, которые человек с нашей стороны проверил и назвал, с их количеством и результатом. Товар никогда не отображается автоматически. Показывается только агрегаты: нет отправителя, нет отправленного текста. Те же данные — это лента JSON :

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

Журнал изменений ссылается на доску, и в каждом выпущенном элементе указано, что его обслуживает.

Что мы можем построить

Мы строим на основе открытых публичных источников и собственного анализа:

  • SEC EDGAR документы и наборы данных (отчеты, владение, события, средства)
  • FRED и другие публичные статистические данные
  • Вычисления по уже представленным данным (соотношения, экраны, сравнения)

Данные, требующие лицензии или условия которых запрещают повторное использование, такие как консенсусные оценки, рейтинги аналитиков или потоки обмена в реальном времени, помечаются wontfix заметкой, указывающей на GET /v1/coverage. Последующие запросы всё равно считаются голосами, так что мы знаем, что нужно.

Конфиденциальность

Запрос не требует предоставить персональные данные. Адрес, с которого вы отправляете, хранится только в виде солёного дайджеста, чтобы применить лимиты.

В данный момент форма не запрашивает адрес электронной почты: следуйте за запросом по его идентификатору. Если ответное письмо будет предложено позже, оно является необязательным, отправляется только при выполнении галочки, отделяется от запроса, используется только для сообщения о отправке или закрытии запроса, удаляется после закрытия запроса или после 365 дней, и никогда не распространяется. См. Конфиденциальность.