> For the complete documentation index, see [llms.txt](https://docs.clore.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.clore.ai/clore.ai/clore.ai-eng-hi/for-hosts/api.md).

# API

> 💡 **पायथन डेवलपर्स:** आधिकारिक [clore-ai Python SDK](/clore.ai/clore.ai-eng-hi/developers/python-sdk.md) कच्चे API कॉल्स के बजाय इसका उपयोग करें। यह प्रमाणीकरण, दर-सीमांकन, पुनः प्रयास और त्रुटि प्रबंधन को स्वचालित रूप से संभालता है।
>
> **त्वरित शुरुआत:** `pip install clore-ai` — देखें [Python SDK दस्तावेज़](/clore.ai/clore.ai-eng-hi/developers/python-sdk.md) और [CLI संदर्भ](/clore.ai/clore.ai-eng-hi/developers/cli-guide.md).

> 🧭 क्या आप ब्राउज़ करने योग्य संदर्भ पसंद करते हैं? इंटरैक्टिव API दस्तावेज़ यहाँ खोलें [clore.ai/api-docs](https://clore.ai/api-docs). इस पृष्ठ के सभी एंडपॉइंट्स के लिए बेस URL: `https://api.clore.ai/v1/`.

<div data-full-width="true"><figure><img src="/files/e83711806ceff5b412cdd6790c36f5cd5844e185" alt=""><figcaption></figcaption></figure></div>

### परिचय <a href="#introduction" id="introduction"></a>

[CLORE.AI](http://clore.ai/) CLORE.AI API का उपयोग आपके वर्कलोड्स की डिप्लॉयमेंट को ... पर स्वचालित करने के लिए किया जा सकता है [CLORE.AI](http://clore.ai/)

सबसे पहले आपको एक API कुंजी प्राप्त करनी होगी\
![alt text](https://clore.ai/assets/html/api-export1.png)\
![alt text](https://clore.ai/assets/html/api-export2.png)

***

### API प्रतिक्रियाएँ <a href="#api-responses" id="api-responses"></a>

प्रतिक्रियाएँ JSON प्रारूप में लौटाई जाती हैं, उनमें अलग-अलग फ़ील्ड हो सकते हैं

हमेशा लौटाया जाने वाला फ़ील्ड code है, जो स्थिति दर्शाता है

**code फ़ील्ड**

| code | विवरण                               |
| ---- | ----------------------------------- |
| `0`  | सामान्य                             |
| `1`  | डेटाबेस त्रुटि                      |
| `2`  | अमान्य इनपुट डेटा                   |
| `3`  | अमान्य API टोकन                     |
| `4`  | अमान्य एंडपॉइंट                     |
| `5`  | 1 अनुरोध/सेकंड की सीमा पार कर दी गई |
| `6`  | त्रुटि निर्दिष्ट है `त्रुटि` फ़ील्ड |

***

### एंडपॉइंट्स <a href="#endpoints" id="endpoints"></a>

#### 1. `वॉलेट्स` <a href="#id-1-wallets" id="id-1-wallets"></a>

**के बारे में**

वॉलेट्स और शेष राशियाँ लौटाएँ

**शीर्षक**

| फ़ील्ड | प्रकार     | अनिवार्य | विवरण    |
| ------ | ---------- | -------- | -------- |
| `auth` | `स्ट्रिंग` | हाँ      | API टोकन |

**आउटपुट**

| फ़ील्ड    | प्रकार       | विवरण          |
| --------- | ------------ | -------------- |
| `code`    | `पूर्णांक`   | स्थिति कोड     |
| `वॉलेट्स` | `[]स्ट्रिंग` | वॉलेट्स का ऐरे |

**उदाहरण**

**इनपुट:**

```
curl -XGET -H 'auth: b8qwqRAL5W7YDyDJeB4XANVvKndbrrPk' 'https://api.clore.ai/v1/wallets'
```

**आउटपुट:**

```
{
  "wallets": [
    {
      "name": "bitcoin",
      "deposit": "tb1q6erw7v02t7hakgmlcl4wfnlykzqj05alndruwr",
      "balance": 0.00153176,
      "withdrawal_fee": 0.0001
    }
  ],
  "code": 0
}
```

#### 2. `my_servers` <a href="#id-2-my_servers" id="id-2-my_servers"></a>

**के बारे में**

आपके वे सर्वर लौटाता है जिन्हें आप [clore.ai](http://clore.ai/) मार्केटप्लेस

**शीर्षक**

| फ़ील्ड | प्रकार     | अनिवार्य | विवरण    |
| ------ | ---------- | -------- | -------- |
| `auth` | `स्ट्रिंग` | हाँ      | API टोकन |

**आउटपुट**

| फ़ील्ड                                | प्रकार       | विवरण                                                                                                                                                              |
| ------------------------------------- | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `code`                                | `पूर्णांक`   | स्थिति कोड                                                                                                                                                         |
| `सीमा`                                | `पूर्णांक`   | सर्वरों की अधिकतम संख्या जो आप स्वामित्व में रख सकते हैं                                                                                                           |
| `सर्वर`                               | `[]स्ट्रिंग` | सर्वरों का ऐरे                                                                                                                                                     |
| `servers[x].name`                     | `स्ट्रिंग`   | उपयोगकर्ता द्वारा चुना गया सर्वर नाम                                                                                                                               |
| `servers[x].connected`                | `स्ट्रिंग`   | क्या सर्वर कभी इससे जुड़ा था [clore.ai](http://clore.ai/)                                                                                                          |
| `servers[x].visibility`               | `स्ट्रिंग`   | मार्केटप्लेस पर दृश्यता                                                                                                                                            |
| `servers[x].pricing`                  | `[]स्ट्रिंग` | मांग पर मूल्य/दिन                                                                                                                                                  |
| `servers[x].online`                   | `बूल`        | क्या सर्वर ऑनलाइन है                                                                                                                                               |
| `servers[x].min_spot_pricing`         | `[]स्ट्रिंग` | स्पॉट मार्केट पर किराये के लिए न्यूनतम मूल्य/दिन                                                                                                                   |
| `servers[x].init_token`               | `स्ट्रिंग`   | मशीन-पंजीकरण टोकन, केवल तब तक लौटाया जाता है जब तक मशीन इनिशियलाइज़ नहीं हो जाती — **इसे एक क्रेडेंशियल की तरह मानें**, यह मशीनों को आपके खाते में पंजीकृत करता है |
| `servers[x].specs`                    | `[]स्ट्रिंग` | सर्वर विशिष्टताएँ                                                                                                                                                  |
| `servers[x].remaining_time`           | `पूर्णांक`   | सबसे हालिया सक्रिय ऑर्डर का किराया समाप्ति समय (ms epoch)                                                                                                          |
| `servers[x].rental_state`             | `स्ट्रिंग`   | समेकित GPU किराया स्थिति: `कोई नहीं`, `आंशिक`, या `पूर्ण`                                                                                                          |
| `servers[x].rented_gpus`              | `पूर्णांक`   | वर्तमान में सक्रिय ऑर्डरों में किराये पर लिए गए GPUs                                                                                                               |
| `servers[x].total_gpus`               | `पूर्णांक`   | सर्वर पर कुल GPUs                                                                                                                                                  |
| `servers[x].rented_price_by_currency` | `ऑब्जेक्ट`   | मुद्रा के अनुसार कुंजीबद्ध सक्रिय ऑर्डर कीमतों का योग                                                                                                              |
| `servers[x].update_channel`           | `स्ट्रिंग`   | होस्टिंग-एजेंट अपडेट चैनल: `स्थिर` या `बीटा`                                                                                                                       |
| `servers[x].requested_channel`        | `स्ट्रिंग`   | वेब UI से अनुरोधित चैनल स्विच (केवल अनुरोध किए जाने पर मौजूद)                                                                                                      |
| `servers[x].target_backend_version`   | `पूर्णांक`   | वर्तमान चैनल द्वारा लक्षित बैकएंड संस्करण                                                                                                                          |

> रेंटल-स्टेट फ़ील्ड्स (`remaining_time`, `rental_state`, `rented_gpus`, `total_gpus`, `rented_price_by_currency`) केवल तब मौजूद होते हैं जब सर्वर के पास सक्रिय ऑर्डर हो।

**उदाहरण**

**इनपुट:**

```
curl -XGET -H 'auth: b8qwqRAL5W7YDyDJeB4XANVvKndbrrPk' 'https://api.clore.ai/v1/my_servers'
```

**आउटपुट:**

```
{
  "servers": [
    {
      "name": "Michael",
      "connected": false,
      "visibility": "hidden",
      "pricing": { "bitcoin": 0, "usd": 0 },
      "online": false,
      "min_spot_pricing": { "bitcoin": 0, "usd": 0 },
      "init_token": "qnwVIMsZPjUWS7jw6gAbTOeoGQNgTH9XVxJaiCEbG0OlmfjF"
    },
    {
      "name": "Jan Vykydal",
      "connected": true,
      "visibility": "public",
      "pricing": { "bitcoin": 0.00010337, "usd": 0 },
      "online": false,
      "min_spot_pricing": { "bitcoin": 0.00005168, "usd": 0 },
      "specs": {
        "mb": "Z590 GAMING X",
        "cpu": "Intel Core i9-11900",
        "cpus": "8/16",
        "ram": 64,
        "disk": "NVMe 512GB",
        "disk_speed": 2000,
        "gpu": "1x GeForce GTX 1080 Ti",
        "gpuram": 11,
        "net": {
          "down":119.61,
          "up":25.24
        }
      }
    }
  ],
  "limit": 16,
  "code": 0
}
```

में USD मान `pricing` ऑब्जेक्ट्स USD-आधारित मूल्य निर्धारण मोड को दर्शाते हैं, जहाँ होस्ट ने इसे सक्षम किया होता है।

#### 3. `server_config` <a href="#id-3-server_config" id="id-3-server_config"></a>

**के बारे में**

विशिष्ट सर्वर की कॉन्फ़िगरेशन प्राप्त करें

**शीर्षक**

| फ़ील्ड         | प्रकार     | अनिवार्य | विवरण                         |
| -------------- | ---------- | -------- | ----------------------------- |
| `auth`         | `स्ट्रिंग` | हाँ      | API टोकन                      |
| `Content-type` | `स्ट्रिंग` | हाँ      | होना चाहिए `application/json` |

**बॉडी**

| फ़ील्ड        | प्रकार     | अनिवार्य | विवरण     |
| ------------- | ---------- | -------- | --------- |
| `server_name` | `स्ट्रिंग` | हाँ      | सर्वर नाम |

**आउटपुट**

| फ़ील्ड                  | प्रकार                   | विवरण                                                                                                     |
| ----------------------- | ------------------------ | --------------------------------------------------------------------------------------------------------- |
| `code`                  | `पूर्णांक`               | स्थिति कोड                                                                                                |
| `creation_completed`    | `बूल`                    | क्या सर्वर निर्माण पूरा हो गया है                                                                         |
| `config`                | `[]स्ट्रिंग`             | सर्वर की कॉन्फ़िगरेशन                                                                                     |
| `config.name`           | `स्ट्रिंग`               | उपयोगकर्ता द्वारा चुना गया सर्वर नाम                                                                      |
| `config.connected`      | `बूल`                    | क्या सर्वर कभी इससे जुड़ा था [clore.ai](http://clore.ai/)                                                 |
| `config.visibility`     | `स्ट्रिंग`               | मार्केटप्लेस पर दृश्यता                                                                                   |
| `config.pricing`        | `[]स्ट्रिंग`             | मांग पर मूल्य/दिन                                                                                         |
| `config.spot_pricing`   | `[]स्ट्रिंग`             | स्पॉट मार्केट पर किराये के लिए न्यूनतम मूल्य/दिन                                                          |
| `config.mrl`            | `पूर्णांक`               | अधिकतम किराये की अवधि घंटों में                                                                           |
| `config.online`         | `बूल`                    | क्या सर्वर ऑनलाइन है                                                                                      |
| `config.initialized`    | `बूल`                    | क्या सर्वर कभी इससे जुड़ा था [clore.ai](http://clore.ai/)                                                 |
| `config.id`             | `पूर्णांक`               | अद्वितीय सर्वर ID                                                                                         |
| `config.rental_status`  | `पूर्णांक`               | 0 - किराये पर नहीं \| 1 - स्पॉट मार्केट पर किराये पर \| 2 - ऑन-डिमांड किराये पर \| 3 - फिक्स्ड-USD किराया |
| `config.specs`          | `[]स्ट्रिंग`             | सर्वर विशिष्टताएँ                                                                                         |
| `config.background_job` | `ऑब्जेक्ट`               | किराये पर नहीं होने पर बैकग्राउंड जॉब: `image`, `command`, `env`, `times_updated`                         |
| `config.autoprice`      | `ऑब्जेक्ट` \| `स्ट्रिंग` | प्रति-मुद्रा ऑटो-प्राइसिंग कॉन्फ़िगरेशन (पुराने string मान `"pow"` / `"usd"` भी आते हैं)                  |
| `config.usd_pricing`    | `ऑब्जेक्ट`               | USD मूल्य लक्ष्य — केवल तब मौजूद जब USD ऑटो-प्राइसिंग सक्षम हो                                            |
| `config.tenants`        | `[]ऑब्जेक्ट`             | सर्वर पर सक्रिय ऑर्डर: `rental_type`, `currency`, `price`, `remaining_time`, `gpu_count`                  |

> `server_config` यह भी वही rental-state और update-channel फ़ील्ड लौटाता है जो `my_servers`: `remaining_time`, `rental_state`, `rented_gpus`, `total_gpus`, `rented_price_by_currency`, `update_channel`, `requested_channel`, `target_backend_version`. दोनों एंडपॉइंट्स में rental-state फ़ील्ड केवल तब मौजूद होते हैं जब सर्वर के पास सक्रिय ऑर्डर हो।

**उदाहरण**

**इनपुट:**

```
curl -XGET -H 'auth: b8qwqRAL5W7YDyDJeB4XANVvKndbrrPk' -H "Content-type: application/json" -d '{
    "server_name":"Jan Vykydal"
}' 'https://api.clore.ai/v1/server_config'
```

**आउटपुट:**

```
{
  "config": {
    "name": "Jan Vykydal",
    "connected": true,
    "visibility": "public",
    "pricing": { "bitcoin": 0.00010337, "usd": 0 },
    "spot_pricing": { "bitcoin": 0.00005168, "usd": 0 },
    "mrl": 72,
    "online": false,
    "initialized": true,
    "id": 4,
    "rental_status": 0,
    "specs": {
      "mb": "Z590 GAMING X",
      "cpu": "Intel Core i9-11900",
      "cpus": "8/16",
      "ram": 64,
      "disk": "NVMe 512GB",
      "disk_speed": 2000,
      "gpu": "1x GeForce GTX 1080 Ti",
      "gpuram": 11,
      "net": {
        "down":119.61,
        "up":25.24
      }
    },
    "background_job": {
      "times_updated": 1,
      "image": "cloreai/ubuntu20.04-jupyter",
      "command": "",
      "env": []
    }
  },
  "creation_completed": true,
  "code": 0
}
```

में USD मान `pricing` ऑब्जेक्ट्स USD-आधारित मूल्य निर्धारण मोड को दर्शाते हैं, जहाँ होस्ट ने इसे सक्षम किया होता है।

#### 4. `मार्केटप्लेस` <a href="#id-4-marketplace" id="id-4-marketplace"></a>

**के बारे में**

मार्केटप्लेस प्राप्त करें

**शीर्षक**

| फ़ील्ड | प्रकार     | अनिवार्य | विवरण    |
| ------ | ---------- | -------- | -------- |
| `auth` | `स्ट्रिंग` | हाँ      | API टोकन |

**आउटपुट**

| फ़ील्ड                          | प्रकार              | विवरण                                                                                                    |
| ------------------------------- | ------------------- | -------------------------------------------------------------------------------------------------------- |
| `code`                          | `पूर्णांक`          | स्थिति कोड                                                                                               |
| `my_servers`                    | `[]स्ट्रिंग`        | सर्वर आईडी का ऐरे जिन्हें आप प्रदान कर रहे हैं [clore.ai](http://clore.ai/) (किराये पर नहीं लिए जा सकते) |
| `सर्वर`                         | `[]स्ट्रिंग`        | मार्केटप्लेस पर सार्वजनिक सर्वरों का ऐरे                                                                 |
| `servers[x].id`                 | `पूर्णांक`          | अद्वितीय सर्वर ID                                                                                        |
| `servers[x].owner`              | `पूर्णांक`          | अद्वितीय मालिक ID                                                                                        |
| `servers[x].mrl`                | `पूर्णांक`          | अधिकतम किराये की अवधि घंटों में                                                                          |
| `servers[x].price.on_demand`    | `[]स्ट्रिंग`        | ऑन-डिमांड मूल्य प्रति दिन                                                                                |
| `servers[x].price.spot`         | `[]स्ट्रिंग`        | न्यूनतम स्पॉट मार्केट मूल्य प्रति दिन                                                                    |
| `servers[x].rented`             | `बूल`               | क्या सर्वर ऑन-डिमांड किराये पर है                                                                        |
| `servers[x].specs`              | `[]स्ट्रिंग`        | सर्वर विशिष्टताएँ                                                                                        |
| `servers[x].partial_gpu_rental` | `ऑब्जेक्ट` \| `बूल` | `false` जब आंशिक किराया उपलब्ध नहीं होता, अन्यथा `{ total_gpus, available_gpus, free_indices }`          |

> `price.on_demand` और `price.spot` केवल वही मुद्राएँ शामिल करें जिन्हें प्रत्येक सर्वर वास्तव में स्वीकार करता है — यदि किसी मुद्रा में सर्वर की कीमत नहीं है, तो उसमें उसे किराये पर नहीं लिया जा सकता।

**उदाहरण**

मार्केटप्लेस प्राप्त करें

**इनपुट:**

```
curl -XGET -H 'auth: b8qwqRAL5W7YDyDJeB4XANVvKndbrrPk' 'https://api.clore.ai/v1/marketplace'
```

**आउटपुट:**

```
{
  "servers": [
    {
      "id": 6,
      "owner": 4,
      "mrl": 73,
      "price": { "on_demand": { "bitcoin": 0.00001 },
      "spot": { "bitcoin": 0.000001 }},
      "rented": false,
      "specs": {
        "mb": "Z590 GAMING X",
        "cpu": "11th Gen Intel(R) Core(TM) i9-11900 @ 2.50GHz",
        "cpus": "8/16",
        "ram": 62.67348861694336,
        "disk": "NVMe disk 247.3623046875GB",
        "disk_speed": 0,
        "gpu": "1x NVIDIA GeForce GTX 1080 Ti",
        "gpuram": 11,
        "net": {
          "up": 26.38,
          "down": 118.42,
          "cc": "CZ"
        }
      }
    }
  ],
  "my_servers": [1, 2, 4],
  "code": 0
}
```

#### 5. `my_orders` <a href="#id-5-my_orders" id="id-5-my_orders"></a>

**के बारे में**

अपने ऑर्डर प्राप्त करें

**शीर्षक**

| फ़ील्ड | प्रकार     | अनिवार्य | विवरण    |
| ------ | ---------- | -------- | -------- |
| `auth` | `स्ट्रिंग` | हाँ      | API टोकन |

**क्वेरी स्ट्रिंग**

| फ़ील्ड             | प्रकार | अनिवार्य | विवरण                       |
| ------------------ | ------ | -------- | --------------------------- |
| `return_completed` | `बूल`  | नहीं     | पूर्ण (समाप्त) ऑर्डर लौटाएँ |

**आउटपुट**

| फ़ील्ड                   | प्रकार       | विवरण                                                                                                                                                                    |
| ------------------------ | ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `code`                   | `पूर्णांक`   | स्थिति कोड                                                                                                                                                               |
| `सीमा`                   | `पूर्णांक`   | सक्रिय ऑर्डरों की अधिकतम संख्या                                                                                                                                          |
| `orders`                 | `[]स्ट्रिंग` | ऑर्डरों का ऐरे                                                                                                                                                           |
| `orders[x].id`           | `पूर्णांक`   | अद्वितीय ऑर्डर ID                                                                                                                                                        |
| `orders[x].fee`          | `दशमलव`      | शुल्क (%) भुगतान किया गया [clore.ai](http://clore.ai/)                                                                                                                   |
| `orders[x].creation_fee` | `दशमलव`      | भुगतान की गई निर्माण शुल्क [clore.ai](http://clore.ai/)                                                                                                                  |
| `orders[x].price`        | `दशमलव`      | ऑर्डर मूल्य (लागत) प्रति दिन                                                                                                                                             |
| `orders[x].mrl`          | `पूर्णांक`   | सेकंड में अधिकतम ऑर्डर किराये की अवधि                                                                                                                                    |
| `orders[x].image`        | `स्ट्रिंग`   | उपयोग किया गया docker image                                                                                                                                              |
| `orders[x].currency`     | `स्ट्रिंग`   | बिलिंग के लिए उपयोग की गई मुद्रा                                                                                                                                         |
| `orders[x].spend`        | `दशमलव`      | अब तक डेबिट की गई वास्तविक राशि: संचित किराये का मूल्य, साथ ही किरायेदार का आधार शुल्क (PoH कमी के बाद) और कोई अतिरिक्त शुल्क; इसमें एकमुश्त निर्माण शुल्क शामिल नहीं है |
| `orders[x].gpu_count`    | `पूर्णांक`   | ऑर्डर द्वारा घिरे गए GPUs की संख्या (ऑन-डिमांड ऑर्डर; यदि यह आंशिक किराया नहीं है, तो rig के कुल GPUs के बराबर)                                                          |
| `orders[x].ct`           | `पूर्णांक`   | निर्माण समय (UNIX समय)                                                                                                                                                   |
| `orders[x].p`            | `पूर्णांक`   | वर्तमान में उपयोग किया गया प्रॉक्सी क्लस्टर                                                                                                                              |
| `orders[x].specs`        | `[]स्ट्रिंग` | सर्वर विशिष्टताएँ                                                                                                                                                        |
| `orders[x].si`           | `पूर्णांक`   | अद्वितीय सर्वर ID                                                                                                                                                        |
| `orders[x].pub_cluster`  | `[]स्ट्रिंग` | फॉरवर्ड किए गए पोर्ट्स वाले सार्वजनिक एंडपॉइंट्स                                                                                                                         |
| `orders[x].tcp_ports`    | `[]स्ट्रिंग` | TCP पोर्ट फ़ॉरवर्डिंग                                                                                                                                                    |
| `orders[x].http_port`    | `स्ट्रिंग`   | HTTPS प्रॉक्सी के माध्यम से फॉरवर्ड किया गया कंटेनर पोर्ट                                                                                                                |
| `orders[x].spot`         | `बूल`        | इंगित करता है कि यह स्पॉट ऑर्डर है                                                                                                                                       |
| `orders[x].expired`      | `बूल`        | इंगित करता है कि ऑर्डर समाप्त हो गया है                                                                                                                                  |

**इनपुट:**

```
curl -XGET -H 'auth: b8qwqRAL5W7YDyDJeB4XANVvKndbrrPk' 'https://api.clore.ai/v1/my_orders?return_completed=true'
```

**आउटपुट:**

```
{
  "orders": [
    {
      "id": 38,
      "fee": 5,
      "creation_fee": 3e-7,
      "price": 0.00001,
      "mrl": 262800,
      "image": "cloreai/ubuntu20.04-jupyter",
      "currency": "bitcoin",
      "spend": 6.944444444444445e-9,
      "ct": 1667401396,
      "p": 1,
      "specs": {
        "mb": "Z590 GAMING X",
        "cpu": "11th Gen Intel(R) Core(TM) i9-11900 @ 2.50GHz",
        "cpus": "8/16",
        "ram": 62.67348861694336,
        "disk": "NVMe disk 247.3623046875GB",
        "disk_speed": 2000,
        "gpu": "1x NVIDIA GeForce GTX 1080 Ti",
        "gpuram": 11,
        "net": {
          "up": 26.38,
          "down": 118.42,
        }
      },
      "si": 6,
      "pub_cluster": [ "n1.c1.clorecloud.net", "n2.c1.clorecloud.net" ],
      "tcp_ports": [ "22:10000" ],
      "http_port": "8888"
    },{
      "id": 36,
      "fee": 2.5,
      "creation_fee": 1e-7,
      "price": 0.00001,
      "mrl": 262800,
      "image": "cloreai/ubuntu20.04-jupyter",
      "currency": "bitcoin",
      "spend": 1.3888888888888888e-7,
      "ct": 1667248597,
      "specs": {
        "mb": "Z590 GAMING X",
        "cpu": "11th Gen Intel(R) Core(TM) i9-11900 @ 2.50GHz",
        "cpus": "8/16",
        "ram": 62.67348861694336,
        "disk": "NVMe disk 247.3623046875GB",
        "disk_speed": 2000,
        "gpu": "1x NVIDIA GeForce GTX 1080 Ti",
        "gpuram": 11,
        "net": {
          "up": 26.38,
          "down": 118.42,
        }
      },
      "si": 6,
      "spot": true,
      "expired": true,
      "tcp_ports": []
    }
  ],
  "limit": 13,
  "code": 0
}
```

#### 6. `spot_marketplace` <a href="#id-6-spot_marketplace" id="id-6-spot_marketplace"></a>

**के बारे में**

विशिष्ट सर्वर के लिए स्पॉट मार्केटप्लेस प्राप्त करें

**शीर्षक**

| फ़ील्ड | प्रकार     | अनिवार्य | विवरण    |
| ------ | ---------- | -------- | -------- |
| `auth` | `स्ट्रिंग` | हाँ      | API टोकन |

**क्वेरी स्ट्रिंग**

| फ़ील्ड   | प्रकार     | अनिवार्य | विवरण             |
| -------- | ---------- | -------- | ----------------- |
| `बाज़ार` | `पूर्णांक` | हाँ      | अद्वितीय सर्वर ID |

**आउटपुट**

| फ़ील्ड                         | प्रकार     | विवरण                                                                         |
| ------------------------------ | ---------- | ----------------------------------------------------------------------------- |
| `code`                         | `पूर्णांक` | स्थिति कोड                                                                    |
| `मौजूद`                        | `बूल`      | यह सत्यापित करना कि बाज़ार मौजूद है                                           |
| `बाज़ार`                       | `ऑब्जेक्ट` | मार्केटप्लेस                                                                  |
| `market.offers`                | `सरणी`     | सर्वर के लिए किराये के प्रस्ताव                                               |
| `market.offers[x].offer_id`    | `पूर्णांक` | अद्वितीय प्रस्ताव ID                                                          |
| `market.offers[x].bid`         | `दशमलव`    | प्रति दिन प्रस्तावित मूल्य (प्रस्ताव की मुद्रा में)                           |
| `market.offers[x].currency`    | `स्ट्रिंग` | बोली की मुद्रा                                                                |
| `market.offers[x].active`      | `बूल`      | यह प्रस्ताव वर्तमान में उपयोग में है                                          |
| `market.offers[x].my`          | `बूल`      | यह प्रस्ताव मेरा है                                                           |
| `market.server`                | `ऑब्जेक्ट` | सर्वर जानकारी                                                                 |
| `market.server.min_pricing`    | `ऑब्जेक्ट` | प्रति स्वीकृत मुद्रा न्यूनतम प्रस्ताव मूल्य प्रति दिन                         |
| `market.server.mrl`            | `पूर्णांक` | में अधिकतम किराये की अवधि **घंटे**                                            |
| `market.server.visibility`     | `स्ट्रिंग` | आप केवल तब प्रस्ताव बना सकते हैं जब दृश्यता सार्वजनिक हो                      |
| `market.server.online`         | `बूल`      | सर्वर ऑनलाइन है                                                               |
| `market.currency_rates_in_usd` | `ऑब्जेक्ट` | विभिन्न मुद्राओं में बोलियों की तुलना के लिए उपयोग की जाने वाली लाइव USD दरें |

> प्रस्ताव किसी भी ऐसी मुद्रा में लगाए जा सकते हैं जिसे सर्वर स्वीकार करता है; प्रतिस्पर्धी बोलियों की तुलना उनके **USD मान** (का उपयोग करके `currency_rates_in_usd`), न कि अंकित मूल्य से.
>
> ⚠️ **अगस्त 2026 में बदला गया:** `market.server.mrl` अब इसमें लौटाया जाता है **घंटे** (पहले सेकंड). एक मान जो पढ़ा गया था `262800` अब पढ़ा जाता है `73`.

**इनपुट:**

```
curl -XGET -H 'auth: b8qwqRAL5W7YDyDJeB4XANVvKndbrrPk' 'https://api.clore.ai/v1/spot_marketplace?market=6'
```

**आउटपुट:**

```
{
  "market": {
    "offers": [
      {
        "offer_id": 39,
        "bid": 0.0000042,
        "active": true,
        "my": true,
        "currency": "bitcoin"
      }
    ],
    "server": {
      "min_pricing": {
        "bitcoin": 0.000001
      },
      "mrl": 73,
      "visibility": "public",
      "online": true
    },
    "currency_rates_in_usd": {
      "bitcoin": 110000,
      "CLORE-Blockchain": 0.0045,
      "USD-Blockchain": 1
    }
  },
  "exists": true,
  "code": 0
}
```

#### 7. `set_server_settings` <a href="#id-7-set_server_settings" id="id-7-set_server_settings"></a>

**के बारे में**

आप जो सर्वर प्रदान कर रहे हैं उसकी सेटिंग्स कॉन्फ़िगर करें [clore.ai](http://clore.ai/) मार्केटप्लेस

**शीर्षक**

| फ़ील्ड         | प्रकार     | अनिवार्य | विवरण                         |
| -------------- | ---------- | -------- | ----------------------------- |
| `auth`         | `स्ट्रिंग` | हाँ      | API टोकन                      |
| `Content-type` | `स्ट्रिंग` | हाँ      | होना चाहिए `application/json` |

**बॉडी**

| फ़ील्ड                       | प्रकार     | अनिवार्य | विवरण                                                                                                                                                                          |
| ---------------------------- | ---------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `नाम`                        | `स्ट्रिंग` | हाँ      | उपयोगकर्ता द्वारा चुना गया सर्वर नाम                                                                                                                                           |
| `उपलब्धता`                   | `बूल`      | हाँ      | क्या सर्वर किराये पर लिया जा सकता है                                                                                                                                           |
| `mrl`                        | `पूर्णांक` | हाँ      | सर्वर के किराये की अधिकतम अवधि में **घंटे** (6 से 3000)                                                                                                                        |
| `bitcoin_on_demand`          | `दशमलव`    | हाँ      | प्रति दिन BTC में ऑन-डिमांड मूल्य                                                                                                                                              |
| `bitcoin_spot`               | `दशमलव`    | हाँ      | प्रति दिन BTC में न्यूनतम स्पॉट मूल्य                                                                                                                                          |
| `CLORE-Blockchain_on_demand` | `दशमलव`    | नहीं     | प्रति दिन CLORE में ऑन-डिमांड मूल्य                                                                                                                                            |
| `CLORE-Blockchain_spot`      | `दशमलव`    | नहीं     | प्रति दिन CLORE में न्यूनतम स्पॉट मूल्य                                                                                                                                        |
| `USD-Blockchain_on_demand`   | `दशमलव`    | नहीं     | प्रति दिन USD में ऑन-डिमांड मूल्य                                                                                                                                              |
| `USD-Blockchain_spot`        | `दशमलव`    | नहीं     | प्रति दिन USD में न्यूनतम स्पॉट मूल्य                                                                                                                                          |
| `enabled-bitcoin`            | `बूल`      | नहीं\*   | इस सर्वर के लिए Bitcoin स्वीकार करें                                                                                                                                           |
| `enabled-CLORE-Blockchain`   | `बूल`      | नहीं\*   | इस सर्वर के लिए CLORE स्वीकार करें                                                                                                                                             |
| `enabled-USD-Blockchain`     | `बूल`      | नहीं\*   | इस सर्वर के लिए USD स्टेबलकॉइन स्वीकार करें                                                                                                                                    |
| `autoprice`                  | `ऑब्जेक्ट` | नहीं     | प्रति-मुद्रा ऑटोप्राइसिंग: एक मुद्रा कुंजी सेट करें (`bitcoin`, `CLORE-Blockchain`) को `"usd"` USD-आधारित ऑटोप्राइसिंग के लिए या `false` नियत मूल्य निर्धारण के लिए            |
| `usd_pricing`                | `ऑब्जेक्ट` | नहीं     | प्रति मुद्रा USD मूल्य लक्ष्य, जैसे `{ "bitcoin": { "on_demand": 10, "spot": 5 } }` — केवल उन मुद्राओं के लिए उपयोग किया जाता है जिनमें `autoprice` को सेट किया गया है `"usd"` |

> \* **स्वीकार की गई मुद्राओं की सूची को फिर से बनाया जाता है `enabled-*` फ़्लैग्स पर हर कॉल में।** अपनी `enabled-<currency>: true` फ़्लैग (या वैध मूल्य के बिना) के बिना कोई मुद्रा सर्वर की स्वीकार की गई मुद्राओं से हटा दी जाती है — सभी फ़्लैग छोड़ देने पर सर्वर किसी भी मुद्रा में किराये पर नहीं लिया जा सकेगा। हमेशा भेजें `enabled-<currency>: true` हर उस मुद्रा के लिए जिसे आप स्वीकार करना जारी रखना चाहते हैं।
>
> प्रति दिन मूल्य प्रति मुद्रा सीमित हैं: 0.000001–0.015 BTC, 0.1–600,000 CLORE, 0.1–1,000 USD.
>
> जब किसी मुद्रा का मूल्य USD में ऑटोप्राइस किया जाता है, तो उसका सूचीबद्ध क्रिप्टो मूल्य इससे निकाला जाता है `usd_pricing` लाइव विनिमय दर पर (लगभग हर 10 मिनट में पुनः निकाला जाता है) और कोई भी `<currency>_on_demand` / `<currency>_spot` इसके लिए भेजा गया मान अनदेखा कर दिया जाता है। `usd_pricing` लक्ष्य पूरे-सर्वर $/दिन के आंकड़े हैं, जिन्हें USD सीमा (0.1–1,000) के विरुद्ध सत्यापित किया जाता है; सीमा से बाहर के मान निकटतम सीमा पर क्लैंप कर दिए जाते हैं।

**आउटपुट**

| फ़ील्ड | प्रकार     | विवरण      |
| ------ | ---------- | ---------- |
| `code` | `पूर्णांक` | स्थिति कोड |

**उदाहरण**

आइए वर्तमान वॉलेट से भेजे गए लेनदेन के लिए एक प्रेषण प्रमाण बनाएं।

**इनपुट:**

```
curl -XPOST -H 'auth: b8qwqRAL5W7YDyDJeB4XANVvKndbrrPk' -H "Content-type: application/json" -d '{
    "name": "Jan Vykydal",
    "availability":true,
    "mrl":96,
    "enabled-bitcoin":true,
    "bitcoin_on_demand":0.0001,
    "bitcoin_spot":0.00000113
}' 'https://api.clore.ai/v1/set_server_settings'
```

**आउटपुट:**

```
{
  "code": 0
}
```

#### 8. `set_spot_price` <a href="#id-8-set_spot_price" id="id-8-set_spot_price"></a>

**के बारे में**

अपने SPOT बाज़ार प्रस्ताव पर प्रति दिन मूल्य सेट करें

**शीर्षक**

| फ़ील्ड         | प्रकार     | अनिवार्य | विवरण                         |
| -------------- | ---------- | -------- | ----------------------------- |
| `auth`         | `स्ट्रिंग` | हाँ      | API टोकन                      |
| `Content-type` | `स्ट्रिंग` | हाँ      | होना चाहिए `application/json` |

**बॉडी**

| फ़ील्ड          | प्रकार     | अनिवार्य | विवरण                           |
| --------------- | ---------- | -------- | ------------------------------- |
| `order_id`      | `पूर्णांक` | हाँ      | अद्वितीय प्रस्ताव ID            |
| `desired_price` | `दशमलव`    | हाँ      | आपका प्रति दिन प्रस्तावित मूल्य |

> **सर्वर के वर्तमान स्पॉट फ़्लोर से कम मूल्य** वर्तमान न्यूनतम के साथ अस्वीकार कर दिया जाता है:
>
> ```
> { "error": "amount_too_low", "min_price": 0.0000012, "code": 6 }
> ```

**उदाहरण**

आइए स्पॉट बाज़ार मूल्य अपडेट करने का प्रयास करें

**इनपुट 1 (मूल्य घटाने का चरण बहुत बड़ा था):**

```
curl -XPOST -H 'auth: b8qwqRAL5W7YDyDJeB4XANVvKndbrrPk' -H "Content-type: application/json" -d '{
    "order_id":39,
    "desired_price":0.00000200
}' 'https://api.clore.ai/v1/set_spot_price'
```

**संभावित आउटपुट 1 (मूल्य घटाने का चरण बहुत बड़ा था):**\
आप स्पॉट बाज़ार प्रस्ताव मूल्य को अधिकतम 0.00000100 ₿ तक घटा सकते हैं

| फ़ील्ड     | प्रकार     | विवरण                                                           |
| ---------- | ---------- | --------------------------------------------------------------- |
| `code`     | `पूर्णांक` | स्थिति कोड                                                      |
| `त्रुटि`   | `स्ट्रिंग` | त्रुटि विवरण फ़ील्ड                                             |
| `max_step` | `दशमलव`    | वर्तमान में आप जिस तक मूल्य घटा सकते हैं, उसका न्यूनतम संभव मान |

```
{
    "error":"exceeded_max_step",
    "max_step":0.0000032,
    "code":6
}
```

**इनपुट 2 (वैध मूल्य चरण-घटाव):**

```
curl -XPOST -H 'auth: b8qwqRAL5W7YDyDJeB4XANVvKndbrrPk' -H "Content-type: application/json" -d '{
    "order_id":39,
    "desired_price":0.00000320
}' 'https://api.clore.ai/v1/set_spot_price'
```

**संभावित आउटपुट 2 (वैध मूल्य चरण-घटाव):**

```
{
    "code": 0
}
```

**इनपुट 3 (इनपुट 2 भेजने के बाद मूल्य और भी घटाएँ):**

```
curl -XPOST -H 'auth: b8qwqRAL5W7YDyDJeB4XANVvKndbrrPk' -H "Content-type: application/json" -d '{
    "order_id":39,
    "desired_price":0.00000220
}' 'https://api.clore.ai/v1/set_spot_price
```

**संभावित आउटपुट 3 (इनपुट 2 भेजने के बाद मूल्य और भी घटाएँ):**\
आप 600 सेकंड में एक बार स्पॉट मूल्य घटा सकते हैं

| फ़ील्ड             | प्रकार     | विवरण                                          |
| ------------------ | ---------- | ---------------------------------------------- |
| `code`             | `पूर्णांक` | स्थिति कोड                                     |
| `त्रुटि`           | `स्ट्रिंग` | त्रुटि विवरण फ़ील्ड                            |
| `time_to_lowering` | `दशमलव`    | मूल्य घटाने की अगली संभावना तक शेष समय (सेकंड) |

```
{
    "error":"can_lower_every_600_seconds",
    "time_to_lowering":513,
    "code":6
}
```

#### 9. `cancel_order` <a href="#id-9-cancel_order" id="id-9-cancel_order"></a>

**के बारे में**

एक सक्रिय ऑर्डर या स्पॉट प्रस्ताव रद्द करें

**शीर्षक**

| फ़ील्ड         | प्रकार     | अनिवार्य | विवरण                         |
| -------------- | ---------- | -------- | ----------------------------- |
| `auth`         | `स्ट्रिंग` | हाँ      | API टोकन                      |
| `Content-type` | `स्ट्रिंग` | हाँ      | होना चाहिए `application/json` |

**बॉडी**

| फ़ील्ड  | प्रकार     | अनिवार्य | विवरण                                                                                                                          |
| ------- | ---------- | -------- | ------------------------------------------------------------------------------------------------------------------------------ |
| `id`    | `पूर्णांक` | हाँ      | अद्वितीय ऑर्डर/प्रस्ताव ID                                                                                                     |
| `issue` | `स्ट्रिंग` | नहीं     | यदि आपको सर्वर के साथ कोई समस्या आई है, तो आप उन्हें रिपोर्ट कर सकते हैं [clore.ai](http://clore.ai/) टीम को, अधिकतम 2048 वर्ण |

**आउटपुट**

| फ़ील्ड | प्रकार     | विवरण      |
| ------ | ---------- | ---------- |
| `code` | `पूर्णांक` | स्थिति कोड |

**उदाहरण**

ऑर्डर/प्रस्ताव रद्द करें

**इनपुट:**\
इस उदाहरण में हम GPU #1 के साथ समस्याएँ रिपोर्ट कर रहे हैं; यदि आपको कोई समस्या नहीं है, तो issue फ़ील्ड शामिल न करें.\
आप text फ़ील्ड में कोई भी संदेश लिख सकते हैं और हम इसकी जाँच करेंगे

```
curl -XPOST -H 'auth: b8qwqRAL5W7YDyDJeB4XANVvKndbrrPk' -H "Content-type: application/json" -d '{
    "id":39,
    "issue":"GPU #1 Was overheating and throttling"
}' 'https://api.clore.ai/v1/cancel_order'
```

**आउटपुट:**

```
{
  "code": 0
}
```

#### 10. `create_order` <a href="#id-10-create_order" id="id-10-create_order"></a>

**के बारे में**

आप इस एंडपॉइंट से स्पॉट ऑफ़र या ऑन-डिमांड ऑर्डर बना सकते हैं

**शीर्षक**

| फ़ील्ड         | प्रकार     | अनिवार्य | विवरण                         |
| -------------- | ---------- | -------- | ----------------------------- |
| `auth`         | `स्ट्रिंग` | हाँ      | API टोकन                      |
| `Content-type` | `स्ट्रिंग` | हाँ      | होना चाहिए `application/json` |

**बॉडी**

| फ़ील्ड               | प्रकार     | अनिवार्य       | विवरण                                                                                                                                                                                                                                                 |
| -------------------- | ---------- | -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `currency`           | `स्ट्रिंग` | हाँ            | मुद्रा का नाम                                                                                                                                                                                                                                         |
| `image`              | `स्ट्रिंग` | हाँ            | Docker Hub से मान्य इमेज                                                                                                                                                                                                                              |
| `renting_server`     | `पूर्णांक` | हाँ            | जिस सर्वर को आप किराये पर लेना चाहते हैं उसका ID                                                                                                                                                                                                      |
| `type`               | `स्ट्रिंग` | हाँ            | `on-demand` या `spot`                                                                                                                                                                                                                                 |
| `spotprice`          | `दशमलव`    | निर्भर करता है | स्पॉट बाज़ार में प्रति दिन प्रस्तावित मूल्य, स्पॉट ऑर्डर बनाते समय आवश्यक                                                                                                                                                                             |
| `ports`              | `ऑब्जेक्ट` | नहीं           | पोर्ट फ़ॉरवर्डिंग कॉन्फ़िगरेशन, अधिकतम 5 रिकॉर्ड                                                                                                                                                                                                      |
| `env`                | `ऑब्जेक्ट` | नहीं           | <p>पर्यावरण चर, स्ट्रिंगाइज़ किए जाने पर कुल 12288 वर्णों तक सीमित.<br>चर नाम - अधिकतम 128 प्रतीक, इसमें नहीं होना चाहिए <code>-</code><br>चर मान - अधिकतम 1536 प्रतीक<br>केवल पहले 30 मान्य चर रखे जाते हैं; अतिरिक्त को चुपचाप हटा दिया जाता है</p> |
| `jupyter_token`      | `स्ट्रिंग` | नहीं           | Jupyter नोटबुक वाली इमेज के लिए Jupyter टोकन, अधिकतम 32 वर्ण \*                                                                                                                                                                                       |
| `ssh_key`            | `स्ट्रिंग` | नहीं           | SSH वाली इमेज के लिए SSH कुंजी, अधिकतम 3072 वर्ण \*                                                                                                                                                                                                   |
| `ssh_password`       | `स्ट्रिंग` | नहीं           | SSH वाली इमेज के लिए SSH पासवर्ड, अधिकतम 32 वर्ण \*                                                                                                                                                                                                   |
| `command`            | `स्ट्रिंग` | नहीं           | ऑर्डर बनने के बाद सर्वर पर कमांड चलाया जाएगा                                                                                                                                                                                                          |
| `required_price`     | `दशमलव`    | नहीं           | जिस मूल्य पर आप ऑर्डर शुरू करना चाहते हैं उसे निर्दिष्ट करें; यदि मशीन मालिक मूल्य बदलता है, तो ऑर्डर शुरू नहीं होगा (केवल ऑन-डिमांड)                                                                                                                 |
| `gpu_count`          | `पूर्णांक` | नहीं           | समर्थन करने वाले सर्वरों पर किराये के लिए GPUs की संख्या [आंशिक किराया](/clore.ai/clore.ai-eng-hi/for-renters/partial-gpu-rental.md). पूरे रिग को किराये पर लेने के लिए छोड़ दें। केवल ऑन-डिमांड, केवल समरूप रिग                                      |
| `gpu_indices`        | `[]int`    | नहीं           | किराये पर लेने के लिए 0-आधारित GPU स्लॉट सूचकांक; लंबाई बराबर होनी चाहिए `gpu_count`. मुक्त स्लॉट लें `partial_gpu_rental.free_indices`. बैकएंड को स्वतः मुक्त GPUs चुनने देने के लिए छोड़ दें                                                        |
| `autossh_entrypoint` | `बूल`      | नहीं           | clore.ai एंट्रीपॉइंट का उपयोग करें, जो स्वचालित रूप से SSH सर्वर और कस्टम `/root/onstart.sh` स्क्रिप्ट                                                                                                                                                |

\* तारांकन से चिह्नित फ़ील्डों में आप केवल इस regexp समूह के वर्ण ही डाल सकते हैं `/^[a-zA-Z0-9\s-=.@+/]+$/`

**आउटपुट**

| फ़ील्ड | प्रकार     | विवरण      |
| ------ | ---------- | ---------- |
| `code` | `पूर्णांक` | स्थिति कोड |

> **सर्वर के फ़्लोर से नीचे की स्पॉट बोलियाँ** वर्तमान न्यूनतम सहित अस्वीकार कर दी जाती हैं, इसलिए आप तुरंत पुनः प्रयास कर सकते हैं:
>
> ```
> { "error": "too_low_price", "min_price": 0.0000012, "code": 6 }
> ```
>
> फ़्लोर को लाइव कॉइन दरों से लगभग हर 10 मिनट में पुनर्गणना किया जाता है, इसलिए मार्केटप्लेस लिस्टिंग से पढ़ा गया मूल्य थोड़ा पुराना हो सकता है — हमेशा लौटाए गए `min_price` को पुनः प्रयास के लिए उपयोग करें।

**उदाहरण**

**इनपुट 1 (स्पॉट प्रस्ताव बनाएं):**

```
curl -XPOST -H 'auth: 6FcuR7ibcwKR1Z32lEFoSotzUUtzKO2H' -H "Content-type: application/json" -d '
{
    "currency":"bitcoin",
    "image":"cloreai/ubuntu20.04-jupyter",
    "renting_server":6,
    "type":"spot",
    "spotprice":0.000001,
    "ports":{
        "22":"tcp",
        "8888":"http"
    },
    "env":{
        "VARIABLE_NAME":"VARIABLE_VALUE",
    },
    "jupyter_token":"hoZluOjbCOQ5D5yH7R",
    "ssh_password":"Hpcj08ZaOpCbTmn1Eu",
    "command":"#!/bin/sh\napt update -y && apt install htop"
}' 'https://api.clore.ai/v1/create_order'
```

**आउटपुट 1 (स्पॉट प्रस्ताव बनाएं):**

```
{
  "code":0
}
```

**इनपुट 2 (ऑन-डिमांड ऑर्डर बनाएं):**

```
curl -XPOST -H 'auth: 6FcuR7ibcwKR1Z32lEFoSotzUUtzKO2H' -H "Content-type: application/json" -d '
{
    "currency":"bitcoin",
    "image":"cloreai/ubuntu20.04-jupyter",
    "renting_server":6,
    "type":"on-demand",
    "ports":{
        "22":"tcp",
        "8888":"http"
    },
    "env":{
        "VARIABLE_NAME":"VARIABLE_VALUE",
    },
    "jupyter_token":"hoZluOjbCOQ5D5yH7R",
    "ssh_password":"Hpcj08ZaOpCbTmn1Eu",
    "command":"#!/bin/sh\napt update -y && apt install htop"
}' 'https://api.clore.ai/v1/create_order'
```

**आउटपुट 2 (ऑन-डिमांड ऑर्डर बनाएं):**

```
{
  "code":0
}
```

#### 11. `renter_fees` <a href="#id-11-renter_fees" id="id-11-renter_fees"></a>

**के बारे में**

वर्तमान शुल्क कॉन्फ़िगरेशन प्राप्त करें: आधार किरायेदार शुल्क, PoH शुल्क में कमी सेटिंग्स, ऑर्डर निर्माण शुल्क, और आपका PoH बैलेंस

**शीर्षक**

| फ़ील्ड | प्रकार     | अनिवार्य | विवरण    |
| ------ | ---------- | -------- | -------- |
| `auth` | `स्ट्रिंग` | हाँ      | API टोकन |

**आउटपुट**

| फ़ील्ड                             | प्रकार     | विवरण                                                |
| ---------------------------------- | ---------- | ---------------------------------------------------- |
| `code`                             | `पूर्णांक` | स्थिति कोड                                           |
| `renter_fees.on_demand`            | `ऑब्जेक्ट` | ऑन-डिमांड ऑर्डरों के लिए प्रति मुद्रा आधार शुल्क (%) |
| `renter_fees.spot`                 | `ऑब्जेक्ट` | स्पॉट ऑर्डरों के लिए प्रति मुद्रा आधार शुल्क (%)     |
| `poh_config.max_reduction_percent` | `पूर्णांक` | PoH के माध्यम से अधिकतम आधार-शुल्क कमी (%)           |
| `poh_config.max_poh_amount`        | `पूर्णांक` | वह PoH बैलेंस जिस पर अधिकतम कमी प्राप्त होती है      |
| `creation_fees.on_demand`          | `ऑब्जेक्ट` | प्रति मुद्रा ऑर्डर निर्माण शुल्क                     |
| `creation_fees.spot`               | `ऑब्जेक्ट` | प्रति मुद्रा स्पॉट ऑर्डर निर्माण शुल्क               |
| `poh_balance`                      | `दशमलव`    | आपका PoH CLORE बैलेंस                                |

**इनपुट:**

```
curl -XGET -H 'auth: b8qwqRAL5W7YDyDJeB4XANVvKndbrrPk' 'https://api.clore.ai/v1/renter_fees'
```

**आउटपुट:**

```
{
  "renter_fees": {
    "on_demand": {
      "base": { "bitcoin": 5, "CLORE-Blockchain": 5, "USD-Blockchain": 5 }
    },
    "spot": {
      "base": { "bitcoin": 1.25, "CLORE-Blockchain": 1.25, "USD-Blockchain": 1.25 }
    }
  },
  "poh_config": { "max_reduction_percent": 50, "max_poh_amount": 2000000 },
  "creation_fees": {
    "on_demand": { "bitcoin": 3e-7, "CLORE-Blockchain": 0.5, "USD-Blockchain": 0.1 },
    "spot": { "bitcoin": 1e-7, "CLORE-Blockchain": 0.05, "USD-Blockchain": 0.005 }
  },
  "poh_balance": 5000,
  "code": 0
}
```

#### 12. `cancel_orders` <a href="#id-12-cancel_orders" id="id-12-cancel_orders"></a>

**के बारे में**

एक साथ कई ऑर्डर रद्द करें (प्रति अनुरोध अधिकतम 256)

**शीर्षक**

| फ़ील्ड         | प्रकार     | अनिवार्य | विवरण                         |
| -------------- | ---------- | -------- | ----------------------------- |
| `auth`         | `स्ट्रिंग` | हाँ      | API टोकन                      |
| `Content-type` | `स्ट्रिंग` | हाँ      | होना चाहिए `application/json` |

**बॉडी**

| फ़ील्ड      | प्रकार  | अनिवार्य | विवरण                                  |
| ----------- | ------- | -------- | -------------------------------------- |
| `order_ids` | `[]int` | हाँ      | रद्द करने के लिए ऑर्डर IDs, अधिकतम 256 |

**आउटपुट**

| फ़ील्ड             | प्रकार     | विवरण                                      |
| ------------------ | ---------- | ------------------------------------------ |
| `code`             | `पूर्णांक` | स्थिति कोड                                 |
| `failed_to_cancel` | `[]int`    | वे ऑर्डर IDs जिन्हें रद्द नहीं किया जा सका |

**इनपुट:**

```
curl -XPOST -H 'auth: b8qwqRAL5W7YDyDJeB4XANVvKndbrrPk' -H "Content-type: application/json" -d '{
    "order_ids": [38, 39]
}' 'https://api.clore.ai/v1/cancel_orders'
```

**आउटपुट:**

```
{
  "failed_to_cancel": [],
  "code": 0
}
```

#### 13. `poh_balance` <a href="#id-13-poh_balance" id="id-13-poh_balance"></a>

**के बारे में**

अपना Proof of Holding बैलेंस प्राप्त करें: आइटम, कुल, और PoH मार्केटप्लेस प्रस्ताव राशियाँ

**शीर्षक**

| फ़ील्ड | प्रकार     | अनिवार्य | विवरण    |
| ------ | ---------- | -------- | -------- |
| `auth` | `स्ट्रिंग` | हाँ      | API टोकन |

**आउटपुट**

| फ़ील्ड                                        | प्रकार       | विवरण                                          |
| --------------------------------------------- | ------------ | ---------------------------------------------- |
| `code`                                        | `पूर्णांक`   | स्थिति कोड                                     |
| `items`                                       | `[]ऑब्जेक्ट` | आपके PoH आइटम उनके व्यक्तिगत बैलेंस के साथ     |
| `balance.total`                               | `दशमलव`      | सभी आइटमों का कुल PoH बैलेंस                   |
| `balance.free_amount`                         | `दशमलव`      | प्रस्तावों में प्रतिबद्ध न किया गया PoH बैलेंस |
| `balance.reward_amount`                       | `दशमलव`      | इनाम के लिए पात्र बैलेंस                       |
| `balance.offers.rented_amount`                | `दशमलव`      | अन्य उपयोगकर्ताओं को किराये पर दी गई राशि      |
| `balance.offers.rented_on_marketplace_amount` | `दशमलव`      | PoH मार्केटप्लेस पर सूचीबद्ध राशि              |
| `balance.offers.leased_amount`                | `दशमलव`      | अन्य उपयोगकर्ताओं से ली गई राशि                |

**इनपुट:**

```
curl -XGET -H 'auth: b8qwqRAL5W7YDyDJeB4XANVvKndbrrPk' 'https://api.clore.ai/v1/poh_balance'
```

**आउटपुट:**

```
{
  "items": [ { "balance": 5000 } ],
  "balance": {
    "total": 5000,
    "free_amount": 4000,
    "reward_amount": 5000,
    "offers": {
      "rented_amount": 0,
      "rented_on_marketplace_amount": 1000,
      "rented_finished_amount": 0,
      "leased_amount": 0
    }
  },
  "code": 0
}
```

#### 14. `server-config.json` <a href="#id-14-server-config-json" id="id-14-server-config-json"></a>

**के बारे में**

स्थिर API कॉन्फ़िगरेशन डेटा प्राप्त करें। प्रमाणीकरण आवश्यक नहीं है

**इनपुट:**

```
curl -XGET 'https://api.clore.ai/v1/server-config.json'
```

#### 15. `get_relay` <a href="#id-15-get_relay" id="id-15-get_relay"></a>

**के बारे में**

आपके पहचाने गए देश के लिए TCP फ़ॉरवर्डिंग रिले नोड्स प्राप्त करें। प्रमाणीकरण आवश्यक नहीं है

**आउटपुट**

| फ़ील्ड  | प्रकार     | विवरण              |
| ------- | ---------- | ------------------ |
| `code`  | `पूर्णांक` | स्थिति कोड         |
| `देश`   | `स्ट्रिंग` | पहचाना गया देश कोड |
| `नोड्स` | `ऑब्जेक्ट` | उपलब्ध रिले नोड्स  |

**इनपुट:**

```
curl -XGET 'https://api.clore.ai/v1/get_relay'
```


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.clore.ai/clore.ai/clore.ai-eng-hi/for-hosts/api.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.