getMyStarBalance

Category: Payments · Bot API 10.3 · Official documentation

Returns the bot's Telegram Stars balance.

Returns: On success, returns StarAmount.

Parameters

This method has no parameters — just call it with your bot token.

Example request

curl

curl -s "https://api.telegram.org/bot$TOKEN/getMyStarBalance"

Python

import requests

TOKEN = "123456789:AAEexampleTokenReplaceWithYours"
resp = requests.get(f"https://api.telegram.org/bot{TOKEN}/getMyStarBalance", timeout=30)
print(resp.json())

JavaScript

const TOKEN = "123456789:AAEexampleTokenReplaceWithYours";
const res = await fetch(`https://api.telegram.org/bot${TOKEN}/getMyStarBalance`);
console.log(await res.json());

Step-by-step guide: How to Create a Telegram Bot: Step by Step with BotFather and Python

Related methods

• sendInvoiceSends an invoice for payment.
• createInvoiceLinkCreates a payment link.
• refundStarPaymentRefunds a Telegram Stars payment.
• sendGiftSends a gift to a user or chat.
• getStarTransactionsReturns bot's Telegram Stars transactions.
• editUserStarSubscriptionCancels or renews a Telegram Stars subscription.
• giftPremiumSubscriptionGifts a Telegram Premium subscription.
• answerShippingQueryAnswers a shipping query.
• answerPreCheckoutQueryAnswers a pre-checkout query.
• getAvailableGiftsReturns available gifts the bot can send.
• getUserGiftsReturns user's gifts.
• getChatGiftsReturns chat's gifts.