Kullanıcı İkincil Piyasa Gruplarını Listele

Kullanıcının ikincil piyasa ilanlarını token başına tek satıra indirgenmiş hâlde, en yeni token önce olacak şekilde döndürür. total_quantity, kullanıcının token üzerinde açtığı ve artık zincir onayı beklemeyen her ilanın miktarını toplar (açık, tamamlanmış ve iptal edilmiş ilanlar birlikte). İlanların kendileri için Kullanıcının Token İlanlarını Listele ucunu kullanın.

İlanı olmayan kullanıcı 404 değil, boş bir sayfa alır.

Gerekli izin: secondary-market:view

İstek

GET /v2/users/{user_id}/secondary-markets

Parametreler

Ad	Tip	Konum	Açıklama
user_id	string	path	Zorunlu. Kullanıcı ID'si
page	integer	query	Zorunlu. Sayfa numarası, 1'den başlar
per_page	integer	query	Zorunlu. Sayfa başına kayıt, 1–100

Başlıklar

Ad	Açıklama
Authorization	Zorunlu. Bearer <access_token>

Örnek

curl --request GET \
  --url '{{baseUrl}}/v2/users/680c02896d91ca0145cfeb81/secondary-markets?page=1&per_page=10' \
  --header 'Authorization: Bearer <access_token>'

Yanıt

{
  "data": [
    {
      "token_id": "68ae06cfcccf4e8fc19362d1",
      "total_quantity": 10,
      "total_amount": "0",
      "overall_profit": null,
      "source": "secondary_market",
      "token": {
        "name": "Sample Token",
        "symbol": "Sample",
        "image": "https://cdn.example.com/tokens/68ae06cfcccf4e8fc19362d1/cover.png",
        "address": "0x4ecde4b1b0a8f7a5d5c1e0f1a2b3c4d5e6f78387",
        "diamond_address": "0x730d22ae2267fc5b40520605868ddb48c29331a7",
        "status": 6,
        "category_id": "667e9251ca818a2138ed4885",
        "price_symbol": "VUSD",
        "is_external": false,
        "is_open_to_secondary_market": true,
        "is_open_to_otc": true,
        "secondary_market": null,
        "rate_changes": {
          "hourly": null,
          "daily": null,
          "weekly": null,
          "monthly": null,
          "quarterly": null
        }
      }
    }
  ],
  "total": 1,
  "page": 1,
  "per_page": 10
}

Yanıt Alanları

Satır, Kullanıcı Varlıklarını Listele ile aynı biçimdedir; bu uçta:

Alan	Tip	Açıklama
data[].token_id	string	İlanların ait olduğu token
data[].total_quantity	integer	Kullanıcının bu token'daki ilanlarının quantity toplamı (bekleyen ilanlar hariç)
data[].total_amount	string	İkincil piyasa gruplarında hesaplanmaz: her zaman "0"
data[].overall_profit	string | null	İkincil piyasa gruplarında hesaplanmaz: her zaman null
data[].source	string	Her zaman secondary_market
data[].token	object	Token: name, symbol (token'ın zincir üstü adı), image, address, diamond_address, status, category_id, price_symbol, is_external, is_open_to_secondary_market, is_open_to_otc. Bu uçta secondary_market null'dır ve her rate_changes penceresi null'dır
total	integer	Kullanıcının ilanı bulunan token sayısı
page	integer	İstenen sayfa
per_page	integer	İstenen sayfa boyutu

Hatalar

Durum	Kod	Açıklama
400	10015	Doğrulama başarısız (page, per_page) — details alanına bakın
500	10000	Beklenmeyen sunucu hatası

Hata biçimi ve ortak kodlar için Hatalar sayfasına bakın.