StardDevelopersداشبورد

خرید استارز تلگرام با API

قیمت لحظه‌ای استارز را بگیر و با یک درخواست، استارز را مستقیم به یوزرنیم تلگرام گیرنده بفرست؛ ارسال خودکار است.

پاسخ کوتاه: بله. با POST /api/v1/orders و بدنه‌ی {"type":"stars","quantity":500,"recipient":"@username"} استارز تلگرام خریده و خودکار به گیرنده فرستاده می‌شود؛ مبلغ از کیف پول Stard کسر می‌شود.

قیمت

curl "https://stard-market.ir/api/v1/stars/price?quantity=500" \
  -H "Authorization: Bearer $STARD_API_KEY"
پاسخ
{
  "object": "stars_price",
  "quantity": 500,
  "unit_price": 4382,
  "amount": 2191000,
  "currency": "IRT",
  "updated_at": "2026-10-01T10:31:49Z"
}

خرید

حداقل ۵۰ استارز. گیرنده فقط با یوزرنیم تلگرام (نه آیدی عددی).

curl -X POST "https://stard-market.ir/api/v1/orders" \
  -H "Authorization: Bearer $STARD_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: stars-7781" \
  -d '{"type": "stars", "quantity": 500, "recipient": "@username"}'

تحویل

استارز با موتور خودکار Stard به‌صورت آنی (معمولاً کمتر از یک دقیقه) به حساب گیرنده می‌رسد. وضعیت را با GET /orders/{id} دنبال کن؛ وقتی status برابر completed شد، تحویل انجام شده است.

پرسش‌های رایج

حداقل خرید استارز از API چقدر است؟

۵۰ استارز.

می‌شود به آیدی عددی استارز فرستاد؟

نه؛ تلگرام استارز را فقط به یوزرنیم می‌فرستد.