Ana içeriğe geç

Admin Get OTC Deal Detail

Tek bir OTC teklifini, token içindeki deal id'siyle döner — Accept ve Cancel'ın kullandığı anahtarın aynısı; bir token'ın tekliflerini listeleyebilen çağıran bu uç için gerekli her şeye zaten sahiptir.

İstek

GET /v2/admin/otcs/tokens/{token_id}/deals/{deal_id}

Parametreler

İsimTipKonumAçıklama
token_idstringpathGerekli. Teklifin üzerinde olduğu token
deal_idintegerpathGerekli. Teklifin deal ID'si

Başlıklar

İsimTipAçıklama
AuthorizationGerekli. Kimlik doğrulama için Bearer token

Örnek

curl --location '\{\{baseUrl\}\}/v2/admin/otcs/tokens/68ae06cfcccf4e8fc19362d1/deals/2' \
--header 'Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...'

Yanıt

{
"id": "6a8b5d02f9129816a6cc79f4",
"token_id": "68ae06cfcccf4e8fc19362d1",
"node_id": "6810a8e5b45680e7d2f95bad",
"user_id": "680c02896d91ca0145cfeb81",
"deal_id": 2,
"price": {
"amount": 5,
"decimal": 6,
"symbol": "USDT",
"address": "0x78fccec69e21dc0b331b59f283d4d5b41ff36654"
},
"quantity": 1,
"status": 0,
"created_at": "2026-08-23T17:41:22.913Z",
"updated_at": "2026-08-23T17:41:22.913Z",
"user": {
"id": "680c02896d91ca0145cfeb81",
"name": "Ada",
"surname": "Yılmaz",
"email": "ada@example.com"
},
"transaction": null
}

Yanıt Alanları

AlanTipAçıklama
idstringTeklifin kendi ID'si. Get Otc Offer By ID ve işlem uçlarında kullanılır
deal_idintegerToken kontratı içinde tekil olan zincir üstü deal ID'si
priceobjectTeklifin birim fiyatı
price.amountnumberBir token'ın fiyatı
price.decimalintegerPara birimi token'ının ondalık basamağı
price.symbolstringPara birimi token sembolü
price.addressstringPara birimi token kontrat adresi
quantityintegerTeklif edilen token adedi
statusintegerTeklif durumu
userobjectTeklifi veren alıcı. Kullanıcı çözülemezse alan gelmez — silinmiş bir alıcı teklifi gizlememelidir
user.name, user.surnamestringİsteğe bağlı; boşsa gelmez
transactionobjectTeklif üzerindeki en son accept veya cancel; hiçbir aksiyon alınmadıysa null
transaction.statusinteger1 Started, 2 InProgress, 3 Done, 4 Error, 5 PendingReceipt
transaction.typeinteger1 accept, 2 cancel

Liste uçları "hangi teklifler var" sorusunu cevaplar; bu uç "bu teklife ne oldu" sorusunu — ki bunun için alıcının kimliği ve zincir üstü sonuç gerekir, ikisi de bir listenin her satırına ait değildir.

Durum Kodları

Durum KoduAçıklama
200Başarılı - teklif detayı alındı
400Hatalı İstek - deal bulunamadı ya da deal id'si ait olmadığı bir token ile eşleştirildi
401Yetkisiz - geçersiz veya eksik kimlik doğrulama token'ı
500Sunucu Hatası

Notlar

  • Başka bir node'a ait token üzerindeki teklif okunamaz.
  • transaction yalnızca en son denemeyi yansıtır. Başarısız bir accept tekrar denenebileceği için tam geçmiş List Otc Transactions ucundadır.