Live open-market rates from Iran, as JSON: currencies, gold, coins and silver in Toman, refreshed near real time.
Near-real-time quotes from Iran's open market plus stored history, as plain JSON. Teams use it for dashboards, price displays, payment pages and research. One API key in a header, no SDK to install.
We take payment in USDT on the TRC-20 network. Order through our Telegram bot and it sends the amount and address right away, or email us and we reply with them. Once the transfer confirms, your API key is on its way.
We never publish a wallet address. Only pay to the address sent by our bot @dolarchandAPI_bot or in our email reply, and only on the TRC-20 network.
If no reply arrives within a working day, check your spam folder and add hello@dolarchand.com to your contacts so our messages reach you.
To buy a plan or change your plan, email: hello@dolarchand.com
https://dolarchand.com/api/v1Every request needs an API key in the X-API-Key header (an Authorization: Bearer header also works). Keys are issued per customer with a monthly request quota. Contact us to request one.
curl -H "X-API-Key: dk_live_xxxxxxxx" \
https://dolarchand.com/api/v1/rates/ratesAll current rates/rates/{code}One asset (USD, EUR, GOLD_18K…)/history/{code}Stored price series for one asset/convert?from=&to=&amount=Cross-rate between two assetsGET /rates/USD →
{
"updatedAt": "2026-06-15T11:05:36.839Z",
"code": "USD",
"buy": 163500,
"sell": 163500,
"priceUsd": 1,
"changeAbs": -6500,
"changePct": -3.82
}Toman-quoted assets use buy/sell in Toman; the gold ounce also includes 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 unavailableRequests past the quota return 429 quota_exceeded. Every successful response carries your plan and monthly quota in the X-Plan and X-Monthly-Quota headers, and all responses are CORS-enabled.