Цены и баланс

ЦеныCopy Anchor Link

Цены указаны в USD: за одну звезду и за Premium на 3, 6 и 12 месяцев.

GET /v1/prices

{
  "currency": "USD",
  "stars": { "unitPrice": "0.0165", "min": 50, "max": 1000000 },
  "premium": [
    { "months": 3, "price": "12.99" },
    { "months": 6, "price": "16.99" },
    { "months": 12, "price": "29.99" }
  ]
}

Суммы передаются строками в долларах США; цена Stars = unitPrice × quantity (500 звёзд × "0.0165" = $8.25). Цена фиксируется в заказе в момент создания: если прайс изменится, уже созданные заказы не пересчитываются.

Режимы пулаCopy Anchor Link

Режим задаётся на ваш аккаунт; цены по умолчанию для режима могут быть переопределены индивидуально.

БалансCopy Anchor Link

GET /v1/balance

{ "currency": "USD", "available": "250.00", "held": "8.25", "creditLimit": "0.00", "unlimitedCredit": false }

• available можно тратить; held заблокировано под заказы в работе.
• Создание заказа блокирует сумму (HOLD), SUCCEEDED списывает её (CAPTURE), FAILED возвращает (RELEASE).
• Если available + creditLimit меньше цены заказа, ответ будет 402 (-9301). При unlimitedCredit: true (включает iFragment по договорённости) заказы не упираются в баланс, долг гасится пополнением.
• Пополнение выполняется по договору, вручную; каждое движение видно в кабинете (ledger).

curl -X GET "https://example.com/v1/prices"

{  "success": true,  "data": {    "currency": "USD",    "stars": {      "unitPrice": "0.0165",      "min": 50,      "max": 1000000    },    "premium": [      {        "months": 3,        "price": "12.99"      },      {        "months": 6,        "price": "16.99"      },      {        "months": 12,        "price": "29.99"      }    ]  },  "meta": {    "requestId": "9f1c2b7e-3a4d-4e5f-8a6b-7c8d9e0f1a2b",    "timestamp": "2026-10-06T09:15:22.481Z",    "processingTimeMs": 38  }}

curl -X GET "https://example.com/v1/balance"

{  "success": true,  "data": {    "currency": "USD",    "available": "248.35",    "held": "1.65",    "creditLimit": "0.00",    "unlimitedCredit": false  },  "meta": {    "requestId": "9f1c2b7e-3a4d-4e5f-8a6b-7c8d9e0f1a2b",    "timestamp": "2026-10-06T09:15:22.481Z",    "processingTimeMs": 38  }}