GET /api/v1/assets/USD_RLS
curl -sS https://servix.cc/api/v1/assets/USD_RLS \
-H "X-API-Key: <your-api-key>"
اندپوینتها
برای هر مسیر، روش احراز هویت، ورودیها، نحوهٔ محاسبهٔ سهمیه، خطاهای مهم، درخواست آمادهٔ cURL و یک پاسخ نمونهٔ امن را میبینید. نام فیلدها با پاسخ واقعی یکسان است و مقدارهای بازار عمداً پنهان شدهاند.
curl -sS https://servix.cc/api/v1/assets/USD_RLS \
-H "X-API-Key: <your-api-key>"
احراز هویت
API امن دو روش برای ارسال کلید میپذیرد. یکی را انتخاب کنید و در کلاینت یا پردازش سمت سرور همیشه از همان روش استفاده کنید.
X-API-Key: <your-api-key>
Authorization: ApiKey <your-api-key>
امنیت کلید API
آدرسها بهسادگی کپی، ذخیره، ثبت و ناخواسته به اشتراک گذاشته میشوند. اطلاعات محرمانه را در هدر درخواست نگه دارید.
https://servix.cc/api/v1/assets/USD_RLS?api_key=<your-api-key>
curl -sS https://servix.cc/api/v1/assets/USD_RLS \
-H "X-API-Key: <your-api-key>"
curl -sS https://servix.cc/api/v1/assets/USD_RLS \
-H "Authorization: ApiKey <your-api-key>"
curl -sS "https://servix.cc/api/v1/assets/USD_RLS/history?from=2026-04-01&to=2026-04-13" \
-H "X-API-Key: <your-api-key>"
اندپوینتها
/api/v1/assets
فهرست کامل آخرین قیمت داراییهای پشتیبانیشده را برمی گرداند.
curl -sS https://servix.cc/api/v1/assets \
-H "X-API-Key: <your-api-key>"
[
{
"code": "USD_RLS",
"name": "USD_RLS",
"slug": "usd_rls",
"labelEn": "US Dollar / Iranian Rial",
"labelFa": "دلار آمریکا / ریال ایران",
"quoteUnit": "RLS",
"value": "<protected-market-value>",
"businessTime": "<source-timestamp>"
}
]
/api/v1/assets/supported
فهرست داراییهای پشتیبانیشده را همراه با نامها، پوشش منبع داده و وضعیت تازگی برمیگرداند.
curl -sS "https://servix.cc/api/v1/assets/supported?category=CRYPTO"eUnit=RLS" \
-H "X-API-Key: <your-api-key>"
{
"updatedAt": "<response-timestamp>",
"staleThresholdMinutes": 60,
"assets": [
{
"code": "USD_RLS",
"baseCode": "USD",
"category": "FX",
"labelEn": "US Dollar / Iranian Rial",
"labelFa": "دلار آمریکا / ریال ایران",
"quoteUnit": "RLS",
"providers": ["SERVIX"],
"providerSupported": true,
"latestValueAvailable": true,
"latestValue": "<protected-market-value>",
"businessTime": "<source-timestamp>",
"sourceTime": "<source-timestamp>",
"insertTime": "<response-timestamp>",
"qualityStatus": "ACCEPTED",
"qualityMessage": "",
"availabilityStatus": "AVAILABLE",
"stale": false,
"ohlcAvailable": true,
"ohlcAvailableFrom": "<source-timestamp>"
}
]
}
/api/v1/assets/USD_RLS
آخرین قیمت یک کد دارایی را برمی گرداند.
curl -sS https://servix.cc/api/v1/assets/USD_RLS \
-H "X-API-Key: <your-api-key>"
{
"code": "USD_RLS",
"name": "USD_RLS",
"slug": "usd_rls",
"labelEn": "US Dollar / Iranian Rial",
"labelFa": "دلار آمریکا / ریال ایران",
"quoteUnit": "RLS",
"value": "<protected-market-value>",
"businessTime": "<source-timestamp>"
}
/api/v1/assets/USD_RLS/2026-04-13
قیمت یک دارایی را در یک تاریخ مشخص برمی گرداند.
curl -sS https://servix.cc/api/v1/assets/USD_RLS/2026-04-13 \
-H "X-API-Key: <your-api-key>"
{
"code": "USD_RLS",
"name": "USD_RLS",
"slug": "usd_rls",
"labelEn": "US Dollar / Iranian Rial",
"labelFa": "دلار آمریکا / ریال ایران",
"quoteUnit": "RLS",
"value": "<protected-market-value>",
"businessTime": "<source-timestamp>"
}
/api/v1/assets/USD_RLS/history?from=2026-04-01&to=2026-04-13
با پارامترهای کوئری، تاریخچه یک دارایی را در بازه زمانی دلخواه دریافت کنید.
curl -sS "https://servix.cc/api/v1/assets/USD_RLS/history?from=2026-04-01&to=2026-04-13" \
-H "X-API-Key: <your-api-key>"
[
{
"code": "USD_RLS",
"name": "USD_RLS",
"slug": "usd_rls",
"labelEn": "US Dollar / Iranian Rial",
"labelFa": "دلار آمریکا / ریال ایران",
"quoteUnit": "RLS",
"value": "<protected-market-value>",
"businessTime": "<source-timestamp>"
}
]
/api/v1/assets/USD_RLS/ohlc?interval=15m&from=2026-08-26T00:00:00Z&to=2026-08-27T00:00:00Z
کندلهای باز، بیشینه، کمینه و بستهشدن (OHLC) یک نماد را در یک بازهٔ زمانی مشخص و نیمهباز برمیگرداند.
curl -sS "https://servix.cc/api/v1/assets/USD_RLS/ohlc?interval=15m&from=2026-08-26T00:00:00Z&to=2026-08-27T00:00:00Z" \
-H "X-API-Key: <your-api-key>"
{
"code": "USD_RLS",
"baseCode": "USD",
"labelEn": "US Dollar / Iranian Rial",
"labelFa": "دلار آمریکا / ریال ایران",
"quoteUnit": "RLS",
"interval": "15m",
"from": "2026-08-26T00:00:00Z",
"to": "2026-08-27T00:00:00Z",
"availableFrom": "<source-timestamp>",
"candles": [
{
"start": "2026-08-26T00:00:00Z",
"end": "2026-08-26T00:15:00Z",
"open": "<protected-market-value>",
"high": "<protected-market-value>",
"low": "<protected-market-value>",
"close": "<protected-market-value>",
"observationCount": 4,
"complete": true
}
]
}
/api/v1/assets/USD_RLS
با ارسال بدنه JSON شامل بازه زمانی، دادههای تاریخی همان دارایی را دریافت میکنید.
curl -sS https://servix.cc/api/v1/assets/USD_RLS \
-H "X-API-Key: <your-api-key>" \
-H "Content-Type: application/json" \
--data '{"fromDate":"2026-04-01","toDate":"2026-04-13"}'
[
{
"code": "USD_RLS",
"name": "USD_RLS",
"slug": "usd_rls",
"labelEn": "US Dollar / Iranian Rial",
"labelFa": "دلار آمریکا / ریال ایران",
"quoteUnit": "RLS",
"value": "<protected-market-value>",
"businessTime": "<source-timestamp>"
}
]
/api/v1/status
اطلاعات عمومی سرویس مانند نسخه API، زمان سرور، لینک مستندات و نام مسیرهای موجود را برمی گرداند.
curl -sS https://servix.cc/api/v1/status
{
"status": "OK",
"application": "price_app",
"apiVersion": "v1",
"serverTime": "<response-timestamp>",
"documentationUrl": "<documentation-url>",
"endpoints": [
"GET /api/v1/assets",
"GET /api/v1/assets/supported",
"GET /api/v1/assets/{assetName}",
"GET /api/v1/assets/{assetName}/{date}",
"GET /api/v1/assets/{assetName}/history?from=YYYY-MM-DD&to=YYYY-MM-DD",
"GET /api/v1/assets/{assetCode}/ohlc?interval=15m&from=<UTC-time>&to=<UTC-time>",
"POST /api/v1/assets/{assetName}",
"GET /api/v1/status",
"GET /api/v1/access"
]
}
/api/v1/access
نوع دسترسی فعلی حساب و اجباری بودن درج منبع را برمیگرداند.
curl -sS https://servix.cc/api/v1/access \
-H "X-API-Key: <your-api-key>"
{
"accessType": "FREE_STARTER",
"attributionRequired": true
}
نمونهها
همه نمونهکدها مانند پنل ویرایشگر نمایش داده شدهاند تا بتوانید بهراحتی آنها را بخوانید و در ابزارهای خود کپی کنید.
curl -sS https://servix.cc/api/v1/assets/USD_RLS \
-H "X-API-Key: <your-api-key>"
const response = await fetch("https://servix.cc/api/v1/assets/USD_RLS", {
headers: { "X-API-Key": "<your-api-key>" }
});
const data = await response.json();
{
"code": "USD_RLS",
"name": "USD_RLS",
"slug": "usd_rls",
"labelEn": "US Dollar / Iranian Rial",
"labelFa": "دلار آمریکا / ریال ایران",
"quoteUnit": "RLS",
"value": "<protected-market-value>",
"businessTime": "<source-timestamp>"
}
curl -sS "https://servix.cc/api/v1/assets/USD_RLS/history?from=2026-04-01&to=2026-04-13" \
-H "X-API-Key: <your-api-key>"
{
"status": 417,
"code": "INVALID_DATE_RANGE",
"message": "The requested date range is not valid.",
"timestamp": "<response-timestamp>",
"path": "/api/v1/assets/USD_RLS/history",
"requestId": "req_example"
}
USD_RLS | دلار آمریکا / ریال ایران
EUR_RLS | یورو / ریال ایران
SEKKEH_RLS | سکه امامی / ریال ایران
NIM_SEKKEH_RLS | نیم سکه / ریال ایران
ROB_SEKKEH_RLS | ربع سکه / ریال ایران
BAHAR_RLS | سکه بهار آزادی / ریال ایران
GOLD_18_RLS | طلای ۱۸ عیار / ریال ایران
GOLD_OUNCE_USD | اونس طلا / دلار آمریکا
SILVER_OUNCE_USD | اونس نقره / دلار آمریکا
PLATINUM_OUNCE_USD | اونس پلاتین / دلار آمریکا
BTC_USD | بیتکوین / دلار آمریکا
ETH_USD | اتریوم / دلار آمریکا
USDT_USD | تتر / دلار آمریکا
BNB_USD | بیانبی / دلار آمریکا
XRP_USD | ایکسآرپی / دلار آمریکا
USDC_USD | یواسدی کوین / دلار آمریکا
SOL_USD | سولانا / دلار آمریکا
TRX_USD | ترون / دلار آمریکا
HYPE_USD | هایپرلیکویید / دلار آمریکا
DOGE_USD | دوجکوین / دلار آمریکا
ZEC_USD | زیکش / دلار آمریکا
LINK_USD | چینلینک / دلار آمریکا
ADA_USD | کاردانو / دلار آمریکا
XLM_USD | استلار / دلار آمریکا
DAI_USD | دای / دلار آمریکا
BCH_USD | بیتکوین کش / دلار آمریکا
USDE_USD | یواسدیای / دلار آمریکا
USD1_USD | یواسدی وان / دلار آمریکا
CC_USD | کانتون کوین / دلار آمریکا
LTC_USD | لایتکوین / دلار آمریکا
USDG_USD | گلوبال دلار / دلار آمریکا
HBAR_USD | هدرا / دلار آمریکا
AVAX_USD | اولانچ / دلار آمریکا
SUI_USD | سویی / دلار آمریکا
SHIB_USD | شیبا اینو / دلار آمریکا
PYUSD_USD | پیپل یواسدی / دلار آمریکا
XAUT_USD | تتر گلد / دلار آمریکا
CRO_USD | کرونوس / دلار آمریکا
TAO_USD | بیتتنسور / دلار آمریکا
UNI_USD | یونیسواپ / دلار آمریکا
NEAR_USD | نیر پروتکل / دلار آمریکا
OKB_USD | اوکیبی / دلار آمریکا
PAXG_USD | پکس گلد / دلار آمریکا
WLFI_USD | ورلد لیبرتی فایننشال / دلار آمریکا
RLUSD_USD | ریپل یواسدی / دلار آمریکا
ASTER_USD | استر / دلار آمریکا
ONDO_USD | اوندو / دلار آمریکا
MNT_USD | منتل / دلار آمریکا
M_USD | ام / دلار آمریکا
USDD_USD | یواسدیدی / دلار آمریکا
AAVE_USD | آوه / دلار آمریکا
PUMP_USD | پامپ / دلار آمریکا
SKY_USD | اسکای / دلار آمریکا
DOT_USD | پولکادات / دلار آمریکا
WLD_USD | ورلدکوین / دلار آمریکا
ICP_USD | اینترنت کامپیوتر / دلار آمریکا
PEPE_USD | پپه / دلار آمریکا
ATOM_USD | کازماس / دلار آمریکا
BTC_RLS | بیتکوین / ریال ایران
ETH_RLS | اتریوم / ریال ایران
USDT_RLS | تتر / ریال ایران
BNB_RLS | بیانبی / ریال ایران
XRP_RLS | ایکسآرپی / ریال ایران
USDC_RLS | یواسدی کوین / ریال ایران
SOL_RLS | سولانا / ریال ایران
TRX_RLS | ترون / ریال ایران
HYPE_RLS | هایپرلیکویید / ریال ایران
DOGE_RLS | دوجکوین / ریال ایران
ZEC_RLS | زیکش / ریال ایران
LINK_RLS | چینلینک / ریال ایران
ADA_RLS | کاردانو / ریال ایران
XLM_RLS | استلار / ریال ایران
DAI_RLS | دای / ریال ایران
BCH_RLS | بیتکوین کش / ریال ایران
USDE_RLS | یواسدیای / ریال ایران
USD1_RLS | یواسدی وان / ریال ایران
CC_RLS | کانتون کوین / ریال ایران
LTC_RLS | لایتکوین / ریال ایران
USDG_RLS | گلوبال دلار / ریال ایران
HBAR_RLS | هدرا / ریال ایران
AVAX_RLS | اولانچ / ریال ایران
SUI_RLS | سویی / ریال ایران
SHIB_RLS | شیبا اینو / ریال ایران
PYUSD_RLS | پیپل یواسدی / ریال ایران
XAUT_RLS | تتر گلد / ریال ایران
CRO_RLS | کرونوس / ریال ایران
TAO_RLS | بیتتنسور / ریال ایران
UNI_RLS | یونیسواپ / ریال ایران
NEAR_RLS | نیر پروتکل / ریال ایران
OKB_RLS | اوکیبی / ریال ایران
PAXG_RLS | پکس گلد / ریال ایران
WLFI_RLS | ورلد لیبرتی فایننشال / ریال ایران
RLUSD_RLS | ریپل یواسدی / ریال ایران
ASTER_RLS | استر / ریال ایران
ONDO_RLS | اوندو / ریال ایران
MNT_RLS | منتل / ریال ایران
M_RLS | ام / ریال ایران
USDD_RLS | یواسدیدی / ریال ایران
AAVE_RLS | آوه / ریال ایران
PUMP_RLS | پامپ / ریال ایران
SKY_RLS | اسکای / ریال ایران
DOT_RLS | پولکادات / ریال ایران
WLD_RLS | ورلدکوین / ریال ایران
ICP_RLS | اینترنت کامپیوتر / ریال ایران
PEPE_RLS | پپه / ریال ایران
ATOM_RLS | کازماس / ریال ایران
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 | لاری گرجستان / ریال ایران
GERAMI_SEKKEH_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 | روبل روسیه / ریال ایران