بازار جهانی

دریافت آخرین آمار کلی بازار

GEThttps://api.arzdigital.com/v1/global/latest

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

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

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

GET/v1/global/latest

curl -sS "https://api.arzdigital.com/v1/global/latest" \
  -H "X-API-Key: YOUR_API_KEY"

نمونه پاسخ200

{
  "status": "success",
  "data": {
    "active_cryptocurrencies": 8034,
    "total_cryptocurrencies": 40128,
    "active_market_pairs": 109017,
    "active_exchanges": 987,
    "total_exchanges": 13341,
    "eth_dominance": 10.771375132916,
    "btc_dominance": 59.949944723123,
    "eth_dominance_yesterday": 10.67932254,
    "btc_dominance_yesterday": 59.77555751,
    "eth_dominance_24h_percentage_change": 0.092052592916,
    "btc_dominance_24h_percentage_change": 0.174387213123,
    "defi_volume_24h": 7701958847.180505,
    "defi_market_cap": 75363892224.98566,
    "stablecoin_volume_24h": 42105488328.71271,
    "stablecoin_market_cap": 272937668109.6142,
    "derivatives_volume_24h": 395182686125.70264,
    "quote": {
      "USD": {
        "total_market_cap": 2541830909742.3374,
        "total_volume_24h": 41165917830.38,
        "altcoin_volume_24h": 26439030439.47315,
        "altcoin_market_cap": 1018004684396.542,
        "total_market_cap_yesterday": 2543311912770.5757,
        "total_volume_24h_yesterday": 100787947133.33,
        "total_market_cap_yesterday_percentage_change": -0.05823128,
        "total_volume_24h_yesterday_percentage_change": -59.15591199,
        "last_updated": "2026-11-07T15:25:59.999Z"
      }
    }
  }
}

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

پارامترها

این درخواست پارامتری ندارد.

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

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

پاسخ

آمار کلی بازار. وقتی آخرین تصویر داده موقتاً در دسترس نباشد، data برابر null است و هزینه‌ای کسر نمی‌شود.

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

statusstring
dataobject | null
data.active_cryptocurrenciesinteger
data.total_cryptocurrenciesinteger
data.active_market_pairsinteger
data.active_exchangesinteger
data.total_exchangesinteger
data.eth_dominancenumber
data.btc_dominancenumber
data.eth_dominance_yesterdaynumber
data.btc_dominance_yesterdaynumber
data.eth_dominance_24h_percentage_changenumber
data.btc_dominance_24h_percentage_changenumber
data.defi_volume_24hnumber
data.defi_market_capnumber
data.stablecoin_volume_24hnumber
data.stablecoin_market_capnumber
data.derivatives_volume_24hnumber
data.quoteobject
مجموع ارقام بازار به تفکیک ارز مظنه. تنها کلید موجود USD است.
data.quote.USDobject
data.quote.USD.total_market_capnumber
data.quote.USD.total_volume_24hnumber
data.quote.USD.altcoin_market_capnumber
data.quote.USD.altcoin_volume_24hnumber
data.quote.USD.total_market_cap_yesterdaynumber
data.quote.USD.total_volume_24h_yesterdaynumber
data.quote.USD.total_market_cap_yesterday_percentage_changenumber
data.quote.USD.total_volume_24h_yesterday_percentage_changenumber
data.quote.USD.last_updatedstring

هدرهای پاسخ

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

خطاها

invalid_keyerror_code 1002
کلید فرستاده نشده، قالبش درست نیست یا چنین کلیدی وجود ندارد.

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