Token İlanlarını Listele

Bir token'ın açık ikincil piyasa ilanlarını en yeniden eskiye, ilan başına bir satır olarak döndürür. Bunlar Token İkincil Piyasa Özetini Getir arkasındaki tekliflerdir. Bir ilanı fiyatlamak ya da satın almak için onun deal_id ve quantity değerlerini kullanın; ilan bütün olarak satın alınır.

Hiçbir ilanı olmayan bir token 404 değil, boş bir sayfa döndürür.

Gerekli izin: secondary-market:view

İstek

GET /v2/users/secondary-markets/tokens/{token_id}/listings

Parametreler

Ad	Tip	Konum	Açıklama
token_id	string	path	Zorunlu. Token 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/secondary-markets/tokens/68ae06cfcccf4e8fc19362d1/listings?page=1&per_page=10' \
  --header 'Authorization: Bearer <access_token>'

Yanıt

{
  "data": [
    {
      "id": "6913b20e55654191dede3801",
      "token_id": "68ae06cfcccf4e8fc19362d1",
      "user_id": "680c02896d91ca0145cfeb82",
      "deal_id": 13,
      "quantity": 10,
      "price": {
        "amount": "12",
        "decimal": 6,
        "symbol": "VUSD",
        "address": "0xf2d90affe805280c004d0135343f2cbd7c96ce98"
      },
      "status": 0,
      "created_at": "2026-11-09T09:40:03Z",
      "updated_at": "2026-11-09T09:41:10Z"
    }
  ],
  "total": 1,
  "page": 1,
  "per_page": 10
}

Yanıt Alanları

Alan	Tip	Açıklama
data[].id	string	İlan ID'si
data[].token_id	string	İlandaki token
data[].user_id	string	Satıcı
data[].deal_id	integer	Zincir üstü anlaşma ID'si; fiyat teklifi ve satın alma uçlarına gönderin
data[].quantity	integer	İlandaki tam token sayısı; satın alma tam olarak bu miktarı göndermelidir
data[].price	object	Birim fiyat: ödeme para biriminin amount (ondalık string), decimal, symbol, address değerleri
data[].status	integer	Bu uçta her zaman 0 (açık)
data[].created_at	string	İlanın kaydedildiği zaman (RFC 3339)
data[].updated_at	string	Son değişiklik (RFC 3339)
total	integer	Token'ın açık ilan 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
400	10016	token_id geçerli 24 karakterlik hex ID değil
500	10000	Beklenmeyen sunucu hatası

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