دارایی‌ها

دریافت نمودار قیمت یک دارایی

GEThttps://api.arzdigital.com/v1/assets/{slug}/chart

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

یا range را بفرستید، یا هر سه پارامتر from، to و interval را. این دو حالت را نمی‌توان با هم به کار برد. در حالت from، to و interval بازه حداکثر ۱۰۰۰ نقطه را در خود جا می‌دهد. در حالت range فاصله نقاط خودکار انتخاب می‌شود و دارایی‌ای که تاریخچه کوتاهی دارد نقاط کمتری برمی‌گرداند. برای فاصله‌های 1d و بیشتر، from به ابتدای روز به وقت UTC گرد می‌شود.

مصرف اعتبار: هر درخواست موفق به ازای هر ۱۰۰ نقطه که برمی‌گرداند ۱ اعتبار مصرف می‌کند و عدد به بالا گرد می‌شود. مثلاً ۲۵۰ نقطه برابر ۳ اعتبار است.

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

GET/v1/assets/bitcoin/chart

curl -sS "https://api.arzdigital.com/v1/assets/bitcoin/chart?range=7d" \
  -H "X-API-Key: YOUR_API_KEY"

نمونه پاسخ200

{
  "status": "success",
  "meta": {
    "low_usd": {
      "time": 1793982000,
      "price_usd": 75381.1163077671,
      "irt_rate": 269800,
      "price_btc": 1
    },
    "high_usd": {
      "time": 1794042000,
      "price_usd": 76101.30465362652,
      "irt_rate": 268808,
      "price_btc": 1
    },
    "low_irt": {
      "time": 1794066600,
      "price_usd": 75599.6470289336,
      "irt_rate": 267822,
      "price_btc": 1
    },
    "high_irt": {
      "time": 1794002700,
      "price_usd": 75968.36808750335,
      "irt_rate": 270000,
      "price_btc": 1
    }
  },
  "data": [
    {
      "time": 1793982000,
      "price_usd": 75381.1163077671,
      "irt_rate": 269800,
      "price_btc": 1
    },
    {
      "time": 1793982300,
      "price_usd": 75665.10731928215,
      "irt_rate": 269899,
      "price_btc": 1
    },
    {
      "time": 1793982600,
      "price_usd": 75672.51704809254,
      "irt_rate": 269977,
      "price_btc": 1
    },
    {
      "time": 1793982900,
      "price_usd": 75822.81654843579,
      "irt_rate": 269915,
      "price_btc": 1
    }
  ]
}

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

پارامترها

slugstringمسیرالزامی
اسلاگ دارایی، مانند bitcoin.
نمونه: bitcoin
rangestringکوئری
بازه‌ای که به همین لحظه ختم می‌شود. نمی‌توان آن را همراه با from، to یا interval فرستاد.
1d7d1m3m6m1yall
fromintegerکوئری
ابتدای بازه، به ثانیه یونیکس. به to و interval هم نیاز دارد.
tointegerکوئری
انتهای بازه، به ثانیه یونیکس. به from و interval هم نیاز دارد.
intervalstringکوئری
فاصله نقاط. به from و to هم نیاز دارد.
مقادیر مجاز (11)
5m30m2h6h12h1d2d3d7d30d60d

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

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

پاسخ

نقاط نمودار، همراه با بیشترین و کمترین مقدار بازه در meta.

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

statusstring
metaobject
meta.low_usdobject | null
meta.low_usd.timeinteger
ثانیه یونیکس.
meta.low_usd.price_usdnumber
قیمت به دلار.
meta.low_usd.irt_ratenumber
نرخ تومان به ازای هر واحد از قیمت دلاری، بدون اعشار.
meta.low_usd.price_btcnumber
قیمت به بیت‌کوین.
meta.high_usdobject | null
meta.high_usd.timeinteger
ثانیه یونیکس.
meta.high_usd.price_usdnumber
قیمت به دلار.
meta.high_usd.irt_ratenumber
نرخ تومان به ازای هر واحد از قیمت دلاری، بدون اعشار.
meta.high_usd.price_btcnumber
قیمت به بیت‌کوین.
meta.low_irtobject | null
meta.low_irt.timeinteger
ثانیه یونیکس.
meta.low_irt.price_usdnumber
قیمت به دلار.
meta.low_irt.irt_ratenumber
نرخ تومان به ازای هر واحد از قیمت دلاری، بدون اعشار.
meta.low_irt.price_btcnumber
قیمت به بیت‌کوین.
meta.high_irtobject | null
meta.high_irt.timeinteger
ثانیه یونیکس.
meta.high_irt.price_usdnumber
قیمت به دلار.
meta.high_irt.irt_ratenumber
نرخ تومان به ازای هر واحد از قیمت دلاری، بدون اعشار.
meta.high_irt.price_btcnumber
قیمت به بیت‌کوین.
dataarray
data[].timeinteger
ثانیه یونیکس.
data[].price_usdnumber
قیمت به دلار.
data[].irt_ratenumber
نرخ تومان به ازای هر واحد از قیمت دلاری، بدون اعشار.
data[].price_btcnumber
قیمت به بیت‌کوین.

هدرهای پاسخ

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

خطاها

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

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