معرفی

API بازارهای نِت اَرز قیمت انس جهانی طلا و نقره و نرخ ۳۴ ارز به تومان را به‌صورت JSON به سایت، اپ یا ربات شما می‌دهد. کلیدش همان کلید API نرخ ارز است: اگر اپ دارید، همان کلید اینجا هم کار می‌کند. هر دو API یک سهمیهٔ روزانه و یک قفل دامنه دارند.

اولین درخواست

curl "https://netarz.ir/api/markets/v1/latest?symbols=XAU,XAG,USD" \
  -H "Authorization: Bearer fx-ntz-v1-..."

{
  "data": [
    {
      "symbol": "XAU",
      "asset_class": "metal",
      "name_fa": "انس طلا",
      "unit": "ounce",
      "quote_currency": "USD",
      "price": 4117.1,
      "change_pct_24h": 0.42,
      "as_of": "2026-10-21T11:05:00+03:30",
      "stale": false,
      "status": "ok",
      "source": "goldapi"
    }
  ],
  "meta": {
    "plan": "free",
    "delayed_minutes": 15,
    "is_delayed": true,
    "sources": [{ "key": "goldapi", "name": "gold-api.com", "url": "https://gold-api.com" }]
  }
}

امروز چه چیزی در API هست

• انس جهانی طلا (XAU) و انس جهانی نقره (XAG) به دلار، از gold-api.com. نِت اَرز هر پنج دقیقه آن را می‌خواند.
• ارزها: همان ۳۴ ارز API نرخ ارز، با همان نرخ و همان تأخیر، تا بتوانید طلا و ارز را در یک درخواست بگیرید.
• نمادهای باز امروز: XAU,XAG,GOLD18,MESGHAL,COIN_EMAMI,COIN_BAHAR,COIN_HALF,COIN_QUARTER,COIN_GERAMI

چه چیزی در این API نیست

قیمت بازار طلا و سکهٔ تهران، حباب سکه، رمزارزها و سهام فعلاً در این API نیستند. عدد تومانی طلا و سکه، هر جا باشد، «ارزش محاسبه‌ای» است: انس جهانی × نرخ دلار نِت اَرز × عیار. این عدد قیمت بازار تهران نیست و هر ردیفش این را با is_market_price: false و یک توضیح فارسی می‌گوید. نِت اَرز طلا و سکه نمی‌فروشد.

بدون برنامه‌نویسی