برچسب‌ها

فهرست برچسب‌ها همراه با آمار بازار

GEThttps://api.arzdigital.com/v1/tags/metrics

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

ارزش بازار، حجم معاملات، سهم از بازار و تغییر قیمت دارایی‌های هر برچسب.

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

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

GET/v1/tags/metrics

curl -sS "https://api.arzdigital.com/v1/tags/metrics?limit=10" \
  -H "X-API-Key: YOUR_API_KEY"

نمونه پاسخ200

{
  "status": "success",
  "meta": {
    "count": 2
  },
  "data": [
    {
      "slug": "ethereum-ecosystem",
      "name": "Ethereum Ecosystem",
      "display_name": "Ethereum Ecosystem",
      "linked_assets": 2888,
      "average_price_change_24h": 806573064765.7894,
      "total_market_cap": 51601836783469450000,
      "total_market_cap_24h": 5970914034.762451,
      "total_dominance": 30.140099999999972,
      "total_volume": 124932886157.02008,
      "negative_price_change_assets": 2038,
      "positive_price_change_assets": 814,
      "last_updated_at": "2026-11-14T00:00:01.049Z"
    },
    {
      "slug": "bnb-chain-ecosystem",
      "name": "BNB Chain Ecosystem",
      "display_name": "BNB Chain Ecosystem",
      "linked_assets": 2882,
      "average_price_change_24h": 6.811273704096531,
      "total_market_cap": 619682506277.8013,
      "total_market_cap_24h": -1.639077050347574,
      "total_dominance": 22.856199999999973,
      "total_volume": 112338761621.31004,
      "negative_price_change_assets": 2097,
      "positive_price_change_assets": 760,
      "last_updated_at": "2026-11-14T00:00:01.049Z"
    }
  ]
}

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

پارامترها

limitintegerکوئری
تعداد ردیف در هر صفحه.
پیش‌فرض: 100محدوده: 1 – 1000
offsetintegerکوئری
تعداد ردیف‌هایی که از ابتدا رد می‌شوند.
پیش‌فرض: 0محدوده: 0 – …
sortstringکوئری
پیش‌فرض: linked_asset_desc
مقادیر مجاز (10)
id_ascid_descupdated_at_ascupdated_at_desclinked_asset_asclinked_asset_descmarket_cap_ascmarket_cap_desctotal_dominance_asctotal_dominance_desc

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

X-API-Keystringالزامی
کلید API شما. آن را در هر درخواست در این هدر بفرستید. کلید در نشانی درخواست پذیرفته نمی‌شود.
Accept-Languagestring
زبان نام‌ها و توضیحات، مانند fa-IR. اگر زبان پشتیبانی نشود، پاسخ با en-US برمی‌گردد.

پاسخ

یک صفحه از برچسب‌ها همراه با آمارشان.

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

statusstring
metaobject
اگر count نیامده باشد، سرویس داده تعداد ردیف‌های برگشتی را گزارش نکرده است.
meta.countinteger
تعداد ردیف‌هایی که هزینه این درخواست بر اساس آن حساب شده، یعنی طول data.
dataarray
data[].slugstring
data[].namestring
data[].display_namestring | null
data[].linked_assetsinteger | null
تعداد دارایی‌های این برچسب.
data[].average_price_change_24hnumber | null
data[].total_market_capnumber | null
data[].total_market_cap_24hnumber | null
تغییر ارزش کل بازار در ۲۴ ساعت.
data[].total_dominancenumber | null
data[].total_volumenumber | null
data[].negative_price_change_assetsinteger | null
تعداد دارایی‌هایی که قیمتشان کاهش یافته است.
data[].positive_price_change_assetsinteger | null
تعداد دارایی‌هایی که قیمتشان افزایش یافته است.
data[].last_updated_atstring | null

هدرهای پاسخ

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

خطاها

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

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