📡 مستندات API نرخ‌چی

با API نرخ‌چی می‌توانید قیمت لحظه‌ای طلا، ارز، سکه و ارز دیجیتال را در پروژه خود نمایش دهید. تمام پاسخ‌ها به فرمت JSON هستند.

🔑 احراز هویت

تمام درخواست‌ها نیاز به API Key دارند. کلید را از داشبورد کاربری دریافت کنید.

روش اول: هدر HTTP

X-API-Key: YOUR_API_KEY

روش دوم: Query Parameter

GET /api/v1/prices?api_key=YOUR_API_KEY

⚡ محدودیت‌ها

📊 قیمت‌ها

{
  "success": true,
  "count": 19,
  "data": [
    {
      "symbol": "usd",
      "name_fa": "دلار آمریکا",
      "name_en": "US Dollar",
      "category": "currency",
      "price": 920000,
      "unit": "تومان",
      "icon": "🇺🇸",
      "change": {
        "amount": 5000,
        "percent": 0.54,
        "direction": "up"
      },
      "high_24h": 925000,
      "low_24h": 915000,
      "updated_at": "2025-01-15 10:30:00"
    }
  ]
}

GET /api/v1/prices/usd
GET /api/v1/prices/gold_18k
GET /api/v1/prices/btc

📈 تاریخچه قیمت

GET /api/v1/history/usd?period=7d

{
  "success": true,
  "symbol": "usd",
  "period": "7d",
  "count": 168,
  "data": [
    { "price": 915000, "recorded_at": "2025-01-08 10:00:00" },
    ...
  ]
}

🔍 وضعیت API Key

{
  "success": true,
  "plan": "free",
  "daily_limit": 100,
  "daily_used": 23,
  "daily_remaining": 77,
  "total_used": 450
}

❌ کدهای خطا

💻 نمونه کد

JavaScript / Fetch

const API_KEY = 'YOUR_API_KEY';

fetch('https://nerkhchii.com/api/v1/prices', {
  headers: { 'X-API-Key': API_KEY }
})
.then(res => res.json())
.then(data => {
  data.data.forEach(item => {
    console.log(`${item.name_fa}: ${item.price.toLocaleString()} ${item.unit}`);
  });
});

PHP

Python

import requests

API_KEY = 'YOUR_API_KEY'
BASE_URL = 'https://nerkhchii.com/api/v1'

headers = {'X-API-Key': API_KEY}
response = requests.get(f'{BASE_URL}/prices', headers=headers)
data = response.json()

for item in data['data']:
    print(f"{item['name_fa']}: {item['price']:,} {item['unit']}")

🧪 Playground - تست زنده

API را مستقیماً از اینجا تست کنید.