Birincil Piyasa Satın Alma Fiyatı

quantity adet token'lık bir birincil piyasa alımını göndermeden fiyatlar: temel tutar, alıcı ücreti ve alıcıdan alınacak toplam. Birincil Piyasadan Satın Al asenkrondur ve yalnızca bir işlem ID'si döndürür; tutarı harcanmadan önce göstermenin yolu budur. Ücret, alımın yaptığı şekilde çözümlenir ve uygulanır; böylece fiyat teklifi ile tahsil edilen tutar örtüşür.

Fiyat teklifi kullanıcı ya da cüzdan almaz: fiyat token'a ve kurulumuna aittir. Alıcıya özgü kontroller (cüzdan, kalan arz, kullanıcı başına sınır) yalnızca alımda yapılır. Harici bir token platform ücreti taşımaz; buyer_fee sıfırdır ve total, subtotal'a eşittir. Listelenmemiş bir token reddedilir.

Gerekli izin: purchase:view

İstek

GET /v2/users/purchases/tokens/{token_id}/primary-market/quote

Parametreler

Ad	Tip	Konum	Açıklama
token_id	string	path	Zorunlu. Token ID'si
quantity	integer	query	Zorunlu. Fiyatlanacak tam token sayısı, en az 1

Başlıklar

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

Örnek

curl --request GET \
  --url '{{baseUrl}}/v2/users/purchases/tokens/68ae06cfcccf4e8fc19362d1/primary-market/quote?quantity=10' \
  --header 'Authorization: Bearer <access_token>'

Yanıt

{
  "token_id": "68ae06cfcccf4e8fc19362d1",
  "market_type": "primary",
  "quantity": 10,
  "unit_price": "1.12",
  "subtotal": "11.2",
  "buyer_fee": {
    "percentage": "2.5",
    "amount": "0.28"
  },
  "total": "11.48",
  "currency": {
    "symbol": "VUSD",
    "decimal": 6,
    "address": "0xf2d90affe805280c004d0135343f2cbd7c96ce98"
  }
}

Yanıt Alanları

Alan	Tip	Açıklama
token_id	string	Fiyatlanan token
market_type	string	Bu uçta her zaman primary
quantity	integer	Fiyatlanan miktar
unit_price	string	Bir token'ın fiyatı
subtotal	string	unit_price × quantity: ücretlerden önceki tutar
buyer_fee.percentage	string	Alıcıdan alınan toplam ücret oranı (sahip, platform sahibi ve düğüm toplamı)
buyer_fee.amount	string	Ücret tutarı: her alıcının payının toplamı; her pay, ücret kontratının aldığı gibi para biriminin ondalık basamağına kırpılır
total	string	Alıcının ödeyeceği tutar: subtotal + buyer_fee.amount
currency.symbol	string	Tüm tutarların ifade edildiği ödeme para biriminin sembolü
currency.decimal	integer	Ödeme para biriminin ondalık basamak sayısı
currency.address	string	Ödeme para biriminin kontrat adresi

Tüm tutarlar ondalık string'dir; bkz. Tutarlar ve Yüzdeler.

Hatalar

Durum	Kod	Açıklama
400	10015	Doğrulama başarısız (quantity eksik ya da 1'den küçük) — details alanına bakın
400	10016	token_id geçerli 24 karakterlik hex ID değil
400	10001	Token bulunamadı (domain 5)
400	10011	Token listelenmemiş (domain 5, token is not active)
500	10000	Beklenmeyen sunucu hatası

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