مواد پر جائیں

ڈیٹا یا تجزیہ کی درخواست کریں

ہمیں بتائیں کہ آپ کو کیا چاہیے تھا اور کیا نہیں ملا۔ درخواستیں ہفتہ وار جائزے میں پڑھی جاتی ہیں، اسی طرح کی درخواستوں کے ساتھ ضم کی جاتی ہیں، اور سب سے زیادہ مانگا جانے والا ڈیٹا جو عوامی ذرائع اجازت دیتے ہیں، سب سے پہلے تیار کیا جاتا ہے۔

کب درخواست کرنی ہے

درخواست بھیجیں جب کوئی ڈیٹا سیٹ، فیلڈ، کمپنی یا تجزیہ غائب ہو، یا جب جواب غلط لگے۔ لوگ فارماستعمال کرتے ہیں؛ ایجنٹس API یا MCP سرور استعمال کرتے ہیں۔ دونوں ایک ہی قطار تک پہنچتے ہیں، ایک ہی حدود کے ساتھ۔

ٹرمینل میں ہر خالی، غیر کور شدہ اور نامعلوم کمپنی اسٹیٹ ایک Request it لنک کے ساتھ ختم ہوتا ہے جو آپ کے لیے فارم بھر دیتا ہے۔ کمانڈ پیلیٹ میں Request ڈیٹا یا تجزیہ بھی شامل ہوتا ہے۔

اقسام

مہرباناسے استعمال کریں
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 ٹول ایک کو اس کے id سے تلاش کرتا ہے۔ 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"
حیثیتمعنی
newموصول ہو گیا، ابھی تک جائزہ نہیں لیا گیا
triagedجائزہ لیا گیا اور اسی طرح کی درخواستوں کے ساتھ ضم کیا گیا
plannedہم اسے بنانے کا ارادہ رکھتے ہیں
doneبنایا گیا؛ served_by اس راستے یا آلے کا نام دیتا ہے جو اسے سروس دیتا ہے
wontfixہم اسے تعمیر نہیں کریں گے؛ عوامی نوٹ میں کیوں لکھا گیا ہے

درخواست اور بھیج دی گئی

درخواست کی گئی اور شپڈ صفحہ میں وہ اشیاء درج ہیں جن کا جائزہ لیا گیا اور عنوان دیا گیا ہے، ان کی گنتی اور نتائج کے ساتھ۔ کوئی آئٹم کبھی خودکار طور پر لسٹ نہیں ہوتا۔ یہ صرف مجموعے دکھاتا ہے: کوئی جمع کروانے والا نہیں، کوئی جمع کرایا ہوا متن نہیں۔ یہی ڈیٹا ایک JSON فیڈ ہے:

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

چینج لاگ بورڈ سے لنکس کرتا ہے، اور ہر شپنگ آئٹم کا نام ہوتا ہے جو اسے سروس دیتا ہے۔

ہم کیا بنا سکتے ہیں

ہم کھلے عوامی ذرائع اور اپنے ماخوذ تجزیے سے کام کرتے ہیں:

  • SEC EDGAR فائلنگز اور ڈیٹا سیٹس (بیانات، ملکیت، تقریبات، فنڈز)
  • FRED اور دیگر عوامی اعداد و شمار
  • ہم پہلے سے موجود ڈیٹا (تناسب، اسکرینز، موازنہ) پر حسابات

وہ ڈیٹا جسے لائسنس کی ضرورت ہو یا جس کی شرائط دوبارہ استعمال کی اجازت نہیں دیتیں، جیسے اتفاق رائے کے تخمینے، تجزیہ کاروں کی ریٹنگز یا حقیقی وقت کے ایکسچینج فیڈز، wontfix ایک نوٹ کے ساتھ نشان زد کیے جاتے ہیں جو GET /v1/coverageکی طرف اشارہ کرتا ہے۔ بعد میں کی درخواستیں اب بھی ووٹ کے طور پر شمار ہوتی ہیں، اس لیے ہمیں معلوم ہوتا ہے کہ کیا مطلوب ہے۔

پرائیویسی

درخواست میں ذاتی معلومات کی کوئی درخواست نہیں ہوتی۔ جس ایڈریس سے آپ بھیجتے ہیں وہ صرف ایک مختصر خلاصے کے طور پر محفوظ رہتا ہے، تاکہ حدود لاگو کی جا سکیں۔

فارم اس وقت ای میل ایڈریس نہیں مانگتا: درخواست کو اس کے شناختی کارڈ سے فالو کریں۔ اگر بعد میں جواب کا ای میل پیش کیا جائے تو وہ اختیاری ہے، صرف اس وقت بھیجا جاتا ہے جب آپ باکس پر نشان لگا دیتے ہیں، درخواست سے الگ رکھا جاتا ہے، صرف یہ بتانے کے لیے استعمال ہوتا ہے کہ درخواست کب بھیجے یا بند ہو جائے، جب درخواست بند ہو جائے یا 365 دن بعد حذف ہو جائے، اور کبھی شیئر نہیں کیا جاتا۔ پرائیویسیدیکھیں۔