StardDevelopersداشبورد

قیمت فروش TON (کیف به کیف / کیف پول تلگرام)

GET/api/v1/ton/sell/quote
scope: prices:readاحراز هویت: Bearerlive و test

مبلغی که از کیف پول حساب کسر می‌شود تا گیرنده دقیقاً amount_ton بگیرد. قیمت هر تون = نرخ لحظه‌ای TON + کارمزد هر تون استارد؛ کارمزد شبکه را استارد می‌پردازد. برای هر دو مقصد (آدرس و یوزرنیم) یکی است. سقف هر ارسال و سقف ۲۴ ساعته هم در پاسخ می‌آید.

درخواست

ناممحلنوعتوضیح
AuthorizationheaderstringالزامیBearer sk_live_… یا Bearer sk_test_…
amount_tonquerystringالزامیمقداری که گیرنده می‌گیرد؛ حداقل 0.1
sourcequerystringاختیاریtoman (پیش‌فرض، از کیف تومانی) یا ton (از موجودی TON)

نمونه

curl "https://stard-market.ir/api/v1/ton/sell/quote?amount_ton=1.5&source=toman" \
  -H "Authorization: Bearer $STARD_API_KEY"
پاسخ — 200
{
  "object": "ton_sell_quote",
  "receive_ton": "1.5",
  "source": "toman",
  "pay": {
    "amount": 645000,
    "currency": "IRT"
  },
  "ton_rate_toman": 400000,
  "price_per_ton_toman": 430000,
  "network_fee": "paid by Stard",
  "min_ton": "0.1",
  "environment": "live",
  "limits": {
    "max_per_request_ton": "20",
    "max_per_24h_ton": "50"
  }
}

خطاها

HTTPcodeکی
400parameter_invalidمقدار کمتر از 0.1 یا نامعتبر
503unavailableنرخ لحظه‌ای TON در دسترس نیست
403insufficient_scopeکلید scope prices:read را ندارد
401invalid_api_key / missing_api_key / api_key_revoked / api_key_expiredکلید نیامده، نامعتبر، باطل یا منقضی است
429rate_limit_exceededسقف درخواست در دقیقه پر شده؛ بعد از Retry-After ثانیه دوباره بفرست

محدودیت نرخ

پیش‌فرض ۶۰ درخواست در دقیقه برای هر کلید (قابل تنظیم در داشبورد). وضعیت در هدرهای X-RateLimit-* برمی‌گردد — جزئیات.