Получить баланс

Возвращает текущий баланс USD.

Баланс

GET /v1/balance

curl -X GET "https://api.zelnum.com/api/v1/balance" \
  -H "X-API-Key: YOUR_KEY_HERE"

{
  "balance": "5.230000"
}

Поле	Тип	Описание
`balance`	string	Доступный баланс в USD с фиксированными 6 знаками после запятой.

Информация о ключе

Возвращает метаданные ключа, использованного в запросе. Сам секрет не возвращается — только маскированный префикс, чтобы понять, какой ключ использовался, не раскрывая его.

GET /v1/api-key

curl -X GET "https://api.zelnum.com/api/v1/api-key" \
  -H "X-API-Key: YOUR_KEY_HERE"

{
  "api_key_id": 12,
  "masked_key": "ck_xxxxxxxxx…****",
  "last_used": "2026-09-12T09:14:03.000000Z",
  "created_at": "2026-08-30T11:02:44.000000Z"
}

Поле	Тип	Описание
`api_key_id`	integer	Идентификатор ключа — удобно указывать в обращениях в поддержку.
`masked_key`	string	Маскированный префикс. Открытый ключ здесь никогда не возвращается.
`last_used`	string \| null	Время последнего запроса, прошедшего аутентификацию с этим ключом.
`created_at`	string	Когда ключ был создан.

Запросы к API ограничиваются по API-ключу и по группе эндпоинтов:

Эндпоинты	Лимит
`GET /v1/balance` · `GET /v1/api-key`	60 запросов / минуту на API-ключ (120 / минуту на IP)

Ошибки

Статус	`code`	Причина
`401`	`unauthorized`	API-ключ отсутствует, неверен или деактивирован.
`403`	`account_banned`	Аккаунт заблокирован. Обратитесь в поддержку.
`429`	—	Достигнут лимит запросов — см. Лимиты.

Оба эндпоинта используют общий бакет: 60 запросов / минуту на ключ API.