StardDevelopersداشبورد

سابقه‌ی فروش NFT

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

سابقه‌ی فروش یک گیفت NFT (مثل plushpepe-1234): آخرین فروش، بالاترین و پایین‌ترین قیمت و فهرست فروش‌ها با مدل، پس‌زمینه و نماد، به TON و تومان.

درخواست

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

نمونه

curl "https://stard-market.ir/api/v1/nfts/plushpepe-1234/history" \
  -H "Authorization: Bearer $STARD_API_KEY"
پاسخ — 200
{
  "object": "nft_history",
  "gift": "finepen-24624",
  "sales_count": 4,
  "last_sale": {
    "gift": "finepen-24624",
    "collection": "finepen",
    "number": 24624,
    "model": "Signature Scribe",
    "backdrop": "Moonstone",
    "symbol": "White Deer",
    "price_ton": 10.0,
    "price_irt": 3991680,
    "sold_at": "2026-09-21T21:07:46Z",
    "source": "purchase"
  },
  "highest_ton": 10.0,
  "lowest_ton": 8.0,
  "sales": [
    {
      "gift": "finepen-24624",
      "collection": "finepen",
      "number": 24624,
      "model": "Signature Scribe",
      "backdrop": "Moonstone",
      "symbol": "White Deer",
      "price_ton": 10.0,
      "price_irt": 3991680,
      "sold_at": "2026-09-21T21:07:46Z",
      "source": "purchase"
    },
    {
      "gift": "finepen-24624",
      "collection": "finepen",
      "number": 24624,
      "model": "Signature Scribe",
      "backdrop": "Moonstone",
      "symbol": "White Deer",
      "price_ton": 8.85,
      "price_irt": 3532636,
      "sold_at": "2026-09-13T10:07:55Z",
      "source": "history"
    },
    {
      "gift": "finepen-24624",
      "collection": "finepen",
      "number": 24624,
      "model": "Signature Scribe",
      "backdrop": "Moonstone",
      "symbol": "White Deer",
      "price_ton": 10.0,
      "price_irt": 3991680,
      "sold_at": "2026-09-07T20:46:40Z",
      "source": "history"
    }
  ],
  "note": "سابقه‌ی فروش‌های ثبت‌شده در بازار؛ مالک فعلی و انتقال‌های بدون فروش در این داده نیست."
}
هدرهای پاسخ
content-type: application/json
x-request-id: req_m4DH4WctKq0TySlwuMV7
x-ratelimit-limit: 1000
x-ratelimit-remaining: 984

خطاها

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-* برمی‌گردد — جزئیات.