دارایی‌ها

دریافت تغییرات قیمت یک دارایی

GEThttps://api.arzdigital.com/v1/assets/{slug}/price-changes

X-API-Key در هدراعتبار چطور کار می‌کند

تغییرات دلاری و تومانی در هر بازه، محاسبه‌شده از تاریخچه ذخیره‌شده.

مصرف اعتبار: هر درخواست موفق، هر چه برگرداند، ۱ اعتبار مصرف می‌کند.

پاسخ خالی و هر نوع خطا هزینه‌ای ندارد.

GET/v1/assets/bitcoin/price-changes

curl -sS "https://api.arzdigital.com/v1/assets/bitcoin/price-changes" \
  -H "X-API-Key: YOUR_API_KEY"

نمونه پاسخ200

{
  "status": "success",
  "data": {
    "priceChangePercent1h": -0.12522892906683064,
    "priceChangePercent24h": 0.40601842030385354,
    "priceChangePercent7d": -2.3322668084640856,
    "priceChangePercent30d": -6.238073338699069,
    "priceChangePercent3m": 16.07316321119095,
    "priceChangePercent1y": -26.72854641515477,
    "priceChangePercentYTD": -13.513091700971092,
    "priceChangePercentIrt1h": -0.04172969896983506,
    "priceChangePercentIrt24h": -0.206540165017958,
    "priceChangePercentIrt7d": -3.2962247994361054,
    "priceChangePercentIrt30d": -5.832825161294052,
    "priceChangePercentIrt3m": 67.83941055030894,
    "priceChangePercentIrt1y": 81.757940467998,
    "priceChangePercentIrtYTD": 69.60640642404724
  }
}

این کدها را از سرور خود اجرا کنید. API هدر CORS نمی‌فرستد، پس مرورگر جلوی درخواست را می‌گیرد.

پارامترها

slugstringمسیرالزامی
اسلاگ دارایی، مانند bitcoin.
نمونه: bitcoin

هدرهای درخواست

X-API-Keystringالزامی
کلید API شما. آن را در هر درخواست در این هدر بفرستید. کلید در نشانی درخواست پذیرفته نمی‌شود.

پاسخ

تغییرات دارایی. بازه‌ای که داده قابل استفاده ندارد null است.

فیلدهای پاسخ (16)

statusstring
dataobject
درصد تغییرات. بازه‌ای که داده قابل استفاده ندارد null است.
data.priceChangePercent1hnumber | null
data.priceChangePercent24hnumber | null
data.priceChangePercent7dnumber | null
data.priceChangePercent30dnumber | null
data.priceChangePercent3mnumber | null
data.priceChangePercent1ynumber | null
data.priceChangePercentYTDnumber | null
data.priceChangePercentIrt1hnumber | null
data.priceChangePercentIrt24hnumber | null
data.priceChangePercentIrt7dnumber | null
data.priceChangePercentIrt30dnumber | null
data.priceChangePercentIrt3mnumber | null
data.priceChangePercentIrt1ynumber | null
data.priceChangePercentIrtYTDnumber | null

هدرهای پاسخ

X-Credits-Charged
اعتباری که این درخواست مصرف کرد. برای هر پاسخی غیر از ۲۰۰، مقدارش 0 است.
X-Credits-Remaining
موجودی حساب پس از این درخواست، بدون احتساب اعتباری که درخواست‌های هنوز در حال اجرا کنار گذاشته‌اند. فقط وقتی منفی است که حساب پس از یک اصلاح دستی بدهکار باشد.
X-RateLimit-Limit
تعداد درخواست مجاز این کلید در هر دقیقه.
X-RateLimit-Remaining
تعداد درخواستی که در بازه فعلی باقی مانده است.
X-RateLimit-Reset
زمانی که دوباره جا برای درخواست باز می‌شود، به ثانیه یونیکس.

خطاها

bad_requesterror_code 1001
یکی از پارامترها جا افتاده، قالبش درست نیست یا خارج از محدوده است.

خطاها هیچ‌وقت هزینه ندارند. خطاها