StardDevelopersداشبورد

آمار کالکشن NFT

GET/api/v1/nfts/collections/{slug}/stats
scope: products:readاحراز هویت: Bearerlive و test

حجم معاملات ۲۴ ساعت/۷ روز/۳۰ روز، تعداد فروش، میانگین، بالاترین و پایین‌ترین فروش، تغییر قیمت ۲۴ ساعته و ۷ روزه و کف قیمت در Stard.

درخواست

ناممحلنوعتوضیح
AuthorizationheaderstringالزامیBearer sk_live_… یا Bearer sk_test_…
slugpathstringالزامیslug کالکشن، مثل plushpepe

نمونه

curl "https://stard-market.ir/api/v1/nfts/collections/plushpepe/stats" \
  -H "Authorization: Bearer $STARD_API_KEY"
پاسخ — 200
{
  "collection": "finepen",
  "volume_24h_ton": 27.99,
  "volume_7d_ton": 27.99,
  "volume_30d_ton": 85.84,
  "sales_24h": 3,
  "sales_7d": 3,
  "sales_30d": 10,
  "average_price_7d_ton": 9.33,
  "highest_sale_30d_ton": 10.0,
  "lowest_sale_30d_ton": 2.0,
  "price_change_24h_percent": null,
  "price_change_7d_percent": 20.39,
  "active_listings_on_stard": 15,
  "floor_price_on_stard": {
    "amount": 4023613,
    "currency": "IRT"
  },
  "ton_rate_irt": 399168,
  "object": "collection_stats"
}
هدرهای پاسخ
content-type: application/json
x-request-id: req_qVYBIZExg4YE4R4Wh31s
x-ratelimit-limit: 1000
x-ratelimit-remaining: 983

خطاها

HTTPcodeکی
400parameter_invalidslug نامعتبر
403insufficient_scopeکلید scope products:read را ندارد
401invalid_api_key / missing_api_key / api_key_revoked / api_key_expiredکلید نیامده، نامعتبر، باطل یا منقضی است
429rate_limit_exceededسقف درخواست در دقیقه پر شده؛ بعد از Retry-After ثانیه دوباره بفرست

محدودیت نرخ

پیش‌فرض ۶۰ درخواست در دقیقه برای هر کلید (قابل تنظیم در داشبورد). وضعیت در هدرهای X-RateLimit-* برمی‌گردد — جزئیات.