---
title: خطاهای رایج
description: کدهای خطا، وضعیت HTTP و توضیحات مربوط به پاسخ‌های Open API.
sidebar:
  label: خطاهای رایج
  icon: circle-alert
  order: 7
---

همه‌ی خطاها به شکل `{ code, message, statusCode }` بازگردانده می‌شوند.

| کد | وضعیت | توضیح |
| --- | --- | --- |
| `AUTH_HEADERS_MISSING` | 401 | یکی از هدرهای X-API-Key، X-Timestamp یا X-Signature ارسال نشده است. |
| `TIMESTAMP_INVALID` | 401 | زمان درخواست منقضی شده یا نامعتبر است — بازه‌ی مجاز ۵ دقیقه است. |
| `API_KEY_INVALID` | 401 | کلید API نامعتبر یا غیرفعال است. |
| `SIGNATURE_INVALID` | 401 | امضای HMAC با محتوای درخواست مطابقت ندارد. |
| `ADVANCED_KYC_NEEDED` | 403 | احراز هویت پیشرفته حساب شما تکمیل نشده است. |
| `INSUFFICIENT_PERMISSIONS` | 403 | کلید API شما دسترسی لازم برای این عملیات را ندارد. |
| `IP_NOT_WHITELISTED` | 403 | آدرس IP درخواست در فهرست مجاز این کلید نیست. |
| `ADDRESS_NOT_VERIFIED` | 403 | آدرس مقصد برداشت، در فهرست آدرس‌های تأییدشده‌ی شما ثبت نشده است. |
| `RATE_LIMIT_EXCEEDED` | 429 | تعداد درخواست‌ها از سقف مجاز عبور کرده است. |