---
title: قیمت‌های لحظه‌ای | Stard API
url: https://stard-market.ir/docs/prices
markdown: https://stard-market.ir/docs/prices.md
language: fa
updated: 2026-11-18
description: قیمت استارز، TON، دلار و پریمیوم به تومان، از همان منبعی که ربات و فروشگاه با آن کار می‌کنند.
---

# قیمت‌های لحظه‌ای

> قیمت استارز، TON، دلار و پریمیوم به تومان، از همان منبعی که ربات و فروشگاه با آن کار می‌کنند.

## همه‌ی نرخ‌ها

```bash
curl "https://stard-market.ir/api/v1/prices" \
  -H "Authorization: Bearer $STARD_API_KEY"
```

```javascript
const res = await fetch("https://stard-market.ir/api/v1/prices", {
  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);
```

```typescript
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/prices", {
  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();
```

```python
import os
import requests

r = requests.get(
    "https://stard-market.ir/api/v1/prices",
    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
<?php
$ch = curl_init("https://stard-market.ir/api/v1/prices");
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);
```

```go
package main

import (
	"fmt"
	"io"
	"net/http"
	"os"
)

func main() {
	req, _ := http.NewRequest("GET", "https://stard-market.ir/api/v1/prices", 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))
}
```

**پاسخ**

```json
{
  "object": "prices",
  "currency": "IRT",
  "star": {
    "amount": 4382,
    "unit": "1 star"
  },
  "ton": {
    "amount": 385770,
    "usd": 1.4976
  },
  "usd": {
    "amount": 256300
  },
  "ton_per_50_stars": 0.5005,
  "updated_at": "2026-10-01T10:31:48Z"
}
```

## به‌روزرسانی

نرخ‌ها حداکثر هر دو دقیقه از منبع به‌روز می‌شوند. برای نمایش در اپ، کش ۳۰ تا ۶۰ ثانیه‌ای کافی است؛ مبلغ نهایی هر سفارش همیشه همان لحظه‌ی ثبت محاسبه می‌شود.
