Kullanıcı Satın Almalarını Listele

Kullanıcının satın alma geçmişini döndürür: tüm piyasalarda, en yeniden eskiye, satın alma başına bir satır. Her satır kendi status değerini, onu yürüten transaction_id'yi ve kesinleştiğinde zincir üstü hash'i taşır. Platform token'ı ve ikincil piyasa satın almaları gönderildikleri andan itibaren burada bekleyen (status = 1) olarak görünür. Token başına tek satır ve toplanmış miktarlar için Kullanıcı Varlıklarını Listele ucunu kullanın.

Hiç satın alma yapmamış kullanıcı 404 değil, boş bir sayfa alır.

Gerekli izin: purchase:view

İstek

GET /v2/users/{user_id}/purchases

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
token_id	string	query	Yalnızca bu token'ın satın almaları

Başlıklar

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

Örnek

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

Yanıt

{
  "data": [
    {
      "id": "6913872955654191dede37dc",
      "token_id": "68ae06cfcccf4e8fc19362d1",
      "quantity": 10,
      "market_type": 0,
      "status": 0,
      "transaction_id": "6913872755654191dede37da",
      "hash": "0x5b0c8f6e2a4d7c1b9e3f5a7d2c4b6e8f0a1c3e5d7b9f1a3c5e7d9b1f3a5c7e9d",
      "wallet_id": "6a89b68e0c46ca4c941271aa",
      "buyer_address": "0x3b4E4dd67EE4054514bA2101e981f4C4D44eFDDc",
      "seller_address": "0x730d22ae2267fc5b40520605868ddb48c29331a7",
      "price": {
        "amount": "1.12",
        "decimal": 6,
        "symbol": "VUSD",
        "address": "0xf2d90affe805280c004d0135343f2cbd7c96ce98"
      },
      "created_at": "2026-11-09T09:40:03Z"
    }
  ],
  "total": 1,
  "page": 1,
  "per_page": 10
}

Yanıt Alanları

Alan	Tip	Açıklama
data[].id	string	Satın alma ID'si
data[].token_id	string	Satın alınan token
data[].quantity	integer	Satın alınan tam token sayısı
data[].market_type	integer	0 birincil piyasa, 1 ikincil piyasa, 2 harici piyasa
data[].status	integer	0 onaylandı (zincirde kesinleşti), 1 bekliyor (gönderildi, onay bekliyor), 2 başarısız (zincir reddetti)
data[].transaction_id	string	Satın almayı yürüten kullanıcı işlemi: satın alma beklerken Kullanıcı İşlemini Getir ile sorgulayın; başarısız olduğunda nedeni işlemin error alanındadır. Satırda yoksa alan gönderilmez
data[].hash	string	Zincir üstü işlem hash'i; satın alma kesinleşene kadar boş
data[].wallet_id	string	Satın almanın ücretlendirildiği ve kesinleştiği alıcı cüzdanı. Satın almaların cüzdan taşımadığı döneme ait satırlarda boş
data[].buyer_address	string	Alıcı cüzdan adresi
data[].seller_address	string	Birincil piyasada token'ı çıkaran düğümün diamond kontratı; ikincil piyasada satıcının cüzdan adresi
data[].price	object	Ödenen birim fiyat: ödeme para biriminin amount (ondalık string), decimal, symbol, address değerleri
data[].created_at	string	Satın almanın kaydedildiği zaman (RFC 3339)
total	integer	Filtreye uyan satın alma 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	user_id ya da 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.