OTC'de Sat

Kullanıcının cüzdanlarından birinden, token başına unit_price fiyatla quantity adet token satmak için bir OTC teklifi oluşturur. Çağrı asenkrondur: bir kullanıcı işlemi (type = 6, OTC teklifi oluşturma) 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; teklif Kullanıcı OTC Tekliflerini Listele içinde ancak zincirde onaylandıktan sonra görünür.

wallet_id zorunludur ve teklifi karşılayan varlığın bulunduğu, teklifi 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 OTC tekliflerinin ve açık ikincil piyasa ilanlarının zaten bağladığı miktar.

Gerekli izin: otc:trade

İstek

POST /v2/users/{user_id}/otcs/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	Teklifi karşılayan varlığın bulunduğu ve teklifi imzalayan satıcı cüzdanı (wallets._id). Kullanıcıya ait olmalı ve token'ın zincirinde bulunmalıdır
quantity	integer	Evet	Teklif edilecek tam token sayısı, en az 1
currency_token_id	string	Evet	Teklifin 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/otcs/tokens/68ae06cfcccf4e8fc19362d1/sell' \
  --header 'Authorization: Bearer <access_token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "wallet_id": "6a89b68e0c46ca4c941271aa",
    "quantity": 3,
    "currency_token_id": "6913307ec95e268b239b2d8b",
    "unit_price": "1.1"
  }'

Yanıt

{
  "transaction_id": "6913872755654191dede37da"
}

Yanıt Alanları

Alan	Tip	Açıklama
transaction_id	string	Teklifi 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)
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	11002	Cüzdanda bu teklif için yeterli serbest token yok (domain 11)
404	10001	Para birimi token'ı bulunamadı (domain 15)
500	10000	Beklenmeyen sunucu hatası

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