İkincil Piyasada Sat

Kullanıcının cüzdanlarından birinden, token başına unit_price fiyatla quantity adet token'ı ikincil piyasada ilana çıkarır. Çağrı asenkrondur: bir kullanıcı işlemi (type = 3, ikincil piyasada satış) kaydeder ve onun transaction_id değerini döndürür. status 3 (tamamlandı) ya da 4 (hata) olana kadar Kullanıcı İşlemini Getir ile sorgulayın; ilan Kullanıcının Token İlanlarını Listele ve Token İlanlarını Listele içinde ancak zincirde onaylandıktan sonra görünür. İlan daha sonra bütün olarak satın alınır.

wallet_id zorunludur ve ilanı karşılayan varlığın bulunduğu, ilanı imzalayan cüzdanı belirtir. Cüzdan bu kullanıcıya ait olmalı ve token'ın zincirinde bulunmalıdır. Cüzdanda yeterli serbest token olmalıdır: kalan miktarı eksi açık ikincil piyasa ilanlarının ve açık OTC tekliflerinin zaten bağladığı miktar.

Gerekli izin: secondary-market:trade

İstek

POST /v2/users/{user_id}/secondary-markets/tokens/{token_id}/sell

Parametreler

Ad	Tip	Konum	Açıklama
user_id	string	path	Zorunlu. Satıcının kullanıcı ID'si
token_id	string	path	Zorunlu. Token ID'si

Başlıklar

Ad	Açıklama
Authorization	Zorunlu. Bearer <access_token>
Content-Type	Zorunlu. application/json

Gövde

Alan	Tip	Zorunlu	Açıklama
wallet_id	string	Evet	İlanı karşılayan varlığın bulunduğu ve ilanı imzalayan satıcı cüzdanı (wallets._id). Kullanıcıya ait olmalı ve token'ın zincirinde bulunmalıdır
quantity	integer	Evet	İlana çıkarılacak tam token sayısı, en az 1
currency_token_id	string	Evet	İlanın fiyatlandığı para birimi (currency_tokens._id)
unit_price	string	Evet	O para biriminde bir token'ın fiyatı, toplam değil. Sıfırdan büyük olmalı ve para biriminin ondalık basamağından fazla basamak içermemelidir. Bkz. Tutarlar ve Yüzdeler

Örnek

curl --request POST \
  --url '{{baseUrl}}/v2/users/680c02896d91ca0145cfeb81/secondary-markets/tokens/68ae06cfcccf4e8fc19362d1/sell' \
  --header 'Authorization: Bearer <access_token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "wallet_id": "6a89b68e0c46ca4c941271aa",
    "quantity": 10,
    "currency_token_id": "6913307ec95e268b239b2d8b",
    "unit_price": "12"
  }'

Yanıt

{
  "transaction_id": "6913872755654191dede37da"
}

Yanıt Alanları

Alan	Tip	Açıklama
transaction_id	string	İlanı oluşturan kullanıcı işlemi. Kullanıcı İşlemini Getir ile sorgulayın

Hatalar

Durum	Kod	Açıklama
400	10015	Doğrulama başarısız (wallet_id, quantity, currency_token_id) ya da unit_price eksik, sıfır, hatalı biçimli veya para biriminin ondalık basamağından ince — details alanına bakın
400	10016	user_id, token_id ya da wallet_id geçerli 24 karakterlik hex ID değil
400	10001	Token bulunamadı (domain 5)
404	10001	Para birimi token'ı bulunamadı (domain 15)
400	10015	Domain 1: wallet does not belong to this user on this network — cüzdan yok, bu kullanıcıya ait değil ya da başka bir zincirde
400	11003	Cüzdanda bu ilan için yeterli serbest token yok (domain 11)
500	10000	Beklenmeyen sunucu hatası

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