نرخ نزدیک به لحظهٔ بازار آزاد ایران بهصورت JSON: ارزها، طلا، سکه و نقره به تومان، با بهروزرسانی نزدیک به لحظه.
API «دلار چند» قیمتهای نزدیک به لحظه را از بازار ارز و طلای ایران دنبال میکند و شما میتوانید با اطمینان قیمتها را نظارت و تحلیل کنید. این API برای یکپارچهسازی ساده و کارکرد پایدار طراحی شده و مناسب تیمهایی است که داشبورد، صفحههای پرداخت، ابزارهای تحلیلی و محصولات مشابه میسازند.
مهم: ما هیچوقت آدرس کیف پول تتر را در سایت منتشر نمیکنیم؛ فقط به آدرسی پرداخت کنید که ربات @dolarchandAPI_bot یا پاسخ ایمیل ما برایتان فرستاده است.
اگر تا یک روز کاری پاسخی نرسید، پوشهٔ اسپم را ببینید و hello@dolarchand.com را به مخاطبانتان اضافه کنید تا پیامهای ما به دستتان برسد.
ایمیل: hello@dolarchand.com
https://dolarchand.com/api/v1هر درخواست به یک کلید API در هدر X-API-Key نیاز دارد (هدر Authorization: Bearer نیز کار میکند). کلیدها برای هر مشتری با سهمیهٔ ماهانهٔ درخواست صادر میشوند.
curl -H "X-API-Key: dk_live_xxxxxxxx" \
https://dolarchand.com/api/v1/rates/ratesهمهٔ نرخهای فعلی/rates/{code}یک دارایی (USD، EUR، GOLD_18K…)/history/{code}سری قیمتِ ذخیرهشده برای یک دارایی/convert?from=&to=&amount=نرخ متقابل بین دو داراییGET /rates/USD →
{
"updatedAt": "2026-06-15T11:05:36.839Z",
"code": "USD",
"buy": 163500,
"sell": 163500,
"priceUsd": 1,
"changeAbs": -6500,
"changePct": -3.82
}داراییهای تومانی buy/sell را به تومان میدهند؛ انس طلا priceUsd را هم دارد.
curl -H "X-API-Key: dk_live_xxxxxxxx" \
"https://dolarchand.com/api/v1/rates/USD"401 invalid_api_key - missing or invalid key
429 quota_exceeded - monthly quota reached
404 not_found - unknown asset code
400 bad_request - missing/invalid parameters
503 unavailable - rates temporarily unavailableدرخواستهای فراتر از سهمیه 429 quota_exceeded برمیگردانند. پلن و سهمیهٔ ماهانهٔ شما در هدرهای X-Plan و X-Monthly-Quota هر پاسخ موفق میآید و همهٔ پاسخها CORS فعال دارند.