این API اطلاعات مربوط به قیمت‌های روز رمز ارزهای پارس بیت را ارائه می‌دهد، از جمله قیمت خرید و فروش و تغییرات درصدی در بازه‌های زمانی مختلف.

احراز هویت

برای دسترسی به این API، شما نیاز به یک توکن احراز هویت دارید. این توکن از طریق سیستم تیکت از ادمین سایت قابل دریافت است.

برای احراز هویت، توکن را در هدر Authorization به عنوان یک Bearer token ارسال کنید.

نمونه:

Authorization: Bearer {your_token}

آدرس‌ها

1. دریافت قیمت رمز ارزها

این آدرس قیمت‌های به‌روز رمز ارزها و اطلاعات مرتبط دیگر را برای تمام رمز ارزهای پشتیبانی شده باز می‌گرداند.

درخواست

متد: GET

آدرس: /v1/cryptocurrencies/price

هدرها:

• Authorization: Bearer {your_token} (اجباری)

پاسخ

پاسخ یک آرایه JSON است که شامل جزئیات مربوط به رمز ارزها می‌باشد.

نمونه پاسخ:

{
        "name": "Bitcoin",
        "fa_name": "بیت کوین",
        "symbol": "BTC",
        "slug": "bitcoin",
        "price_usd": "97972.904580005",
        "inventory": "1.0464224432405",
        "buy_status": true,
        "buy_price": 8391732941.451000213623046875,
        "sell_status": true,
        "sell_price": 8274370219.32499980926513671875,
        "percent_change_1h": "0.66568863",
        "percent_change_24h": "-0.82715625",
        "percent_change_7d": "-4.42956742",
        "percent_change_30d": "-0.83531764",
        "last_updated": "2025-02-05T10:48:03.000000Z"
    }

فیلدها

• name: نام رمز ارز .

• fa_name: نام فارسی رمز ارز .

• symbol: نماد رمز ارز .

• slug: شناسه URL-friendly رمز ارز.

• price_usd: قیمت فعلی رمز ارز به دلار.

• inventory: مقدار موجودی رمز ارز سایت.

• buy_status: وضعیت خرید (boolean) که نشان‌دهنده این است که آیا این رمز ارز برای خرید در دسترس است.

• buy_price: قیمت خرید رمز ارز.

• sell_status: وضعیت فروش (boolean) که نشان‌دهنده این است که آیا این رمز ارز برای فروش در دسترس است.

• sell_price: قیمت فروش رمز ارز.

• percent_change_1h: تغییر درصدی قیمت در 1 ساعت گذشته.

• percent_change_24h: تغییر درصدی قیمت در 24 ساعت گذشته.

• percent_change_7d: تغییر درصدی قیمت در 7 روز گذشته.

• percent_change_30d: تغییر درصدی قیمت در 30 روز گذشته.

• last_updated: زمان آخرین به‌روزرسانی قیمت.

کشینگ

اطلاعات رمز ارزها به مدت 1 دقیقه کش می‌شوند. اگر درخواست مشابهی طی 1 دقیقه بعدی ارسال شود، پاسخ کش‌شده به کاربر باز خواهد گشت تا عملکرد بهبود یابد.

مثال درخواست cURL

curl -X GET
    "https://pars-bit.com/api/v1/cryptocurrencies/price" \ -H "Authorization: Bearer your_token"