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

Bir dağıtım token'ı için belirli bir tarih aralığındaki harici kullanıcı satın alımlarını döndürür. Hem start_date hem de end_date zorunludur ve ISO 8601 formatında olmalıdır (2006-01-02T15:04:05Z07:00).

İstek

GET /v2/distributions/tokens/{tokenID}/purchases

Parametreler

Ad	Tip	Yer	Açıklama
tokenID	string	path	Zorunlu. Dağıtım token ID'si
start_date	string	query	Zorunlu. Aralık başlangıcı, ISO 8601
end_date	string	query	Zorunlu. Aralık bitişi, ISO 8601

Başlıklar (Headers)

Ad	Açıklama
Authorization	Zorunlu. Kimlik doğrulama için Bearer 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 eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...'

Yanıt

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

Yanıt Alanları

Alan	Tip	Açıklama
data	array	Harici satın alımların listesi
data[].id	string	Satın alma ID'si
data[].quantity	integer	Satın alınan miktar
data[].price	number	Birim fiyat
data[].currency	object	Para birimi {symbol, decimal, address}
data[].buyer_address	string	Alıcı cüzdan adresi
data[].seller_address	string	Satıcı cüzdan adresi
data[].market_id	string	Pazar ID'si
data[].hash	string	Zincir üstü işlem hash'i
data[].created_at	string	Satın alma zamanı (ISO 8601)
total	integer	Aralıktaki toplam satın alma sayısı

Durum Kodları

Durum Kodu	Açıklama
200	Başarılı
400	Hatalı İstek - Eksik tokenID, start_date veya end_date, ya da geçersiz tarih formatı
401	Yetkisiz - Geçersiz veya eksik kimlik doğrulama token'ı
500	Sunucu Hatası