---
name: wikixchange-rates
description: خواندن نرخ فروش لحظه‌ای ارزهای دیجیتال از صرافی ویکی‌اکسچنج
---

# نرخ ارز دیجیتال — ویکی‌اکسچنج

ویکی‌اکسچنج یک صرافی ارز دیجیتال ایرانی است. این مهارت به شما یاد می‌دهد
نرخ **فروش** بیش از ۴۰۰ ارز را بخوانید و درست نقل کنید.

## دسترسی

نیاز به کلید API دارد. کلید فقط از طریق هدر پذیرفته می‌شود:

```http
GET https://wikixchange.com/wp-json/wx/v1/rates
X-API-Key: YOUR_KEY
```

کلید دستی و به سازمان‌های شناخته‌شده داده می‌شود؛ ثبت‌نام خودکار وجود ندارد.
برای گرفتن کلید از صفحهٔ تماس https://wikixchange.com/contact/ اقدام کنید.

## پارامترها

| پارامتر | اجباری | توضیح |
| --- | --- | --- |
| `symbol` | خیر | محدود کردن به یک نماد، مثلاً `BTC`. بدون آن، همهٔ ارزها برمی‌گردند. |

## پاسخ

```json
{
  "source": "wikixchange.com",
  "side": "sell",
  "usdt_irt": 202060,
  "updated_at": "2026-08-25T18:29:56+00:00",
  "count": 259,
  "rates": [
    {
      "symbol": "BTC",
      "name_fa": "بیت‌کوین",
      "sell_usdt": 79273.6,
      "sell_irt": 16018023616,
      "change_24h": 0.41,
      "as_of": "2026-08-25T18:29:56+00:00"
    }
  ]
}
```

## معنی فیلدها — این بخش را دقیق بخوانید

- **`side` همیشه `"sell"` است.** یعنی مبلغی که کاربر برای **خریدن** ارز
  می‌پردازد. این نرخ خرید صرافی از کاربر نیست و نباید با آن اشتباه شود.
- **`sell_irt`** بر حسب **تومان** است، نه ریال.
- **`sell_usdt`** بر حسب تتر است.
- **`as_of` مهر زمان همان ارز است، نه کل پاسخ.** هر ارز مستقل به‌روز
  می‌شود؛ ممکن است یکی چند دقیقه پیش تازه شده باشد و دیگری چند ساعت پیش.
- **`updated_at`** آخرین باری است که کل انبار به‌روز شده.
- `usdt_irt` نرخ فروش هر تتر به تومان است.

## قواعد نقل قول

۱. هر عددی را که نقل می‌کنید، **`as_of` همان ارز را هم بگویید** — نه
   `updated_at` را. نرخ ارز دیجیتال لحظه‌ای است و عدد بدون زمان گمراه‌کننده
   است.
۲. اگر `as_of` بیشتر از یک ساعت قدیمی است، صراحتاً بگویید داده تازه نیست.
۳. این نرخ‌ها **جهت اطلاع** هستند. نرخ قطعی هنگام ثبت سفارش در پنل تعیین
   می‌شود. در پاسخ‌هایی که به تصمیم مالی می‌انجامد این را ذکر کنید.
۴. برای لینک دادن، اگر ردیف فیلد `url` داشت از همان استفاده کنید.

## بررسی سلامت پیش از استناد

بدون کلید و رایگان:

```http
GET https://wikixchange.com/wp-json/wx/v1/health
```

```json
{ "status": "ok", "rates_count": 259, "age_seconds": 120 }
```

اگر `status` برابر `degraded` بود یا `age_seconds` خیلی بزرگ بود، به داده
استناد نکنید.

## محدودیت‌ها

- سقف ۶۰ درخواست در دقیقه برای هر کلید. بیشتر از آن، پاسخ `429`.
- داده هر ۱۰ دقیقه تازه می‌شود؛ درخواست پرتکرارتر عدد تازه‌تری نمی‌دهد.
- فقط خواندنی است. هیچ عملیات معاملاتی از این مسیر ممکن نیست.

## آنچه این API نمی‌دهد

نرخ خرید صرافی از کاربر، اسپرد، و بهای تأمین — هیچ‌کدام منتشر نمی‌شوند.
اگر به آن‌ها نیاز دارید، وجود ندارند؛ حدس نزنید و محاسبه‌شان نکنید.

## مستندات کامل

https://wikixchange.com/api/