getMyTonBalanceПоддерживается
Синоним метода getMyGramBalance в NextGram: тот же обработчик, параметры и ответ. Расширение NextGram (в официальном Bot API его нет). Возвращает баланс бота в коинах — внутренней валюте NextGram, которую бот получает за оплаченные счета в коинах (sendGramInvoice, createGramInvoiceLink, sendInvoice с currency "TON"). Аналог getMyStarBalance для коинов. Синоним — getMyTonBalance. Returns an object with the bot balance in GRAM on success.
Метод NextGram. Баланс — сумма оплаченных счетов в коинах минус возвраты (refundGramPayment) и выводы (withdrawGramBalance). Баланс в Starsх — getMyStarBalance.
Параметры
Метод не принимает параметров.
Что возвращает
| Поле | Тип | Описание |
|---|---|---|
currency | String | Всегда "TON" (так коины обозначаются в счетах и платежах). |
amount | Integer | Баланс в нанотонах (1 коин = 1000000000). |
nanoton_amount | Integer | То же, что amount: баланс в нанотонах. |
gram_amount | String | Баланс в коинах десятичной строкой без лишних нулей: "1.5", "0.01", "0". |
Ошибки
Ошибка приходит как {"ok": false, "error_code": 400, "description": "Bad Request: КОД: пояснение"}, если не указано иное.
| Ошибка | Когда |
|---|---|
401 Unauthorized | неверный токен бота |
501 METHOD_NOT_FOUND | платежи в коинах на сервере отключены |
Пример запроса
curl "https://api.mirviss.ru/bot$TOKEN/getMyTonBalance"from aiogram import Bot
from aiogram.client.session.aiohttp import AiohttpSession
from aiogram.client.telegram import TelegramAPIServer
from aiogram.methods.base import TelegramMethod
# Метода NextGram нет в aiogram: описываем его сами, bot(...) отправит запрос как обычно.
class GetMyTonBalance(TelegramMethod[dict]):
__returning__ = dict
__api_method__ = "getMyTonBalance"
session = AiohttpSession(api=TelegramAPIServer.from_base("https://api.mirviss.ru"))
bot = Bot(TOKEN, session=session)
balance = await bot(GetMyTonBalance())
print(balance["gram_amount"], balance["nanoton_amount"]) # "1.5" 1500000000const res = await fetch(`https://api.mirviss.ru/bot${TOKEN}/getMyTonBalance`);
const { result } = await res.json();
console.log(result.gram_amount); // "1.5"Ответ (Object)
{
"ok": true,
"result": {
"currency": "TON",
"amount": 1500000000,
"nanoton_amount": 1500000000,
"gram_amount": "1.5"
}
}