---
title: برداشت TON — POST /api/v1/wallet/ton/withdrawals | Stard API
url: https://stard-market.ir/docs/reference/ton-withdraw
markdown: https://stard-market.ir/docs/reference/ton-withdraw.md
language: fa
updated: 2026-11-18
description: برداشت TON فقط به کیف پولی که مالک حساب با TON Connect در مینی‌اپ وصل کرده (آدرس دلخواه پذیرفته نمی‌شود تا کلید لو‌رفته نتواند پول را جای دیگری بفرستد). بر
---

# برداشت TON

`POST /api/v1/wallet/ton/withdrawals`

> برداشت TON فقط به کیف پولی که مالک حساب با TON Connect در مینی‌اپ وصل کرده (آدرس دلخواه پذیرفته نمی‌شود تا کلید لو‌رفته نتواند پول را جای دیگری بفرستد). برداشت‌های غیرعادی به صف بررسی می‌روند.

## درخواست

| نام | محل | نوع |  | توضیح |
|---|---|---|---|---|
| `Authorization` | header | `string` | الزامی | `Bearer sk_live_…` یا `Bearer sk_test_…` |

### بدنه (JSON)

| فیلد | نوع |  | توضیح |
|---|---|---|---|
| `source` | `string` | الزامی | ton یا toman |
| `amount` | `string` | الزامی | مبلغ |

## نمونه

```bash
curl -X POST "https://stard-market.ir/api/v1/wallet/ton/withdrawals" \
  -H "Authorization: Bearer $STARD_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"source": "ton", "amount": "2.5"}'
```

```javascript
const res = await fetch("https://stard-market.ir/api/v1/wallet/ton/withdrawals", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.STARD_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "source": "ton",
    "amount": "2.5"
  }),
});
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/wallet/ton/withdrawals", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.STARD_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "source": "ton",
    "amount": "2.5"
  }),
});
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.post(
    "https://stard-market.ir/api/v1/wallet/ton/withdrawals",
    headers={
    "Authorization": f"Bearer {os.environ['STARD_API_KEY']}",
    },
    json={
        "source": "ton",
        "amount": "2.5"
    },
    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/wallet/ton/withdrawals");
curl_setopt_array($ch, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_CUSTOMREQUEST => "POST",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer " . getenv("STARD_API_KEY"),
    "Content-Type: application/json",
  ],
  CURLOPT_POSTFIELDS => json_encode([
    "source" => "ton",
    "amount" => "2.5"
  ]),
  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"
	"strings"
)

func main() {
	body := strings.NewReader(`{"source": "ton", "amount": "2.5"}`)
	req, _ := http.NewRequest("POST", "https://stard-market.ir/api/v1/wallet/ton/withdrawals", body)
	req.Header.Set("Authorization", "Bearer "+os.Getenv("STARD_API_KEY"))
	req.Header.Set("Content-Type", "application/json")
	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))
}
```

## خطاها

| HTTP | code | کی |
|---|---|---|
| `400` | `ton_wallet_not_linked` | کیف پول TON وصل نیست |
| `400` | `live_only` | فقط با کلید live |
| `403` | `insufficient_scope` | کلید scope `wallet:write` را ندارد |
| `401` | `invalid_api_key / missing_api_key / api_key_revoked / api_key_expired` | کلید نیامده، نامعتبر، باطل یا منقضی است |
| `429` | `rate_limit_exceeded` | سقف درخواست در دقیقه پر شده؛ بعد از `Retry-After` ثانیه دوباره بفرست |

## محدودیت نرخ

پیش‌فرض ۶۰ درخواست در دقیقه برای هر کلید (قابل تنظیم در داشبورد). وضعیت در هدرهای `X-RateLimit-*` برمی‌گردد — [جزئیات](https://stard-market.ir/docs/rate-limits).
