Harici Kullanıcı Satın Alımlarını Getir

Bir token'ın harici pazarlarda (platform dışındaki alıcılar tarafından) yapılmış ve belirli bir tarih aralığında kaydedilmiş satın alımlarını en yeniden eskiye döndürür. Zincir onayı bekleyen satın alımlar listelenmez. Liste sayfalanmaz: eşleşen tüm satın alımlar döner ve total bunların sayısıdır.

Aralık, satın alımın platforma kaydedildiği zamana göre filtreler; yanıttaki created_at ise satın alımın zincir üstündeki zamanıdır ve daha erken olabilir. Token kontrol edilmez: bilinmeyen bir token id'si boş liste döndürür.

Gerekli izin: distribution:view-purchases

İstek

GET /v2/distributions/tokens/{token_id}/purchases?start_date={start_date}&end_date={end_date}

Parametreler

Ad	Tip	Konum	Açıklama
token_id	string	path	Zorunlu. Token'ın platformdaki id'si (24 karakterlik hex)
start_date	string	query	Zorunlu. Aralığın başlangıcı, dahil. Saat dilimi içeren RFC 3339 / ISO 8601, örn. 2025-01-01T00:00:00Z
end_date	string	query	Zorunlu. Aralığın sonu, dahil. start_date ile aynı biçim

Başlıklar

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

Örnek

curl --request GET \
  --url '{{baseUrl}}/v2/distributions/tokens/67d8774e903bfcbe7eb5d93e/purchases?start_date=2025-01-01T00:00:00Z&end_date=2025-12-31T23:59:59Z' \
  --header 'Authorization: Bearer <access_token>'

Yanıt

{
  "data": [
    {
      "id": "69120e5fe5064fdeaef6f057",
      "quantity": 10,
      "price": "100",
      "currency": {
        "symbol": "USDT",
        "decimal": 6,
        "address": "0xc2132D05D31c914a87C6611C10748AEb04B58e8F"
      },
      "buyer_address": "0x1111111111111111111111111111111111111111",
      "seller_address": "0x4A096E485281DE1B8bF11A511D39d5B128EF7C4b",
      "market_id": "67d76014d9c4853c097bcf9a",
      "hash": "0x9b1e7f2c0d4a6b8e3f5a7c9d1e2f4a6b8c0d2e4f6a8b0c2d4e6f8a0b2c4d6e8f",
      "created_at": "2025-06-01T12:34:56Z"
    }
  ],
  "total": 1
}

Yanıt Alanları

Alan	Tip	Açıklama
data	array	Aralıktaki satın alımlar, en yeniden eskiye
data[].id	string	Satın alma id'si
data[].quantity	integer	Satın alınan token sayısı
data[].price	string	Ödenen birim fiyat, ondalık string (bkz. Tutarlar ve Yüzdeler)
data[].currency	object	Fiyatın para birimi: symbol, decimal (integer) ve kontrat address'i
data[].buyer_address	string	Alıcının cüzdan adresi
data[].seller_address	string	Satıcının adresi
data[].market_id	string	Satın alımın yapıldığı harici pazarın id'si
data[].hash	string	Satın alma işleminin hash'i
data[].created_at	string	Satın alımın zincir üstündeki zamanı (ISO 8601)
total	integer	data içindeki satın alma sayısı

Hatalar

Durum	Kod	Açıklama
400	10015	start_date ya da end_date eksik — details alanına bakın
400	10016	token_id geçerli bir 24 karakterlik hex id değil
500	10000	start_date ya da end_date RFC 3339 biçiminde değil (mesaj invalid start_date format / invalid end_date format) ya da beklenmeyen bir sunucu hatası

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