डेटा या विश्लेषण का अनुरोध करें

अनुरोध कब करें

जब आपकी ज़रूरत का कोई डेटासेट, फ़ील्ड, कंपनी या विश्लेषण उपलब्ध न हो, या कोई उत्तर गलत लगे, तो अनुरोध भेजें। लोग फ़ॉर्म का उपयोग करते हैं; एजेंट API या MCP सर्वर का उपयोग करते हैं। दोनों एक ही कतार में पहुँचते हैं और उन पर समान सीमाएँ लागू होती हैं।

टर्मिनल में हर खाली, कवरेज से बाहर और अज्ञात कंपनी की स्थिति के अंत में “इसका अनुरोध करें” लिंक होता है, जो आपके लिए फ़ॉर्म भर देता है। कमांड पैलेट में “डेटा या विश्लेषण का अनुरोध करें” भी सूचीबद्ध है।

प्रकार

फ़ॉर्म का उपयोग करें

डेटा या विश्लेषण का अनुरोध करें फ़ॉर्म में प्रकार, आपको क्या चाहिए, क्यों चाहिए (वैकल्पिक) और कंपनी (वैकल्पिक) पूछे जाते हैं। पाठ में व्यक्तिगत डेटा शामिल न करें।

आपको तुरंत अनुरोध की आईडी मिलती है। बाद में स्थिति देखने के लिए इसे संभालकर रखें।

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

प्रति पते प्रति UTC दिन अधिकतम 10 अनुरोध, कुल 500। किसी भी सीमा को पार करने पर उत्तर 429 होता है और साथ में Retry-After मिलता है (rate_limited देखें)। GET /v1/request-data बॉडी का विवरण देता है।

एजेंट से अनुरोध भेजें

MCP सर्वर में इसके लिए दो टूल हैं: request_data उन्हीं फ़ील्ड के साथ अनुरोध भेजता है, और request_status उसकी आईडी से उसे खोजता है। API से मिलने वाले ऐसे उत्तर जो माँग पूरी नहीं करते, उनमें request_data प्रकार का समाधान होता है, इसलिए एजेंट कभी अटकता नहीं है।

https://mcp.financial.md/mcp

इसकी स्थिति देखें

मिलते-जुलते अनुरोध एक माँग मद में जुड़ जाते हैं, जिसकी पहचान प्रकार, कंपनी और अवधारणा से होती है; दोहराया गया अनुरोध एक वोट जोड़ता है। इसे स्थिति पृष्ठ पर या GET /v1/request-data/{id} से देखें:

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

अनुरोधित और उपलब्ध कराए गए

अनुरोधित और उपलब्ध कराए गए पेज पर वे मदें उनकी गिनती और परिणाम के साथ सूचीबद्ध हैं, जिनकी हमारी टीम के किसी व्यक्ति ने समीक्षा की है और शीर्षक दिया है। कोई मद कभी भी अपने-आप सूचीबद्ध नहीं होती। इसमें केवल समेकित जानकारी दिखाई जाती है: न अनुरोध भेजने वाला, न भेजा गया पाठ। यही डेटा एक JSON फ़ीड के रूप में भी उपलब्ध है:

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

परिवर्तन लॉग में बोर्ड का लिंक है, और हर उपलब्ध कराई गई मद बताती है कि उसे कौन उपलब्ध कराता है।

हम क्या बना सकते हैं

हम निःशुल्क सार्वजनिक स्रोतों और अपने स्वयं के व्युत्पन्न विश्लेषण से बनाते हैं:

• SEC EDGAR फाइलिंग और डेटा सेट (वित्तीय विवरण, स्वामित्व, घटनाएँ, फंड)
• FRED और अन्य सार्वजनिक आँकड़े
• हम पहले से जो डेटा उपलब्ध कराते हैं, उस पर गणनाएँ (अनुपात, स्क्रीन, तुलनाएँ)

जिस डेटा के लिए लाइसेंस चाहिए या जिसकी शर्तें पुनः उपयोग की अनुमति नहीं देतीं, जैसे सर्वसम्मति अनुमान, विश्लेषक रेटिंग या रियल-टाइम एक्सचेंज फ़ीड, उसे wontfix चिह्नित किया जाता है और साथ में GET /v1/coverage की ओर निर्देशित करने वाली टिप्पणी दी जाती है। इसके लिए बाद में आने वाले अनुरोध भी वोट के रूप में गिने जाते हैं, ताकि हमें पता रहे कि किसकी माँग है।

गोपनीयता

अनुरोध में कोई व्यक्तिगत डेटा नहीं माँगा जाता। सीमाएँ लागू करने के लिए, जिस पते से आप भेजते हैं उसे केवल सॉल्टेड डाइजेस्ट के रूप में रखा जाता है।

फ़ॉर्म अभी ईमेल पता नहीं माँगता: अनुरोध को उसकी id से ट्रैक करें। यदि बाद में जवाब पाने के लिए ईमेल का विकल्प दिया जाता है, तो वह वैकल्पिक होगा, केवल आपके बॉक्स पर टिक करने पर भेजा जाएगा, अनुरोध से अलग रखा जाएगा, केवल अनुरोध उपलब्ध होने या बंद होने की सूचना देने के लिए इस्तेमाल होगा, अनुरोध बंद होने पर या 365 दिनों के बाद हटा दिया जाएगा और कभी साझा नहीं किया जाएगा। गोपनीयता देखें।