एंडपॉइंट
संस्करण 1
बेस URL https://www.kovaragrid.com/api/public/v1। रिस्पॉन्स JSON में होते हैं और अधिकतम 10 मिनट तक कैश किए जाते हैं। हर रिस्पॉन्स में एक meta ब्लॉक होता है, जिसमें जनरेशन का समय, श्रेय और शर्तें होती हैं।
GET/offerings
मौजूदा सार्वजनिक ऑफ़रिंग, जिनमें प्रोवाइडर, GPU, रीजन, अनुबंध की शर्तें, मूल सूचीबद्ध कीमत और इकाई, प्रति GPU-hour USD में Kovara की अलग तुलनीय कीमत, कॉन्फ़िडेंस ग्रेड और जाँच की तारीखें शामिल हैं। offering_id के अनुसार पेजों में बँटा।
| पैरामीटर | अर्थ |
|---|
| gpu | वैकल्पिक GPU स्लग, जैसे nvidia-h100-sxm (देखें /gpus)। |
| provider | वैकल्पिक प्रोवाइडर स्लग (देखें /providers)। |
| limit | 1–500, डिफ़ॉल्ट 100। |
| cursor | पिछले पेज का next_cursor मान। |
curl "https://www.kovaragrid.com/api/public/v1/offerings?limit=2"
GET/gpu-prices
मौजूदा सार्वजनिक ऑफ़रिंग वाले हर GPU के लिए: ऑफ़रिंग और प्रोवाइडर की संख्या, और प्रति GPU-hour USD में तुलनीय कीमत का न्यूनतम, 25वाँ पर्सेंटाइल, मीडियन, 75वाँ पर्सेंटाइल और अधिकतम मान। ऑन-डिमांड को सभी अनुबंधों से अलग दिखाया जाता है।
curl "https://www.kovaragrid.com/api/public/v1/gpu-prices"
GET/price-history
किसी एक ऑफ़रिंग के प्रकाशित कीमत ऑब्ज़र्वेशन, नवीनतम पहले, जिनमें मूल मान और इकाई के बगल में प्रति GPU-hour सामान्यीकृत USD, ऑब्ज़र्वेशन का प्रकार और कॉन्फ़िडेंस ग्रेड होते हैं। स्रोत हर ऑफ़रिंग के पेज पर सूचीबद्ध हैं।
| पैरामीटर | अर्थ |
|---|
| offering | आवश्यक offering_id, जैसे OFR-0217 या OFF000001। |
| days | 1–365, डिफ़ॉल्ट 90। |
curl "https://www.kovaragrid.com/api/public/v1/price-history?offering=OFR-0217&days=30"
GET/indices
/index पेजों द्वारा इस्तेमाल किया जाने वाला सार्वजनिक Compute Index ओवरव्यू। आधिकारिक फ़िक्सिंग और सांकेतिक गणनाओं को अलग-अलग लेबल किया जाता है।
curl "https://www.kovaragrid.com/api/public/v1/indices"
GET/indices/{slug}/series
एक सार्वजनिक Compute Index सीरीज़, प्रति GPU-hour USD में डाउनलोड करने योग्य पंक्तियों के रूप में: प्रकाशित फ़िक्सिंग (official_fixing, हर तारीख का सबसे ऊँचा संशोधन) और लाइव टेप (indicative_tape), हमेशा अलग-अलग लेबल किए हुए। खाली मान खाली ही रहते हैं, कभी शून्य नहीं। जो सीरीज़ प्रकाशित रेफ़रेंस नहीं है, वह meta.publication_state में यह बताती है।
| पैरामीटर | अर्थ |
|---|
| slug | आवश्यक सीरीज़ स्लग, सीरीज़ पेज पर /index/ के बाद का हिस्सा। |
| range | 24H, 7D, 30D या All। डिफ़ॉल्ट 30D। |
| format | json (डिफ़ॉल्ट) या csv। |
curl "https://www.kovaragrid.com/api/public/v1/indices/{slug}/series?range=7D&format=csv"GET/indices/{slug}/fixings
एक सीरीज़ की प्रकाशित फ़िक्सिंग, नवीनतम पहले। हर संशोधन सूचीबद्ध होता है ताकि सुधार उस मान के बगल में दिखते रहें जिसे वे सुधारते हैं, और is_latest_revision हर तारीख के मौजूदा संशोधन को चिह्नित करता है। वैकल्पिक रूप से हर फ़िक्सिंग के पीछे के प्रोवाइडर घटक भी शामिल करता है। जिस सीरीज़ की कोई प्रकाशित फ़िक्सिंग नहीं है, वह खाली सूची लौटाती है, कभी गणना किया गया विकल्प नहीं।
| पैरामीटर | अर्थ |
|---|
| slug | आवश्यक सीरीज़ स्लग, सीरीज़ पेज पर /index/ के बाद का हिस्सा। |
| limit | 1–500, डिफ़ॉल्ट 60। |
| format | json (डिफ़ॉल्ट) या csv (हर फ़िक्सिंग संशोधन के लिए एक पंक्ति)। |
| include | constituents (केवल json): हर फ़िक्सिंग के पीछे प्रति-प्रोवाइडर मान और ऑब्ज़र्वेशन id। |
curl "https://www.kovaragrid.com/api/public/v1/indices/{slug}/fixings?include=constituents"GET/indices/{slug}/widget.svg
किसी Compute Index सीरीज़ की नवीनतम प्रकाशित फ़िक्सिंग के लिए एम्बेड करने योग्य, श्रेय-सहित SVG कार्ड। इसे लेखों, प्रेज़ेंटेशन और प्रोवाइडर पेजों में इस्तेमाल करें; यह किसी कैंडिडेट को कभी रेफ़रेंस के रूप में नहीं दिखाता।
| पैरामीटर | अर्थ |
|---|
| slug | आवश्यक सीरीज़ स्लग, सीरीज़ पेज पर /index/ के बाद का हिस्सा। |
<img src="https://www.kovaragrid.com/api/public/v1/indices/{slug}/widget.svg" alt="Kovara Compute Index" />