egotg 0.1.0

ego.tg — SMS Aggregation SDK. One API, every SMS provider.

egotg

Official Python SDK for ego.tg — SMS aggregation platform. One API, every SMS provider.

Install

pip install egotg

Quick Start

import egotg

client = egotg.Client("your_api_key")

# Get cheapest WhatsApp number
number = client.get_number(service="wa", country="auto")
print(f"Use this number: +{number.phone}")

# Wait for verification code
code = number.wait_for_code(timeout=120)
print(f"Got code: {code}")

# Done
number.complete()

API

Client

client = egotg.Client("your_api_key")
client = egotg.Client("your_api_key", base_url="https://ego.tg/api")

Account

balance = client.balance()  # Returns float (USD)

Services & Pricing

services = client.services()       # [{"code": "tg", "name": "Telegram"}, ...]
countries = client.countries()     # {"22": {"id": "22", "eng": "India"}, ...}
prices = client.prices("tg")      # Sorted by price ascending
prices = client.prices("wa", country="22")  # Filter by country

Buy Numbers

# Auto-select cheapest country
number = client.get_number(service="tg", country="auto")

# Specific country
number = client.get_number(service="wa", country="22")

print(number.phone)    # "628123456789"
print(number.service)  # "wa"
print(number.status)   # "waiting"

Wait for Code

code = number.wait_for_code(timeout=120, interval=5)
# Polls every 5s for up to 120s, returns the code string
# Raises TimeoutError if no code received

Complete / Cancel

number.complete()           # Mark as used
refund = number.cancel()    # Cancel and get refund

Error Handling

from egotg import InsufficientBalance, NoNumbers, EgoError

try:
    number = client.get_number(service="tg")
except InsufficientBalance:
    print("Top up at https://ego.tg/payments")
except NoNumbers:
    print("Try a different service or country")
except EgoError as e:
    print(f"API error: {e}")

Supported Services

190+ countries, 500+ services including:

Code	Service
tg	Telegram
wa	WhatsApp
ig	Instagram
go	Google
tw	Twitter/X
fb	Facebook
mt	Steam
nf	Netflix
am	Amazon

Links

• Dashboard
• API Docs
• Pricing