데이터 또는 분석 요청

필요했지만 찾지 못한 내용을 알려주세요. 요청은 매주 검토하며 유사한 요청과 통합합니다. 공개 출처에서 확보할 수 있는 데이터 중 요청이 가장 많은 데이터부터 구축합니다.

요청이 필요한 경우

필요한 데이터셋, 필드, 기업 또는 분석이 없거나 답변이 잘못된 것 같으면 요청을 보내주세요. 사용자는 양식을, 에이전트는 API 또는 MCP 서버를 이용합니다. 두 방식 모두 같은 대기열로 전달되며 동일한 한도가 적용됩니다.

터미널에서 데이터가 비어 있거나, 제공 범위에 없거나, 알 수 없는 기업으로 표시되는 모든 상태에는 양식을 자동으로 채워주는 요청하기 링크가 마지막에 표시됩니다. 명령 팔레트에도 데이터 또는 분석 요청이 표시됩니다.

유형

유형	용도
`dataset`	현재 제공하지 않는 전체 데이터셋
`field`	개별 항목 또는 속성
`analysis`	직접 수행해야 했던 계산
`coverage`	현재 제공 범위에 없는 기업, 거래소 또는 국가
`bug`	잘못되거나 정상 작동하지 않는 답변
`other`	그 외 모든 사항

양식으로 요청

데이터 또는 분석 요청 양식에는 유형, 필요한 내용, 이유(선택 사항), 기업(선택 사항)을 입력합니다. 본문에 개인정보를 포함하지 마세요.

요청 ID가 즉시 발급됩니다. 나중에 상태를 조회할 수 있도록 보관하세요.

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이며, 요청 ID, 요청이 통합된 수요 항목, 해당 항목의 상태 및 현재까지의 요청 수를 포함합니다:

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

UTC 기준 하루에 주소당 최대 10건, 전체 최대 500건까지 요청할 수 있습니다. 어느 한도든 초과하면 Retry-After가 포함된 429 응답이 반환됩니다(rate_limited 참조). GET /v1/request-data에서 본문 형식을 설명합니다.

에이전트에서 요청 전송

MCP 서버에는 이를 위한 두 가지 도구가 있습니다. request_data는 동일한 필드로 요청을 보내고, request_status는 ID로 요청을 조회합니다. 요구를 충족하지 못한 API 응답에는 request_data 유형의 해결 방법이 포함되므로 에이전트는 다음 단계를 진행할 수 있습니다.

https://mcp.financial.md/mcp

상태 확인

유사한 요청은 유형, 기업, 개념을 키로 하는 하나의 수요 항목으로 통합되며, 반복 요청은 1표를 추가합니다. 상태 페이지 또는 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를 안내하는 메모가 붙습니다. 이후 같은 데이터에 대한 요청도 투표로 집계되므로, 어떤 데이터에 수요가 있는지 파악할 수 있습니다.

개인정보 보호

요청 시 개인정보를 요구하지 않습니다. 요청을 보내는 주소는 제한을 적용하기 위해 솔트를 적용한 해시값으로만 보관됩니다.

현재 양식에서는 이메일 주소를 요구하지 않습니다. 요청 id로 진행 상황을 확인하세요. 향후 회신 이메일 기능이 제공되더라도 선택 사항이며, 체크박스를 선택한 경우에만 이메일이 전송됩니다. 이메일 주소는 요청과 별도로 보관되고, 요청한 기능이 출시되거나 요청이 종료될 때 알리는 용도로만 사용되며, 요청 종료 시 또는 365일 후 삭제되고, 절대 공유되지 않습니다. 개인정보 보호를 참조하세요.