مستندات API استارد (Stard API)
API رسمی Stard Market برای خرید خودکار استارز تلگرام، پریمیوم، گیفت، یوزرنیم و شماره و دریافت قیمتهای لحظهای.
sk_live_ یا sk_test_ در هدر Authorization کار میکند و به برنامهی تو اجازه میدهد قیمت استارز و محصولات تلگرام را بخواند و سفارش واقعی ثبت کند.Stard API چیست؟
Stard API یک REST API با پاسخ JSON است که همان امکانات فروشگاه و ربات Stard را در اختیار برنامهی تو میگذارد: دیدن محصولات و قیمتها، ثبت سفارش واقعی با پرداخت خودکار از کیف پول API (TON یا تومان) و پیگیری وضعیت سفارش. هیچ سیستم جداگانهای پشتش نیست؛ سفارشهای API دقیقاً با همان موتورهای خودکاری انجام میشوند که سفارشهای مینیاپ را انجام میدهند.
شروع سریع
از ساخت کلید تا اولین درخواست در ۵ دقیقه
مرجع API
همهی endpointها با نمونه در ۶ زبان
API Explorer
درخواست واقعی از داخل مرورگر
محیط test
تست کامل بدون پول واقعی
آدرس پایه و قالب
همهی درخواستها به https://stard-market.ir/api/v1 فرستاده میشوند، با HTTPS و JSON (UTF-8). مبلغها عدد صحیح توماناند (currency: "IRT") و مقدار TON رشتهی دقیق با ۹ رقم اعشار، تا هیچ خطای گرد کردن پیش نیاید. زمانها ISO 8601 به وقت UTC هستند.
curl "https://stard-market.ir/api/v1/ping" \
-H "Authorization: Bearer $STARD_API_KEY"const res = await fetch("https://stard-market.ir/api/v1/ping", {
method: "GET",
headers: {
Authorization: `Bearer ${process.env.STARD_API_KEY}`,
},
});
const data = await res.json();
if (!res.ok) throw new Error(`${data.error.code}: ${data.error.message}`);
console.log(data);type StardError = { error: { type: string; code: string; message: string; param: string | null; request_id: string } };
const res = await fetch("https://stard-market.ir/api/v1/ping", {
method: "GET",
headers: {
Authorization: `Bearer ${process.env.STARD_API_KEY}`,
},
});
if (!res.ok) {
const { error } = (await res.json()) as StardError;
throw new Error(`${error.code}: ${error.message} (${error.request_id})`);
}
const data: Record<string, unknown> = await res.json();import os
import requests
r = requests.get(
"https://stard-market.ir/api/v1/ping",
headers={
"Authorization": f"Bearer {os.environ['STARD_API_KEY']}",
},
timeout=20,
)
data = r.json()
if r.status_code >= 400:
raise RuntimeError(f"{data['error']['code']}: {data['error']['message']}")
print(data)<?php
$ch = curl_init("https://stard-market.ir/api/v1/ping");
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer " . getenv("STARD_API_KEY"),
],
CURLOPT_TIMEOUT => 20,
]);
$data = json_decode(curl_exec($ch), true);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
if ($status >= 400) {
throw new RuntimeException($data["error"]["code"] . ": " . $data["error"]["message"]);
}
print_r($data);package main
import (
"fmt"
"io"
"net/http"
"os"
)
func main() {
req, _ := http.NewRequest("GET", "https://stard-market.ir/api/v1/ping", nil)
req.Header.Set("Authorization", "Bearer "+os.Getenv("STARD_API_KEY"))
res, err := http.DefaultClient.Do(req)
if err != nil {
panic(err)
}
defer res.Body.Close()
b, _ := io.ReadAll(res.Body)
fmt.Println(res.StatusCode, string(b))
}چه کارهایی میشود کرد؟
- قیمت لحظهای استارز، TON، دلار و تلگرام پریمیوم —
GET /prices،GET /stars/price - جستجوی همهی محصولات: گیفت، NFT، یوزرنیم، شماره، پریمیوم —
GET /products - خرید خودکار استارز و محصولات با پرداخت از کیف پول —
POST /orders - پیگیری و لغو سفارش —
GET /orders/{id}،POST /orders/{id}/cancel - موجودی کیف پول و تراکنشها —
GET /wallet - مزایدهها و آمار بازار —
GET /auctions
