Yêu cầu dữ liệu hoặc phân tích
Hãy cho chúng tôi biết bạn cần gì và chưa tìm thấy gì. Các yêu cầu được đọc trong một đợt đánh giá hàng tuần, hợp nhất với các yêu cầu tương tự, và dữ liệu được yêu cầu nhiều nhất mà các nguồn công khai cho phép sẽ được xây dựng trước.
Khi nào nên yêu cầu
Gửi yêu cầu khi thiếu bộ dữ liệu, trường, công ty hoặc phân tích bạn cần, hoặc khi một câu trả lời trông có vẻ sai. Mọi người dùng biểu mẫu; agent dùng API hoặc máy chủ MCP. Cả hai đều vào cùng một hàng đợi, với cùng các giới hạn.
Mỗi trạng thái công ty trống, chưa được che phủ và không xác định trong terminal đều kết thúc bằng liên kết Yêu cầu để điền vào biểu mẫu cho bạn. Bảng lệnh cũng liệt kê Yêu cầu dữ liệu hoặc phân tích.
Các loại
| Tốt bụng | Dùng nó cho |
|---|---|
dataset | Một bộ dữ liệu mà chúng ta còn thiếu |
field | Một dòng hoặc thuộc tính |
analysis | Một phép tính bạn phải thực hiện bằng tay |
coverage | Một công ty, sàn giao dịch hoặc quốc gia mà chúng tôi không bao phủ |
bug | Một câu trả lời sai hoặc bị hỏng |
other | Bất cứ điều gì khác |
Sử dụng biểu mẫu
Biểu mẫu Yêu cầu dữ liệu hoặc phân tích yêu cầu loại, những gì bạn cần, lý do (tùy chọn) và công ty (tùy chọn). Không bao gồm dữ liệu cá nhân trong văn bản.
Bạn sẽ nhận được mã yêu cầu ngay lập tức. Giữ lại để tra cứu tình trạng sau.
Gửi một cái từ API
POST /v1/request-data cần kind và want, và tùy chọn why, company và endpoint_or_tool. Nó không cần chìa khóa và không bao giờ được sạc.
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"}'Câu trả lời là 201 với mã yêu cầu, mục yêu cầu mà nó tham gia, trạng thái và số lượng người đã hỏi cho đến nay:
{
"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": { ... }
}Tối đa 10 yêu cầu cho mỗi địa chỉ mỗi UTC ngày, tổng cộng 500. Vượt quá một trong hai giới hạn, câu trả lời là 429 với Retry-After (xem rate_limited). GET /v1/request-data mô tả cơ thể.
Gửi một thư từ đại lý
Một agent gửi yêu cầu với cuộc gọi POST ở trên. Trên máy chủ MCP , công cụ request_status tra cứu theo id của nó. Các câu trả lời chưa được trả lời từ API mang theo một cách khắc phục kiểu request_data, nên agent không bao giờ bị kẹt.
https://mcp.financial.md/mcpTheo dõi tình trạng của nó
Các yêu cầu tương tự được gộp thành một mục nhu cầu, định danh theo loại, công ty và khái niệm; một yêu cầu lặp lại sẽ thêm một phiếu bầu. Tra cứu trên trang trạng thái hoặc bằng GET /v1/request-data/{id}:
curl "https://api.financial.md/v1/request-data/0b8f6a52-6f0e-4a8e-9a43-3c0f6b2d1e11"| Tình trạng | Ý nghĩa |
|---|---|
new | Đã nhận, chưa được xem xét |
triaged | Đã xem xét và hợp nhất với các yêu cầu tương tự |
planned | Chúng tôi dự định xây dựng nó |
done | Xây dựng; served_by nêu tên tuyến đường hoặc công cụ phục vụ nó |
wontfix | Chúng ta sẽ không xây dựng nó; ghi chú công khai nói lý do |
Đã yêu cầu và gửi đi
Trang Yêu cầu và gửi liệt kê các mặt hàng mà một người bên chúng tôi đã xem xét và đặt tiêu đề, kèm theo số lượng và kết quả của chúng. Một mặt hàng không bao giờ được liệt kê tự động. Nó chỉ hiển thị tổng hợp: không có người gửi, không có văn bản gửi. Dữ liệu tương tự là nguồn cấp JSON :
curl "https://api.financial.md/v1/requested"Nhật ký thay đổi liên kết đến bảng, và mỗi mục đã phát hành nêu rõ phần nào phục vụ mục đó.
Những gì chúng ta có thể xây dựng
Chúng tôi xây dựng dựa trên các nguồn công khai mở và phân tích do chính chúng tôi phát sinh:
- SEC EDGAR hồ sơ và bộ dữ liệu (báo cáo, quyền sở hữu, sự kiện, quỹ)
- FRED và các thống kê công cộng khác
- Tính toán trên dữ liệu mà chúng tôi đã phục vụ (tỷ lệ, màn hình, so sánh)
Dữ liệu cần có giấy phép hoặc các điều khoản cấm tái sử dụng, như ước tính đồng thuận, xếp hạng nhà phân tích hoặc nguồn trao đổi thời gian thực, được đánh dấu wontfix bằng một ghi chú chỉ về GET /v1/coverage. Các yêu cầu sau này vẫn được tính là phiếu bầu, vì vậy chúng ta biết mình muốn gì.
Quyền riêng tư
Yêu cầu không yêu cầu dữ liệu cá nhân. Địa chỉ bạn gửi chỉ được lưu dưới dạng bản tóm tắt muối, để áp dụng giới hạn.
Hiện tại biểu mẫu không yêu cầu địa chỉ email: hãy theo dõi một yêu cầu bằng id của nó. Nếu sau này có tùy chọn email phản hồi, đó là tùy chọn, chỉ được gửi khi bạn tích vào ô, được lưu tách biệt khỏi yêu cầu, chỉ dùng để báo cho bạn khi yêu cầu được phát hành hoặc đóng, bị xóa khi yêu cầu đóng hoặc sau 365 ngày, và không bao giờ được chia sẻ. Xem Quyền riêng tư.