Developers · 2026

API for Telegram Stars, Premium and TON

Send Stars, Premium and TON top-ups by @username from your shop, bot or CRM via the OREO.TG HTTP API. Idempotency keys, sandbox environment, webhooks for order status. Prices update in real time, following the TON rate.

Quick example

POST https://api.oreo.tg/v1/orders
Content-Type: application/json
Idempotency-Key: 6f1f3c0b-7c9b-4e3e-9b7c-91a4...
Authorization: Bearer YOUR_API_KEY

{
  "categoryId": "stars",
  "amount": 100,
  "recipientUsername": "@example"
}

Idempotency keys

Send Idempotency-Key on every POST — no double-charge, no double-delivery, even on flaky networks.

Sandbox environment

A real-looking sandbox bot for end-to-end tests. Zero TON and Stars spent on QA.

Webhooks

Created, paid, delivered, refunded — push events to your URL with HMAC signature. No long-polling.

Real-time prices

Get a quote, lock it for 60 seconds, charge your customer at the exact rate. No TON-rate surprises.

OpenAPI 3.1

Generate clients for TypeScript, Python, Go and PHP from OpenAPI 3.1. SDK starters for Node and Python.

Custom SLA

From 100 orders / month — dedicated limits, 99.95%+ SLA, priority support and a personal account manager.

Core endpoints

  • GET/v1/categoriesList of products and price tiers
  • POST/v1/ordersCreate an order from a preset (Stars / Premium / TON)
  • GET/v1/orders/:labelOrder status, recipient, amount, timeline
  • POST/v1/orders/:label/payCreate a payment session
  • POST/v1/orders/:label/refundFull or partial refund (within the allowed window)
  • GET/v1/balanceAccount balance and partner limits

Need access?

Message us on Telegram @helIo_stars. We'll issue your API key, share docs and discuss volume terms.

Connect API →