سفارش، فعال سازی و استفاده از API قیمت ریالی را شفاف و سریع انجام دهید.

۰۱

انتخاب پلن

از بخش محصولات در صفحه اصلی پلنی را انتخاب کنید که با سقف درخواست روزانه و مدت اعتبار موردنیاز شما هماهنگ است.

۰۲

تکمیل پرداخت

وارد شوید، سفارش را تایید کنید و با پرداخت کریپتو یا پرداخت دستی مسیر خرید را کامل کنید.

۰۳

دریافت کلید API

بعد از کامل شدن پرداخت، از مسیر Profile > API Keys کلید فعال را مشاهده کنید. مقدار کامل فقط یک بار نمایش داده می شود.

۰۴

ارسال درخواست های احراز هویت شده

کلید را در هدر X-API-Key یا در Authorization: ApiKey ... قرار دهید و دریافت قیمت ها را شروع کنید.

GET /api/v1/assets

فهرست کامل آخرین قیمت دارایی های پشتیبانی شده را برمی گرداند.

GET /api/v1/assets/USD_RLS

آخرین قیمت یک کد دارایی را برمی گرداند.

GET /api/v1/assets/USD_RLS/2026-04-13

قیمت یک دارایی را در یک تاریخ مشخص برمی گرداند.

POST /api/v1/assets/USD_RLS

با ارسال بدنه JSON شامل بازه زمانی، داده های تاریخی همان دارایی را دریافت می کنید.

GET /api/v1/assets/supported

فهرست دارایی های پشتیبانی شده را همراه با برچسب ها، پوشش تامین کننده و وضعیت به روز بودن برمی گرداند.

GET /api/v1/status

اطلاعات عمومی سرویس مانند نسخه API، زمان سرور، لینک مستندات و نام مسیرهای موجود را برمی گرداند.

POST /api/v1/assets/USD_RLS

مسیر قدیمی بازه تاریخی. برای اتصال های جدید از مسیر GET history استفاده کنید.

درخواست یک دارایی

curl -sS https://your-domain.com/api/v1/assets/USD_RLS \
  -H "X-API-Key: pk_live_your_key_here"

نمونه JavaScript fetch

const response = await fetch("https://your-domain.com/api/v1/assets/USD_RLS", {
  headers: { "X-API-Key": "pk_live_your_key_here" }
});
const data = await response.json();

نمونه پاسخ

{
  "code": "USD_RLS",
  "name": "USD_RLS",
  "slug": "usd_rls",
  "labelEn": "US Dollar / Iranian Rial",
  "labelFa": "دلار آمریکا / ریال ایران",
  "value": 382540,
  "businessTime": "2026-04-13T10:24:00Z"
}

بدنه بازه تاریخی

curl -sS "https://your-domain.com/api/v1/assets/USD_RLS/history?from=2026-04-01&to=2026-04-13"

فهرست خلاصه نمادهای پشتیبانی شده

USD_RLS  |  دلار آمریکا / ریال ایران
EUR_RLS  |  یورو / ریال ایران
SEKKEH_RLS  |  سکه امامی / ریال ایران
NIM_SEKKEH_RLS  |  نیم سکه / ریال ایران
ROB_SEKKEH_RLS  |  ربع سکه / ریال ایران
BAHAR_RLS  |  سکه بهار آزادی / ریال ایران
GERAMI_SEKKEH_RLS  |  سکه گرمی / ریال ایران
GOLD_18_RLS  |  طلای ۱۸ عیار / ریال ایران
GOLD_OUNCE_USD  |  اونس طلا / دلار آمریکا
SILVER_OUNCE_USD  |  اونس نقره / دلار آمریکا
PLATINUM_OUNCE_USD  |  اونس پلاتین / دلار آمریکا
GOLD_MESGHAL_RLS  |  مثقال طلا / ریال ایران
GOLD_24_RLS  |  طلای ۲۴ عیار / ریال ایران
STOCK_IR  |  شاخص بورس ایران
AFN_RLS  |  افغانی افغانستان / ریال ایران
AED_RLS  |  درهم امارات / ریال ایران
AMD_RLS  |  درام ارمنستان / ریال ایران
AZN_RLS  |  منات آذربایجان / ریال ایران
BHD_RLS  |  دینار بحرین / ریال ایران
BRL_RLS  |  رئال برزیل / ریال ایران
GBP_RLS  |  پوند انگلیس / ریال ایران
CAD_RLS  |  دلار کانادا / ریال ایران
CHF_RLS  |  فرانک سوئیس / ریال ایران
DKK_RLS  |  کرون دانمارک / ریال ایران
GEL_RLS  |  لاری گرجستان / ریال ایران
HKD_RLS  |  دلار هنگ کنگ / ریال ایران
INR_RLS  |  روپیه هند / ریال ایران
IQD_RLS  |  دینار عراق / ریال ایران
KWD_RLS  |  دینار کویت / ریال ایران
MYR_RLS  |  رینگیت مالزی / ریال ایران
NOK_RLS  |  کرون نروژ / ریال ایران
NZD_RLS  |  دلار نیوزیلند / ریال ایران
OMR_RLS  |  ریال عمان / ریال ایران
PKR_RLS  |  روپیه پاکستان / ریال ایران
QAR_RLS  |  ریال قطر / ریال ایران
SAR_RLS  |  ریال عربستان / ریال ایران
SEK_RLS  |  کرون سوئد / ریال ایران
SGD_RLS  |  دلار سنگاپور / ریال ایران
THB_RLS  |  بات تایلند / ریال ایران
TRY_RLS  |  لیر ترکیه / ریال ایران
AUD_RLS  |  دلار استرالیا / ریال ایران
JPY_RLS  |  ین ژاپن / ریال ایران
CNY_RLS  |  یوان چین / ریال ایران
RUB_RLS  |  روبل روسیه / ریال ایران
BTC_USD  |  بیت‌کوین / دلار آمریکا
ETH_USD  |  اتریوم / دلار آمریکا
USDT_USD  |  تتر / دلار آمریکا
USDC_USD  |  یو‌اس‌دی کوین / دلار آمریکا
SOL_USD  |  سولانا / دلار آمریکا
XRP_USD  |  ایکس‌آرپی / دلار آمریکا
ADA_USD  |  کاردانو / دلار آمریکا
DOGE_USD  |  دوج‌کوین / دلار آمریکا
DOT_USD  |  پولکادات / دلار آمریکا
LTC_USD  |  لایت‌کوین / دلار آمریکا
LINK_USD  |  چین‌لینک / دلار آمریکا
AVAX_USD  |  اولانچ / دلار آمریکا
XLM_USD  |  استلار / دلار آمریکا
ATOM_USD  |  کازماس / دلار آمریکا