GET/offerings
العروض العامة الحالية مع المزود ووحدة GPU والمنطقة وشروط العقد والسعر المدرج الأصلي ووحدته، والسعر المستقل القابل للمقارنة الذي تحسبه Kovara بالدولار الأمريكي (USD) لكل GPU-hour، ودرجة الثقة وتواريخ الفحص. مقسمة إلى صفحات حسب offering_id.
| المعامل | المعنى |
|---|
| gpu | معرّف slug اختياري لوحدة GPU، مثل nvidia-h100-sxm (راجعوا /gpus). |
| provider | معرّف slug اختياري للمزود (راجعوا /providers). |
| limit | 1–500، القيمة الافتراضية 100. |
| cursor | قيمة next_cursor من الصفحة السابقة. |
curl "https://www.kovaragrid.com/api/public/v1/offerings?limit=2"
GET/gpu-prices
لكل وحدة GPU لها عروض عامة حالية: عدد العروض والمزودين، والحد الأدنى والمئين 25 والوسيط والمئين 75 والحد الأقصى للسعر القابل للمقارنة بالدولار الأمريكي (USD) لكل GPU-hour. يُبلّغ عن أسعار الاستخدام عند الطلب منفصلة عن جميع العقود.
curl "https://www.kovaragrid.com/api/public/v1/gpu-prices"
GET/price-history
ملاحظات الأسعار المنشورة لعرض واحد، الأحدث أولًا، مع القيمة الأصلية ووحدتها إلى جانب السعر الموحد بالدولار الأمريكي (USD) لكل GPU-hour، ونوع الملاحظة ودرجة الثقة. المصادر مدرجة في صفحة كل عرض.
| المعامل | المعنى |
|---|
| 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
النظرة العامة على Compute Index العام التي تستخدمها صفحات /index. ويُوسم التثبيت الرسمي والحسابات الاسترشادية كلٌّ على حدة.
curl "https://www.kovaragrid.com/api/public/v1/indices"
GET/indices/{slug}/series
سلسلة عامة واحدة من Compute Index في صورة صفوف قابلة للتنزيل بالدولار الأمريكي (USD) لكل GPU-hour: عمليات التثبيت المنشورة (official_fixing، أعلى مراجعة لكل تاريخ) والشريط المباشر (indicative_tape)، موسومة دائمًا كلٌّ على حدة. القيم الفارغة تبقى فارغة، ولا تصبح صفرًا أبدًا. والسلسلة التي ليست مرجعًا منشورًا تذكر ذلك في meta.publication_state.
| المعامل | المعنى |
|---|
| slug | معرّف 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 | معرّف slug للسلسلة مطلوب، وهو الجزء الذي يلي /index/ في صفحة السلسلة. |
| limit | 1–500، القيمة الافتراضية 60. |
| format | json (افتراضي) أو csv (صف واحد لكل مراجعة تثبيت). |
| include | constituents (json فقط): القيم الخاصة بكل مزود ومعرّفات الملاحظات وراء كل تثبيت. |
curl "https://www.kovaragrid.com/api/public/v1/indices/{slug}/fixings?include=constituents"GET/indices/{slug}/widget.svg
بطاقة SVG قابلة للتضمين وتحمل الإسناد، لأحدث تثبيت منشور لسلسلة من Compute Index. استخدموها في المقالات والعروض التقديمية وصفحات المزودين؛ فهي لا تقدّم أبدًا سلسلة مرشحة على أنها مرجع.
| المعامل | المعنى |
|---|
| slug | معرّف slug للسلسلة مطلوب، وهو الجزء الذي يلي /index/ في صفحة السلسلة. |
<img src="https://www.kovaragrid.com/api/public/v1/indices/{slug}/widget.svg" alt="Kovara Compute Index" />