दर सीमाएँ और कोटा
प्रत्येक finlight API कुंजी एक प्लान से बंधी होती है, और प्लान आपकी उपयोग सीमाएँ और आप किन क्षमताओं तक पहुँच सकते हैं, यह निर्धारित करता है। सीमाएँ प्रति API कुंजी, रीयल-टाइम में लागू की जाती हैं। यह पृष्ठ प्रत्येक सीमा और प्रत्येक प्लान द्वारा अनलॉक की जाने वाली चीज़ों की व्याख्या करता है; अपने प्लान के सटीक आँकड़ों के लिए finlight डैशबोर्ड या मूल्य निर्धारण पृष्ठ देखें।
चार उपयोग सीमाएँ
- Name
मासिक अनुरोध कोटा- Description
प्रत्येक REST अनुरोध आपके मासिक भत्ते से एक अनुरोध का उपभोग करता है। काउंटर प्रत्येक बिलिंग अवधि की शुरुआत में रीसेट होता है। इसे पार करने पर
429के साथ "Exceeded token limit of N for the current period." लौटाया जाता है।
- Name
बर्स्ट दर- Description
प्रति 10 सेकंड में अनुरोधों पर एक अल्पकालिक सीमा, जो स्पाइक्स को सहज बनाती है। केवल उन्हीं प्लान पर लागू होती है जो इसे परिभाषित करते हैं। इसे पार करने पर
429के साथ "Exceeded rate limit of N requests per 10 seconds." लौटाया जाता है — लगभग 10 सेकंड रुककर पुनः प्रयास करें।
- Name
WebSocket कनेक्शन- Description
आपकी कुंजी के लिए समवर्ती WebSocket कनेक्शनों की अधिकतम संख्या। सीमा से अधिक नए कनेक्शन अस्वीकार कर दिए जाते हैं। एक अलग सीमा प्रति अवधि स्ट्रीम किए गए संदेशों की कुल संख्या को सीमित करती है। WebSocket के लिए सशुल्क प्लान आवश्यक है।
- Name
Webhook डिलीवरी कोटा- Description
प्रति बिलिंग अवधि webhook डिलीवरी की अधिकतम संख्या। एक सहयोगी सीमा यह तय करती है कि आप कितने webhook बना सकते हैं। जब डिलीवरी कोटा समाप्त हो जाता है, तो अगली अवधि तक डिलीवरी रुक जाती है।
आपके प्लान द्वारा अनलॉक की गई क्षमताएँ
कच्ची सीमाओं के अलावा, आपका प्लान यह नियंत्रित करता है कि कौन-सी सुविधाएँ उपलब्ध हैं। ऐसी सुविधा का अनुरोध करना जो आपके प्लान में शामिल नहीं है, 403 लौटाता है (REST के लिए) या बस डेटा छोड़ देता है (webhook/WebSocket के लिए)।
- Name
ऐतिहासिक डेटा- Description
आप कितने पीछे तक क्वेरी कर सकते हैं, यह आपके प्लान पर निर्भर करता है। Free और Pro Light प्लान वर्तमान में लगभग पिछले एक महीने के लेख कवर करते हैं; उच्च प्लान गहरी ऐतिहासिक कवरेज अनलॉक करते हैं। अपने प्लान की समय-सीमा के भीतर क्वेरी करने के लिए
from/toदिनांक फ़िल्टर का उपयोग करें — उसके बाहर की तिथियों के अनुरोध बस उस श्रेणी के लिए कोई परिणाम नहीं लौटाते। प्रत्येक प्लान की सटीक इतिहास-सीमा के लिए मूल्य निर्धारण पृष्ठ देखें।
- Name
सेंटिमेंट विश्लेषण- Description
लेखों पर
sentimentऔरconfidenceफ़ील्ड शामिल करता है। न दिए जाने पर पेलोड से हटा दिया जाता है।
- Name
कंपनी इकाइयाँ- Description
companiesऐरे (AI-समाधानित टिकर, ISIN, एक्सचेंज आदि) शामिल करता है औरincludeEntitiesसक्षम करता है। न दिए जाने पर हटा दिया जाता है।
- Name
कस्टम स्रोत- Description
आपके डिफ़ॉल्ट सेट में जोड़े गए निजी या ग्राहक-विशिष्ट समाचार स्रोत। उच्च / एंटरप्राइज़ प्लान पर उपलब्ध।
प्रवर्तन कैसे काम करता है
- प्रति कुंजी, रीयल-टाइम में। प्रत्येक अनुरोध आपके काउंटर बढ़ाता है; सीमा पार होते ही API तुरंत
429लौटाता है। - डैशबोर्ड उपयोग लाइव नहीं है। finlight डैशबोर्ड में दिखाया गया उपयोग लगभग दिन में एक बार एकत्रित होता है और पिछले दिन तक की गतिविधि दर्शाता है — यह रीयल-टाइम काउंटर नहीं है। प्रवर्तन लाइव है, इसलिए आज के लिए आपका वास्तविक शेष कोटा डैशबोर्ड में दिखाए गए से भिन्न हो सकता है।
- मासिक काउंटर रीसेट आपकी बिलिंग अवधि की शुरुआत में होते हैं — कोटा
429स्वतः साफ़ हो जाता है। - कोई दर-सीमा हेडर नहीं। finlight वर्तमान में
Retry-AfterयाX-RateLimit-*हेडर नहीं भेजता। बर्स्ट429को "लगभग 10 सेकंड प्रतीक्षा करें" मानें; मासिक429को "इस अवधि के लिए कोटा समाप्त" मानें। त्रुटियाँ और स्टेटस कोड देखें।
प्लान
| प्लान | सामान्य उपयोग |
|---|---|
| Free | मूल्यांकन और कम-मात्रा उपयोग। केवल REST (कोई WebSocket नहीं)। |
| Pro (Light / Standard / Scale) | बढ़ते कोटा, WebSocket, webhook और समृद्ध संवर्धन के साथ उत्पादन वर्कलोड। |
| Enterprise | उच्च मात्रा, कस्टम स्रोत और अनुकूलित सीमाएँ। |
सटीक संख्यात्मक सीमाएँ (मासिक टोकन, बर्स्ट दर, WebSocket कनेक्शन, webhook कोटा) और प्रति प्लान सुविधा-सेट मूल्य निर्धारण का हिस्सा हैं और बदल सकते हैं। हमेशा finlight डैशबोर्ड में अपने वर्तमान प्लान की सीमाएँ जाँचें, या मूल्य निर्धारण पृष्ठ पर प्लान की तुलना करें। उच्च सीमाएँ या कस्टम स्रोत चाहिए? हमसे संपर्क करें।
जब आप किसी सीमा तक पहुँचते हैं
- बर्स्ट
429→ लगभग 10 सेकंड रुकें, फिर जारी रखें। - मासिक कोटा
429→ आपने इस अवधि के अनुरोध उपयोग कर लिए हैं; अपग्रेड करें, या रीसेट की प्रतीक्षा करें। - WebSocket कनेक्शन अस्वीकृत → आप अपनी समवर्ती-कनेक्शन सीमा पर हैं; किसी निष्क्रिय कनेक्शन को बंद करें (WebSocket क्विकस्टार्ट में
takeoverविकल्प देखें)। - Webhook डिलीवरी रुकी → इस अवधि के लिए आपका डिलीवरी कोटा समाप्त हो गया है; यह अगली अवधि में फिर शुरू होगा।
- किसी सुविधा पर
403→ वह क्षमता आपके प्लान में नहीं है; ऊपर दी गई तालिका देखें।
सटीक त्रुटि-निकायों के लिए, त्रुटियाँ और स्टेटस कोड देखें।