Token Bazında Gruplanmış OTC Tekliflerini Listele

Bir düğümün OTC tekliflerini token bazında gruplayarak listeler: her token için teklif sayısı, teklif edilen toplam miktar ve fiyat aralığıyla bir satır. Düğüm API anahtarınızın düğüm alt ağacında olmalıdır. Zincir üstü oluşturulması henüz onaylanmamış teklifler dışarıda kalır; diğer tüm durumlardaki teklifler (açık, kabul edilmiş, iptal edilmiş, reddedilmiş) sayılır.

Düğüm bir query filtresidir ve çağrı GET'tir; eskiden düğüm path'te ve sayfalama JSON gövdede olan bir POST idi. Teklifi olmayan bir düğüm boş sayfa döner.

Gerekli izin: otc:view

İstek

GET /v2/admin/otcs?node_id={node_id}&page={page}&per_page={per_page}

Parametreler

Ad	Tip	Konum	Açıklama
node_id	string	query	Zorunlu. Teklifleri listelenen düğüm (24 karakter hex)
page	integer	query	Zorunlu. Sayfa numarası, 1'den başlar
per_page	integer	query	Zorunlu. Sayfa başına kayıt, 1–100

Başlıklar

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

Örnek

curl --request GET \
  --url '{{baseUrl}}/v2/admin/otcs?node_id=6810a8e5b45680e7d2f95bad&page=1&per_page=10' \
  --header 'Authorization: Bearer <access_token>'

Yanıt

{
  "data": [
    {
      "token_id": "68ae06cfcccf4e8fc19362d1",
      "total_count": 3,
      "token_address": "0x78fccec69e21dc0b331b59f283d4d5b41ff36654",
      "token_price_symbol": "USDT",
      "token_image": "https://fra1.digitaloceanspaces.com/apex/dev/token/68ae06cfcccf4e8fc19362d1/images/c476dc47-374f-4da9-a948-ecd76b9c8305.png",
      "token_name": "DeriToken",
      "token_symbol": "DERI",
      "token_status": 6,
      "token_category_id": "667e9251ca818a2138ed4915",
      "total_quantity": 12,
      "min_price": "4.5",
      "max_price": "5.25"
    }
  ],
  "total": 1,
  "page": 1,
  "per_page": 10
}

Yanıt Alanları

Alan	Tip	Açıklama
data	array	Her token için bir satır
data[].token_id	string	Token ID'si
data[].total_count	integer	Token üzerindeki teklif sayısı
data[].total_quantity	integer	Tekliflerin quantity toplamı (tam token)
data[].min_price	string	En düşük teklif birim fiyatı, ondalık string
data[].max_price	string	En yüksek teklif birim fiyatı, ondalık string
data[].token_address	string	Token kontrat adresi
data[].token_price_symbol	string	Tokenın fiyatlandığı para biriminin sembolü
data[].token_image	string	Tokenın varsayılan görselinin URL'si
data[].token_name	string	Token adı
data[].token_symbol	string	Tokenın kısa adı
data[].token_status	integer	Tokenın status değeri
data[].token_category_id	string	Tokenın varlık kategorisi ID'si
total	integer	Teklifi olan token sayısı
page	integer	Geçerli sayfa
per_page	integer	Sayfa başına kayıt

Hatalar

Durum	Kod	Açıklama
400	10015	Doğrulama başarısız — details alanına bakın
400	10001 (domain 2)	Düğüm bulunamadı
400	10001 (domain 5)	Teklifi olan bir token bulunamadı
403	10005 (domain 2)	Düğüm, API anahtarınızın düğüm alt ağacının dışında
500	10000	Beklenmeyen sunucu hatası

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