API رایگان قیمت دلار، طلا و سکه؛ وب‌سرویس بازار آزاد
قیمت بازار آزاد ارز، طلا، سکه، رمزارز و فلزات با شناسه‌های ثابت؛ ریالی، و چند قلم جهانی به دلار. بازار آزاد شبانه‌روزی است و قیمت‌ها هر چند دقیقه به‌روز می‌شوند، با تاریخچه‌ی روزانه.
فهرست کامل قیمت‌ها
شناسه‌ی هر قیمت spot: به‌علاوه‌ی کد آن است. قاعده ساده است: کد بی‌پسوند ریالی است و پسوند _USD یعنی دلاری؛ مثلاً spot:BTC بیت‌کوین به ریال و spot:BTC_USD به دلار.
ارز
طلا
سکه
رمزارز
نقره و انس جهانی
چند قیمت در یک درخواست
curl -H "x-api-key: YOUR_API_KEY" \
"https://nerkhy.ir/v1/quotes?ids=spot:USD,spot:EUR,spot:GOLD_18K,spot:COIN_EMAMI,spot:USDT"const url = new URL("https://nerkhy.ir/v1/quotes");
url.searchParams.set("ids", "spot:USD,spot:EUR,spot:GOLD_18K,spot:COIN_EMAMI,spot:USDT");
const res = await fetch(url, { headers: { "x-api-key": "YOUR_API_KEY" } });
const { data, meta } = await res.json();import requests
res = requests.get(
"https://nerkhy.ir/v1/quotes",
params={"ids": "spot:USD,spot:EUR,spot:GOLD_18K,spot:COIN_EMAMI,spot:USDT"},
headers={"x-api-key": "YOUR_API_KEY"},
timeout=10,
)
res.raise_for_status()
data = res.json()["data"]<?php
$url = "https://nerkhy.ir/v1/quotes" . "?" . http_build_query(["ids" => "spot:USD,spot:EUR,spot:GOLD_18K,spot:COIN_EMAMI,spot:USDT"]);
$ch = curl_init($url);
curl_setopt_array($ch, [
CURLOPT_HTTPHEADER => ["x-api-key: YOUR_API_KEY"],
CURLOPT_RETURNTRANSFER => true,
CURLOPT_TIMEOUT => 10,
]);
$body = json_decode(curl_exec($ch), true);
curl_close($ch);
$data = $body["data"];همه‌ی قیمت‌های بازار آزاد هم با یک درخواست می‌آیند: GET /v1/quotes?market=spot. برای یک نوع، type را اضافه کنید (مثلاً type=coin).
{
"data": {
"id": "spot:USD",
"market": "spot",
"type": "currency",
"symbol": "USD",
"name": {
"fa": "دلار آمریکا",
"en": "US Dollar"
},
"currency": "IRR",
"unit": "unit",
"status": "active",
"referencePrice": 2715650,
"price": {
"last": 2715650,
"close": null,
"open": null,
"high": 2728100,
"low": 2704000,
"previousClose": 2694000
},
"change": {
"amount": 21650,
"percent": 0.8
},
"limits": null,
"orderBook": null,
"trading": null,
"fund": null,
"fundamentals": null,
"tradeDate": "2026-10-22",
"lastTradeAt": "2026-10-22T14:19:11+03:30",
"observedAt": "2026-10-22T10:49:17.981Z",
"stale": false,
"source": "tgju"
}
}فیلدهای قیمت بازار آزاد
فیلدهای مخصوص بورس (limits، orderBook، trading و fundamentals) برای بازار آزاد null هستند.
تبدیل به تومان
همه‌ی قیمت‌های ریالی را برای تومان بر ۱۰ تقسیم کنید. قیمت‌ها عدد کامل‌اند و فقط برای نمایش گرد کنید.
const toman = (q) => (q.currency === "IRR" ? q.referencePrice / 10 : null);
// ۲٬۷۱۵٬۶۵۰ ریال → «۲۷۱٬۵۶۵ تومان»
const label = new Intl.NumberFormat("fa-IR").format(Math.round(toman(usd))) + " تومان";def toman(q):
return q["referencePrice"] / 10 if q["currency"] == "IRR" else None<?php
function toman(array $q): ?float {
return $q["currency"] === "IRR" ? $q["referencePrice"] / 10 : null;
}همین حالا شروع کنید
ثبت‌نام و استفاده از نرخی API رایگان است. پس از تأیید حساب، کلید API را از داشبورد بسازید و اولین درخواست را بفرستید.